Skript-Editor

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Der Skript-Editor in Studio ist das Hauptwerkzeug für das Skripten auf Roblox.Es ist eine selbst verbessernde Umgebung, die dir hilft, hochwirksamen Code zu schreiben, deine Entwicklungszeit zu verkürzen und deine Erfahrungen zu wiederholen.Es kann deine Skript-Erfahrung verbessern, indem:

Der Skript-Editor unterstützt alle Arten von Skripten und öffnet sich automatisch, wenn du ein neues Skript erstellst oder ein vorhandenes Skript im Explorer-Fenster doppelt anklickst.

Funktionen zur automatischen Vervollständigung

Die Autovervollständigungsfunktionen des Skripteditors generieren Code-bezogene Informationen, die Ihre Programmiereffizienz verbessern können, wie:

  • Informierte Vorschläge darüber, wie Phrasen abgeschlossen werden, wenn du sie eingibst, die für das Erlebnis-Datenmodell kontextbezogen sind.Wenn du beispielsweise ein Model in Workspace mit dem Namen RocketShip hast, schlägt die automatische Vervollständigung vor, RocketShip einzugeben, wenn du workspace.roc tippst, und zeigt an, dass es sich um ein Model handelt.

    Autocomplete showing suggestions based on the experience's data model
  • Füllen Sie Namen automatisch aus für Variablen und Funktionen, die Sie erklären, und helfen Sie, lästige Tippfehler zu vermeiden.

    Autocomplete showing suggestions based on a previously declared variable.
  • Dokumentations-Popups mit Codebeispielen , die ähnlich sind wie die auf der Engine API-Referenz, die Ihnen Kontext über die Verwendung der API geben.

    Autocomplete showing suggestions based on a Roblox Engine API.
  • Tooltips beim Überfahren , die Sie mit Ihrer eigenen definierten Dokumentation anpassen können.

    Autocomplete showing custom documentation.
  • On-Hover-Skript-Analysediagnostik mit Informationen, die du verwenden kannst, um Fehler zu beheben.

    Autocomplete showing diagnostic information.
  • Funktionssignaturen , wenn du ein Argument eingibst, das dir eine Referenz für seine Parameter und Rückgabewerte liefert.

    Autocomplete showing function signature

Kodierung navigation

Gehe zur Erklärung

Du kannst zu der Erklärung einer Funktion oder Variable springen, indem du Ctrl auf Windows oder auf Mac klickst, wenn du die Anruf anklickst, oder indem du mit der rechten Maustaste auf seinen Anruf klickst und dann auf Gehe zur Erklärung gehst.

Go to Declaration workflow on a declared function

Skriptfunktionsfilter

Der Skriptfunktionsfilter zeigt eine Liste aller Funktionen an, die in einem Skript deklariert wurden.Um es zu öffnen, drücke AltF auf Windows oder F auf Mac.Wenn die Liste geöffnet ist, kannst du die Unterschriften für jede Funktion durchsuchen, sie nach Namen filtern und doppelt anklicken, um zu ihrer Erklärung zu springen.

Script Function Filter showing all functions inside a script

Finden und ersetzen

Das Suchen/Ersetzen -Widget lässt dich Code in einem offenen Skript finden und ersetzen.Das Widget unterstützt das Übereinstimmen von Fall, das Übereinstimmen des gesamten Wortes und die Suche nach regulären Ausdrücken.Um es zu öffnen, drücke CtrlF auf Windows oder F auf Mac.

Find/Replace widget labeled

Echtzeit-Feedback

Skriptanalyse

Das Skript-Analyse-Fenster , zugänglich von der Ansicht-Registerkarte, führt eine statische Analyse Ihrer Skripte durch und zeigt aktive Fehler und Warnungen an.Für weitere Informationen zu Fehlern und Warnungen siehe die Luau-Linting-Dokumentation.

Script with various marked errors
Skriptfehler hervorgehoben im Skript-Editor
Script Analysis window with details on marked errors from script
Fehler werden im Skript-Analysen-Fenster erklärt

Ausgang

