dayz-dev

name	dayz-dev
description	DayZ Enforce Script development orchestrator. Dynamically fetches class APIs, script references, and mod documentation. Supports vanilla, Community Framework, and Expansion development for DayZ 1.28+.
allowed-tools	Read, Write, Edit, Glob, Grep, Bash, WebFetch, WebSearch

DayZ Development

Dynamic documentation orchestrator for DayZ mod development. Supports vanilla Enforce Script, Community Framework (CF), and DayZ Expansion. Target version: DayZ 1.28+ (v1.28.161464)

Philosophy

1. Fetch, don't memorize - Always get latest from authoritative sources
2. Framework-aware thinking - Detect vanilla vs CF vs Expansion, adapt patterns
3. Enforce Script correctness - DayZ uses Enforce Script (C-like), NOT C#/C++/Lua
4. Server-side validation - Never trust client-side data
5. Null-safe always - Every Cast<>, GetInventory(), GetIdentity() must be null-checked

---

CRITICAL: No Hallucination Policy

NEVER invent or guess Enforce Script classes, methods, config tokens, or parameters.

Rules:

1. If unsure about a class/method -> MUST fetch from DayZ Scripts API or Script Diff repo
2. If unsure about config.cpp tokens -> MUST fetch from BI wiki or DayZ Central Economy repo
3. If a class doesn't exist -> Tell user honestly, suggest alternatives
4. If parameters unknown -> Fetch documentation, don't guess
5. NEVER use C#/C++ syntax -> Enforce Script looks like C but has key differences

Before writing any class or method call:

• Is this a real DayZ class? -> Verify at dayz-scripts.yadz.app or DayZ-Script-Diff
• Is this the correct method signature? -> Check parameter types and order
• Does this work on server/client/both? -> Check script module (3_Game/4_World/5_Mission)
• Am I null-checking accessors? -> Cast<>, GetInventory(), GetIdentity(), GetPlayer()

When you don't know:

"I'm not 100% certain about this class/method. Let me fetch the documentation..."
[Use WebFetch to get accurate info]

Verification Sources:

Type	Source	Action
Script API (v1.28)	https://dayz-scripts.yadz.app/	WebFetch for class/method docs
Script Diff (official)	https://github.com/BohemiaInteractive/DayZ-Script-Diff	Check exact source code
Enforce Syntax	https://community.bistudio.com/wiki/DayZ:Enforce_Script_Syntax	Language reference
Config tokens	https://community.bistudio.com/wiki/CfgVehicles_Config_Reference	Config.cpp reference
Central Economy	https://github.com/BohemiaInteractive/DayZ-Central-Economy	types.xml, events.xml
CF docs	https://github.com/Arkensor/DayZ-CommunityFramework	CF source + docs
Expansion wiki	https://github.com/salutesh/DayZ-Expansion-Scripts/wiki	Expansion reference
Server config	https://dzconfig.com/wiki/	Server XML/JSON configs
DeepWiki Expansion	https://deepwiki.com/salutesh/DayZ-Expansion-Scripts	AI-analyzed Expansion architecture
DayZ Explorer	https://dayzexplorer.zeroy.com/	Enforce essentials, Math, FileIO, Widget API

Example - WRONG:

// DON'T: Using C# syntax or inventing methods
player.GetComponent<Inventory>().AddItem("AK74");  // NOT Enforce Script!

Example - RIGHT:

// DO: Use verified Enforce Script with null checks
PlayerBase player = PlayerBase.Cast(GetGame().GetPlayer());
if (player)
{
    EntityAI item = player.GetInventory().CreateInInventory("AKM");
    if (item)
    {
        // item created successfully
    }
}

---

Content Map

Read ONLY relevant files based on the request:

File	Description	When to Read
scripting/enforce-script.md	Enforce Script language quick reference	Writing any code
scripting/class-hierarchy.md	Class tree and key singletons	Looking up classes
scripting/client-server.md	Script module architecture	New mod, client/server questions
scripting/memory-management.md	ref, autoptr, Managed patterns	Memory/lifecycle issues
systems/mod-structure.md	Mod folders, config.cpp, meta.cpp	Creating new mods
systems/networking.md	RPC, NetSync, CF NetworkedVariables	Multiplayer sync
systems/inventory.md	Inventory system, InventoryLocation	Item manipulation
systems/actions.md	Action system hierarchy	Custom actions
systems/weapons.md	Weapon FSM, configs	Weapon mods
systems/vehicles.md	Vehicle config, SimulationModule	Vehicle mods
frameworks/framework-detection.md	Detect vanilla vs CF vs Expansion	Starting new task
frameworks/community-framework.md	CF modules, RPC, NetworkedVariables	Using CF
frameworks/expansion.md	Expansion systems overview	Using Expansion
config/config-cpp.md	config.cpp reference and patterns	Item/vehicle config
config/types-xml.md	types.xml, economy system	Loot spawning
config/server-config.md	Server configuration files	Server setup
compatibility/version-128.md	1.28 breaking changes and new features	Version questions, migration

