Missions - AlPepino/Next-Days GitHub Wiki
This is a description of all mission variables:
active
takes values 0/1, disable/enable mission
isManaged
takes values 0/1, disable/enable. When is set 1 then mission is managed by another mission
isPositionRelativeToMasterMission
takes values 0/1, disable/enable. When is set 1 then mission is spawned relative to master mission
eventOnStartSpawn
string array where you declare slave missions which will be spawned when this mission starts
eventOnStartDespawn
string array where you declare slave missions which will be despawned when this mission starts
postponeEventOnStart
postpone events in seconds which is required in eventOnStartSpawn and eventOnStartDespawn
eventOnEnterSafeRadiusSpawn
string array where you declare slave missions which will be spawned when someone enters mission safeRadius perimeter
eventOnEnterSafeRadiusDespawn
string array where you declare slave missions which will be despawned when someone enters mission safeRadius perimeter
postponeEventOnEnterSafeRadius
postpone events in seconds which is required in eventOnEnterSafeRadiusSpawnand eventOnEnterSafeRadiusDespawn
eventOnEndSpawn
string array where you declare slave missions which will be spawned when this mission ends
eventOnEndDespawn
string array where you declare slave missions which will be despawned when this mission ends
postponeEventOnEnd
postpone events in seconds which is required in eventOnEndSpawn and eventOnEndDespawn
forceCheckDespawnCondition
takes values 0/1, disable/enable. When is set 1 then this mission can be despawned even if someone is still in safeRadius perimeter. Very useful in scenarios.
spawnInNightOnly
takes values 0/1, disable/enable. When is set 1 then mission can be spawned only at night (spawn conditions)
conditionPlayers
takes number from 0 to X. Where X means minimal players on server for spawning this mission (spawn conditions)
conditionMaxPlayers
takes number from 0 to X. Where X means maximum players on server for spawning this mission (spawn conditions). Also mission is despawned when count of players exceeds this threshold
missionRespawn
takes number from 0 to X. Where X means time in seconds for next try to spawn mission
chance
takes float value 0-1. 1 means 100% chance for spawning (spawn conditions)
timeRespawn
takes number from 0 to X. Where X means time in seconds for restoring loot in mission containers. 0 means no loot restoring
timeOffset
takes number from 0 to X. Where X means time in seconds for postpone first try to spawning mission
showInMap
takes values 0/1, disable/enable. When is set 1 then mission can be marked on map
showInMapWhenEnter
takes values 0/1, disable/enable. When is set 1 then mission can be marked on map only if someone enters mission cleanRadius perimeter
mapTitle
mission label on map
sendInfo
takes values 0/1, disable/enable notification about starting and ending mission
startMessage
message for players when mission starts
endMessage
message for players when mission ends
alertInfo
takes values 0/1, disable/enable. When is set 1 then players get message when enter/leave mission safeRadius perimeter
alertMessageIn
message for players when enter safeRadius perimeter
alertMessageOut
message for players when leave safeRadius perimeter
pagerInfo
takes values 0/1, disable/enable. When is set 1 then players get message when enter/leave mission cleanRadius perimeter
pagerMessageIn
message for players when enter cleanRadius perimeter
pagerMessageOut
message for players when leave cleanRadius perimeter
nominal
takes number from 0 to X. Where X means max count of spawned mission at once
lifeTime
takes number from 0 to X. Where X means mission lifeTime in seconds. 0 means permanent mission
restock
takes number from 0 to X. Where X means max count of this events during gameplay. 0 means no mission spawn
safeRadius
takes number from 0 to X. Where X means mission radius in meters. This is a trigger for spawning dynamic AI
cleanRadius
takes number from 0 to X. Where X means mission radius in meters. It must be equal or higher to safeRadius. This is a trigger for managing player who enters/leaves mission. When is someone in this radius then countdown of mission lifeTime is stopped
distanceRadius
takes number from 0 to X. Where X means safe distance beetween missions. This mision cannot be spawned while is any active mission within this radius
position
takes float array [x,h,y,yaw],[x,h,y,yaw](/AlPepino/Next-Days/wiki/x,h,y,yaw],[x,h,y,yaw)
. When mission is creating then is selected random element of this mission to place it
positionOffset
takes number from 0 to X. Where X means spawning offset from selected position in meters
radiationDynamic
takes integer number. Value > 0 means creating radiation zone when someone enter the mission saferadius zone. Value means postpone spawn radiation zone in seconds
radiationSpawnedByContaminedArea
takes integer number 0/1 (disable/enable). 1 means spawning radiation zone when the contamined area is created
radiusOfRadiation
takes number array where first element means min and second max range of generated radiation area radius in meters (random value is chosen)
strengthOfRadiation
takes float array where first element means min and second max range of generated radiation strength in Sv (random value is chosen)
heightOfRadiationArea
takes integer value. When is value > 0 then this value defines half the height of the zone cylinder. Useful for undergroungd
enableSineFunction
takes values 0/1, disable/enable alternative way for calculating radiation
strengthOfRadiationOffset
takes float values. This is a important variable when is enabled enableSineFunction
enableDeactivation
takes values 0/1, disable/enable option to disable radiation when someone close radioactive barrel in radiation mission
visualEffect
takes number from 0 to X. Where X means index of particle effect for spawned radioactive barrels
loot
takes object array where object has these variables
- className - class name of container like "SeaChest"
- spawnQuestItem- takes values 0/1, disable/enable spawning "WantedItem" declared in NPC quest"
- makePersist - takes values 0/1, disable/enable. When is set to 1 then item stays when mission is despawned
- position - relative item position (vector) for this mission
- yaw - takes float value
- pitch - takes float value
- roll - takes float value
- positionOffset - takes number from 0 to X. Where X means spawning offset from position in meters
- chance - takes float value 0-1. 1 means 100% chance for spawning
- stashed - takes values 0/1, disable/enable. When is set to 1 and item can be stashed then is stashed
- locked - takes values 0/1, disable/enable. When is set to 1 then item is locked
- cargo - takes object array where is defined loot for this container
vehicles
takes object array where object has these variables:
- title - label of vehicle set from Vehicles.json
- chance - takes float value 0-1. 1 means 100% chance for spawning
- position - relative vehicle position (vector) for this mission
- yaw - takes float value
- pitch - takes float value
- roll - takes float value
- makePersist - takes values 0/1, disable/enable. When is set to 1 then vehicle stays when mission is despawned even if none taken it
structures
takes object array where object has these variables:
- className - class name of object
- makeFire - takes values 0/1, disable/enable. When is set to 1 and there is a fireplace in spawned building then is set permanent fire
- makePersist - takes values 0/1, disable/enable. When is set to 1 then object stays when mission is despawned
- position - relative item position (vector) for this mission
- yaw - takes float value
- pitch - takes float value
- roll - takes float value
- noPlaceOnSurface - takes values 0/1, disable/enable. When is set to 1 then object is spawned on exact position
spawnPlaceForVehicles
takes object array where object has these variables (works for trader when buying):
- position - relative item position (vector) for this mission
- yaw - takes float value
- pitch - takes float value
- roll - takes float value
NPC
takes object array where object has these variables:
- className - class name of trader
- chance - takes float value 0-1. 1 means 100% chance for spawning
- position - relative NPC position (vector) against this mission
- yaw - takes float value
- pitch - takes float value
- roll - takes float value
- IsDead - takes values 0/1 (false/true)
- AvailableGoodsByTag- takes string array, where string represents label of whole categories group
- CurrencyID - takes integer value of currency ID, this varialbe is used just at first trader init
- EnabledInteractions - takes integer value for init NPC interactions while creating its Stock_X.json
- CentralStockID - takes integer value of central stock ID. This ID represents name of file created in folder Next-Days/Trader
- StockID - takes integer value of stock ID. This ID represents name of file created in folder Next-Days/Trader
- stance - takes integer value for setting NPC stance
- attachments - takes string array which contains class names of NPC attachments
- cargo - takes object array where is defined loot for this NPC
NPCdynamic
identical like in case "NPC". This variable is used to spawn NPC just in entering mission saferadius
godmodTrader
takes values 0/1, disable/enable (works for trader mission only). When is set 1 then trader is immortal
godmodPlayers
takes values 0/1, disable/enable (works for trader mission only). When is set 1 then player is immortal when enters trader zone
contaminedAreas
object is structured almost identical like vanilla one. These option are extra added:
- positionOffset - takes integer number which represents random spawning offset from the mission position in meters
- timeOffset - takes integer number which represents time spawning offset in seconds
- chance - takes float value 0-1. 1 means 100% chance for spawning
contaminedAreasDynamic
identical like in case "contaminedAreas". This variable is used to spawn contamined area just in entering mission saferadius.