Neu seit dem Update vom November 2025: Die Player-Konsole hat einen zusätzlichen Reiter „Interface“, und sie funktioniert wieder in Linux-AppImage-Builds.
Allgemein
Die Player-Konsole blendest du mit der Tab-Taste ein und aus. Sie dient vor allem dazu, ein Spiel schneller zu testen und zu prüfen, ob Animationen und Aktionen wie erwartet starten und enden. Außerdem hilft sie dir, Fehler im Spiel zu finden. Sie steht nur in nicht kompilierten Spielen zur Verfügung (damit fertige Spiele nicht analysiert werden können).
Achte darauf, dass die Schriftart der Konsolenausgabe alle nötigen Sonderzeichen enthält (z. B. #'".,:>!/%()|- ). Sonst werden diese Zeichen nicht ausgegeben und Informationen fehlen.
Bei den Schlüsselwörtern spielt die Groß-/Kleinschreibung keine Rolle (es ist egal, ob du 'SET', 'set' oder 'Set' schreibst). Gibst du ein Visionaire-Objekt an, muss der Name aber exakt geschrieben sein. Enthält ein Name Leerzeichen, muss er in Anführungszeichen stehen (z. B. "open door"). Ohne Leerzeichen kannst du die Anführungszeichen auch weglassen.
Ist die Ausgabe der Konsole zu lang für den Bildschirm, kannst du mit 'Bild auf'/'Bild ab' scrollen. Mit 'Strg' + 'Pos1'/'Ende' springst du zur ersten bzw. letzten Seite der Ausgabe. Mit 'Alt' + 'Pfeil hoch'/'Pfeil runter' holst du zuletzt eingegebene Befehle zurück, damit du einen Befehl nicht erneut eintippen musst.
Die Konsole bietet außerdem eine Befehlsvervollständigung, mit der du Befehle schneller eingibst. Unter dem Cursor erscheint eine Liste möglicher Optionen für die aktuelle Eingabe. Mit 'Pfeil hoch'/'Pfeil runter' wählst du einen Eintrag und übernimmst ihn mit 'Enter' (oder der Tab-Taste). Drückst du 'Esc', während die Liste angezeigt wird, verschwindet sie. Gibt es mehr Optionen als Platz, zeigen drei Punkte ("...") unten weitere Einträge an.
Befehlsübersicht
- CHANGE: wechselt den aktuellen Charakter, die Szene usw.
- SET: setzt Objekte, Eigenschaften usw.
- PRINT: gibt verschiedene Informationen in der Konsole aus
- SHOW: zeigt ein Visionaire-Objekt an (Charakter, Szene, ...)
- ADD: fügt ein Item hinzu
- REMOVE: entfernt ein Item, eine Aktion oder eine Animation
- CLEAR: setzt eine Konsoleneigenschaft zurück oder leert die Logdatei
Befehlsdetails
In dieser Dokumentation werden alle Schlüsselwörter in Großbuchstaben geschrieben. In Kleinbuchstaben geschriebene Wörter sind Namen eines Objekts (wie im Editor angezeigt) oder haben eine besondere Bedeutung. Wenn es für einen Befehl mehrere Optionen gibt, werden alle Optionen in eckige Klammern ('[' und ']') geschrieben und durch einen senkrechten Strich ('|') getrennt.
CHANGE
SET CHARACTER character
Legt den aktuellen Charakter fest (den der Spieler steuert) und wechselt in die Szene dieses Charakters.
Beispiel:
CHANGE CHARACTER Mother
Wechselt zum Charakter 'Mother'.
CHANGE SCENE scene [object]
Wechselt in eine Szene und setzt den aktuellen Charakter auf das angegebene Szenenobjekt. Ist kein Szenenobjekt angegeben, wird der Charakter auf das erste Objekt der Szene gesetzt (in der Reihenfolge der Objektliste im Editor).
Beispiel:
CHANGE SCENE Forest Grave
Wechselt in die Szene 'Forest' und setzt den aktuellen Charakter auf das Szenenobjekt 'Grave'.
SET
SET CONDITION condition [TRUE|FALSE]
Setzt eine Bedingung auf wahr oder falsch.
Beispiel:
SET CONDITION "open door" TRUE
Setzt die Bedingung "open door" auf wahr.
SET VALUE value number
Setzt einen Wert auf eine Zahl.
Beispiel:
SET VALUE account 1000
Setzt den Wert account auf 1000.
SET CURRENTCHARACTER character
Legt den aktuellen Charakter fest (den der Spieler steuert) und wechselt in die Szene dieses Charakters.
Beispiel:
SET CURRENTCHARACTER Mother
Wechselt zum Charakter 'Mother'.
SET CHARACTERTOOBJECT character object
Setzt einen Charakter auf ein Szenenobjekt. Das Szenenobjekt wird zuerst in der aktuellen Szene gesucht, wird es dort nicht gefunden, in allen Objekten aller Szenen.
Beispiel:
SET CHARACTERTOOBJECT Daniel "locker (closed)"
Setzt den Charakter 'Daniel' auf das Objekt 'locker (closed)'.
SET CHARACTERTOSCENE character scene
Setzt einen Charakter in eine Szene, und zwar auf das erste Objekt der Szene (in der Reihenfolge der Objektliste im Editor).
Beispiel:
SET CHARACTERTOSCENE Daniel Forest
Setzt den Charakter 'Daniel' in die Szene 'Forest'.
SET CHARACTERTOSCENEOBJECT character scene Object
Setzt einen Charakter auf ein Szenenobjekt. Das Objekt wird in der angegebenen Szene gesucht.
Beispiel:
SET CHARACTERTOSCENEOBJECT Daniel Forest Road
Setzt den Charakter 'Daniel' auf das Objekt 'Road' in der Szene 'Forest'.
SET OUTFIT character outfit
Legt das Outfit eines Charakters fest.
Beispiel
SET OUTFIT Daniel "with hat"
Setzt das Outfit 'with hat' als aktuelles Outfit des Charakters 'Daniel'.
SET TRACE [ANIMATION|ACTION] [ON|OFF]
Schaltet erweiterte Meldungen in der Logdatei ein oder aus.
- ANIMATION Meldungen zum Starten und Stoppen von Animationen.
- ACTION Meldungen zum Starten und Stoppen von Aktionen.
- ON schaltet den gewählten Meldungstyp ein, OFF schaltet ihn aus.
SET CONSOLEALPHA alpha
Legt die Deckkraft (Alpha) der Konsolenschrift fest. alpha muss eine Zahl zwischen 0 (= transparent) und 100 (= deckend) sein.
Beispiel:
SET CONSOLEALPHA 50
Setzt die Konsolenschrift auf halbe Transparenz.
SET CONSOLEFONT fontnr
Legt die Schriftart der Konsole fest. fontnr ist die Position der Schriftart in der Schriftartenliste (wie im Editor angezeigt).
Beispiel:
SET CONSOLEFONT 3
Legt die dritte Schriftart als Konsolenschrift fest.
SET CONSOLEBGCOLOR color
Legt die Farbe des Felds unter der Konsolenausgabe fest. color ist eine Folge von 3 hexadezimalen Farbwerten (jedes Paar steht für Rot, Grün oder Blau). Alternativ kannst du eine der vordefinierten Farben angeben: BLACK, BLUE, CYAN, GRAY, GREEN, DARKBLUE, DARKGREEN, DARKRED, PURPLE, RED, WHITE und YELLOW.
Beispiel:
SET CONSOLEBGCOLOR FF0040
Setzt die Farbe des Felds auf Rot mit leichtem Blaustich (Rot = 'FF hex', Grün = '00 hex', Blau = '40 hex'). Das entspricht Rot = 255, Grün = 0 und Blau = 64.
Beispiel:
SET CONSOLEBGCOLOR GREEN
Setzt die Farbe des Feldes auf Grün.
SET CONSOLEBGALPHA alpha
Legt die Deckkraft (Alpha) des Felds unter der Konsolenausgabe fest. alpha muss zwischen 0 (= transparent) und 100 (= deckend) liegen.
Beispiel:
SET CONSOLEBGALPHA 20
Setzt die Sichtbarkeit des Felds auf 20 Prozent.
SET CONSOLECOMMANDBGCOLOR color
Legt die Farbe des Felds unter der Befehlszeile der Konsole fest. color ist eine Folge von 3 hexadezimalen Farbwerten (jedes Paar steht für Rot, Grün oder Blau). Alternativ kannst du eine der vordefinierten Farben angeben: BLACK, BLUE, CYAN, GRAY, GREEN, DARKBLUE, DARKGREEN, DARKRED, PURPLE, RED, WHITE und YELLOW.
SET CONSOLECOMMANDBGALPHA alpha
Legt die Deckkraft (Alpha) des Felds unter der Befehlszeile der Konsole fest. alpha muss zwischen 0 (= transparent) und 100 (= deckend) liegen.
SET CONSOLETEXTWRAP [ON|OFF]
Aktiviert/Deaktiviert den automatischen Zeilenumbruch der Konsolenausgabe.
- ON Zu lange Zeilen werden in mehrere Zeilen aufgeteilt.
- OFF Zu lange Zeilen werden am Bildschirmrand abgeschnitten.
Beispiel:
SET CONSOLETEXTWRAP OFF
Schaltet den automatischen Zeilenumbruch für zu lange Ausgaben aus.
PRINT ANIMATIONS
Gibt alle laufenden Animationen aus. So kannst du prüfen, ob noch Animationen anderer Szenen laufen.
PRINT ACTIONS
Gibt alle laufenden Aktionen aus. So kannst du prüfen, ob alle Aktionen wie vorgesehen laufen (und beendet werden).
PRINT CONDITIONS
Gibt alle Bedingungen des Spiels mit ihrem aktuellen Wert aus, sortiert nach Namen.
PRINT VALUES
Gibt alle Werte des Spiels mit ihrem aktuellen Inhalt aus, sortiert nach Namen.
PRINT SCENES
Gibt alle Szenen des Spiels aus, sortiert nach Namen.
PRINT CHARACTERS
Gibt alle Charaktere des Spiels aus, sortiert nach Namen.
PRINT CACHE
Zeigt den Inhalt des Bildcaches. Der Cache hält Bilder im Speicher (bis er voll ist), damit sie schneller geladen werden.
PRINT LOG
Gibt den Inhalt der Logdatei aus ('messages.log' im Verzeichnis des Players). Achte darauf, dass die Logdatei nicht zu groß wird (siehe Befehl CLEAR).
PRINT TEXTURES
Gibt Informationen zu den Texturen im Grafikspeicher aus.
PRINT SOUNDS
Gibt alle geladenen Sounds aus. Diese Sounds werden entweder gerade abgespielt oder liegen im Speicher (z. B. Schrittgeräusche).
SHOW
SHOW ANIMATIONDETAILS [ON|OFF]
Zeigt alle aktuell geladenen Animationen an. Die gewählte Animation erscheint in einem Rechteck (256x256) mit dem aktuell aktiven Frame. Solange die Anzeige aktiv ist, blätterst du mit 'Bild auf'/'Bild ab' durch die Animationen. Währenddessen ist keine andere Ausgabe möglich.
Beispiel:
SHOW ANIMATIONDETAILS ON
Schaltet die Anzeige der Animationen ein.
SHOW OBJECTANIMATION animation
Startet eine Animation eines Szenenobjekts.
Beispiel:
SHOW OBJECTANIMATION waterfall water
Startet die Animation 'water' des Szenenobjekts 'waterfall'.
SHOW CHARACTERANIMATION character animation
Startet eine Charakteranimation. Die Animation wird im angegebenen Charakter gesucht.
Beispiel:
SHOW CHARACTERANIMATION Daniel "waving (front)"
Startet die Animation 'waving (front)' des Charakters 'Daniel'.
SHOW SCENE scene
Zeigt eine Szene an. Die Position des aktuellen Charakters ändert sich nicht.
Beispiel:
SHOW SCENE Forest
Zeigt die Szene 'Forest'.
SHOW CHARACTER character
Zeigt einen Charakter an. Die aktuelle Szene wechselt zu der Szene, in der sich der Charakter befindet. Der aktuelle Charakter ändert sich nicht.
Beispiel:
SHOW CHARACTER Mother
Wechselt in die Szene, in der sich der Charakter 'Mother' befindet.
SHOW TEXTURES [ON|OFF]
Zeigt alle Texturen im Grafikspeicher an. Solange die Anzeige aktiv ist, blätterst du mit 'Bild auf'/'Bild ab' durch die Texturen. Währenddessen ist keine andere Ausgabe möglich.
Beispiel:
SHOW TEXTURES ON
Schaltet die Anzeige der Texturen ein.
ADD
ADD ITEM item
Fügt das Item dem Interface des aktuellen Charakters hinzu. Ist es dort bereits vorhanden, wird es kein zweites Mal hinzugefügt.
Beispiel:
ADD ITEM key
Fügt das Item 'key' dem Interface des aktuellen Charakters hinzu.
REMOVE
REMOVE ITEM item
Entfernt das Item aus dem Interface des aktuellen Charakters. Ist es dort nicht vorhanden, passiert nichts.
Beispiel:
REMOVE ITEM key
Entfernt das Item 'key' aus dem Interface des aktuellen Charakters.
EXEC
Führt einen Skriptbefehl aus. Eine ausführliche Beschreibung des Scriptings (mit allen Befehlen) findest du in der Skriptdokumentation.
Beispiel:
EXEC game:setValue(VGameFadeDelay, 1000)
Setzt die Überblendzeit für den Wechsel in eine neue Szene auf 1000 Millisekunden.
CLEAR
CLEAR LOG
Leert die Logdatei vollständig ('messages.log' im Verzeichnis des Players).
CLEAR TRACE [ANIMATION|ACTION]
Schaltet das Schreiben erweiterter Meldungen in die Logdatei aus. Der Befehl entspricht SET TRACE [ANIMATION|ACTION] OFF.