Troubleshooting the Blender add-on

Read the status message in the Model Vista Create sidebar. Use Diagnostics > Copy Diagnostics and the explicit action JSON copy controls for detailed inspection.

Add-on does not appear

Install model_vista_create-1.0.0-blender45-51-win64.zip, not a zip with an extra parent folder.
Enable Model Vista Create in Preferences and remove/disable stale Configurables, ModelVista States, or Model Vista Create installations.
Restart Blender after replacing an imported add-on.

Native core does not load

Use the complete Windows x64 package with Blender 4.5 or 5.1. It includes ABI-specific native modules such as _modelvista_create_core.cp311-win_amd64.pyd. Copying Python files alone is insufficient. Other Blender releases/platforms need a matching package.

File does not load

Confirm the file is a valid .glb or .gltf and required external resources exist.
A standard file does not need an existing States extension; it can receive new States.
Check the status for GLB header, JSON, import, or native-core errors.

Preview does not work

Confirm Asset Root, target object types, and target paths. Load with Import Scene On Load, or assign your existing hierarchy.
Assign Preview Camera if a Camera State has no explicit target.
Clear search and disable Show States for Selected Objects if the State is missing.
Use Restore Scene / Stop Preview to recover the scene after a preview or interrupted transition.
Light previews support energy/filter and, in Blender 5.1, temperature. Unknown State behavior is not emulated.

The wrong duplicate object changes

Version 1.0.0 resolves exact paths before import-name compatibility matching. If an older version stored the wrong target, remove the entry and add the intended selected object again under Targets or Visible Objects. Keep targets inside Asset Root.

Material preview or export looks wrong

Use Diagnostics > Repair > Apply Material Bindings for imported material slots.
Assign an existing Blender material to the option and check the target meshes.
Normal Material States affect the first slot. Preview All Material Slots changes Blender preview only.
Inspect the material usage count before editing a shared material; use Make Unique Copy for an independent alternative.
Address missing-image and shader hints and bake procedural textures for glTF export.
Keep the original GLB+ available when re-export needs its texture payloads.

Animation changes are missing

Restore previews before editing Actions/NLA or constraints, then Bake Timeline into Option again. Embedded clips are snapshots, so editing live Actions does not update them. Keep animated objects in the target subtree and check clip index, speed, loop, and frame range. Index -1 stops playback. See animation scope.

Input Actions look wrong

Expand Input Actions or Edit > Option Triggers, then Bindings. Edit Path changes one path while retaining other binding settings; disabling Add to Existing Bindings replaces the action. Check full JSON under Diagnostics. Bindings do not trigger Blender shortcuts.

Inactive objects look wrong

Confirm inactive-object records in Overview or Diagnostics and the intended Asset Root. Export includes hidden descendants and records them as inactive, excluding material helper geometry.

Changes were not saved

Blender Save stores the authoring project. Save Changes to Source writes extension metadata to a loaded source. Export Model + States writes geometry, materials, and States together.
A new Blender-authored asset has no source file; use export.
Previewing an option does not set its startup choice. Use Edit > Set as Startup.
Confirm write access and verify the saved project or exported file by reopening it.

Export is cancelled

Read the validation summary and repair missing/outside targets, invalid target types, unresolved materials, metadata/light/reflection-probe paths, invalid image references, or missing/cyclic Group links. Use Choose Object or selection-based target controls to reassign objects. Export deliberately stops when required references are invalid.