Zones - Ninjin89/ninjinspvppvewiki GitHub Wiki

Zone Configuration (Zones.json)

CAN BE OUTDATED SOMETIMES

name

Type: String

Unique name used internally for identifying the zone.

displayName

Type: String

This value appears on maps or UIs where zone names are shown. If not set, the name is used as a fallback.

If you wanna hide the label even if players have them set to show, use and empty space inside displayName this:

"displayName": " ",

type

Type: Integer

  • 1: PvP Zone
  • 2: PvE Zone
  • 3: Visual Only (No interaction changes)
  • 4: Raid Zone
  • 5: SafeZone

priority

Type: Integer

Defines precedence when zones overlap. Higher number wins. Use higher value for the zone that should overlap, if you want to merge use same prio level.

https://www.youtube.com/watch?v=8LBmpoxzPxA

enableCustomMessages

Type: Boolean (0 or 1)

Toggles entry/exit notifications for this zone.

customTitle

Type: String

Notification title when entering or leaving this zone.

customMessageEnter / customMessageExit

Type: String

Custom text displayed when a player enters or exits the zone.

customIcon

Type: String

Path to the icon shown in the notification. Must reference a valid .edds inside an active mod.

Example: NinjinsPvPPvE/gui/alarm.edds

notificationColor

Type: Integer

Color in ARGB format. Use this tool to generate: https://argb-int-calculator.netlify.app/

days

Type: String

Active days for the zone. Example: "Monday Tuesday Friday"

startHour / endHour

Type: Integer

Start and end time in 24h format. Example: 0 to 24 = all day.

zoneAlpha, zoneRed, zoneGreen, zoneBlue

Type: Integer

Color + transparency for the zone shape on map.

  • zoneAlpha: 0 (invisible) to 255 (opaque)
  • RGB values: 0-255

forceFirstPerson

Type: Boolean (0 or 1)

Forces player into first-person while inside the zone.

UsesDisallowedVehicles

Type: Boolean (0 or 1)

If 1, vehicles from DisallowedVehicles in Itemrules.json are blocked from entering the zone.

shape

Type: Integer

  • 0: Circle Zone (use center and radius)
  • 1: Polygon Zone (use vertices array)

drawShape

Type: Boolean (0 or 1)

If 1, the zone shape will be drawn on admin/player maps.

drawStrikeZone

Type: Boolean (0 or 1)

  • 1 = draw strikes lines
  • 0 = Do not draw strike lines

image

radius

Type: Float

Radius of the zone. Only applies to circle shapes.

EnableExpansion3DMarker

Type: Boolean (0 or 1)

Enable 3D Expansion Marker.

OnlyAllowExpansion2DMarker

Type: Boolean (0 or 1)

Restrict to 2D Expansion Map marker only.

ExpansionMarkerName

Type: String

Name of the Marker to show in Server Marker List.

This settings can be set for each Zone.

Expansion3DIcon

Type: String

Icon that should be used to show in Server Marker List (only does allow Expansion Icons)

Expansion Icon List: https://github.com/salutesh/DayZ-Expansion-Scripts/wiki/%5BServer-Hosting%5D-List-of-default-icon-names

This settings can be set for each Zone.

center

Type: Array [X, Y, Z]

Central coordinates of the circle zone. Y is optional and unused.

vertices

Type: Array of Vectors [X, Y, Z]

Defines the polygon points for custom shaped zones.

zoneMinHeight

Type: Float

Min height in meters where the zone should start (use 0 for ground).

zoneMaxHeight

Type: Float

Max height is used for upper height limit of the zone.

ignoreHeightCheck

Type: Boolean (0 or 1)

Ignore height checks and make it apply infinitely.

noBuildRadius

Type: Float

Draw a radius around an existing zone for a NoBuild zone.

  • If set to -1 = not a NoBuild zone
  • If set above 0 so like 1 zone becomes NoBuild zone + value in meters, it must have atleast value of 1 to cover full zone as no build!
  • Does NOT work with Polygon Zones!

Players inside will get nobuild state (blocks deploy action).

EXAMPLE GUIDE: https://www.youtube.com/watch?v=ulFQdnTbN74

EXAMPLE IMAGE: grafik

NoLogOut

Type: Boolean (0 or 1)

Sets player state to NoLogOut.

NoLogOutTeleportPos

Type: Array [X, Y, Z]

Teleport position for players logging out inside this zone.

Zone Example with All Fields

{
  "name": "Circle Example PvP",
  "displayName": "Circle Example PvP",
  "ZonelabelOffsetX_Meters": 0.0,
  "ZonelabelOffsetZ_Meters": 0.0,
  "ZoneLabelColor": 0,
  "type": 1,
  "priority": 10,
  "NoLogOut": 1,
  "NoLogOutTeleportPos":[
    3707.6201171875,
    402.0,
    5998.08984375
    ],
  "HideWhenNested": 0,
  "enableCustomMessages": 1,
  "customTitle": "Circle Zone Example PVP",
  "customMessageEnter": "You entered the Circle Zone Example!",
  "customMessageExit": "You exited the Circle Zone Example!",
  "customIcon": "NinjinsPvPPvE/gui/guns.edds",
  "notificationColor": -16711936,
  "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 255,
  "zoneGreen": 0,
  "zoneBlue": 0,
  "forceFirstPerson": 0,
  "UsesDisallowedVehicles": 0,
  "shape": 0,
  "drawShape": 1,
  "drawStrikeZone": 0,
  "radius": 300.0,
  "EnableExpansion3DMarker": 0,
  "OnlyAllowExpansion2DMarker": 0,
  "ExpansionMarkerName": "Circle Zone",
  "Expansion3DIcon": "Info",
  "center": [3000.0, 0.0, 3000.0],
  "vertices": []
}

