Script-Synchronisierung

Roblox Studio verfügt über einen integrierten Skripteditor zum Bearbeiten des Codes in Ihrem Roblox-Projekt. Der Editor umfasst wichtige Funktionen wie Linting, Typüberprüfung, Autocomplete und kollaboratives Bearbeiten.

Viele Entwickler haben jedoch einen bevorzugten Texteditor oder eine integrierte Entwicklungsumgebung (IDE) wie Visual Studio Code, Cursor, Sublime Text oder Notepad++. Beliebte Entwicklungsumgebungen bieten oft Funktionen oder Plugins, die im Studio nicht vorhanden sind. Um einen externen Editor oder eine IDE mit Studio zu verwenden, aktivieren Sie die Funktion Script-Synchronisierung.

Die Script-Synchronisierung funktioniert, indem sie die Skripte in Ihrem Datenmodell mit Textdateien auf Ihrem lokalen Laufwerk synchronisiert. Änderungen, die an den Luau-Dateien auf der Festplatte vorgenommen werden, werden auf die Skripte in Studio angewendet und umgekehrt. Diese Synchronisierung bedeutet, dass Sie ein Skript in einem externen Editor wie VS Code bearbeiten können und die Änderung umgehend in Studio sehen.

Wann Sie die Script-Synchronisierung verwenden sollten

• Wenn Sie Ihren bevorzugten Texteditor verwenden oder Code in die Versionskontrolle einpflegen möchten, aber Studio für alles andere nutzen möchten, ist die Script-Synchronisierung eine gute Wahl. Sie funktioniert auch mit Roblox' integrierten Kollaborationstools, die bei vielen Drittanbieter-Tools oft nicht unterstützt werden.

  Die Script-Synchronisierung funktioniert gut mit bestehenden Roblox-Projekten, da sie eine zusätzliche Funktion ist, anstatt eine umfassende Änderung daran, wie Sie das Projekt verwalten.

• Wenn Sie Ihr gesamtes Projekt (nicht nur den Code) in die Versionskontrolle einpflegen oder Ihr Dateisystem als maßgebliche Quelle für Ihr Projekt verwenden möchten, sind Drittanbieter-Tools wie Rojo die bessere Wahl.

Script-Synchronisierung einrichten

1. Wählen Sie im Explorer einen oder mehrere Ordner aus, die Sie synchronisieren möchten.

2. Klicken Sie mit der rechten Maustaste und wählen Sie Script-Synchronisierung ⟩ Mit Verzeichnis synchronisieren.

   

3. Wählen Sie ein Verzeichnis auf Ihrem Computer (oder erstellen Sie ein neues) und klicken Sie auf Speichern.

4. Klicken Sie in Studio erneut mit der rechten Maustaste auf den Ordner und wählen Sie Script-Synchronisierung ⟩ Im Explorer anzeigen (Windows) oder Im Finder anzeigen (macOS).

5. Öffnen Sie das Verzeichnis in Ihrem bevorzugten Texteditor.

   Alternativ können Sie mit der rechten Maustaste auf ein einzelnes Skript in Studio klicken und In externem Editor öffnen auswählen.

Sie können einzelne Skripte synchronisieren, jedoch empfehlen wir dringend, Ordner zu synchronisieren. Wenn Sie einen Ordner synchronisieren, synchronisiert die Script-Synchronisierung automatisch seine untergeordneten Ordner und Skripte, sodass Sie Skripte erstellen, löschen und umbenennen können, ohne die Synchronisierung jedes Mal aktivieren zu müssen.

Nachdem Sie die Script-Synchronisierung eingerichtet haben, möchten Sie höchstwahrscheinlich eine LSP-Erweiterung hinzufügen zu Ihrem Texteditor.

Wichtige Tipps

• Die Script-Synchronisierung synchronisiert nur Script, LocalScript, ModuleScript und Folder Instanzen. Alle anderen Instanzen in einem synchronisierten Ordner werden ignoriert. Vermeiden Sie die Synchronisierung von Ordnern, die Skripte zusammen mit anderen Instanzen enthalten.

