Files
MagnetismHeroes/SourceAssets/Models/Heroes/README.md
T

45 lines
2.8 KiB
Markdown

# Magnetic knight candidate
This is a model review candidate. It is not connected to a prefab, scene, stage,
collider, input target or game state. User model/material approval precedes game
adoption. No Unity import or Android appearance/selection pass is claimed here.
`MagneticKnight.blend` contains separately named editable collections for the
one-meter spherical body, knight equipment, existing-face preview, thin ribbon
preview, and render studio. The face atlas is packed unchanged for portability.
The review face and ribbon are excluded from the FBX exports; retain the game's
six-expression SpriteRenderer and existing animated light ribbon during later
integration. There is no new face, head, arm, leg, rig or animation.
`HeroBody.fbx` has a body-centered pivot and radius 0.5 meters. `KnightEquipment.fbx`
has the same attachment origin and contains named meshes for the open helmet,
short rounded toy sword, and layered round magnet-emblem shield. Object scales
are applied. Authoring is Z up in meters; exports use -Z forward / Y up without
animation. Preserve the imported axis transform when creating the later wrapper.
The existing SphereCollider radius 0.5, root scale 1, and ball IDs remain owned by
the existing game. Equipment must stay visual-only, without colliders or input
targets. The equipment is a GroupBadge candidate for one representative per group.
The opaque export materials use uniform portable base colors, roughness and
metallic values, with no procedural texture or Blender-only shader dependency.
Their exact values are in `provenance.json`. The body is smooth with welded poles
and no geometric seam. Helmet details follow its shell, and sword/shield stay
beside the open eye-and-mouth area. Verify numbers, selection highlights, crowded
groups and camera-facing behavior in Unity after approval; Blender shots alone
do not prove those gameplay checks.
Regeneration (from this worktree root, with the Blender execution owner):
```powershell
& 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe' --background --python tools/models/build_hero.py -- --review-dir 'C:/git/MagnetismHeroes/artifacts/verification/VisualUpgrade/ModelReview/Heroes'
& 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe' --background --python tools/models/build_hero.py -- --verify-only
```
The tool only writes the Heroes source/export folders and the specified review
folder. It does not run the initial scenery builder. Provenance includes the
actual Blender version, source/export bytes and SHA256, existing sprite records,
material values, source licensing, and review limits. `verification.json` records
the actual source reopen, body radius/scale/geometry gates and FBX reimport checks.
Unity-generated `.meta` files are deliberately absent from this candidate; the
later Unity import owner must create them after approval.