---

Dynamic Fetching - Decision Tree

Step 1: Classify the Request

If user asks about...	Action
Enforce Script class/method (EntityAI, PlayerBase, etc.)	FETCH from DayZ Scripts API
Config.cpp tokens (CfgVehicles, CfgWeapons)	FETCH from BI Wiki
Central Economy (types.xml, events.xml)	FETCH from DayZ-Central-Economy repo
CF feature (RPCManager, Modules, NetworkedVariables)	FETCH from CF GitHub
Expansion system (Market, Quests, AI, Basebuilding)	FETCH from Expansion wiki
Script diff between versions	FETCH from DayZ-Script-Diff repo
Server configuration	FETCH from DZconfig wiki
Mod structure, best practices	READ local files
1.28 compatibility/changes	READ local compatibility file

Step 2: WebFetch URLs

Script API Reference (v1.28)

Base URL: https://dayz-scripts.yadz.app/

WebFetch(
  url: "https://dayz-scripts.yadz.app/",
  prompt: "Find documentation for the class or method '{CLASS_OR_METHOD}'.
           Include: inheritance, methods, parameters, return types."
)

Key API Pages:

Category	URL
Enforce Essentials	https://dayz-scripts.yadz.app/d5/d78/group___enforce
Math Library	https://dayz-scripts.yadz.app/d5/d98/group___math
String Methods	https://dayz-scripts.yadz.app/d5/da2/group___strings
Widget UI System	https://dayz-scripts.yadz.app/d9/d0e/group___widget_a_p_i
Math Class	https://dayz-scripts.yadz.app/d4/d34/class_math

Alternate API Reference (older but comprehensive)

Base URL: https://dayzexplorer.zeroy.com/

Page	URL
Enforce Core	https://dayzexplorer.zeroy.com/group___enforce.html
Math Functions	https://dayzexplorer.zeroy.com/group___math.html
FileIO API	https://dayzexplorer.zeroy.com/group___file.html
Particle Effects	https://dayzexplorer.zeroy.com/group___particle_effect.html
Widget API	https://dayzexplorer.zeroy.com/group___widget_a_p_i.html
DiagMenu	https://dayzexplorer.zeroy.com/group___diag_menu.html
Weather Class	https://dayzexplorer.zeroy.com/class_weather.html
Vector Class	https://dayzexplorer.zeroy.com/classvector.html

Official Script Source (for exact implementations)

WebFetch(
  url: "https://github.com/BohemiaInteractive/DayZ-Script-Diff/tree/main/scripts",
  prompt: "Find the source code for '{CLASS_NAME}' in the DayZ script tree.
           Show the class definition, methods, and inheritance."
)

Config References

WebFetch(
  url: "https://community.bistudio.com/wiki/CfgVehicles_Config_Reference",
  prompt: "Find the config token '{TOKEN_NAME}' and its usage.
           Include: type, default value, parent class, example."
)

Central Economy

WebFetch(
  url: "https://github.com/BohemiaInteractive/DayZ-Central-Economy",
  prompt: "Find the economy configuration for '{ITEM_OR_SETTING}'.
           Include: types.xml entry, spawn parameters, nominal/min values."
)

Community Framework

WebFetch(
  url: "https://github.com/Arkensor/DayZ-CommunityFramework/tree/production/docs",
  prompt: "Find documentation for CF '{FEATURE}'.
           Include: API, usage examples, required setup."
)

Expansion Scripts

WebFetch(
  url: "https://github.com/salutesh/DayZ-Expansion-Scripts/wiki",
  prompt: "Find documentation for Expansion '{SYSTEM}'.
           Include: settings, configuration, scripting API."
)

Server Configuration

WebFetch(
  url: "https://dzconfig.com/wiki/",
  prompt: "Find documentation for '{CONFIG_FILE}'.
           Include: all parameters, types, default values, examples."
)

---

Request Router - Pattern Matching