Das Ausgabe -Fenster, zugänglich von der Ansicht-Registerkarte, zeigt Fehler an, die durch das Ausführen von Skripten aufgezeichnet wurden, Nachrichten von der Roblox-Engine, Nachrichten von Anrufen bei print() und Fehler von Anrufen bei warn().Für Details zur Konfiguration für Ihren Workflow siehe Ausgabe.

Code-Hilfe

Code-Assistenz ist eine Funktion, die Linien oder Funktionen des Codes vorschlägt, wenn du siebst, hilft dir, effizienter zu codieren und dich zu konzentrieren.Basierend auf Kontexten aus deinem Kommentar und Code werden Vorschläge auf zwei Arten ausgelöst:

  • Automatisch , wenn du für ein paar Sekunden auf einer Linie anhältst und das AI-Modell genügend Kontext für einen Vorschlag hat.
  • Manuell mit Tastenkürzel Alt auf Windows oder auf Mac (Sie können dieses Tastenkürzel anpassen).

Drücke Tab, um einen Vorschlag zu akzeptieren, oder ignoriere ihn, indem du weiter tippst.Derzeit muss dein Skript mindestens ein paar Zeilen Code enthalten, um einen Vorschlag auszulösen.

Verbessere Vorschläge

Um genauere und relevantere Vorschläge zu erhalten, wird empfohlen, dass Sie saubere Codierpraktiken befolgen, unabhängig von der Unterstützung, und:

  • Zerlegen Sie Ihren Code in kleinere Funktionen.
  • Verwende beschreibende Skriptnamen, die die allgemeine Absicht von dem, was jedes Skript tut, einfangen.Beispielsweise benenne ein Skript SyncCustomSounds statt nur Sounds .
  • Weise beschreibende Namen für Parameter, Funktionen und Skripte zu.Zum Beispiel benenne ein Teil GreenSphere statt einfach grs oder benenne eine Funktion statt ».Die Verwendung benannter Funktionen gegenüber anonymen Funktionen kann auch bessere Hinweise erzeugen.
  • Konsistent enthalten gut geschriebene Kommentare, die die zu implementierende Aufgabe beschreiben und die Eingänge/Ausgänge beschreiben, die es sein sollte.
    • Betrachte die Möglichkeit, einige Beispielanrufe mit erwarteten Ergebnissen in Kommentaren einzuschließen.
    • Schlage vor, wie ein Problem gelöst werden kann, zum Beispiel -- Use raycast.
    • Verwende die genaue Funktions- oder Variablenname, den du definiert hast, zum Beispiel -- Create 10 greenSphere objects anstelle von -- Create 10 spheres.
  • Wenn du ein Neuling in der Skriptierung bist, beginne mit einfachen Projekten wie "mache den Spieler springen, wenn er das Teil berührt" oder nutze das Tool, um kleine Code-Snippets zu generieren, die du erweitern kannst, wenn dein Wissen wächst.

Beschränkungen

Das Tool hilft, grundlegende Codieraufgaben zu automatisieren, aber es schlägt nicht immer den perfekten Code vor. Bekannte Einschränkungen umfassen:

  • Manuelles Auslösen erzeugt nicht immer einen Vorschlag .
  • Vorschläge werden von einem Korpus von Code maschinell gelernt und können daher einige Einschränkungen des Codes widerspiegeln, auf dem sie trainiert wurden.Vorschläge können beispielsweise keine neueren APIs zugunsten älterer APIs verwenden oder sie können Lua statt Luau verwenden.
  • Das Werkzeug kann falsche oder irreführende Informationen generieren, die für Ihren Zweck nicht nützlich sind.
  • Interne Filter versuchen, beleidigende Sprache zu blockieren, aber sie sind nicht umfassend und es besteht die Möglichkeit, dass das Tool beleidigende oder verzerrte Informationen generiert.
  • Die Vorschläge können bei den Benutzern gleich, ähnlich oder unterschiedlich sein, auch mit den gleichen Eingabeaufforderungen. Ihr Code wird jedoch niemals mit anderen geteilt.
  • Die Empfehlung kann aufgrund der begrenzten Länge der Ausgabe aus den Lernmodellen unvollständig sein.
  • Es gibt ein tägliches Limit für die Anzahl der Vorschläge und sobald das Limit erreicht ist, erhältst du keine Vorschläge mehr bis zum nächsten Tag.

