API Referenz

Vollständige API Referenz

Auch in Kurzform im Editor selbst verfügbar:

Asset-Konstruktoren

Konstruktoren erstellen die Hauptasset-Typen, die vom Editor verwendet werden. Wenn du einen einer Variablen zuweist, erkennt der Editor ihn und ermöglicht es dir, den passenden Asset-Editor mit Strg+Klick zu öffnen.

Listenmethoden

Erstelle Listen mit [] oder [value1, value2, ...]. Lese und überschreibe Einträge mit list[index] und iteriere mit for (var i = 0; i < list.length(); i = i + 1).

Operatoren

Operatoren sind kleine Symbole, die gängige Berechnungen durchführen. Der Modulo-Operator ist besonders nützlich für das Wrappen von Timern, Indizes, Animationsschritten oder sich wiederholenden Mustern.

Objekt-Eigenschaften

Objekte sind die Dinge, die dein Skript normalerweise während des Spiels bewegt und ändert. Diese Funktionen lesen oder aktualisieren die Position, das Sprite, das Kollisionsverhalten, die Schicht und den visuellen Farbton eines Objekts.

Sprite-Funktionen

Sprite-Funktionen ermöglichen es, den Sprite-Pixeldaten und die Animationsgeschwindigkeit zu inspizieren oder zu modifizieren. Die meisten Spiele zeichnen Sprites im Editor, aber diese Funktionen sind nützlich für prozedurale Effekte, Debugging oder einfache Laufzeitanpassungen.

Animationsfunktionen

Animationsfunktionen arbeiten an Objekten, die Sprites mit mehreren Frames verwenden. Verwende sie, wenn du willst, dass Code die aktuelle Animationsframe inspiziert oder gezwungen wird.

Transformationsfunktionen (Flip/Rotation)

Transformationsfunktionen ändern, wie das Sprite eines Objekts gezeichnet wird, ohne das Sprite selbst zu bearbeiten. Sie sind gut, um ein Sprite in mehreren Richtungen wiederzuverwenden.

Hinweis: Diese Transformationen werden nur zur Renderzeit angewendet. Sie beeinflussen nicht die Kollisionskästen oder tatsächlichen Sprite-Pixeldaten.

Kollisionsarten

Kollisionsarten entscheiden, wie ein Objekt an Kollisionsprüfungen teilnimmt. Wähle den Typ basierend auf der Rolle des Objekts: Wände sind normalerweise statisch, Spieler normalerweise dynamisch und Abholungen oft Trigger.

Szenenfunktionen

Szenenfunktionen steuern, welche Szene aktiv ist, welche Objekte sich darin befinden und szenenweite Einstellungen wie Hintergrundfarbe und Schwerkraft. Sie bieten auch Suchhilfen, um Objekte an Positionen oder nach Namen zu finden.

Audio-Wiedergabe

Audio-Wiedergabefunktionen starten und stoppen Audio-Assets aus Skripten. playAudio() gibt ein Handle zurück, sodass du später diese spezifische Wiedergabeinstanz stoppen oder überprüfen kannst.

Bildschirmfunktionen

Bildschirmfunktionen helfen, wenn du die Fenstergröße wissen oder zwischen Bildschirm-Pixeln und Weltpositionen umwandeln musst. Dies ist nützlich für Maus-Zielen, Klickerkennung und kamera-bewusste UI.

Fenster-Modus

Steuere den Fenster-Modus für exportierte Spiele. Diese Funktionen haben keine Wirkung, wenn du im Editor spielst (der Editor hat höhere Autorität über den Fensterzustand).

Beispiel:

func start() {
    // Setze den Fenster-Modus (WINDOW_MAXIMIZED ist der Standard für exportierte Spiele)
    setWindowMode(WINDOW_MAXIMIZED())
}

Hinweis: Wenn setWindowMode() in einem exportierten Spiel nie aufgerufen wird, ist der Standard WINDOW_MAXIMIZED.

UI-Funktionen

Die UI verwendet eine virtuelle Bildschirmauflösungsauflösung. Der Standard-UI-Raum ist 100 x 100. Die Schriftgröße kann für nachfolgende Text-Widgets mit uiPushFontSize(size) erhöht werden und mit uiPopFontSize() wiederhergestellt werden. Schriftfarben können mit uiPushFontColor(r, g, b[, a]) gestapelt werden, und UI-Elementfüllungen können mit uiPushElementColor(r, g, b[, a]) gestapelt werden. Wie bei der restlichen sofortigen UI gelten diese Überschreibungen während des Baus der UI des aktuellen Frames. Wenn die gepushte Größe 0 oder kleiner ist, verwendet die Engine die automatische Größe.

