Itemrules - Ninjin89/ninjinspvppvewiki GitHub Wiki

ItemRules Configuration (ItemRules.json)

AllowedAmmoInPvEState

Type: Array[String]
Defines which ammo types are allowed for use in PvE zones. Useful for non-lethal projectiles like paintball ammo.

"AllowedAmmoInPvEState": [
  "DLT_Bullet_Paintball_Orange",
  "DLT_Bullet_Paintball_Blue",
  "DLT_Bullet_Paintball_Green",
  "DLT_Bullet_Paintball_Pink"
]

BypassZoneChecksGrenades

Type: Array[String]
Grenades listed here bypass PvP/PvE/Raid zone restrictions, allowing usage regardless of zone rules.

"BypassZoneChecksGrenades": [
  "DLT_Paintball_Grenade_Ammo",
  "DLT_Paintball_Grenade_Ammo_Small",
  "DLT_Paintball_Grenade_Pink",
  "DLT_Paintball_Grenade_Green",
  "DLT_Paintball_Grenade_Orange",
  "DLT_Paintball_Grenade_Blue",
  "DLT_Paintball_GrenadeSmall_Pink",
  "DLT_Paintball_GrenadeSmall_Blue",
  "DLT_Paintball_GrenadeSmall_Orange",
  "DLT_Paintball_GrenadeSmall_Green"
]

BlockDeployIfPlayerInPvEState

Type: Array[String]
Prevents deploying listed items when the player is in a PvE state.

"BlockDeployIfPlayerInPvEState": [
  "TerritoryFlagKit",
  "LandMineTrap"
]

BlockDeployIfPlayerInPvPState

Type: Array[String]
Prevents deploying listed items when the player is in a PvP state.

"BlockDeployIfPlayerInPvPState": [
  "TerritoryFlagKit",
  "LandMineTrap"
]

BlockDeployIfPlayerInRaidState

Type: Array[String]
Prevents deploying listed items when the player is in a Raid state.

"BlockDeployIfPlayerInRaidState": [
  "TerritoryFlagKit",
  "LandMineTrap"
]

⚠️ Note: These checks are based on player state, not zone location. If Global PvP is active, restrictions apply globally unless zone-specific logic is added later.


CantBeDamagedOnGround

Type: Array[String]

Prevents listed items from being damaged while on the ground. Useful for items that should not be shootable or destroyed when dropped.

Example:

"CantBeDamagedOnGround": [
  "default_item_1",
  "default_item_2"
]

DisallowedVehicles

Type: Array[String]

Defines vehicle classes that are not allowed in zones using UsesDisallowedVehicles in ItemRules.

Example:

"DisallowedVehicles": [
  "Transport",
  "ExpansionHelicopterScript",
  "RFFSHeli_base",
  "CarScript"
]

CantBeDamagedAnimalsinPvE

Type: Array[String]

Prevents damage to listed animal classes inside PvE zones. Requires the NinjinsPvPPvE-Animal Mod.

Example:

"CantBeDamagedAnimalsinPvE": [
  "Animal_Cat",
  "Animal_Horse",
  "Doggo"
]

PvEBlockedExplosivesDamage

Type: Array[String]

Blocks explosive-type damage from the listed classnames while in PvE zones. Supports classnames and baseclasses.

Example:

"PvEBlockedExplosivesDamage": [
  "ExplosivesBase",
  "Ammo_40mm_Base",
  "Expansion_C4_Explosion",
  "Expansion_RPG_Explosion",
  "Expansion_LAW_Explosion",
  "Land_FuelStation_Feed",
  "Land_FuelStation_Feed_Enoch",
  "Expansion_M203",
  "LargeGasCanister",
  "M67Grenade"
]

CreateZoneWhenItemSpawned

Type: Object<String, DynamicZone>

Creates a temporary zone around an item when it's spawned to the ground. The item must be on the ground and not inside a container.

Example:

"CreateZoneWhenItemSpawned": {
  "Ninjin_EventItem1": {
    "type": 1,
    "priority": 10,
    "enableCustomMessages": 1,
    "customTitle": "Event ZONE",
    "customMessageEnter": "You entered an Event Zone!",
    "customMessageExit": "You exited the Event Zone!",
    "customIcon": "info",
    "notificationColor": -256,
    "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
    "startHour": 0,
    "endHour": 24,
    "zoneAlpha": 255,
    "zoneRed": 0,
    "zoneGreen": 255,
    "zoneBlue": 0,
    "forceFirstPerson": 0,
    "radius": 100.0,
    "drawShape": 1
  }
}

Notes

  • Items must be on the ground to trigger zone creation via CreateZoneWhenItemSpawned in mainconfig set to 1.
  • Use this feature carefully to avoid abuse through item persistence after server restarts.

NBItemWhiteList

Type: Array[String] List of item classnames allowed to be deployed inside NoBuild zones.


AllowedAmmoInPaintBallState

Type: Array[String] Paintball-compatible ammo types allowed if both players are in the Paintball state.

Example:

"AllowedAmmoInPaintBallState": [
  "DLT_Bullet_Paintball_Orange",
  "DLT_Bullet_Paintball_Blue",
  "DLT_Bullet_Paintball_Green",
  "DLT_Bullet_Paintball_Pink",
  "DLT_Paintball_Grenade_Ammo",
  "DLT_Paintball_Grenade_Ammo_Small",
  "DLT_Paintball_Grenade_Pink",
  "DLT_Paintball_Grenade_Green",
  "DLT_Paintball_Grenade_Orange",
  "DLT_Paintball_Grenade_Blue",
  "DLT_Paintball_GrenadeSmall_Pink",
  "DLT_Paintball_GrenadeSmall_Blue",
  "DLT_Paintball_GrenadeSmall_Orange",
  "DLT_Paintball_GrenadeSmall_Green"
]

CantBeDamagedInPvE

Type: Array[String] List of items that cannot be damaged in PvE zones or by players with PvE status.

Configurable via:

Example:

"CantBeDamagedInPvE": [
  "Watchtower"
]

CantBeDamagedInPvP

Type: Array[String] List of items that cannot be damaged in PvP zones or by players with PvP status.

Configurable via:

  • BlockItemDamageStateorZones in MainConfig
  • Admin Menu > General

Example:

"CantBeDamagedInPvP": [
  "Watchtower"
]