Code-Privatsphäre

Derzeit verwendet Roblox keine nicht-öffentlichen Daten, um die Lernmodelle zu trainieren.Das Tool verwendet nur einen kleinen Teil der freien Marktplatzressourcen für das Tuning großer Sprachmodelle und der Unter集合 hat verschiedene Prüfungen für Qualitäts- und Sicherheitsfilter bestanden.

Darüber hinaus werden alle Vorschläge durch das AI-Modell generiert und werden nicht von einem Benutzer auf den anderen übertragen.Da dein Code nicht für das Modelltraining verwendet wird, wird es anderen Benutzern von Code-Assist nicht vorgeschlagen, mit der Ausnahme, dass Code auf freie Marktplätze veröffentlicht wird.

Mehrfach-Cursor

Der Skript-Editor unterstützt die Verwendung mehrerer Cursoren, um Änderungen gleichzeitig vorzunehmen.Du kannst Cursor basierend auf deinen Bedürfnissen hinzufügen, indem du mit einem Mausklick oder Tastaturkürzel klickst.Der initiale Cursor wird als primärer Cursor bezeichnet und zusätzliche Cursor werden als sekundäre Cursor bezeichnet.

  • Bearbeitet, die du an der primären Cursor-Kopie an die sekundären Cursor durchführst.Jede Bearbeitung zählt als eine Aktion, sodass die Rückgängigmachung/Wiederholung einer Bearbeitung für alle Cursor gilt.
  • Widgets wie Autovervollständigung erscheinen auf der primären Maus, aber nicht auf den sekundären Mäusen.
  • Alle Standard-Tastaturkürzel für die Skriptbearbeitung funktionieren mit mehreren Cursor-Editorn, einschließlich Code-Indenterung, Kommentarumschaltung und Löschung von Zeilen.

Die folgende Tabelle fasst mehrere Cursor-Workflows und ihre Kurzwege zusammen.

BefehlFensterMac
Cursor an der Mausposition hinzufügen/entfernen Alt + klicken + klicken
Entferne den zuletzt hinzugefügten Cursor CtrlUU
Cursor hinzufügen/modifizieren bei Mausziehen Alt + ziehen + ziehen
Cursor oben/unten hinzufügen CtrlAlt  / CtrlAlt  /
Cursor zum nächsten passenden Auswahl hinzufügen CtrlDD
Füge einen Cursor zu jeder passenden Auswahl hinzu ShiftAltLShiftL
Säule/Block auswählen ShiftAlt  + ziehenShift  + ziehen
Selektionen in Zeilen aufteilen ShiftAltIShiftI

Cursor hinzufügen

Du kannst Cursor mit einer Kombination aus Tastaturkürzeln und Mausmanövern hinzufügen.Verschmelzen Cursoren, wenn sie den gleichen Raum einnehmen, z. B. wenn du Cursoren mit Pfeiltasten hinzufügst oder alle Zeichen zwischen den Cursoren löscht.

An der Mausposition

Um einen Cursor an der Position des Mauspointers hinzuzufügen:

  1. Halte Alt auf Windows oder auf Mac.

  2. Klicken Sie, wo Sie den Cursor hinzufügen möchten.

Mit Mausziehen

Du kannst die Maus ziehen, um einen Cursor zu einer Auswahl hinzuzufügen, eine mehrzeilige Auswahl in Blöcke aufzuteilen oder Blöcke von Code/Leerzeichen auszuwählen.

Um einen Cursor zu einer Auswahl von Code durch Ziehen hinzuzufügen:

  1. Halte Alt auf Windows oder auf Mac.

  2. Klicke und ziehe deine Maus über die Auswahl von Code.

Über und unter dem primären Cursor