UI-Zustandskonstanten

UI-Funktionen geben Zustandskonstanten zurück, sodass Ihr Skript feststellen kann, ob ein Widget inaktiv, schwebend, gehalten oder geklickt wurde. Normalerweise ist UI_CLICKED() der Wert, den Sie für Schaltflächenaktionen überprüfen.

Kamera-Funktionen

Die Kameraposition repräsentiert das Zentrum der Ansicht. Der Zoom sorgt für eine konsistente vertikale Weltansicht unabhängig von der Bildschirmgröße.

Zoom-Verhalten: Der Zoom sorgt für eine konsistente vertikale Weltansicht unabhängig von der Fenstergröße oder dem Seitenverhältnis. Breitere Bildschirme zeigen mehr horizontal, aber dieselbe vertikale Menge.

Eingabe-Funktionen

Eingabefunktionen ermöglichen dem Spiel, auf den Zustand von Tastatur und Maus zu reagieren. Verwenden Sie Pressed für Einzelframe-Aktionen, Held für kontinuierliche Bewegungen und Released für Aktionen, die beim Loslassen einer Taste stattfinden.

Maus-Tastenkonstanten

Maus-Tastenkonstanten werden in die Maus-Eingabefunktionen übergeben. Sie machen den Code lesbarer als rohe Zahlen.

Tastenkonstanten

Tastenkonstanten werden in die Tastatureingabefunktionen übergeben. Die Engine stellt Buchstaben, Zahlen, Funktionstasten, Pfeile und eine kleine Menge gemeinsamer Sondertasten bereit.

Buchstaben: KEY_A() bis KEY_Z()

Zahlen: KEY_0() bis KEY_9()

Funktionstasten: KEY_F1() bis KEY_F12()

Sondertasten: | Konstante | Taste | |----------|-----| | KEY_SPACE() | Leertaste | | KEY_ENTER() | Enter/Return | | KEY_ESCAPE() | Escape | | KEY_TAB() | Tab | | KEY_BACKSPACE() | Rücktaste | | KEY_DELETE() | Löschen | | KEY_SHIFT() | Shift | | KEY_CTRL() | Steuerung | | KEY_ALT() | Alt | | KEY_LEFT() | Linke Pfeiltaste | | KEY_RIGHT() | Rechte Pfeiltaste | | KEY_UP() | Obere Pfeiltaste | | KEY_DOWN() | Untere Pfeiltaste | | KEY_HOME() | Pos1 | | KEY_END() | Ende |

Mathe-Funktionen

Mathe-Helfer decken häufige Berechnungen in Bewegung, Animation, Zufälligkeit und Wertgrenzen ab. Sie halten Skripte kürzer und einfacher zu lesen.

Utility-Funktionen

Utility-Funktionen sind allgemeine Helfer, die nicht zu einem bestimmten Asset-Typ gehören. print() ist besonders nützlich beim Lernen, da es zeigt, was Ihr Skript tut.

String-Funktionen

String-Funktionen arbeiten mit Textwerten. Zurzeit ist dieser Abschnitt absichtlich klein.

Speicherfunktionen

Speichern und Laden von Spieldaten in Dateien. Unterstützt Zahlen, Strings, Booleans und Listen (einschließlich verschachtelter Listen). Unterstützt keine Werte von Sprite, Scene, Object oder Audio.

Beispiel: Speichern und Laden des Spielerfortschritts

// Spielerdaten speichern
var playerData = [100, "Player1", true, [1, 2, 3]]
var savePath = getAppDataPath() + "/MyGame/save.dat"
if (save(savePath, playerData)) {
    print("Spiel gespeichert!")
}

// Spielerdaten laden
if (fileExists(savePath)) {
    var loaded = load(savePath)
    if (loaded != null) {
        var health = loaded[0]
        var name = loaded[1]
        var hasKey = loaded[2]
        var inventory = loaded[3]
    }
}

// Verschlüsseltes speichern (zum Verbergen von Daten vor alltäglicher Prüfung)
var secretData = ["secret", 12345]
save(getAppDataPath() + "/MyGame/config.dat", secretData, "binary", "mySecretKey")
var decrypted = load(getAppDataPath() + "/MyGame/config.dat", "mySecretKey")

// Textformat (menschlich lesbar, nützlich für Debugging)
save(getAppDataPath() + "/MyGame/debug.txt", playerData, "text")

Hinweise:

• Binärformat (Standard) ist kompakt und schneller
• Textformat ist menschlich lesbar, nützlich für Debugging
• Falscher Verschlüsselungsschlüssel gibt null zurück (Daten sind Müll)
• Verzeichnisse werden beim Speichern automatisch erstellt