-
Notifications
You must be signed in to change notification settings - Fork 58
[Server Hosting] Quest Objectives Configuration
You can name an objective configuration file to whatever you want as long as it has the .json file extension and is placed in the related objective configurations folder.
Integer.
Current config file version. NEVER CHANGE THIS!
Integer.
Unique objective ID. Make sure this ID is different for every single objective in this objective category! You can use the same ID for a different objective configuration in a different objective category but never use the same ID in the same category twice!
Integer.
Objective Type of this objective configuration. As every objective type uses and handles different parameters and values we need to tell the system what kind of objective this is. Always needs to be the category where the config file is located.
TARGET = 2
TRAVEL = 3
COLLECT = 4
DELIVERY = 5
TREASUREHUNT = 6
AIPATROL = 7
AICAMP = 8
AIVIP = 9
ACTION = 10
CRAFTING = 11
There are different objective types that all do something different when added to a quest and every objective has a different configuration depending on the objective type:
TARGET = Quest player/s will need to kill certain amount of mobs/players. (Optional: With a special weapon).
TRAVEL = Quest player/s will need to go to location XY.
COLLECT = Quest player/s will need to collect/find a certain amount of items.
DELIVERY = The Quest player/s will need to deliver given items to a certain position and NPC.
TREASUREHUNT = Quest player/s will need to find a location containing a stashed treasure.
AIPATROL = Quest player/s will need to clear an AI patrol. (Optional: With a special weapon).
AICAMP = Quest player/s will need to clear an AI Camp. (Optional: With a special weapon).
AIVIP = Quest player/s will need to protect and escort a AI to a certain location.
ACTION = Quest player/s will need to execute a certain Action.
CRAFTING = Quest player/s will need to craft certain items.
String.
Objective text that will get displayed in the quest-log and quest hud when the objective is active and displayed.
Integer.
Time limit in seconds the quest player/s has/have to complete this objective. This should be set and added in the quest configuration file that will contain this objective in its objectives array as it allows you to reuse this objective in other quests with different time limit values or without one.
Example:
{
"ConfigVersion": 21,
"ID": 10,
"ObjectiveType": 10,
"ObjectiveText": "Activate the flax flow control panel in A-3:",
"TimeLimit": -1,
"ActionNames": [
"ActionFlaxControlPanel"
],
"AllowedClassNames": [],
"ExcludedClassNames": [],
"ExecutionAmount": 1
}Array[String].
Class names of the action classes that will trigger this objective.
Array[String].
Class names of items/entities that are allowed for this action objective. Example: If we would add the name "PotatoSeed" in here and the player would need to execute the "Plant seed" action then the objective would only be completed when the player used a "PotatoSeed" for the plant action.
Array[String].
Class names of items/entities that are not allowed for this action objective. Example: If we add the name "PotatoSeed" in here and the player would need to execute the "Plant seed" action then the objective would only be completed when the player used any seed but not when he used "PotatoSeed" for the plant action.
Integer.
Controls how many times the action needs to be executed to complete this objective.
Example:
{
"ConfigVersion": 21,
"ID": 1,
"ObjectiveType": 8,
"ObjectiveText": "Kill all 5 Soldiers at the marked location:",
"TimeLimit": -1,
"AICamp": {
"Positions": [
[
7328.93017578125,
48.1505012512207,
10510.7001953125
],
[
7283.7001953125,
48.2599983215332,
10534.400390625
],
[
7309.75,
45.495601654052737,
10525.900390625
],
[
7309.72021484375,
45.51839828491211,
10507.2001953125
],
[
7282.93994140625,
45.47999954223633,
10552.2998046875
]
],
"NPCSpeed": "RUN",
"NPCMode": "HALT",
"NPCFaction": "NAC",
"NPCLoadoutFile": "Namalsk_NAC.json",
"NPCAccuracyMin": 0.5,
"NPCAccuracyMax": 0.699999988079071,
"ClassNames": [
"eAI_SurvivorM_Mirek",
"eAI_SurvivorM_Denis",
"eAI_SurvivorM_Boris",
"eAI_SurvivorM_Cyril",
"eAI_SurvivorM_Elias",
"eAI_SurvivorM_Francis",
"eAI_SurvivorM_Guo",
"eAI_SurvivorM_Hassan",
"eAI_SurvivorM_Indar",
"eAI_SurvivorM_Jose",
"eAI_SurvivorM_Kaito",
"eAI_SurvivorM_Lewis",
"eAI_SurvivorM_Manua",
"eAI_SurvivorM_Niki",
"eAI_SurvivorM_Oliver",
"eAI_SurvivorM_Peter",
"eAI_SurvivorM_Quinn",
"eAI_SurvivorM_Rolf",
"eAI_SurvivorM_Seth",
"eAI_SurvivorM_Taiki",
"eAI_SurvivorF_Linda",
"eAI_SurvivorF_Maria",
"eAI_SurvivorF_Frida",
"eAI_SurvivorF_Gabi",
"eAI_SurvivorF_Helga",
"eAI_SurvivorF_Irena",
"eAI_SurvivorF_Judy",
"eAI_SurvivorF_Keiko",
"eAI_SurvivorF_Eva",
"eAI_SurvivorF_Naomi",
"eAI_SurvivorF_Baty"
],
"SpecialWeapon": 0,
"AllowedWeapons": []
},
"MinDistRadius": 50.0,
"MaxDistRadius": 150.0,
"DespawnRadius": 880.0,
"CanLootAI": 0,
"InfectedDeletionRadius": 500
}Array[Vector].
Positions where an AI unit will spawn. The amount of vector positions in this array also controlls the amout of units the player/s has/have to kill to complete this objective.
String.
NPC speed definition. Same as for AI patrol settings.
String.
NPC mode definition. Same as for AI patrol settings.
String.
NPC faction definition. Same as for AI patrol settings.
String.
NPC loadout file. Same as for AI patrol settings.
Array[String].
Class names that will be used to control kills. If a unit gets killed that is not in this array the kill will not count for this objective.
Boolean.
If enabled the kills will only get counted when the killed unit has been killed with a weapon defined in the "AllowedWeapons" array.
Array[String].
If "SpecialWeapon" is enabled then this array controls the allowed weapons the quest players can and need to use to kill certain objective targets.
Float.
Min. distance the player can be from the objective position so eliminations count.
Float.
Max. distance the player can be from the objective position so eliminations count.
Float.
If all quest players leave the objective area and are away in the given range the AI despawn will trigger.
Boolean.
Controls if spawned AI can be looted or not.
Integer.
Controls the radius from the objective position that will mark the area within infected will get deleted. Set to 0 so infected don't get deleted when in that area.
Example:
{
"ConfigVersion": 18,
"ID": 1,
"ObjectiveType": 7,
"ObjectiveText": "Kill all 5 units of the NAC patrol at the marked location:",
"TimeLimit": -1,
"AIPatrol": {
"NPCUnits": 5,
"Waypoints": [
[
7674.0498046875,
3.5786099433898927,
10115.7001953125
],
[
7633.830078125,
2.9364099502563478,
10080.900390625
],
[
7545.85009765625,
8.462610244750977,
10091.400390625
],
[
7648.47998046875,
10.765999794006348,
10136.900390625
]
],
"NPCSpeed": "WALK",
"NPCMode": "REVERSE",
"NPCFaction": "NAC",
"NPCFormation": "RANDOM",
"NPCLoadoutFile": "Namalsk_NAC.json",
"NPCAccuracyMin": 0.0,
"NPCAccuracyMax": 0.0,
"ClassNames": [
"eAI_SurvivorM_Mirek",
"eAI_SurvivorM_Denis",
"eAI_SurvivorM_Boris",
"eAI_SurvivorM_Cyril",
"eAI_SurvivorM_Elias",
"eAI_SurvivorM_Francis",
"eAI_SurvivorM_Guo",
"eAI_SurvivorM_Hassan",
"eAI_SurvivorM_Indar",
"eAI_SurvivorM_Jose",
"eAI_SurvivorM_Kaito",
"eAI_SurvivorM_Lewis",
"eAI_SurvivorM_Manua",
"eAI_SurvivorM_Niki",
"eAI_SurvivorM_Oliver",
"eAI_SurvivorM_Peter",
"eAI_SurvivorM_Quinn",
"eAI_SurvivorM_Rolf",
"eAI_SurvivorM_Seth",
"eAI_SurvivorM_Taiki",
"eAI_SurvivorF_Linda",
"eAI_SurvivorF_Maria",
"eAI_SurvivorF_Frida",
"eAI_SurvivorF_Gabi",
"eAI_SurvivorF_Helga",
"eAI_SurvivorF_Irena",
"eAI_SurvivorF_Judy",
"eAI_SurvivorF_Keiko",
"eAI_SurvivorF_Eva",
"eAI_SurvivorF_Naomi",
"eAI_SurvivorF_Baty"
],
"SpecialWeapon": 0,
"AllowedWeapons": []
},
"MinDistRadius": 50.0,
"MaxDistRadius": 150.0,
"DespawnRadius": 880.0,
"CanLootAI": 0
}Integer.
Amount of patrol AI units to spawn.
Array[Vector].
Waypoint positions for the patrol route.
String.
NPC speed definition. Same as for AI patrol settings.
String.
NPC mode definition. Same as for AI patrol settings.
String.
NPC faction definition. Same as for AI patrol settings.
String.
NPC loadout file. Same as for AI patrol settings.
Array[String].
Class names that will be used to control kills. If a unit gets killed that is not in this array the kill will not count for this objective.
Boolean.
If enabled the kills will only get counted when the killed unit has been killed with a weapon defined in the "AllowedWeapons" array.
Array[String].
If "SpecialWeapon" is enabled then this array controls the allowed weapons the quest players can and need to use to kill certain objective targets.
Float.
Min. distance the player can be from the objective position so eliminations count.
Float.
Max. distance the player can be from the objective position so eliminations count.
Float.
If all quest players leave the objective area and are away in the given range the AI despawn will trigger.
Boolean.
Controls if spawned AI can be looted or not.
Example:
{
"ConfigVersion": 21,
"ID": 1,
"ObjectiveType": 9,
"ObjectiveText": "Bring the VIP to the marked location.",
"TimeLimit": 180,
"Position": [
8961.6396484375,
4.474669933319092,
10601.099609375
],
"MaxDistance": 10.0,
"AIVIP": {
"NPCLoadoutFile": "SurvivorLoadout.json",
"NPCClassName": "eAI_SurvivorF_Frida"
},
"MarkerName": "Escort VIP",
"ShowDistance": 1,
"CanLootAI": 0
}Vector.
Objective position to where the VIP AI needs to be escorted.
Float.
If the escorted AI is within the given range from the objective position the objective will be triggered as completed.
String.
NPC loadout file. Same as for AI patrol settings.
String.
NPC class name of the eAI entity that should be used to spawn in the VIP NPC. Leave the field empty to get a random AI unit.
String.
Text for the objective quest marker. Leave empty to create no marker.
Boolean.
Controls whether the distance to the objective position will be displayed in the quest HUD.
Boolean.
Controls if spawned AI can be looted or not.
Example:
{
"ConfigVersion": 21,
"ID": 1,
"ObjectiveType": 4,
"ObjectiveText": "Catch and deliver 3 mackerel's.",
"TimeLimit": -1,
"Collections": [
{
"Amount": 3,
"ClassName": "Mackerel",
"QuantityPercent": -1
}
],
"MaxDistance": 10.0,
"MarkerName": "Deliver Items",
"ShowDistance": 1,
"AddItemsToNearbyMarketZone": 0,
"NeedAnyCollection": 0
}Array[ExpansionQuestObjectiveDelivery].
Items the quest players need to/can collect for this objective. There is always a class name and amount needed to define an entry correctly.
Float.
Distance for the range check to the quest turn-in NPC position before the objective range check triggers. The quest players need to collect the items and reach this distance to the quest turn-in NPC position before the objective is triggered as completed.
String.
Text for the objective quest marker. Leave empty to create no marker.
Boolean.
Controls whether the distance to the objective position will be displayed in the quest HUD.
Boolean.
Only used when the market mod is loaded and the quest turn-in NPC is within a market zone. Controls if the objective items get added to the nearby market zone after the quest with this objective has been completed. The stock and items given in the "Collections" array will then be added to the related market zone on the next server restart.
Boolean.
Controls if the quest players need to collect all the items defined in the "Collections" array or only one. If this parameter is enabled and players still have more than one objective item then they will need to select the item they want to use to complete this quest when turning the quest in.
Example:
{
"ConfigVersion": 21,
"ID": 1,
"ObjectiveType": 11,
"ObjectiveText": "Craft a stone knife:",
"TimeLimit": -1,
"ItemNames": [
"StoneKnife"
],
"ExecutionAmount": 1
}Array[String].
Class names of the items the player is able to craft to complete this objective.
Integer.
How many times does the crafting action need to be executed to complete the objective?
Example:
{
"ConfigVersion": 21,
"ID": 1,
"ObjectiveType": 5,
"ObjectiveText": "Deliver the note to the hunter \"Eddie\":",
"TimeLimit": -1,
"Collections": [
{
"Amount": 1,
"ClassName": "ExpansionQuestItemPaper",
"QuantityPercent": -1
}
],
"MaxDistance": 5.0,
"MarkerName": "Talk to Eddie",
"ShowDistance": 1,
"AddItemsToNearbyMarketZone": 0
}Array[ExpansionQuestObjectiveDelivery].
Items the quest players need to deliver for this objective and will be spawned on the main quest player when the quest with this objective is accepted/started. There is always a class name and amount needed to define an entry correctly. "QuantityPercent" is needed when the player delivers items such as ammo or pills that can be stacked, "QuantityPercent" controls the stack size amount that gets spawned on the quest player when starting the quest. 10 should be used here as a value when the item has a quantity to match with the needed amount.
Float.
Distance for the range check to the quest turn-in NPC position before the objective range check triggers. The quest players need to collect the items and reach this distance to the quest turn-in NPC position before the objective is triggered as completed.
String.
Text for the objective quest marker. Leave empty to create no marker.
Boolean.
Controls whether the distance to the objective position will be displayed in the quest HUD.
Boolean.
Only used when the market mod is loaded and the quest turn-in NPC is within a market zone. Controls if the objective items get added to the nearby market zone after the quest with this objective has been completed. The stock and items given in the "Collections" array will then be added to the related market zone on the next server restart.
Example:
{
"ConfigVersion": 18,
"ID": 1,
"ObjectiveType": 2,
"ObjectiveText": "Eliminate 10 infected.",
"TimeLimit": -1,
"Position": [
0.0,
0.0,
0.0
],
"MaxDistance": 0.0,
"Target": {
"Amount": 10,
"ClassNames": [
"ZmbM_CitizenASkinny_Base",
"ZmbM_CitizenASkinny_LT_Base",
"ZmbM_CitizenBFat_Base",
"ZmbM_ClerkFat_Base",
"ZmbM_ClerkFat_LT_Base",
"ZmbM_CommercialPilotOld_Base",
"ZmbM_CommercialPilotOld_LT_Base",
"ZmbM_ConstrWorkerNormal_Base",
"ZmbM_DoctorFat_Base",
"ZmbM_FarmerFat_Base",
"ZmbM_FarmerFat_LT_Base",
"ZmbM_FirefighterNormal_Base",
"ZmbM_FishermanOld_Base",
"ZmbM_HandymanNormal_Base",
"ZmbM_HeavyIndustryWorker_Base",
"ZmbM_HermitSkinny_Base",
"ZmbM_HikerSkinny_Base",
"ZmbM_HunterOld_Base",
"ZmbM_Jacket_Base",
"ZmbM_Jacket_LT_Base",
"ZmbM_JoggerSkinny_Base",
"ZmbM_Runner_Base",
"ZmbM_JournalistSkinny_Base",
"ZmbM_MechanicSkinny_Base",
"ZmbM_MotobikerFat_Base",
"ZmbM_OffshoreWorker_Base",
"ZmbM_ParamedicNormal_Base",
"ZmbM_PatientSkinny_Base",
"ZmbM_PolicemanFat_Base",
"ZmbM_PolicemanSpecForce_Base",
"ZmbM_priestPopSkinny_Base",
"ZmbM_PrisonerSkinny_Base",
"ZmbM_SkaterYoung_Base",
"ZmbM_SkaterYoung_LT_Base",
"ZmbM_SurvivorDean_Base",
"ZmbM_VillagerOld_Base",
"ZmbM_VillagerOld_LT_Base",
"ZmbF_BlueCollarFat_Base",
"ZmbF_CitizenANormal_Base",
"ZmbF_CitizenANormal_LT_Base",
"ZmbF_CitizenBSkinny_Base",
"ZmbF_Clerk_Normal_Base",
"ZmbF_ClerkFat_Base",
"ZmbF_Clerk_Normal_LT_Base",
"ZmbF_DoctorSkinny_Base",
"ZmbF_HikerSkinny_Base",
"ZmbF_JoggerSkinny_Base",
"ZmbF_Runner_Base",
"ZmbF_JournalistNormal_Base",
"ZmbF_JournalistNormal_LT_Base",
"ZmbF_MechanicNormal_Base",
"ZmbF_MilkMaidOld_Base",
"ZmbF_MilkMaidOld_LT_Base",
"ZmbF_NurseFat_Base",
"ZmbF_ParamedicNormal_Base",
"ZmbF_PatientOld_Base",
"ZmbF_PoliceWomanNormal_Base",
"ZmbF_ShortSkirt_Base",
"ZmbF_ShortSkirt_LT_Base",
"ZmbF_SkaterYoung_Base",
"ZmbF_SkaterYoung_LT_Base",
"ZmbF_SurvivorNormal_Base",
"ZmbF_SurvivorNormal_LT_Base",
"ZmbF_VillagerOld_Base",
"ZmbF_VillagerOld_LT_Base",
"ZmbM_PatrolNormal_Base",
"ZmbM_Soldier_Base",
"ZmbM_SoldierNormal_Base",
"ZmbM_usSoldier_normal_Base",
"ZmbM_NBC_Yellow",
"ZmbM_NBC_Grey"
],
"CountSelfKill": 0,
"SpecialWeapon": 0,
"AllowedWeapons": [],
"ExcludedClassNames": [],
"CountAIPlayers": 0
}
}Vector.
Objective positions where the given entities need to be eliminated. Leave empty or set to vector 0 to disable this condition.
Float.
If an objective position is defined then the quest players need to be within a given range when they eliminate a target.
Integer.
Amount of eliminations that need to be executed on given entities to complete this objective.
Array[String].
Class names that will be used to control kills. If a unit gets killed that is not in this array the kill will not count for this objective.
Boolean.
If the target entity is a type of player this parameter controls if player suicides or eliminations on the quest players will count towards the quest objective.
Boolean.
If enabled the kills will only get counted when the killed unit has been killed with a weapon defined in the "AllowedWeapons" array.
Array[String].
If "SpecialWeapon" is enabled then this array controls the allowed weapons the quest players can and need to use to kill certain objective targets.
Array[String].
Class names of entities that will not count towards the objective when eliminated.
Boolean.
If the target entitiy is a type of expansion AI unit this paramter controls if AI eliminations will count towards the quest objective.
Example:
{
"ConfigVersion": 18,
"ID": 2,
"ObjectiveType": 3,
"ObjectiveText": "Travel to the outpost in Jalovisko:",
"TimeLimit": -1,
"Position": [
8573.5400390625,
14.803199768066407,
10492.900390625
],
"MaxDistance": 5.0,
"MarkerName": "Jalovisko Outpost",
"ShowDistance": 1,
"TriggerOnEnter": 1,
"TriggerOnExit": 1
}Vector.
Objective positions where the quest players need to travel to.
Float.
If a quest player is within the given range to the objective position the objective will get triggered as completed.
String.
Text for the objective quest marker. Leave empty to create no marker.
Boolean.
Controls whether the distance to the objective position will be displayed in the quest HUD.
Bolean.
Controls if the distance check will trigger when entering the defined objective area. Should always be enabled as this objective type will not be complete otherwise!
Boolean.
Controls if the distance check will trigger and set the objective to incomplete when leaving the defined objective area.
Example:
{
"ConfigVersion": 18,
"ID": 1,
"ObjectiveType": 6,
"ObjectiveText": "Find the hidden stash at the marked location:",
"TimeLimit": -1,
"ShowDistance": 1,
"ContainerName": "ExpansionQuestSeaChest",
"DigInStash": 1,
"MarkerName": "???",
"MarkerVisibility": 4,
"Positions": [
[
8141.41015625,
16.381799697875978,
10659.7998046875
]
],
"Loot": [
{
"Name": "ExpansionBanknoteHryvnia",
"Attachments": [],
"Chance": 0.30000001192092898,
"QuantityPercent": -1,
"Max": -1,
"Variants": []
},
{
"Name": "Expansion_CigarettePack_Chernamorka",
"Attachments": [],
"Chance": 0.30000001192092898,
"QuantityPercent": -1,
"Max": -1,
"Variants": []
}
],
"LootItemsAmount": 2,
"MaxDistance": 10.0
}Boolean.
Controls whether the distance to the objective position will be displayed in the quest HUD.
String.
Container entity class name that will be used for this objective. The entity class always needs to inherit from "ExpansionQuestContainerBase".
Boolean.
Controls if the container will be dug into an underground stash or not.
String.
Text for the objective quest marker. Leave empty to create no marker.
Integer.
Defines the visibility of the objective quest marker. (4 - visible on map | 2 - visible in world | 6 - visible on map and in world.)
Boolean.
Controls whether the distance to the objective position will be displayed in the quest HUD.
Array[Vector].
A random position from this array will be selected when the quest with this objective is started and set as the stash and objective position.
Array[ExpansionLoot].
Loot reward items that will get spawned/attached into/on the stash.
Integer.
Max amount of loot items that will get selected and spawned into the stash from the defined expansion loot configuration.
Float.
If a quest player is within a given range of the objective position the stash will be created and spawned.
Copyright© 2020-2026 DayZ Expansion Mod Team. We do not authorize any entity to publish this DayZ Standalone modification without licensing from the DayZ Expansion Mod Team.