Project files and tools

Path	Contents
project.json	Project settings and format version
scene.json	Scene objects with stable IDs
scripts/	Editable Luau gameplay
assets/	Imported files, addressed by content hash
.playweave/	Local history, recovery data, and captures

Inspect a project

cargo run -p playweave-cli -- validate ./my-game
cargo run -p playweave-cli -- schema
cargo run -p playweave-cli -- rpc ./my-game

The RPC command reads one JSON-RPC 2.0 request per line and writes responses to standard output:

{"jsonrpc":"2.0","id":1,"method":"project.inspect"}
{"jsonrpc":"2.0","id":2,"method":"components.schema"}

Edits include a base revision and validate before saving. Conflicting revisions are rejected.

Recovery and formats

Interrupted saves recover when the project next opens. After a crash, check that no writer is running before removing .playweave/write.lock.

Unsupported formats fail with an error. Keep backups; automatic migration and conversion from other engines are not available.