Spieler:Brokkoli/ScriptingAnfängerkurs

Aus STNE-Wiki

Wechseln zu: Navigation, Suche
fertige Scripte | Anleitungen und FAQ | Überblick über die Scripting-Sektion | Hilfen zum Arbeiten im Wiki

Inhaltsverzeichnis

Vorwort

Eine Besonderheit von STNE ist, dass man durch Scripts die meisten Aktionen automatisieren kann und sogar das Spiel mit eigenen Seiten erweitern kann.

Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen. Wir wünschen allen viel Spaß und gutes Gelingen.

Grundlagen

Um mit dieser Anleitung zu beginnen solltest du erstmal ein neues Script erstellen. Wähle als Scripttyp "Benutzerdefiniertes Script ohne Eingabeassistent". (Was ein "Web-Script" ist wird in einer weiteren Anleitung behandelt.) Nun bist du in der Quelltextansicht, die allerdings noch nichts anzeigt - Du hast ja noch kein Script eingegeben. Gehe nun auf "Quelltext bearbeiten" um dein erstes Script zu programmieren.

Scripts in STNE bestehen aus einer Datei die grundsätzlich zeilenweise abgearbeitet wird. In jeder Zeile kann eine Anweisung oder auch ein Kommentar stehen. Wobei Kommentare nur zur Erklärung dienen und keinen Einfluss auf das Script haben.

Hello World

Wir beginnen den Ausflug in die Programmierwelt mit einem klassischen Bespiel. Dem "Hello World"-Script. Das einzige was dieses Script macht ist "Hello World" in die Ausgabe zu schreiben.

Gib folgendes im Scripteditor ein und klicke danach auch "Speichern & ausführen":

WriteLine('Hello World');

Nun solltest du die folgende Ausgabe sehen:

Script gestartet.
Hello World
Script beendet.

Klicke nun auf "Quelltext" um zum Scripteditor zurückzukehren.

Was tut dieses Script?

Das Script besteht, wie man leicht sieht, aus nur einer Zeile mit einer Anweisung. Die Anweisung ist hier ein Aufruf der Funktion WriteLine (Was genau ein Funktionsaufruf ist, wird später erklärt). Dieser Funktion wird in runden Klammern mitgegeben, welcher Text ausgegeben werden soll. In diesem Fall handelt es sich um eine benutzerdefinierte Zeichenfolge (Genauer: Ein "String" - Dies wird auch später erklärt). Benutzerdefinierte Zeichenfolgen stehen immer in Anführungszeichen.

Kommentare

Nun verändere das Script dass es wie folgt aussieht:

//"Hello World" ausgeben
WriteLine('Hello World');

Wenn du dieses ausführst, passiert... genau das gleiche wie zuvor. Die neue Zeile die mit "//" beginnt ist nämlich ein Kommentar.

Was ist ein Kommentar?

Kommentare werden nicht ausgeführt und haben daher keinen Einfluss auf das Verhalten des Scriptes. Also wozu das ganze?

Bei grösseren Scripts kann man schnell die Übersicht verlieren was eigentlich geschieht. Daher ist es sehr sinnvoll mit Kommentaren zu beschreiben was man mit dem Script oder Scriptteil beabsichtigt. Kommentare sollten sehr ausfürlich verwendet werden - insbesondere wenn du das Script an andere weitergeben willst, die das Script auch verstehen sollen.