ai-3d-to-dayz · diff
git:20260831.0a5e0e4 to git:20261001.e42d2f4
76 added, 76 removed. Audit A to A.
---
name: ai-3d-to-dayz
description: >
Front-end para generar un prop, item o asset 3D de DayZ con IA: image/text-to-3D,
limpieza y retopología low-poly manifold, UV, normal bake high→low, PBR y handoff
a .p3d/.paa/.rvmat. Úsala para "generar un objeto/modelo 3D para DayZ", "crear un
prop desde cero", "image to 3D", "convertir un GLB de IA en .p3d", Hunyuan,
Tripo o Rodin, y low-poly realista. Decide el generador y los gates del front-end;
alimenta dayz-model-pipeline, el pipeline de texturas y dayz-pbo-build, no los
sustituye. Compón con blender-assembly, dayz-3d-viewer y 3d-generation-harness.
hunyuan3d-local es opcional/externa (no va en este pack). No usar para humanoides ni animación.
---
# ai-3d-to-dayz
- Front-end de generación asistida por IA para producir un asset 3D **game-ready para DayZ** desde una
- idea. Scaffold de workflow: la estructura y los handoffs están verificados; los tool-picks concretos son
- claims del canal @stefan_3d_ai marcados `❓ validar` hasta confirmarlos con tests propios.
+ AI-assisted generation front-end to produce a 3D asset **game-ready for DayZ** from an
+ idea. Workflow scaffold: structure and handoffs are verified; specific tool-picks are
+ claims from @stefan_3d_ai channel marked `❓ validate` until confirmed with own tests.
- > **Fuente y estado:** destilado de 33 vídeos del canal. KB con timestamps en
- > `<knowledge-notes>\ai-3d-pipeline\` (`index.md` + 6 stages). Nombres de
- > tools / versiones / settings = claims del creador, NO hechos. Verificar antes de fiarse (R2).
+ > **Source and status:** distilled from 33 channel videos. KB with timestamps in
+ > `<knowledge-notes>\ai-3d-pipeline\` (`index.md` + 6 stages). Tool
+ > names / versions / settings = creator claims, NOT facts. Verify before trusting (R2).
## WHEN TO USE
- - El usuario quiere un objeto/prop/item para un mod DayZ y no quiere (o no puede) modelarlo a mano.
- - Hay una imagen de referencia, o se puede generar una.
- - Target = **props/items estáticos o con partes mecánicas** (armas, contenedores, equipo, props de mundo).
- - NO usar para: personajes humanoides, o cuando la necesidad principal es animación esquelética (el
- pipeline del canal no cubre animación config-driven de DayZ — ver `stage-05-animation` de la KB).
+ - User wants an object/prop/item for a DayZ mod and does not want (or cannot) model by hand.
+ - Reference image exists, or one can be generated.
+ - Target = **static props/items or with mechanical parts** (weapons, containers, gear, world props).
+ - DO NOT use for: humanoid characters, or when primary need is skeletal animation (channel
+ pipeline does not cover DayZ config-driven animation — see KB `stage-05-animation`).
## PIPELINE (scaffold idea → .p3d)
- 1. **Referencia.** Imagen limpia: fondo blanco, iluminada por todos lados, sin objetos extra. Tools
- `❓ validar`: Nano Banana / Krea / 3D AI Studio. **Quitar fondo SIEMPRE** antes de image-to-3D.
- 2. **Generar malla.** Geometría > textura (DayZ rehace la textura). Rutas verificadas como disponibles:
- - **Hunyuan 2.1 local** (RTX 3090) → skill externa opcional `hunyuan3d-local` si está instalada (no se distribuye en este pack). Controlar `target_face_number`.
- - **Tripo / 3D AI Studio** (acceso de pago) → vía de pago para generar malla; pedir low-poly con control de polígonos. No hay skill en este pack que lo automatice.
- - Controlar el poly count EN la generación; sin límite, toda tool saca millones de tris.
- 3. **Limpiar + retopo.** Importar GLB a Blender (invoca `blender-assembly`). Bajar a low-poly **manifold**:
- Retopoflow (manual) o Quad Remesher; o AI auto-retopo (Tripo/Rodin/Hunyuan) **+ cleanup obligatorio**.
- 4. **UV + normal bake (high→low).** Es el paso que genera el `_nohq`. Blender Cycles, selected→active
- (low primero, luego high), Bake Type Normal, Non-Color, margin 8px, tunear Extrusion/Max Ray Distance.
- Detalle de settings: `stage-01-mesh-retopo-uv-bake` de la KB. DayZ `_nohq` is DirectX-style (Y−):
+ 1. **Reference.** Clean image: white background, lit from all sides, no extra objects. Tools
+ `❓ validate`: Nano Banana / Krea / 3D AI Studio. **ALWAYS remove background** before image-to-3D.
+ 2. **Generate mesh.** Geometry > texture (DayZ remakes texture). Routes verified as available:
+ - **Hunyuan 2.1 local** (RTX 3090) → optional external skill `hunyuan3d-local` if installed (not distributed in this pack). Control `target_face_number`.
+ - **Tripo / 3D AI Studio** (paid access) → paid route to generate mesh; request low-poly with polygon control. No skill in this pack automates it.
+ - Control poly count DURING generation; without limit, every tool produces millions of tris.
+ 3. **Clean + retopo.** Import GLB into Blender (invokes `blender-assembly`). Reduce to low-poly **manifold**:
+ Retopoflow (manual) or Quad Remesher; or AI auto-retopo (Tripo/Rodin/Hunyuan) **+ mandatory cleanup**.
+ 4. **UV + normal bake (high→low).** Step generating `_nohq`. Blender Cycles, selected→active
+ (low first, then high), Bake Type Normal, Non-Color, margin 8px, tune Extrusion/Max Ray Distance.
+ Settings detail: KB `stage-01-mesh-retopo-uv-bake`. DayZ `_nohq` is DirectX-style (Y−):
invert the green channel on export — verified fixture F7 in blender-assembly (Rule 11).
- 5. **Texturizar sobre la UV.** Tool: **Modddif** ❓ (pending validation, backlog #3: UV-respect and map
- usability unverified) (color → `_co`; normal → `_nohq`; NO saca roughness/metallic).
- El `_smdi` se hace aparte (PBR manual en Blender, o repackear un ORM de Tripo). NO re-mallar un retopo'd.
- 6. **Handoff DayZ.** Ensamblar `.p3d` MLOD — **opción recomendada: add-on Blender Arma 3 Object Builder**
- (lo que usa la comunidad DayZ; LODs/proxies/named selections nativos) o py3d. `_smdi`: repackear
- rough/metal con **preset SubstanceToArma** (R=white,G=metal,B=rough, invertir rough). Convertir a `.paa`
- (TexView/ImageToPAA), montar `.rvmat`, binarizar. → skills `dayz-texture-pipeline`, `dayz-model-pipeline`,
- `dayz-pbo-build`. Previsualizar con `dayz-3d-viewer`. Validar in-game con `dayz-test-ingame`.
+ 5. **Texture on UV.** Tool: **Modddif** ❓ (pending validation, backlog #3: UV-respect and map
+ usability unverified) (color → `_co`; normal → `_nohq`; does NOT output roughness/metallic).
+ `_smdi` is made separately (manual PBR in Blender, or repack Tripo ORM). DO NOT remesh a retopo'd.
+ 6. **DayZ Handoff.** Assemble `.p3d` MLOD — **recommended option: Blender Arma 3 Object Builder add-on**
+ (what DayZ community uses; native LODs/proxies/named selections) or py3d. `_smdi`: repack
+ rough/metal with **SubstanceToArma preset** (R=white,G=metal,B=rough, invert rough). Convert to `.paa`
+ (TexView/ImageToPAA), build `.rvmat`, binarize. → skills `dayz-texture-pipeline`, `dayz-model-pipeline`,
+ `dayz-pbo-build`. Preview with `dayz-3d-viewer`. Validate in-game with `dayz-test-ingame`.
- ## HARD RULES (las trampas que rompen DayZ)
+ ## HARD RULES (the pitfalls that break DayZ)
- - **La IA es solo BLOCKOUT high-poly, NO produce assets game-ready para DayZ** (confirmado por
- contrafactual independiente, 2026-06-23). El pipeline oficial Bohemia/Enfusion exige geometría
- manifold+cerrada+convexa y ships un Model Quality Assurance que marca non-manifold/ngon/non-convex
- como defectos — justo lo que la IA + auto-retopo generan. El output IA va SIEMPRE por retopo manual
- (Retopoflow/Quad Remesher) + UV + bake + validación Object Builder antes del `.p3d`. "AI auto-retopo
- suficiente" = REFUTADO. (liga con `dayz-binarize-vertex-limit`; detalle en `20_Knowledge/ai-3d-pipeline/counterfactual.md`).
- - **NUNCA fiar la colocación / orientación / escala de un `.p3d` a la visión IA** — es el eslabón débil
- documentado (rota 90°, no reposiciona). Usar checks numéricos (verify_bounds) + diff contra imagen de
- referencia. (liga con `blender-visual-review`).
- - Las tools de textura **DEBEN texturizar sobre la UV existente**, no re-mallar un modelo ya retopo'd.
- Verificar este punto en cualquier tool nueva antes de meterla en el pipeline.
- - Vértices DayZ = punto×normal×uv por LOD. El budget no es "caras"; normales compartidas reducen el conteo.
- - Nombres/versiones/settings de tools marcados `❓` son **claims sin verificar del creador** — confirmar
- contra la herramienta real antes de codificarlos como verdad.
+ - **AI is only high-poly BLOCKOUT, it does NOT produce game-ready assets for DayZ** (confirmed by
+ independent counterfactual, 2026-06-23). The official Bohemia/Enfusion pipeline requires manifold+closed+convex
+ geometry and ships a Model Quality Assurance marking non-manifold/ngon/non-convex
+ as defects — precisely what AI + auto-retopo generate. AI output ALWAYS goes through manual retopo
+ (Retopoflow/Quad Remesher) + UV + bake + Object Builder validation before `.p3d`. "AI auto-retopo
+ sufficient" = REFUTED. (links to `dayz-binarize-vertex-limit`; detail in `20_Knowledge/ai-3d-pipeline/counterfactual.md`).
+ - **NEVER trust placement / orientation / scale of a `.p3d` to AI vision** — it is the documented
+ weak link (rotates 90°, does not reposition). Use numerical checks (verify_bounds) + diff against reference
+ image. (links to `blender-visual-review`).
+ - Texture tools **MUST texture over existing UV**, not remesh an already retopo'd model.
+ Verify this point on any new tool before putting it into pipeline.
+ - DayZ vertices = point×normal×uv per LOD. Budget is not "faces"; shared normals reduce count.
+ - Tool names/versions/settings marked `❓` are **unverified claims from creator** — confirm
+ against actual tool before encoding them as truth.
## TOOL SHORTLIST (estado)
- | Tool | Rol | Estado |
+ | Tool | Role | Status |
|---|---|---|
- | Hunyuan 2.1 (local) | generar **blockout** high-poly, poly control | disponible ✅ (skill externa `hunyuan3d-local`, no en este pack) |
- | Tripo / 3D AI Studio | generar malla low-poly, retopo, PBR | acceso ✅; **#1 en arena low-poly independiente (Top3D 71.8%)**; ⚠️ Smart Low-Poly tras paywall |
- | Blender + Retopoflow/Quad Remesher (o ZRemesher/InstaLOD) | retopo manifold, UV, bake | núcleo ✅ — **insalvable** (la IA no lo reemplaza) |
- | **Arma 3 Object Builder** (add-on Blender, MrClock8163) | `.p3d` MLOD nativo: LODs, proxies, named selections, RVMAT, RTM | ✅ **estándar de la comunidad DayZ** (Discord + dep. DayZ-LOD-Tools); **sustituto/complemento de py3d**. Enlace oficial abajo, en «Externas clave» |
- | **Modddif** (ex-"Modif/Motif") | color (`_co`) + normal (`_nohq`) sobre UV existente | ✅ free; NO roughness/metallic |
- | 3D AI Studio / Meshy Texture | PBR completo (albedo+normal+rough+metal) sobre UV existente | ✅ confirmado; repackear a `_smdi` |
- | Sloyd (paramétrico) | props templados (barriles/cajas/armas) quad+UV+LOD out-of-box | ✅ menos cleanup que IA para props simples |
- | Rodin (Hyper3D) | edición de malla, partes, PBR | acceso ✅; #3 arena low-poly |
- | AI animación (Mixamo/AccuRig/Cascadeur/…) | rig/anim humanoide | BAJA para props DayZ |
+ | Hunyuan 2.1 (local) | generate high-poly **blockout**, poly control | available ✅ (external skill `hunyuan3d-local`, not in this pack) |
+ | Tripo / 3D AI Studio | generate low-poly mesh, retopo, PBR | access ✅; **#1 in independent low-poly arena (Top3D 71.8%)**; ⚠️ Smart Low-Poly behind paywall |
+ | Blender + Retopoflow/Quad Remesher (or ZRemesher/InstaLOD) | manifold retopo, UV, bake | core ✅ — **unavoidable** (AI does not replace it) |
+ | **Arma 3 Object Builder** (Blender add-on, MrClock8163) | native `.p3d` MLOD: LODs, proxies, named selections, RVMAT, RTM | ✅ **DayZ community standard** (Discord + dep. DayZ-LOD-Tools); **substitute/complement for py3d**. Official link below, under "Key external links" |
+ | **Modddif** (ex-"Modif/Motif") | color (`_co`) + normal (`_nohq`) over existing UV | ✅ free; NO roughness/metallic |
+ | 3D AI Studio / Meshy Texture | full PBR (albedo+normal+rough+metal) over existing UV | ✅ confirmed; repack to `_smdi` |
+ | Sloyd (parametric) | templated props (barrels/crates/weapons) quad+UV+LOD out-of-box | ✅ less cleanup than AI for simple props |
+ | Rodin (Hyper3D) | mesh editing, parts, PBR | access ✅; #3 low-poly arena |
+ | AI animation (Mixamo/AccuRig/Cascadeur/…) | humanoid rig/anim | LOW for DayZ props |
- ## VALIDATION BACKLOG (endurecer este skill tras esto)
+ ## VALIDATION BACKLOG (harden this skill after this)
- 1. ~~Generación A/B: mismo prop DayZ vía Hunyuan 2.1 local vs Tripo → geometría + poly control.~~
+ 1. ~~A/B generation: same DayZ prop via local Hunyuan 2.1 vs Tripo → geometry + poly control.~~
RESOLVED by the 2026-06-10 mk47 shootout (hunyuan3d-local §"Hard-surface → fal.ai") + the 2026-06-23
full-body case: local 2.1 wins as default (free, organic, concept iteration); fal Hunyuan 3.1 Pro for
fine hard-surface; fal Rodin 2.5 for organic full-body; Tripo 2.5 gave efficient direct low-poly
(92k tris) but was not the pick.
- 2. Normal bake high→low (workflow Ep.3) → exportar → `_nohq.paa` → validar in-game.
- 3. Modif sobre una UV hecha → ¿respeta la UV? ¿maps sirven para `_co`/`_nohq`?
- 4. LOD batch vía Blender-MCP: un prompt que decime a N targets + downscale texturas → prototipo de LODs
+ 2. High→low normal bake (Ep.3 workflow) → export → `_nohq.paa` → validate in-game.
+ 3. Modif on prepared UV → does it respect UV? do maps work for `_co`/`_nohq`?
+ 4. LOD batch via Blender-MCP: prompt decimating to N targets + downscale textures → LOD prototype
(any VISUAL decimation is user-gated — rule 2026-07-02: ask before, default is manual by the user).
- Al confirmar cada punto: sustituir el `❓` correspondiente por el dato verificado + cita, aquí y en la KB.
+ Upon confirming each item: replace corresponding `❓` with verified data + citation, here and in KB.
## SOURCES
- KB: `20_Knowledge/ai-3d-pipeline/index.md` (+ stage-00/01/04/05/07/08).
- - **Contrafactual + deep dives:** `counterfactual.md`, `arma3-object-builder.md`, `alternatives-deep-dive.md`. Son notas de investigacion privadas y **no** viajan en este pack; lo que decidieron ya esta resumido arriba.
- - Externas clave: [Arma3 Object Builder](https://github.com/MrClock8163/Arma3ObjectBuilder) · [SubstanceToArma (preset `_smdi`)](https://github.com/MoonieFR/SubstanceToArma) · [Top3D low-poly arena](https://www.top3d.ai/leaderboard?type=low-poly).
- - Transcripciones: `30_Research/youtube/stefan_3d_ai/` (33 vídeos) + `_counterfactual/` (5 independientes).
- - Skill de extracción: `youtube-research`.
+ - **Counterfactual + deep dives:** `counterfactual.md`, `arma3-object-builder.md`, `alternatives-deep-dive.md`. These are private research notes and do **not** travel in this pack; what they decided is already summarized above.
+ - Key external links: [Arma3 Object Builder](https://github.com/MrClock8163/Arma3ObjectBuilder) · [SubstanceToArma (preset `_smdi`)](https://github.com/MoonieFR/SubstanceToArma) · [Top3D low-poly arena](https://www.top3d.ai/leaderboard?type=low-poly).
+ - Transcripts: `30_Research/youtube/stefan_3d_ai/` (33 videos) + `_counterfactual/` (5 independent).
+ - Extraction skill: `youtube-research`.
## (added 2026-06-23) Ruta personajes / infected (zombis)
- Para un personaje o criatura humanoide (zombi / infected DayZ) NO autorar desde cero: reskin de un vanilla.
- Recipe verificado en `20_Knowledge/dayz-custom-infected.md` -- heredar `ZombieMaleBase` reutiliza el esqueleto
- `OFP2_ManSkeleton` + animaciones + IA vanilla (gratis por herencia del bloque `enfanimsys`); el coste real es
- riguear la malla a los bones vanilla. Escalado runtime de DayZ roto (T140705) -> hornear el tamano en la
- malla. La generacion de la malla full-body organica va por fal Rodin (ver hunyuan3d-local added 2026-06-23).
+ For a humanoid character or creature (zombie / DayZ infected) do NOT author from scratch: reskin of a vanilla.
+ Verified recipe in `20_Knowledge/dayz-custom-infected.md` -- inheriting `ZombieMaleBase` reuses skeleton
+ `OFP2_ManSkeleton` + vanilla animations + AI (free by inheritance of the `enfanimsys` block); the actual cost is
+ rigging the mesh to the vanilla bones. DayZ runtime scaling broken (T140705) -> bake the size into the
+ mesh. Organic full-body mesh generation goes through fal Rodin (see hunyuan3d-local added 2026-06-23).
- ## Reglas promovidas del corpus de lecciones (added 2026-07-27)
+ ## Rules promoted from the lessons corpus (added 2026-07-27)
- Promovidas desde `AI/20_Knowledge/lessons-learned.md` para que lleguen por trigger en vez
- de depender de que alguien recuerde buscarlas. Cada regla cita su `LL-NNN` de origen;
- la entrada completa (síntoma, origen, evidencia) vive allí. No quites la cita: el índice
- `lessons-index.md` detecta la promoción buscando esa referencia dentro de las skills.
+ Promoted from `AI/20_Knowledge/lessons-learned.md` so that they arrive via trigger instead
+ of relying on someone remembering to look them up. Each rule cites its source `LL-NNN`;
+ the full entry (symptom, origin, evidence) lives there. Do not remove the citation: the index
+ `lessons-index.md` detects promotion by searching for that reference inside the skills.
- - **LL-154** — Prepara la referencia con rembg, autocrop, fondo blanco, margen y agujeros transparentes rellenados; usa cuerpo completo cuando el output lo requiera. Tras generar, valida `trimesh.extents`: un eje casi cero es un fallo plano aunque el render parezca plausible.
+ - **LL-154** — Prepare reference with rembg, autocrop, white background, margin, and filled transparent holes; use full body when the output requires it. After generating, validate `trimesh.extents`: a near-zero axis is a planar failure even if the render looks plausible.
## (added 2026-08-31, SP-071) Generic-DCC visual winding at MLOD emission
For a raw Blender, OBJ, glTF, or FBX import whose measured axis transform preserves winding,
reverse the vertex order of every **visual** face when emitting the authoring MLOD. Proxy
triangles are exempt: their winding encodes the proxy frame. Keep this step in the generic-DCC
profile handed to `dayz-model-pipeline`; do not generalize it to a vehicle or reconstructed
source profile with a different measured lineage.
A pre-binarize census of
`dot(cross(v1-v0, v2-v0), mean_stored_normal)` can predict the result inside a calibrated
source profile. Exclude `abs(dot) < 1e-9`. At the measured generic-DCC calibration, at least
95% negative is `SOLID`, positive-dominant is `INVERTED`, and an intermediate result means
mixed per-piece winding that must be isolated before a bulk fix.
This census is a **profile signal, not a universal gate**. Do not compare its ratios across
ODOL, MLOD produced from ODOL by an external ODOL->MLOD converter (not distributed with this
pack), raw DCC MLOD, or vanilla references: stored-normal conventions differ by origin. Only
enforce a threshold after an in-game A/B has calibrated that exact source pipeline. The final
verdict remains the in-game A/B between the candidate and an all-visual-faces-flipped variant.