Sync Tool

Keep collections, endpoints and workflows as YAML in your project and push or pull them.

Editor > Network Storage > Sync Tool keeps your server's collections, endpoints and workflows as YAML files in your project and pushes or pulls them through the API of the server in your Setup (baseUrl). Game values are edited in the server's owner console or over its API.

#Workflow

1. Write collections, endpoints, workflows, tests and libraries as YAML under Editor/Network Storage/.
2. Check for Updates compares local files with the server.
3. Push sends local changes; Pull downloads the server's version.
4. View Diff shows a side-by-side comparison before anything is overwritten.

Sync moves resource definitions, not player data. Player records live in the server's database.

#Source files

Editor/
  Network Storage/              # folder configurable in Setup
    .env                        # credentials (gitignored, never published)
    collections/<id>.collection.yml
    endpoints/<slug>.endpoint.yml
    workflows/<id>.workflow.yml
    tests/<id>.test.yml
    libraries/<id>.library.yml

.yaml is accepted too; prefer .yml. Each file starts with:

sourceVersion: 1
kind: endpoint
id: mine-ore
definition:
  method: POST
  steps: []

Existing JSON resources stay readable and pushable; new and pulled resources are written as YAML. JSON is not converted to YAML automatically. The full model is in source-authoring.md and source-authoring.schema.json, with examples in Examples/SourceAuthoring.

#Validate from the command line

python Libraries/sboxcool.network-storage/Editor/source_compiler.py --project-root .
python Libraries/sboxcool.network-storage/Editor/sync.py --project-root . --sources --dry-run