Um einen Cursor direkt über oder unter dem primären Cursor hinzuzufügen:

  1. Drücke und halte CtrlAlt auf Windows oder auf Mac.

  2. Drücke die oder Pfeile.

Zu passenden Auswahlmöglichkeiten

Du kannst Cursoren zu allen Übereinstimmungen einer Auswahl oder zum nächsten/vorherigen Übereinstimmung hinzufügen und optional umschalten, ob Übereinstimmungen groß- und kleinschreibungssensitiv sind oder das gesamte Wort übereinstimmen.

Um einen Cursor für alle Übereinstimmungen eines ausgewählten Teils hinzuzufügen:

  1. Wählen Sie den Code aus, nach dem Sie Übereinstimmungen suchen möchten.

  2. Drücken Sie ShiftAltL auf Windows oder ShiftL auf Mac.

Cursor entfernen

Du kannst Cursoren mit den folgenden Tastaturkürzeln und Mausmanövern entfernen.Alternativ kannst du die Mehrfach-Cursor-Bearbeitung beenden, indem du Esc drückst.

An der Mausposition

Um einen Cursor zu entfernen:

  1. Drücke und halte Alt auf Windows oder auf Mac.

  2. Klicken Sie auf den Cursor, den Sie entfernen möchten.

Neuesten hinzugefügt

Um den kürzlich hinzugefügtesten Cursor zu entfernen, drücke CtrlU auf Windows oder U auf Mac.

Cursor kopieren und einfügen

Das Kopieren einer Auswahl an Code beinhaltet die Cursor darin.Das Verhalten der Einfügung hängt von der Anzahl der Cursoren an der Quelle und der Anzahl der Cursoren am Ziel ab:

  • Wenn die Anzahl der Cursoren gleich ist, wird jeder kopierte Cursor an jeden entsprechenden Ziel-Cursor geklebt.
  • Wenn die Anzahl der Cursoren unterschiedlich ist, erhält jeder Cursor am Ziel jede einzelne Einfügung mit jedem kopierten Cursor als neue Zeile.

On-Type-Formatierung

Durch Drücken von Eingabe/Zurück wird jeder Cursor an der neuen Linie im Verhältnis zur vorherigen Linie automatisch indentiert.Wenn die vorherige Zeile mit einem unvollständigen Block beginnt, versucht der Formatter, sie zu vervollständigen.

Editor-Einstellungen

Viele Anpassungsoptionen sind über Datei > Studio-Einstellungen ( AltS auf Windows; S auf Mac) zugänglich).

A close up view of the Studio Settings window with the Script Editor tab selected.

Gewöhnlich modifizierte Optionen umfassen:

AuswahlBeschreibung
Schrift Schriftart und Größe für Code im Editor.
Tab-Breite Anzahl der Plätze, die eine Tab Indenterstellung darstellen.
Indenter mit Leerstellen verwenden Wenn aktiviert, werden Leerstellen mit der Breite von Tab-Breite eingefügt, indem Tab gedrückt wird.
Text-Wrappe Wenn aktiviert, umfassen längere Codezeilen die nächste Zeile.
Skript-Editor Farbpräferenz Farbpräsetzung für Code-Elemente, Auswahlfarben und mehr.Nachdem du ein Voreinstellung gewählt hast, kannst du spezifische Farben für Optionen wie Auswahlfarbe und Kommentarfarbe festlegen.

Tastatzkürzel

Der Skript-Editor hat die folgenden Tastaturkürzel.Du kannst auch auf viele Befehle von der Skript-Registerkarte zugreifen, die immer in der Studio-Symbolleiste angezeigt wird, wenn du ein Skript anzeigst oder bearbeitest.

BefehlFensterMac
Skript schließen CtrlWW
Letztes geschlossenes Skript erneut öffnen CtrlShiftTShiftT
Schnell öffnen CtrlPP
Skript im Explorer anzeigen CtrlAltKK
Hineinzoomen Ctrl==
Rauszoomen Ctrl--
Skript-Zoom zurücksetzen Ctrl00