meshy-dev/meshy-dcc-adapters/meshy-unity

Meshy Unity handoff

Use session to confirm the Editor PID, project, unsaved scenes and source-write policy. Its focus, pause, background and frame-count fields are diagnostics only.

Model paths must be below Assets/. inspect_model proves Unity loaded mesh data; instantiate_model also creates an undoable scene object. Read that object back with inspect_object and the returned instance_id. Instance IDs are session-scoped: rediscover them after a reload or restart. These operations require idle Edit Mode. GLB needs conversion to FBX or OBJ outside Unity.

A keyed FBX texture set (material_textures, with each file's byte count and SHA-256) maps to one material: Standard in the Built-in pipeline, Lit in the Universal Render Pipeline. Metallic goes to red and inverted roughness to alpha of one packed map. The tool does not install URP or switch pipelines; other pipelines are unsupported. Model-only imports report geometry_only.

inspect_renderers is read-only. It scans the active loaded scene, including inactive objects, and reports missing materials, shader errors and Standard/URP Lit pipeline mismatches. Pass max_material_slots after a save and reopen to read texture bindings. Bindings are not visual proof; check a Game View image before claiming the appearance is right.

save_scene_as saves only the active scene to a .unity path below Assets/ and refuses to overwrite another scene. open_scene refuses while any open scene is dirty.

Never repeat a mutation whose outcome is unknown; repeat only read-only checks. To close an Editor that meshy-dcc start-instance launched, use meshy-dcc stop-instance. It refuses while scenes are unsaved unless the user agreed to discard them (--discard-unsaved).