RULE 1: Enforce Script Class/Method Detection

Triggers when:

• Class names (PascalCase like EntityAI, PlayerBase, ItemBase, CarScript)
• Method calls (GetInventory(), CreateInInventory(), SetHealth())
• "enforce script", "dayz class", "dayz method", "script API"

Action: Fetch from https://dayz-scripts.yadz.app/ or DayZ-Script-Diff

RULE 2: Config.cpp / CfgVehicles Detection

Triggers when:

• CfgVehicles, CfgWeapons, CfgMagazines, CfgAmmo
• CfgPatches, CfgMods, DamageSystem
• "config.cpp", "model config", "item config", "vehicle config"
• scope, displayName, model, hiddenSelections

Action: Read local config/config-cpp.md + Fetch from BI wiki if needed

RULE 3: Central Economy Detection

Triggers when:

• types.xml, events.xml, cfgspawnabletypes.xml, cfgeconomycore.xml
• "loot spawn", "item spawn", "economy", "nominal", "min", "restock"
• randompresets.xml, cfgenvironment.xml

Action: Read local config/types-xml.md + Fetch from DayZ-Central-Economy repo

RULE 4: CF / Expansion Framework Detection

Triggers when:

• RPCManager, CF_ModuleWorld, NetworkedVariables, ModStorage
• ExpansionMarket, ExpansionQuest, ExpansionAI, ExpansionTerritory
• "community framework", "CF module", "expansion", "market system"

Action: Detect framework -> Fetch from appropriate docs

RULE 5: Networking / RPC Detection

Triggers when:

• ScriptRPC, GetRPCManager(), SendRPC, AddRPC
• RegisterNetSyncVariable, SetSynchDirty, OnVariablesSynchronized
• "sync variable", "RPC", "network", "client-server communication"

Action: Read local systems/networking.md + Fetch if needed

RULE 6: Server Configuration Detection

Triggers when:

• serverDZ.cfg, cfgGameplay.json, storage_1
• "server config", "gameplay settings", "admin", "BattlEye"

Action: Read local config/server-config.md + Fetch from DZconfig wiki

RULE 7: 1.28 Compatibility

Triggers when:

• "1.28", "update", "breaking change", "migration", "compatibility"
• sealed, Obsolete, Contact, SurfaceProperties
• "vehicle brake", "useNewNetworking", "parameter limit"

Action: Read local compatibility/version-128.md

RULE 8: Local Knowledge

Triggers when:

• Mod structure, folder layout, PBO packaging
• Best practices, anti-patterns, common pitfalls
• Memory management, lifecycle patterns
• Action system, weapon system, inventory system

Action: Read relevant local markdown file

---

Mod Framework Auto-Detection

When starting a task, detect what frameworks the mod uses:

Check config.cpp dependencies

// Vanilla only
requiredAddons[] = {"DZ_Data"};

// Community Framework
requiredAddons[] = {"DZ_Data", "JM_CF_Scripts"};

// Expansion
requiredAddons[] = {"DZ_Data", "JM_CF_Scripts", "DayZExpansion_Core"};

Check script imports

// CF detection
GetRPCManager()     // Uses CF RPC system
CF_ModuleWorld      // Uses CF Module system

// Expansion detection
ExpansionMarketModule       // Uses Expansion Market
ExpansionQuestModule        // Uses Expansion Quests
eAIBase                     // Uses Expansion AI

Check mod.cpp / meta.cpp

// CF dependency
dependency[] = {"Community Framework"};

// Expansion dependency
dependency[] = {"DayZ Expansion Core", "DayZ Expansion Scripts"};

---

Best Practices (Quick Reference)

Enforce Script Rules

Rule	Why
Use !GetGame().IsDedicatedServer() for client check	IsClient() returns FALSE during init
Assign getter results to local var before foreach	foreach on inline getter returns fails
Always parenthesize bitwise ops: (a & b) == b	Bitwise ops have lower precedence than comparisons
Use ref ONLY for member variables	ref in function params is WRONG
Check last file before reported error location	Compiler errors often point to wrong file
Never leave empty preprocessor blocks	Can cause segfaults

Memory Management Rules

Rule	Why
ref for member variables only	Controls reference lifetime
Never delete manually	Enforce Script uses GC
Inherit from Managed for ref counting	Enables ref/autoptr usage
autoptr auto-deletes when scope exits	Use for temporary owned references

Null Safety Rules

