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

2.8 KiB

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):

& '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.