Versioning

Arrival.Space gives you three ways to back up, version, and transfer your Spaces. All versioning tools are found in the Advanced tab of Edit Mode under the Versioning section.

Export & Import

The simplest way to save or transfer a Space. Export downloads a .zip file to your computer; Import uploads one back.

Export

1. Enter Edit Mode and open the Advanced tab
2. Click Export Space (or use the download icon on the Versioning row)
3. A .zip file named after your Space is downloaded to your computer

Import

1. In the Advanced tab, click Import Space (or the upload icon)
2. Select a .zip file previously exported from Arrival.Space
3. Confirm the import — all entities in the current Space will be replaced with the contents of the file

Use cases

• Moving a Space between accounts
• Sharing a Space with a collaborator offline
• Keeping a local backup on your hard drive

Save Version (Snapshots)

Save Version creates a server-side snapshot of your Space that you can browse, compare, and restore at any time. No external accounts or setup required.

Saving a version

1. In the Advanced tab, open the Versioning panel
2. Click Save Version
3. Enter an optional note describing this version (e.g. "before lighting rework")
4. The snapshot is saved on the server immediately

Browsing versions

Your saved versions appear as a list below the Save Version button, newest first. Each entry shows:

• The version note (click to edit)
• When it was saved

Comparing versions

• Click the diff icon on any version to see what changed between that version and your current Space. Changes are shown per-entity as added, removed, or modified.
• Click Changes since last version (above the list) to see unsaved changes compared to your most recent version.

Restoring a version

Click the restore icon on any version to revert your Space to that point. The Space will reload automatically after restoring.

備考

Up to 50 versions are kept per Space. When you exceed this limit, the oldest versions are automatically removed.

GitHub Sync

GitHub Sync connects your Space to a GitHub repository. Each sync creates a git commit, giving you full version history, branching, diffs, and the ability to pull changes back.

Requirements

• A GitHub account
• A Personal Access Token (PAT) with repository permissions

Creating a GitHub Personal Access Token

1. Go to github.com/settings/tokens
2. Click Generate new token and select Fine-grained token
3. Give it a descriptive name (e.g. arrival-space-sync)
4. Set an expiration date
5. Under Repository access, select All repositories (or limit to specific ones)
6. Under Permissions > Repository permissions, set:
   • Contents > Read and write
   • Metadata > Read-only (selected automatically)
7. Click Generate token
8. Copy the token immediately -- you won't be able to see it again

Keep your token safe

Treat your PAT like a password. Your token is stored locally in your browser and is never saved on Arrival.Space servers.

First-time setup

1. In the Versioning panel, click Push to GitHub
2. Enter your Personal Access Token
3. Choose a Repository Name (defaults to your Space title)
4. Enter a Commit Message
5. Click Push

If the repository doesn't exist yet, it will be created automatically as a private repository under your GitHub account.

Pushing changes

Once connected, clicking Push to GitHub only asks for a commit message -- your PAT and repository are remembered. If nothing changed since the last push, you'll be told the repo is already up to date.

Branches

After the initial sync, a Branch dropdown appears in the GitHub section. You can:

• Switch between existing branches to view their history or push to them
• Create a new branch by selecting + New Branch from the dropdown

Viewing history

The commit history for the selected branch is shown below the branch selector. Each commit displays its message, short hash, author, and date.

Comparing commits

Click the diff icon on any commit to see a unified diff of that commit's state versus your current Space.

Pulling from GitHub

When the remote branch has commits that are newer than your last sync, a notification appears showing how many new commits are available. Click it to pull the latest version from GitHub into your Space. The Space reloads automatically after pulling.

Restoring a commit

Click the restore icon on any commit to revert your Space to that exact point in the repository history.

What Gets Saved

All three methods (export, snapshot, and git sync) save the same data:

• All entities in the Space (positions, settings, metadata) as individual JSON files
• Space settings (title, privacy, lighting, colors, and all room configuration stored in RoomInfo)
• Plugin source code (.mjs files are downloaded and included in the export)

Binary assets (3D models, images, audio) are not included -- only their URLs are stored. The assets themselves remain hosted on Arrival.Space's CDN.

Tips

• Save versions regularly to keep a recoverable history of your work
• Use meaningful notes and commit messages to make it easy to find specific versions later
• Export before risky changes as a quick local safety net
• If your GitHub token expires, generate a new one -- it will be used on the next push