EDITABLE SOURCE AND REBUILDING

All dimensions are metres. The Python model source uses Blender's Z-up,
right-handed coordinates. io_object_mu converts these to KSP/Unity Y-up.
The Y coordinate in a KSP attach node equals Z in the modeling source.

SOURCE CONTENTS

parts_spec.json            Dimensions, nodes, 24-side count and clear bores.
build_models.py            Original mesh, atlas and OBJ generator.
mu_tools.py                Small helpers around the vendored .mu writer.
build_configs.py           Part CFG, version and craft-template generator.
render_models.py           Blender render of the exported .mu meshes.
compose_preview.py         Annotated layout using those actual mesh renders.
validate_meshes.py         Independent binary geometry/collider validation.
validate_configs.py        Static CFG and craft-attachment validation.
MouseIntoSpace_Source.blend Packed editable Blender source scene.
OBJ/                      All 18 part meshes, MTL and shared atlas.
io_object_mu/              Verified upstream writer/reader and GPL license.
upstream_provenance.json   Source URL, revision and byte-verification record.

The Blender file includes the assembled rocket and separately named
collections for exploded, engine-bay, open-top and adapter previews. The
colliders are hidden from view/render. The OBJ files include every part and
use the same render vertices as the exported .mu assets. OBJ files do not
contain the physics colliders; those are reproduced by build_models.py.

REBUILD

From the package root, with Python 3, Pillow and NumPy installed:

  python3 Source/build_models.py
  python3 Source/build_configs.py
  python3 Source/validate_meshes.py GameData/MouseIntoSpace/Models --spec Source/parts_spec.json --report QA/mesh_validation.json
  python3 Source/validate_configs.py . --output QA/config_validation.json

To rebuild the preview and packed Blender source with Blender 4.x:

  blender -b --python Source/render_models.py
  python3 Source/compose_preview.py

The model and CFG builders use matching dimensions but are separate files.
When changing dimensions, update both the mesh specification and the CFG
builder; then run both validators. Keep top/bottom joint positions, engine
deck positions, and craft-template heights consistent.

MATERIAL AND COLLIDER NOTES

All installed models share a 1024 x 1024 PNG atlas and the stock KSP/Specular
shader. Texture alpha is a specular mask, not transparency. The studio preview
uses an approximate Blender material and is not an in-game screenshot.

Each lower engine bay uses thin convex wall segments around an empty center.
Only the fuel body above the recessed mounting deck is a solid collider.
Separation rings and expansion adapters are hollow compound colliders.
Do not replace a hollow opening with a single convex cylinder: that would
fill its center and defeat the engine clearance design.

No engine model, thrust transform, engine module, or exhaust effect is built
into these stage parts. Attach an engine part to the recessed engine node.
The gold nose and inline control ring are uncrewed stock-module avionics.

VALIDATION SCOPE

The JSON reports in QA document structural checks of the exported files.
They are not KSP runtime or flight tests. Load the mod in KSP to verify Unity
asset loading, physics, staging behavior, heat, and your chosen engines.
