DE Basic

Basic Runtime und IDE — Deutsch

Home · BASIC · UO API · A–Z · Examples · Languages

Basic IDE Runtime führt Skripte im Basic-Syntax aus und verbindet UO.*-Aufrufe mit ClassicUO. Die integrierte Entwicklungsumgebung basiert auf Eclipse Theia mit Monaco und einem Basic-Spracherweiterungsmodul.

Einstiegspunkt

Ein direkt gestartetes Skript benötigt:

SUB Main()
    UO.Print('Basic gestartet')
END SUB

Runtime indiziert beim Öffnen oder Ändern den gesamten Text: SUB, FUNCTION, Parameter, lokale und globale Deklarationen, API-Aufrufe, Diagnosemeldungen und Outline-Symbole. Die Position von Main und die Scrollposition des Editors spielen keine Rolle.

Bereiche der IDE

• Explorer — Dateien und ausgewähltes Skript;
• Editor — Basic-Quelltext;
• Outline — SUB und FUNCTION der ausgewählten Datei;
• Problems — Syntax- und Validierungsfehler mit Sprung zur Zeile;
• Output / Debug Console — chronologische Ausgabe;
• API Inspector — Dokumentation des ausgewählten Runtime-Elements;
• Variables / Watch / Call Stack — Werte eines angehaltenen Debuggers;
• API Manual — vollständiger Runtime-Katalog.

Die Bereiche sind größenveränderbar. Abgetrennte oder inaktive Panels sollen ihren Inhalt weiter anzeigen und aktualisieren.

Mehrere Skripte und Status

Mehrere Skripte laufen unabhängig. Grün bedeutet running, Gelb paused und Schwarz beziehungsweise die normale Themenfarbe stopped/ausgewählt. Run, Pause und Stop beziehen sich auf den in Explorer ausgewählten Skriptprozess. Das Schließen des IDE-Fensters beendet laufende Skripte nicht, solange ClassicUO Runtime weiterläuft; beim erneuten Öffnen wird der Zustand neu gelesen.

Run- und Debug-Befehle

Funktion	Taste	Wirkung
Run Current Script	F5	aktuelles Skript prüfen und starten
Start Script (SUB Main) / Run Without Debugging	Ctrl+F5	SUB Main() ohne Debug-Stopp starten
Start Debugging	F4	SUB Main() unter dem Debugger starten
Validate	F6	Syntax prüfen, nicht starten
Pause/Resume Current Script	F7	ausgewählten Prozess pausieren/fortsetzen
Continue	F8	nach Pause oder Breakpoint fortsetzen
Toggle Breakpoint	F9	Breakpoint der Zeile umschalten
Step Over	F10	aktuelle Anweisung ausführen
Step Into	F11	in aufgerufene SUB/FUNCTION wechseln
Step Out	Shift+F11	aktuelle Prozedur verlassen
Stop	Shift+F5	ausgewählten Prozess stoppen
Restart Debugging	Ctrl+Shift+F5	ausgewählten Prozess unter Debug neu starten
API Documentation for Symbol	Ctrl+F1	Manual zum Symbol öffnen

Stop All Scripts und Pause All Scripts wirken auf alle passenden Prozesse. Ein ausgegrauter Eintrag ist im aktuellen Zustand nicht anwendbar; Step-Befehle werden erst aktiv, wenn der Debugger auf einer ausführbaren Anweisung angehalten hat.

Schrittweises Debugging

Die tatsächlich auszuführende Zeile wird hervorgehoben. F10 folgt ausführbaren Anweisungen statt visuellen Textzeilen. F11 betritt eine Benutzerprozedur; Shift+F11 läuft bis zur Rückkehr. Exakte locals, globals, watches und frames sind im angehaltenen Zustand verfügbar; während des kontinuierlichen Laufs kann nur der letzte sichere Snapshot angezeigt werden.

Sprachunterstützung im Editor

• Completion zeigt vollständige UO.*-Syntax;
• ein Klick auf ein API-Element öffnet dessen Beschreibung;
• ein Doppelklick fügt die vollständige Form in den Editor ein;
• Ctrl-hover zeigt nur bei gedrücktem Ctrl eine kompakte Dokumentation;
• Tooltip-Text wird umgebrochen und innerhalb des Bildschirms gehalten.

Reaktionsfähigkeit von Runtime

Runtime verwendet vorbereitete Quelltext-Caches, getrennte Arbeitskontexte, kooperatives Yielding und begrenzte Arbeitseinheiten für den Spielthread. Das reduziert kurze UI-Blockierungen bei Basic-Makros. Ein Skript muss trotzdem in langen Schleifen UO.Wait(...) verwenden und aktive Endlosschleifen vermeiden.

Speichern

• neuer unbenannter Text → Autoload\Scripts;
• geöffnete Datei → ursprünglicher Pfad;
• Save All → alle geänderten Dokumente;
• vor Run wird ungespeicherter Inhalt zur Speicherung angeboten.