Itemrules - Ninjin89/ninjinspvppvewiki GitHub Wiki

ItemRules Configuration (ItemRules.json)

CAN BE OUTDATED SOMETIMES

`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.

Does require: https://steamcommunity.com/sharedfiles/filedetails/?id=3440985685

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:

BlockItemDamageStateorZones in MainConfig to make checks on player state or zone and item position
Admin Menu > General

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"
]