Example Polygon Zone

{
  "name": "VisualPolygon1",
  "displayName": "Polygon Area",
  "type": 2,
  "priority": 1,
  "enableCustomMessages": 1,
  "customTitle": "Visual Area",
  "customMessageEnter": "Entered Visual Area",
  "customMessageExit": "Left Visual Area",
  "customIcon": "NinjinsPvPPvE/gui/alarm.edds",
  "notificationColor": -65536,
  "days": "Monday Tuesday Wednesday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 255,
  "zoneGreen": 255,
  "zoneBlue": 0,
  "forceFirstPerson": 0,
  "UsesDisallowedVehicles": 0,
  "shape": 1,
  "drawShape": 1,
  "radius": 0.0,
  "center": [0.0, 0.0, 0.0],
  "vertices": [
    [4000.0, 0.0, 4000.0],
    [4200.0, 0.0, 4000.0],
    [4200.0, 0.0, 4200.0],
    [4000.0, 0.0, 4200.0]
  ]
}

Example Airdrop Zone

"AirdropDefaults": {
  "type": 1,
  "priority": 10,
  "enableCustomMessages": 1,
  "customTitle": "Airdrop Zone",
  "customMessageEnter": "Entered Airdrop Zone",
  "customMessageExit": "Exited Airdrop Zone",
  "customIcon": "NinjinsPvPPvE/gui/airdrop.edds",
  "notificationColor": -65281,
  "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 255,
  "zoneGreen": 0,
  "zoneBlue": 255,
  "forceFirstPerson": 1,
  "radius": 100.0,
  "drawShape": 0
}

Example Mi8 Wreck Zone

"VanillaMi8Wreck": {
  "type": 1,
  "priority": 10,
  "enableCustomMessages": 1,
  "customTitle": "Mi8 Crash Zone",
  "customMessageEnter": "You entered the Mi8 crash zone!",
  "customMessageExit": "You exited the Mi8 crash zone!",
  "customIcon": "NinjinsPvPPvE/gui/helicopter.edds",
  "notificationColor": -65536,
  "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 255,
  "zoneGreen": 0,
  "zoneBlue": 0,
  "forceFirstPerson": 1,
  "radius": 100.0,
  "drawShape": 1
}

Example UH1Y Wreck Zone

"VanillaUH1YWreck": {
  "type": 1,
  "priority": 10,
  "enableCustomMessages": 1,
  "customTitle": "UH1Y Crash Zone",
  "customMessageEnter": "You entered the UH1Y crash zone!",
  "customMessageExit": "You exited the UH1Y crash zone!",
  "customIcon": "NinjinsPvPPvE/gui/helicopter.edds",
  "notificationColor": -16711936,
  "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 0,
  "zoneGreen": 255,
  "zoneBlue": 0,
  "forceFirstPerson": 1,
  "radius": 100.0,
  "drawShape": 1
}

Example AI Dynamic Mission Zone

"AIDynamicMission": {
  "type": 1,
  "priority": 10,
  "enableCustomMessages": 1,
  "customTitle": "AI Dynamic Mission Zone",
  "customMessageEnter": "You entered an AI PvP mission zone!",
  "customMessageExit": "You exited the AI PvP mission zone!",
  "customIcon": "NinjinsPvPPvE/gui/guns.edds",
  "notificationColor": -16737793,
  "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 255,
  "zoneGreen": 128,
  "zoneBlue": 0,
  "forceFirstPerson": 1,
  "radius": 150.0,
  "drawShape": 1
}

Example KOTH Event Zone

"KOTHZoneDefaults": {
  "type": 1,
  "priority": 10,
  "enableCustomMessages": 1,
  "customTitle": "King of the Hill",
  "customMessageEnter": "You've entered a King of the Hill!",
  "customMessageExit": "You've left the King of the Hill!",
  "customIcon": "NinjinsPvPPvE/gui/pvpman.edds",
  "notificationColor": -3407668,
  "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
  "startHour": 0,
  "endHour": 24,
  "zoneAlpha": 255,
  "zoneRed": 255,
  "zoneGreen": 50,
  "zoneBlue": 50,
  "forceFirstPerson": 0,
  "radius": 100.0,
  "drawShape": 1
}

Example Dynamic Contaminated Area (Vanilla Event)

    "ContaminatedZoneDefaults": {
        "type": 2,
        "priority": 10,
        "enableCustomMessages": 1,
        "customTitle": "Contaminated Zone",
        "customMessageEnter": "You have entered a contaminated zone!",
        "customMessageExit": "You have exited the contaminated zone!",
        "customIcon": "NinjinsPvPPvE/gui/toxic.edds",
        "notificationColor": -12517568,
        "days": "Monday Tuesday Wednesday Thursday Friday Saturday Sunday",
        "startHour": 0,
        "endHour": 24,
        "zoneAlpha": 255,
        "zoneRed": 255,
        "zoneGreen": 0,
        "zoneBlue": 0,
        "forceFirstPerson": 1,
        "radius": 120.0, 
        "drawShape": 1
    }

"radius": 120.0,

THIS CANNOT BE CHANGED IT TAKES VANILLA RADIUS OF CONTAMINATED AREA CREATION