• Synchronisieren Sie keine Skripte, die Attribute oder Tags haben. Die Script-Synchronisierung ignoriert diese, was zu Datenverlust führen kann, wenn Sie Skripte erstellen oder löschen oder beginnen, mit einer älteren Version Ihrer Dateien auf der Festplatte zu synchronisieren.

• Die Script-Synchronisierung erfordert, dass die Namen der Skripte mit Ihrem Dateisystem kompatibel sind – keine doppelten Namen oder nicht unterstützten Zeichen. Wenn Studio auf eines dieser Probleme stößt, wird ein Fehler angezeigt und Sie werden aufgefordert, die Situation zu beheben, bevor die Synchronisierung fortgesetzt werden kann.

• Wenn sich während des Schließens von Studio synchronisierte Dateien oder Ordner ändern, fragt Studio Sie, wie Sie die Situation beim erneuten Öffnen des Ortes lösen möchten.

• Das Löschen einer obersten (oder „Root“) Instanz – der Instanz, die Sie ursprünglich synchronisiert haben – auf Ihrem lokalen Laufwerk kann dazu führen, dass Studio einen Fehler anzeigt. Um eine oberste Instanz zu löschen:

  1. Klicken Sie in Studio mit der rechten Maustaste auf das Skript oder den Ordner und wählen Sie Script-Synchronisierung ⟩ Synchronisierung stoppen.
  2. Wählen Sie die Option Datei(en) löschen oder Ordner(e) löschen, um die Instanz von Ihrem lokalen Laufwerk zu löschen.
  3. Löschen Sie das Skript oder den Ordner in Studio.

  Sie können untergeordnete Instanzen in Studio oder auf Ihrer lokalen Festplatte löschen, ohne die Synchronisierung zu deaktivieren, und die Löschung wird synchronisiert, wie Sie es erwarten würden.

Einen Sprachserver einrichten

Sprachserver bieten Ihrem Texteditor sprachspezifische Funktionen wie Autocomplete, Typüberprüfung, „Gehe zu Definition“ und mehr. Für VS Code empfehlen wir Luau Language Server.

Erweiterungen des Sprache-Server-Protokolls (LSP) müssen die Hierarchie des Datenmodells eines Projekts verstehen, um ordnungsgemäß zu funktionieren. Die VS Code-Erweiterung enthält ein begleitendes Studio-Plugin (Luau Language Server Companion), das diese Daten bereitstellt.

Wir empfehlen dringend, beide zu installieren. Wenn Sie die VS Code-Erweiterung und das begleitende Studio-Plugin verwenden, funktionieren die Sprachfunktionen in VS Code korrekt, während Sie die Script-Synchronisierung verwenden.

Empfohlene Erweiterungen

• Roblox Luau LSP und Luau Language Server Companion - Sprachfunktionen (siehe oben)
• selene - Statische Codeanalyse (Linting)
• StyLua - Automatische Codeformatierung

Synchronisierungsregeln

Bei der Synchronisierung einer Instanz mit untergeordneten Elementen mit einem Verzeichnis auf der Festplatte synchronisiert Studio automatisch die Erstell-, Umbenennungs-, Verschiebungs- und Löschvorgänge von untergeordneten Elementen mit den entsprechenden Dateien und Ordnern auf der Festplatte. Dieser Ansatz ermöglicht es Ihnen, Ihren Code zu pflegen, ohne manuell die Synchronisierung für einzelne Skripte zu stoppen und zu starten.

Auf der Festplatte verwendet die Script-Synchronisierung die folgenden Regeln, um die verschiedenen Arten von Skripten voneinander zu unterscheiden.

Einstellungen

Die Script-Synchronisierung hat mehrere Einstellungen im Fenster Studio-Einstellungen (AltS oder ⌥S). Die Standardeinstellungen sind für die meisten Anwendungsfälle geeignet.