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:
- 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
inMainConfig
- Admin Menu > General
Example:
"CantBeDamagedInPvP": [
"Watchtower"
]