dayz-p3d-audit
Audits DayZ .p3d models and their config.cpp, model.cfg and .rvmat for collision, action, physics, animation and path problems (report only). Use when an object has no collision or actions, players wa
SKILL.mdskills/dayz-p3d-audit/SKILL.md
GitHub<!-- skill-dir-note -->
Path note:
<skill-dir>in commands below is the absolute path of this skill's folder. When the agent loads this skill the harness exposes the skill's base directory; substitute it before running. Sibling skills are reached via<skill-dir>\..\dayz-X\.
/dayz-p3d-audit
Validates .p3d model files, config.cpp, model.cfg, and .rvmat materials against DayZ engine requirements, targeting the failure modes that produce zero engine errors but break collision, targeting, animation, or textures.
Follow skills/_shared/dayz-conventions.md. The script runs /dayz-preflight first and stops if it fails.
How to run
The script reads .p3d files with py3d. Install it once:
python -m pip install -r "<skill-dir>\requirements.txt"
Audit one or more models (MLOD source, not binarized ODOL):
python "<skill-dir>\scripts\audit_p3d.py" path\to\model.p3d [more.p3d ...]
Include config/model.cfg path checks and the model.cfg animation check:
python "<skill-dir>\scripts\audit_p3d.py" model.p3d --config path\to\config.cpp --model-cfg path\to\model.cfg
Check .rvmat materials for P:\ paths:
python "<skill-dir>\scripts\audit_p3d.py" --rvmat path\to\a.rvmat --rvmat path\to\b.rvmat
Repeat --rvmat once per file; a .p3d written after it is still audited as a model.
P:\ paths inside // or /* */ comments are ignored, since the engine never reads them.
Full mod sweep (all .p3d, config.cpp, .rvmat, model.cfg; other inputs are ignored):
python "<skill-dir>\scripts\audit_p3d.py" --scan-dir path\to\mod\
The sweep ends with a SCAN SUMMARY line counting CRITICAL findings, P:\ paths and
ODOL rejects across the failing files, then one line per failing file with its own counts.
Animations are checked from model.cfg. The script finds the CfgModels class named
after the model file (inherited from its parent class when it has no Animations of
its own) and, for each animation, checks that its selection exists in the Visual LOD,
that its axis has exactly 2 points in the Memory LOD, and that any begin and end
points exist there. The model.cfg comes from --model-cfg, or under --scan-dir from
the model's folder or the nearest parent folder. Without a model.cfg, animations are
not checked.
The Geometry LOD autocenter property is checked only when the config.cpp (--config,
or under --scan-dir the nearest one found the same way) has a class whose
model is this p3d and that sets autocenter = 0 (either one may come from a parent class in
the same file). Kits and ordinary items do not use it, so they get no finding. The
same config decides the pos center checks: a missing pos center (WARNING) or one far
from the origin (NOTE) is reported only for those autocenter=0 items. The missing box_placing_min/max NOTE
appears only for a model with no Geometry LOD (the hologram uses the Geometry LOD
bounding box first) and never when boundingbox_min/max are present. Memory LOD point
names match without case (Pos Center counts as pos center), like the animation lookups.
A config.cpp that exists but cannot be read is an ERROR that fails the run, since the
autocenter and pos center checks could not be decided.
Degenerate faces are measured over the whole polygon: a quad is split into two triangles, so a valid quad whose first three vertices lie on one line is not flagged.
Exit codes:
- 0: no CRITICAL, P-DRIVE or ERROR finding. WARNING and NOTE findings are printed but never fail the run.
- 1: any .p3d has a CRITICAL finding, any text file (config.cpp, .rvmat, model.cfg)
has a
P:\path, printed as aP-DRIVEfinding with its line number, or a file or the--scan-dirfolder is missing or unreadable. A binarized ODOL .p3d (not MLOD) and a .p3d that cannot be read also give exit 1, with a[FAIL]line on stderr naming why. When the only failures are ODOL files, the last line isOVERALL: NOT AUDITED(the file was never checked) instead ofOVERALL: ISSUES FOUND. - 2: no input was given, or py3d is not installed. The second case prints the
python -m pip install -rline above.
Only MLOD source files can be audited; binarized ODOL files are rejected. Audit the MLOD the model was built from (the .p3d Object Builder saves; Addon Builder binarizes it when packing). Agentic-Z ships no debinarizer, so a vanilla or third-party ODOL model with no source cannot be audited here. When a model has several Visual LODs, LOD0 is the one checked. Interpret findings with the references below.
Diagnostic decision tree
1. Can you SEE the object in-game?
NO → Check model path in config.cpp (backslash prefix, case)
YES ↓
2. Is the object buried/floating?
BURIED → Missing autocenter=0 in config.cpp AND/OR LOD property
FLOATING → autocenter=0 on a kit class (only placed objects need it)
CORRECT ↓
3. Does floating text (item name) appear near it?
NO → Entity not spawned. Check CreateObjectEx, server logs
YES ↓
4. Do debug Print() in ActionCondition appear in script log?
YES → ActionCondition rejecting. Read prints to find which check fails
NO ↓ (P3D Geometry LOD issue: engine can't raycast)
5. Run audit_p3d.py and check:
a. Face winding outward? → Verify per references/winding-methodology.md
(the script deliberately omits the naive
centroid check: it false-positives on DayZ)
b. Component01 present? → Lowercase component01 is fine (a NOTE;
vanilla binarized models use it). Another
spelling is a WARNING: rename to Component01
c. autocenter=0 LOD property? → If missing: add (checked only when config.cpp
sets autocenter = 0)
d. pos center in Memory? (autocenter=0 items only) → If missing: add at (0,0,0)
e. Components cover all? → The Component selections together cover
every vertex and face; each component is
one convex closed piece. If some are left
out: add them to a component
f. Mesh watertight? → If open: close gaps
g. Geometry LOD exists? → If missing: create one
h. Geometry LOD mass set? → The audit prints the mass as a NOTE, or says
the LOD has none
i. Collision faces have a → CRITICAL when any face in the Geometry,
material? GeoPhys or FireGeo LOD has none: assign a
penetration .rvmat (references/p3d-killers.md
section 10). In the ViewGeo LOD it is only a
WARNING, since View Geometry faces often
carry no material
6. Animations not playing?
→ Run audit_p3d.py with --model-cfg: the selection each model.cfg
animation names must exist in the Visual LOD, and its axis must
exist in the Memory LOD with exactly 2 points
→ Check that config.cpp AnimationSources match the source names
in model.cfg
7. Textures missing/white?
→ Check P:\ paths in config.cpp hiddenSelectionsTextures
→ Check P:\ paths in .rvmat files
→ Verify .paa files exist at referenced paths
References
Deep material lives in <skill-dir>\references\:
references/p3d-killers.md: the 10 silent P3D killers (inverted winding, Component01 naming, autocenter LOD property, missing LODs, memory points, animation selections, collision-LOD surface materials, …) plus Blender export pitfalls and script-side gotchas that co-occur during debugging.references/config-rvmat-checks.md: config.cpp checks (P:\ paths, placed-object properties, AnimationSources, hiddenSelections) and .rvmat checks (paths, plus the Super-shader stage layout to review by hand).references/winding-methodology.md: how to actually verify face winding (edge-pair topology, averaged-normal checks), which heuristics mislead and why, known traps, and the full Blender-import checklist.