Benutzer-Werkzeuge

Webseiten-Werkzeuge


scripting:setup

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu der Vergleichsansicht

Beide Seiten, vorherige Überarbeitung Vorherige Überarbeitung
Nächste Überarbeitung
Vorherige Überarbeitung
scripting:setup [2022/06/04 21:13]
madshadow
scripting:setup [2022/06/04 21:48] (aktuell)
madshadow
Zeile 1: Zeile 1:
 ====== Aufsetzen der Umgebung und Debugtools ====== ====== Aufsetzen der Umgebung und Debugtools ======
-**Richte deine Entwicklungsumgebung richtig ein, für effizientes und effektives Arbeiten!**\\+**Richte deine Entwicklungsumgebung richtig ein, für effizienteres und effektiveres Arbeiten!**\\
  
-//Arbeitsaufwand 5-10 Minuten.:-)//\\ +Folgende Optionen sind möglich um das Coden für Siedler stark zu vereinfachen:
- +
-Dazu müssen folgende Schritte ausgeführt werden:+
   - Visual Studio Code installieren und einrichten   - Visual Studio Code installieren und einrichten
-  - Ein Ordner für externe Skripte +  - Skripte extern laden 
-  - Den Lua Debugger verwenden.+  - Eine Funktionsreferenz mit den Parametern der Lua-API 
 +  - Das Debugscript aktivieren 
 +  - Den LuaDebugger verwenden
  
 ---- ----
Zeile 31: Zeile 31:
   * **Features**:   * **Features**:
   * Externe Skripte können bearbeitet werden ohne das Spiel neuzustarten.   * Externe Skripte können bearbeitet werden ohne das Spiel neuzustarten.
-  * Parameter für die Siedler-API abfragen. 
  
   * **Schritte**:   * **Schritte**:
Zeile 41: Zeile 40:
   * Der Dateiname im Pfad muss zur angelegten .lua passen.   * 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**:
 +  * Herunterladen: https://github.com/mcb5637/s5LuaReference
 +  * 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 <code>-debugscript</code> 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: <code>..settlershok.exe" -debugscript</code>
 +  * __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.
 +
 +  * **Schritte**:
 +  * Die Debugger dll herunterladen: https://github.com/mcb5637/SettlersLuaDebugger/releases/download/v0.5.9/DebugS5.zip
 +  * (Falls Link nicht verfügbar, neueste Releases hier: https://github.com/mcb5637/SettlersLuaDebugger/releases )
 +  * .zip entpacken und LuaDebugger.dll im Siedlerverzeichnis neben jede **settlershok.exe** legen. Das sind die Pfade:
 +  * **<Siedlerverzeichnis>/bin** 
 +  * **<Siedlerverzeichnis>/extra1/bin** 
 +  * **<Siedlerverzeichnis>/extra2/bin**
scripting/setup.1654377212.txt.gz · Zuletzt geändert: 2022/06/04 21:13 von madshadow