Models
Models shows P3D files, the 3D model format of DayZ. It opens your own editable models (MLOD, the source form written by Object Builder and by this page) and the game's models (ODOL, the binarized form shipped in the game's PBOs), which are read-only. You use it to see how a model is built, to bring a mesh from Blender or an AI generator into a mod, to fix what the game or Binarize would refuse, and to edit the model.cfg that animates it. To list your own models, add your mod folder in Settings; to browse the game's, the DayZ folder must be set there.
The screen
- Header:
Openpicks a.p3danywhere on disk.model.cfgopens the model.cfg drawer for the open model.Import 3D modelopens the import form. - Model list (left): the
Workspace/Gameswitch, the number of models, a filter field and one row per model.Workspacelists the.p3dfiles of your mod folders, editable ones (MLOD) first;Gamesearches the models inside the game's PBOs by path. Each side shows at most 500 rows: type more of the path to narrow it. Click a row to open the model. - Toolbar (above the 3D view): the LOD list,
Solid/Solid + wire/Wireframe,Textures,Proxies(off by default),Frame, and for an editable model the pick modesNavigate,Parts,Faces,Vertices. - 3D view (centre): the LOD chosen in the list. Left drag orbits, right drag or Shift drag pans, the wheel zooms, double-click frames the model. A LOD without faces (Memory) is drawn as dots. The path of the open model is under the view. When a file cannot be read, a
Cannot displaycard gives the reason. - LOD pane (right): kind, resolution, points, faces, mass and size of the LOD shown; its named selections (click one to highlight it in the view); its textures and materials. For a game model, a note says it is binarized and view-only.
- Edit tools (right, editable models only): the viewport selection, named selections (create, add to, remove from, delete), named properties of the LOD, mass, proxies, memory points with
Show markers. Below, theEditsection: buttons that fill the operations box with a usual repair,Apply,Undo(Ctrl+Z),Redo(Ctrl+Y),SaveandSave as…. - Validation (right, editable models only): the issues of the model, each with its severity and a line saying what to do, the total mass, and
Check as(item, weapon, vehicle). - model.cfg drawer:
Open,New, theTree/Textviews,Save,Save as…; the tree ofCfgSkeletonsandCfgModels; the details of the selected skeleton, class or animation;Pose preview; the validation of the file against the open model.
First steps
- Open Models and click
Gameat the top of the list. - Type
canteenin the search field and clickCanteen.p3d. It opens read-only. - Orbit with a left drag, zoom with the wheel. Switch to
Solid + wireto see the faces. - Open the LOD list and pick each entry in turn:
1.000to4.000get lighter,Geometryis a simple closed shape,Memoryholds only a few named points. - On the
MemoryLOD, click a name underNamed selectionsto see which point it is.
Take the tour (in the app)
Common tasks
Study a vanilla model
- Click
Gameand search by part of the path (weapons\firearms,offroadhatchback). - Open the model, then go through its LODs.
- Tick
Proxiesto show the placeholder triangles of the attached models. - Read the named selections of the first LOD: these are the names a config or a model.cfg refers to.
Import a mesh as a P3D
- Click
Import 3D modeland choose the source mesh (.obj,.gltf,.glb; FBX,.blend, DAE, STL, PLY, 3DS, USD and Alembic are converted with Blender when it is installed). - Set the mod prefix if the form did not find it: the folder name under which the game sees your files, for example
MyMod\data\. - Leave
Mesh onlyfor a plain conversion (visual LOD, generated Geometry, View and Fire Geometry, optional shadow volume), or choose an object kind (item, weapon, vehicle, clothing). Weapons and vehicles need a vanilla class inBased on. - For a weapon, a vehicle or clothing, click
Check partsto see what the mesh has and what is missing before importing. - Click
Import. The result panel lists what was done, what to adjust and the issues; the new model opens.
Fix what Validation reports
- Open your model (it must be MLOD). Read the list under
Validation. - Choose a kind in
Check asto also compare with what vanilla models of that kind have. - In
Edit, click the button that matches the hint (Collision,View + Fire geo,Shadow volume,Fix winding,Weld + clean,Mass…). It writes the operation in the box; change its values if needed. - Click
Apply. The model changes in memory and Validation updates. - Click
Save. The first save keeps the original as<name>.p3d.bak.
Name a selection or place a memory point
- Choose
Parts,FacesorVerticesabove the view and click or drag a box. Shift adds, Ctrl removes, Esc clears. - Under
Named selections, type a name and useCreate / assign. - For a memory point, type its name under
Memory points: it is placed at the centre of what you picked, or at the origin. - Tick
Show markersto see memory points and proxies as labels in the view.
Edit the model.cfg
- Open the model, then click
model.cfg. The page looks for amodel.cfgin the model's folder and up to four parent folders. - If there is none,
Newstarts one next to the model, with a skeleton and a class named like the P3D. - Select a skeleton to edit its bones, a class to set its skeleton and sections, an animation to set its type, source, selection and axis.
- Tick
Show in 3DunderPose previewand move a source to see the parts move. - Fix what the drawer's Validation lists, then
Save.
Start from a recipe
With no model open, the empty state lists the recipes for this page as chips (New item, Import clothing, Import a vehicle…): a click starts one in Beans Assistant, which asks a few questions, proposes a plan and works step by step with checks. All recipes opens the whole catalogue. The help panel (F1) lists them too.
Examples
- An item: the canteen (in the app): a small item with four resolution LODs, Geometry, View Geometry, Fire Geometry and Memory. The Memory LOD holds
invviewand the bounding box points. - A weapon: the AKM (in the app): the Memory LOD has the muzzle points (
usti hlavne,konec hlavne), the ejection points (nabojnicestart,nabojniceend) andeye. WithProxieson you see where the magazine, the handguard, the buttstock and the optic sit. - A vehicle: the Offroad Hatchback (in the app): about 15 000 faces in the first LOD. Wheels and crew are proxies;
doors_driverand the like are the selections that move; the Memory LOD has the wheel and door axes and the get-in positions; Geometry is split intoComponentNNparts. - Clothing: the hoodie (in the app):
hoodie_m.p3d, the model worn by a male character. Its first LOD has one selection per bone of the character skeleton (spine,leftarm…), and the LODs also carrycamomale, the selection a config retextures.hoodie_f.p3dandhoodie_ground.p3dare in the same folder.
Concepts
- P3D, MLOD and ODOL: a
.p3dis either MLOD, the editable source, or ODOL, the binarized form the game loads fastest. The game's own models are ODOL: this page converts them for viewing and does not edit them. A mod is built from MLOD sources. - LOD: one mesh of the model. A P3D holds several, each with a resolution number that says what it is for. See LOD on the Bohemia wiki.
- Resolution LODs (
0.000,1.000,2.000…): the meshes that are drawn. The engine switches to a higher number, a lighter mesh, as the object gets further away. - Geometry: the physical collision, made of closed convex parts named
Component01,Component02… It also carries the mass of the object. - View Geometry and Fire Geometry: copies of the collision used for what the cursor and the view can hit, and for what bullets hit. Without them an object cannot be looked at or shot.
- Memory: named points and no faces. The game reads them by name: the muzzle and the eye of a weapon, wheel axes, get-in positions, the axis an animation turns around.
- Shadow volume: a closed, triangulated mesh used only to cast the shadow.
- ViewPilot, LandContact: the model seen in first person or from inside a car; the points an object rests on when dropped.
- Named selection: a named set of points and faces of a LOD. The game animates parts (bones), hides them (
hiddenSelections), retextures them (camo) and damages them by selection name. - Proxy: a placeholder triangle in a selection named
proxy:\path\to\model.001. The game draws another model there: an attachment, a magazine, a door, a wheel, a crew member. - Named property: a key and value on a LOD, mostly on Geometry, such as
autocenter = 0. - model.cfg: a text file next to the model.
CfgSkeletonslists bones and their parents;CfgModelshas one class per model, named like the P3D file, with its skeleton, its sections and its animations. A bone name must be a named selection of the model; an animation axis is a memory point. See Model Config on the Bohemia wiki. - What the checks mean: Validation looks for what makes Binarize or the game fail: no resolution LOD or two with the same resolution; no Geometry, Memory, View or Fire Geometry; a Geometry without mass, without
ComponentNNparts, or with parts that are open, not convex or wound the wrong way; a shadow volume that is not closed or has quads; faces that are degenerate, untextured or broken; texture paths that are absolute, use/or are not.paa/.rvmat; tables that no longer match the points.Check asadds the LODs, memory points, selections and properties the game's own items, weapons or vehicles have.
Pitfalls
- Trying to edit a game model: it is binarized and view-only, so the edit tools and Validation are hidden. Start from your own MLOD source.
- A
CfgModelsclass not named like the P3D file is ignored by the engine: the drawer flags it. - A bone or an animation selection that is not a named selection of the model does nothing: the tree marks it with
!and Validation lists it. - Texture paths are game paths with backslashes (
MyMod\data\thing_co.paa), never disk paths. TheTexture prefixbutton rewrites them. - A model without Geometry falls through the ground; without mass it cannot be simulated; without View and Fire Geometry it cannot be targeted or hit.
- Memory points placed by the import come from the bounding box: check and move them (the result panel lists them under
To adjust). - Tree edits in the model.cfg drawer rewrite the file without its comments,
#defineand#include. Use theTextview to keep them. - Opening another model while yours has unsaved changes needs a second click to confirm, then the changes are lost. Save first.
- A model that changes on disk (a Blender export, a tool) is reloaded; if you have unsaved edits a banner asks first.
- The model.cfg panel with unsaved edits: Open, New and Close warn first; the same click again within 10 seconds discards the edits.
For agents
Tools of dzt that do the same work without the window:
p3d_info: LODs, selections, mass, textures, bounding box of a file or a game virtual path; skeleton, animations and proxies for binarized models.p3d_validate: the checks of the Validation section.p3d_selections,p3d_proxies: named selections per LOD; proxies with their position.p3d_edit: the JSON operations of theEditbox, applied to an MLOD file.p3d_regenerate_collision: rebuild Geometry, View Geometry, Fire Geometry or a shadow LOD from the visual mesh.p3d_template: requirements and starting files for an item, weapon or vehicle.model_import: OBJ / glTF to MLOD with generated LODs (the form withMesh only).asset_inspect,asset_import: the parts check and the full import with an object kind.asset_sounds: own sounds for an imported car.asset_check: a config class against its model, the way the game assembles it at spawn.modelcfg_info,modelcfg_edit,modelcfg_validate: read, edit and check a model.cfg.item_preview: render a config class as a PNG.vfs_searchwithext: "p3d"finds game models.
Files the page reads and writes:
- Reads
.p3dfrom the workspaces (folders scanned 12 levels deep, hidden folders skipped) and from the game's PBOs, textures through the game data, andmodel.cfg(plain or rapified) from disk or the game data. - Writes the open
.p3donSave(with<name>.p3d.bakonce) or a new one onSave as…;model.cfgonSave(a.bakonce). The import writes the.p3dand, with an object kind, textures, rvmat,model.cfg,config.cpp(merged into the mod's, previous text kept asconfig.cpp.bak), a preview PNG and<name>.source.json.
What the page tells the assistant: the open file, binarized (view-only) with the ODOL version, the LOD shown with its face count, the selected named selection, a load error, whether there are unsaved changes, the validation issues as problems, and the suggested action Check this model. Anchors for data-guide: models-open, models-cfg-button, models-import, models-explorer, models-source, models-source-game, models-toolbar, models-lod-select, models-viewport, models-inspector, models-edit, models-validation, models-cfg-panel.
See also
- Textures: convert PNG / TGA to
.paaand look at the textures a model uses. - Config: the
config.cppclass that points at the model. - Animations: character animation graphs, as opposed to model.cfg animations.
- PBO Packer and Steam Workshop: pack the mod and test it.
- The Workbench