Versionierung

Arrival.Space bietet dir drei Möglichkeiten, deine Spaces zu sichern, zu versionieren und zu übertragen. Alle Werkzeuge zur Versionierung findest du im Tab Erweitert des Edit Mode im Bereich Versionierung.

Export & Import

Die einfachste Möglichkeit, einen Space zu speichern oder zu übertragen. Export lädt eine .zip-Datei auf deinen Computer herunter, Import lädt sie wieder hoch.

1 Export

1. Öffne den Edit Mode und wechsle in den Tab Erweitert
2. Klicke auf Space exportieren (oder nutze das Download-Symbol in der Zeile Versionierung)
3. Eine .zip-Datei mit dem Namen deines Space wird auf deinen Computer heruntergeladen

2 Import

1. Klicke im Tab Erweitert auf Space importieren (oder auf das Upload-Symbol)
2. Wähle eine .zip-Datei aus, die zuvor aus Arrival.Space exportiert wurde
3. Bestätige den Import. Alle Entities im aktuellen Space werden durch den Inhalt der Datei ersetzt

Einsatzmöglichkeiten

• Einen Space zwischen Konten verschieben
• Einen Space offline mit einer mitarbeitenden Person teilen
• Ein lokales Backup auf deiner Festplatte behalten

Version speichern (Snapshots)

Version speichern erstellt einen Snapshot deines Space auf dem Server, den du jederzeit durchsuchen, vergleichen und wiederherstellen kannst. Es sind keine externen Konten und kein zusätzliches Setup erforderlich.

1 Eine Version speichern

1. Öffne im Tab Erweitert den Bereich Versionierung
2. Klicke auf Version speichern
3. Gib optional eine Notiz ein, die diese Version beschreibt, zum Beispiel vor Lighting-Überarbeitung
4. Der Snapshot wird sofort auf dem Server gespeichert

Versionen durchsuchen

Deine gespeicherten Versionen erscheinen als Liste unter der Schaltfläche Version speichern, die neueste zuerst. Jeder Eintrag zeigt:

• Die Versionsnotiz (zum Bearbeiten anklicken)
• Den Zeitpunkt, zu dem sie gespeichert wurde

2 Versionen vergleichen

• Klicke bei einer Version auf das Diff-Symbol, um zu sehen, was sich zwischen dieser Version und deinem aktuellen Space geändert hat. Änderungen werden pro Entity als hinzugefügt, entfernt oder geändert dargestellt.
• Klicke oberhalb der Liste auf Änderungen seit letzter Version, um ungespeicherte Änderungen im Vergleich zu deiner neuesten Version zu sehen.

3 Eine Version wiederherstellen

Klicke bei einer Version auf das Wiederherstellen-Symbol, um deinen Space auf genau diesen Stand zurückzusetzen. Nach dem Wiederherstellen wird der Space automatisch neu geladen.

info

Es werden bis zu 50 Versionen pro Space gespeichert. Wenn du dieses Limit überschreitest, werden die ältesten Versionen automatisch entfernt.

GitHub Sync

GitHub Sync verbindet deinen Space mit einem GitHub-Repository. Jeder Sync erstellt einen git Commit und gibt dir damit eine vollständige Versionshistorie, Branches, Diffs und die Möglichkeit, Änderungen wieder zurückzuholen.

Anforderungen

• Ein GitHub-Konto
• Ein Personal Access Token (PAT) mit Berechtigungen für Repositories

Einen GitHub Personal Access Token erstellen

1. Öffne github.com/settings/personal-access-tokens
2. Klicke auf Generate new token und wähle Fine-grained token
3. Gib einen aussagekräftigen Namen ein, zum Beispiel arrival-space-sync
4. Lege ein Ablaufdatum fest
5. Wähle unter Repository access entweder All repositories oder beschränke den Zugriff auf bestimmte Repositories
6. Stelle unter Permissions > Repository permissions Folgendes ein:
   • Contents > Read and write
   • Metadata > Read-only (wird automatisch ausgewählt)
   • Administration > Read and write
7. Klicke auf Generate token
8. Kopiere den Token sofort. Danach kannst du ihn nicht noch einmal sehen

Bewahre deinen Token sicher auf

Behandle deinen PAT wie ein Passwort. Dein Token wird lokal in deinem Browser gespeichert und niemals auf Arrival.Space-Servern abgelegt.

Erstes Setup

1. Klicke im Bereich Versionierung auf Push to GitHub
2. Gib deinen Personal Access Token ein
3. Wähle einen Repository Name aus. Standardmäßig wird der Titel deines Space verwendet
4. Gib eine Commit Message ein
5. Klicke auf Push

Wenn das Repository noch nicht existiert, wird es automatisch als private Repository unter deinem GitHub-Konto angelegt.

Änderungen pushen

Sobald die Verbindung steht, fragt Push to GitHub nur noch nach einer Commit Message. Dein PAT und dein Repository werden gespeichert. Wenn sich seit dem letzten Push nichts geändert hat, bekommst du die Meldung, dass das Repository bereits aktuell ist.

Branches

Nach dem ersten Sync erscheint im GitHub-Bereich ein Dropdown Branch. Du kannst:

• Zwischen bestehenden Branches wechseln, um deren Verlauf anzusehen oder in sie zu pushen
• Einen neuen Branch erstellen, indem du im Dropdown + New Branch auswählst

Verlauf anzeigen

Der Commit-Verlauf des ausgewählten Branch wird unterhalb des Branch-Auswahlfeldes angezeigt. Jeder Commit zeigt Message, kurzen Hash, Autor und Datum.

Commits vergleichen

Klicke bei einem Commit auf das Diff-Symbol, um einen einheitlichen Diff dieses Commit-Zustands im Vergleich zu deinem aktuellen Space zu sehen.

Aus GitHub pullen

Wenn es im Remote-Branch Commits gibt, die neuer sind als dein letzter Sync, erscheint ein Hinweis, der anzeigt, wie viele neue Commits verfügbar sind. Klicke darauf, um die neueste Version aus GitHub in deinen Space zu pullen. Danach wird der Space automatisch neu geladen.

Einen Commit wiederherstellen

Klicke bei einem Commit auf das Wiederherstellen-Symbol, um deinen Space exakt auf diesen Punkt in der Repository-Historie zurückzusetzen.

Was gespeichert wird

Alle drei Methoden, also Export, Snapshot und git sync, speichern dieselben Daten:

• Alle Entities im Space, also Positionen, Einstellungen und Metadaten, als einzelne JSON-Dateien
• Space-Einstellungen, also Titel, Privatsphäre, Lighting, Farben und die komplette in RoomInfo gespeicherte Raumkonfiguration
• Plugin-Quellcode (.mjs-Dateien werden heruntergeladen und in den Export aufgenommen)

Binäre Assets wie 3D-Modelle, Bilder oder Audio werden nicht mitgespeichert. Es werden nur ihre URLs abgelegt. Die Assets selbst bleiben auf dem CDN von Arrival.Space gehostet.

Tipps

• Speichere regelmäßig Versionen, damit du einen wiederherstellbaren Verlauf deiner Arbeit hast
• Verwende aussagekräftige Notizen und Commit Messages, damit du bestimmte Versionen später leichter findest
• Exportiere vor riskanten Änderungen, um schnell ein lokales Sicherheitsnetz zu haben
• Wenn dein GitHub-Token abläuft, erstelle einen neuen. Er wird beim nächsten Push verwendet