Benutzer-Werkzeuge

Webseiten-Werkzeuge


scripting:setup

Aufsetzen der Umgebung und Debugtools

Richte deine Entwicklungsumgebung richtig ein, für effizienteres und effektiveres Arbeiten!

Folgende Optionen sind möglich um das Coden für Siedler stark zu vereinfachen:

  1. Visual Studio Code installieren und einrichten
  2. Skripte extern laden
  3. Eine Funktionsreferenz mit den Parametern der Lua-API
  4. Das Debugscript aktivieren
  5. Den LuaDebugger verwenden

Schritt 1: Visual Studio Code installieren und einrichten

  • Features:
  • Hervorhebung der Syntax und schnelle Fehlererkennung.

Herunterladen und installieren:
https://code.visualstudio.com/download


Schritt 2: Ein Ordner für externe Skripte

  • Features:
  • Externe Skripte können bearbeitet werden ohne das Spiel neuzustarten.
  • Schritte:
  • Navigiere in dein Siedler Mapverzeichnis *../extra2/shr/maps/user/*
  • Erstelle einen Ordner namens scripts.
  • Neue Skripte erstellst du hier als myscript.lua Datei. Beliebiger Name wählbar.
  • Öffne den Skripteditor im Mapeditor und füge als einzige Zeile ein:
 Script.Load("maps\\user\\scripts\\myscript.lua") 
  • Der Dateiname im Pfad muss zur angelegten .lua passen.

Schritt 3: Funktionsreferenz: Parameter der Lua-API

  • Features:
  • Zeigt dir die richtigen Parameter zu jeder Lua-API Funktion.

* Schritte:

  • Die .zip-Datei entpacken und in ../extra2/shr/maps/user/scripts/ entpacken.
  • Den Ordner ../extra2/shr/maps/user/scripts/ in Visual Studio Code öffnen.. API Funktionen sollten dann erkannt werden.

Schritt 4: Das debugscript aktivieren

  • Features:
  • Typische Fehler im Skript wie fehlende Zeichen oder Aufrufen nicht existenter Funktionen (gennant Syntaxfehler) werden sofort als gemeldet.
  • Schritte:
  • Um das Debug-Script zu aktivieren, muss
    -debugscript

    als Kommandozeilenparameter an Siedler beim Start übergeben werden.

  • Möglichkeit 1: Wenn eine Verknüpfung für Siedler auf dem Desktop vorhanden ist:
  • Rechtsklick → Eigenschaften → In der Zeile hinter Ziel: ganz nach rechts und hinter ..settlershok.exe„ -debugscript anfügen und mit OK beenden.
  • Wichtig ist ein Leerzeichen zwischen -debugscript und dem “-Zeichen:
    ..settlershok.exe" -debugscript
  • Möglichkeit 2: Im MPUpdater von Kimichura kann per Häckchen das Debug-Script aktiviert werden.

Schritt 5: Den LuaDebugger verwenden

  • Features:
  • Ermöglicht das interaktive debuggen von Skripten, mittel break points, anzeigen aktueller Variablenbelegungen, etc.
scripting/setup.txt · Zuletzt geändert: 2022/06/04 21:48 von madshadow