Gizmo troubleshooting
“scape: command not found”
Run yarn install in the exported project, then use its yarn dev command. Exported kits contain the CLI as a local archive. A repository example is not the same as an exported kit; follow quickstart instead of assuming a globally installed command.
Pairing expired or the world is unavailable
Pairing codes last five minutes. Open the printed link, sign in with the world owner account, compare the code, and connect in the developer sidebar. Use a compatible host with developer-world endpoints. Session approval lasts two hours; a restart or disconnect revokes it.
My upload is rejected
Read the named field and supplied value in the error. The previous build remains active. Common causes include invalid initial/saved state, duplicate type or emoji, reserved built-in identity, unsupported imports, invalid effect ranges, or exceeding the 1 MiB project bundle.
Validate payloads and reducer results separately. A field shown in a select is not automatically safe server input. All existing state must pass your new validator.
I changed the type, version or collision behavior
Remove affected placed instances before applying that kind of incompatible update. There is no automatic state migration. Do not silently coerce unknown saves to defaults to bypass validation.
A button is under Configure
Editor controls belong under Configure by default. Use placement: 'action' for an explicit action-row control, but it does not change permission or expose protected fields. Automatic select controls cannot also be action-row buttons.
Sound or light is missing
Check recipe validation and referenced sound names first. Confirm whether the effect is local preview, cosmetic arrival, shared action feedback, or ambience. Those have different triggers and lifecycles.
Output respects player volume, distance, visibility, floor changes and platform support. Stale effects may be intentionally suppressed. An uploaded recipe cannot force output or bypass native routing.
Travel does nothing
Use a compatible movement authority. Confirm link completeness for linked travel, bounds, ordered exits, occupancy and cooldown. Walkability is independent; an inert travel recipe does not automatically make its cell walkable.
Where do I publish?
A development upload is not publication. Ordinary-world installation, stable releases and marketplace distribution are not yet available. See availability.