Rule	Example
Always check Cast<> results	PlayerBase p = PlayerBase.Cast(entity); if (p) {...}
Always check GetInventory()	if (player.GetInventory()) {...}
Always check GetIdentity()	if (player.GetIdentity()) {...}
Always check GetGame().GetPlayer()	Can be null during init/cleanup

Security Rules

Rule	Reason
Validate on server side	Client can be tampered
Check GetGame().IsServer() before gameplay logic	Prevent client-side exploitation
Use RPC callbacks, not direct events	Prevent event spoofing
Validate player identity on server RPCs	Prevent impersonation

Mod Structure

MyMod/
├── mod.cpp                    # Mod metadata
├── meta.cpp                   # Workshop metadata (auto-generated)
├── Keys/                      # BIS key for server signing
├── Addons/
│   └── MyMod/
│       ├── config.cpp         # CfgPatches, CfgMods, CfgVehicles
│       ├── $PREFIX$            # Mod prefix file
│       └── scripts/
│           ├── config.cpp     # Script module registration
│           ├── 3_Game/        # Game-level scripts (available everywhere)
│           ├── 4_World/       # World-level scripts (entities, items, players)
│           └── 5_Mission/     # Mission-level scripts (HUD, menus, mission logic)

---

Anti-Patterns

Don't	Do
GetGame().IsClient() during init	!GetGame().IsDedicatedServer()
foreach (auto x : GetSomething())	auto list = GetSomething(); foreach (auto x : list)
if (flags & FLAG == FLAG)	if ((flags & FLAG) == FLAG)
ref in function parameters/returns/locals	ref/autoptr only for class member variables
Add : ParentClass to modded class	modded class already inherits - never add inheritance
delete obj;	obj = null; (let GC handle cleanup)
Trust client data in RPCs	Always validate server-side
GetGame() in hot paths	Use g_Game global (1.28+ optimization)
SurfaceIsPond() / SurfaceIsSea()	g_Game.GetWaterDepth(pos) <= 0 (much faster)
GetObjectsAtPosition() frequently	Use static arrays, triggers, or GetScene()
Empty #ifdef / #endif blocks	Always have content or remove entirely
Hardcode framework dependencies	Detect at runtime via config.cpp
Skip null checks on Cast<>	Always check before using result
Write files outside $saves:/$profile:	FileIO only works in those directories
Unqualified member names in modded classes	Prefix with mod name: m_MyMod_VarName

---

DayZ-Specific Patterns

Modded Class Injection (The DayZ Way)

modded class PlayerBase
{
    override void SetActions(out TInputActionMap InputActionMap)
    {
        super.SetActions(InputActionMap);
        AddAction(MyCustomAction, InputActionMap);
    }
}

RPC Communication (Vanilla)

// Server -> Client
ScriptRPC rpc = new ScriptRPC();
rpc.Write(someData);
rpc.Send(player, ERPCs.RPC_USER_ACTION_MESSAGE, true, player.GetIdentity());

// Client handler
void OnRPC(PlayerIdentity sender, Object target, int rpc_type, ParamsReadContext ctx)
{
    if (rpc_type == ERPCs.RPC_USER_ACTION_MESSAGE)
    {
        ctx.Read(someData);
    }
}

RPC Communication (CF)

// Register
GetRPCManager().AddRPC("MyMod", "MyRPCHandler", this, SingeplayerExecutionType.Both);

// Send
GetRPCManager().SendRPC("MyMod", "MyRPCHandler", new Param1<string>("data"), true, null);

// Handler
void MyRPCHandler(CallType type, ParamsReadContext ctx, PlayerIdentity sender, Object target)
{
    Param1<string> data;
    if (!ctx.Read(data)) return;
    // process data.param1
}

Player Lifecycle Events

OnInit -> InvokeOnConnect -> OnClientReadyEvent -> OnClientDisconnectedEvent -> MissionFinish

Net Sync Variables

class MyEntity extends ItemBase
{
    int m_MyValue;

    void MyEntity()
    {
        RegisterNetSyncVariableInt("m_MyValue", 0, 100);
    }

    void SetMyValue(int val)
    {
        m_MyValue = val;
        SetSynchDirty();
    }

    override void OnVariablesSynchronized()
    {
        super.OnVariablesSynchronized();
        // m_MyValue is now updated on client
    }
}

---

Related Skills

Need	Skill
UI/HUD design	Read scripting/ files for Widget system
Server administration	Read config/server-config.md
Expansion modding	Read frameworks/expansion.md
Version migration	Read compatibility/version-128.md