Bearbeiten von „Kategorie:Scripte“

== Einleitung ==
Ganz allgemein gesprochen gibt es alle möglichen Werkzeuge um eine Software herum. Dazu gehören Werkzeuge wie Wiki oder Forum die eine Datenbank benötigen, dann gibt es Kommunikationswerkzeuge wie IRC, Skype, Teamspeaker und Instantmessenger. Nicht vergessen werden dürfen Sachen die zusätzliche Programme wie Ankhor, Excel, Openoffice oder auch Libreoffice verwenden. Und zu guter Letzt gibt es auch noch die Scripte. 

Die Scripte, um die es hier geht, haben keine Datenbank im Hintergrund. Der Autor des Artikels geht davon aus, dass die meisten Anwender nicht in der Lage sind selbständig einen Server mit Datenbank aufzusetzen und zu verwalten. 

Horizon ist ein Online-Game, was mit frei verfügbaren Browsern gespielt wird. Der Browser stellt über die URL eine Anfrage an den Horizon-Server und bekommt eine Antwort in Form eines Textes in der Sprache HTML, ergänzt um Javascript. HTML beschreibt wie die anzuzeigenden Inhalte dargestellt werden sollen und beinhaltet natürlich auch die Inhalte selber, Javascript kümmert sich um interaktive Sachen wie Tooltipps.
Es gibt nun 2 Browser (Firefox und Chrome), die bieten die Möglichkeit vor der Ausgabe der Seite den Inhalt verändern zu können. Und genau dafür sind die Scripte gemacht. Sie lesen also den vom Server übermittelten HTML-Code und verändern diesen so, dass zusätzliche Informationen angezeigt werden können. Damit diese Scripte arbeiten können ist also ein entsprechender Browser zu verwenden und beim Firefox noch das Addon GreaseMonkey zu installieren. Die Scripte selber sind alle in Javascript formuliert. Da Javascript agiert wäre es auch denkbar Scripte zu schreiben, die selber Anforderungen an den Horizon-Server schicken. Genau hier liegt die Grenze zwischen legal und illegal. '''Alle Scripte, die Anforderungen an den Horizon-Server stellen sind sogenannte aktive Scripte und streng verboten.''' Gerechter Weise zieht ein Verstoss dagegen einen Ausschluß vom Spiel unter Umständen sogar verbunden mit einen Hausverbot (dem gesetzlichen Verbot sich erneut mit anderer Identität auf dem Server anzumelden) nach sich.
Erwähnt sei noch eine weitere Möglichkeit: sogenannte Proxy-Server. Hierbei wird in die Kommunikationsstrecke zwischen Browser und Server ein weiterer Rechner oder auch nur ein Programm geschaltet - genauso wie eine Firewall. Auch hier gibt es verschiedene Proxy-Server die das Scripten erlauben. Da sich der Autor mit diesen Proxys das letzte mal vor ca 8 Jahren beschäftigt hat spielen diese hier keine Rolle. Möglicherweise finden sich andere Mitspieler die diese Programmierung bevorzugen - falls ja gibt es möglicherweise bald einen eigenen Bereich in der Wiki dafür.

== How to - oder: wie funktioniert das nun? ==
Einzige Vorraussetzung ist, dass Javascript installiert ist und ausgeführt werden darf. Aber da das ohnehin auch Vorraussetzung für ein funktionierendes Horizon ist wird hier davon ausgegangen, dass diese Vorraussetzung erfüllt ist.
=== Installation GreaseMonkey ===
Im Firefox ruft man auf: Extras->Add-ons. Es öffnet sich ein neuer Tab. In diesem neuen Tab wählt man links oben "Add-ons suchen aus und gibt dann rechts oben im Suchfeld GreaseMonkey ein. Nach einem Klick auf die Lupe wird Greasemonkey gefunden und mann kann rechts auf installieren klicken. Nach der Installation muss der Firefox neu gestartet werden.
=== Installation eines Scriptes ===
Nach einem Klick auf Extras sieht man gleich den Eintrag für Greasemonkey. Hält man die Maus auf den Eintrag erscheint ein Untermenü, dessen erster Eintrag Greasemonkey selber ist. Der Haken davor zeigt an das GM aktiv ist. Mit einem einfachen Klick hier kann GM deaktiviert werden für den Fall, das mal was schief geht.
Ein weiterer Eintrag ist "Neues Benutzerscript". Nach einem Klick drauf öffnet sich ein Dialogfenster. In diesem Fenster ist zunächst nur der Name wichtig - aus diesem setzt sich der Dateiname zusammen, unter dem das Script abgelegt wird. Nach einem Klick auf ok wird der Dialog durch einen Editor ersetzt und ein bischen Text ist auch schon eingetragen. Was die einzelnen Zeile bedeuten wird gleich erklärt. Man kann sich jetzt also einen Quelltext von einer der unten verlinkten Seiten kopieren, in dem Editor einfügen, speichern und eventuell war es das dann schon.
=== Aufbau eines GreaseMonkey-Scriptes ===
Hier erklärt am Händlerscript. Nach dem neu Anlegen des Benutzerscriptes findet man einen Kopf wie diesem im Editor:
<pre>
// ==UserScript==
// @name           Haendlerrechner_0.60
// @namespace      goetterheimat
// @include 	   *game.horiversum.org/game/main/main.php?cmd=message&send=sent&subcmd=*&action=view*
// Version: 0.2b
// ==/UserScript==
</pre>
Dabei bedeuten:
<pre>
// ==UserScript==
// ==/UserScript==
</pre>
Start und Ende des "Konfigurations-Kopfes"
<pre>
// @name           Haendlerrechner_0.60
// Version: 0.2b
// ==/UserScript==
</pre>
Name und Version des Scriptes. Diese sind für die Funktionalität nicht wichtig, werden aber auf der Übersichtsseite für die GM-Scripte mit angezeigt und man kann so überprüfen, ob das eigene Script noch aktuell ist.
<pre>
// @namespace      goetterheimat
</pre>
Auch dieser Namespace ist nicht sonderlich wichtig - er dient nur zur Unterscheidung der Scripte falls man mal mehrere mit gleichem Namen hat.
<pre>
// @include 	   *game.horiversum.org/game/main/main.php?cmd=message&send=sent&subcmd=*&action=view*
</pre>
Diese Zeile (es können auch mehrere sein!) sind extrem wichtig. Sie beschreiben die URL, auf die das Script angewendet wird. Sicherlich will niemand das Händlerscript auf Google oder youtube anwenden - was soll das Script da tun? Es würde nur Rechenzeit verbrauchen und den Firefox langsam machen. Deshalb verbietet sich hier ein Eintrag wie dieser:
<pre>
// @include 	   *
</pre>
Der Eintrag hängt davon ab, wir ihr Horizon aufgerufen habt. Aktuell gibt es nur eine bekannte Seite:<br>
www.Horiversum.org<br>
Ein * bedeutet immer, das hier beliebig viele Zeichen stehen dürfen. Deshalb wird *game.horiversum.org... auch mit http://game.horiversum.org... oder mit https://irgendwas.gam.horiversum.org... funktionieren.<br>
Wenn es also mal wieder eine Speedrunde geben sollte und deren URL http://speed.horiversum.org... heissen sollte dann wird das script nicht funktionieren. In diesem Fall wird die ganze Zeile einfach kopiert und unten drunter noch einmal eingefügt und entsprechend geändert:
<pre>
// @include 	   *game.horiversum.org/game/main/main.php?cmd=message&send=sent&subcmd=*&action=view*
// @include 	   *speed.horiversum.org/game/main/main.php?cmd=message&send=sent&subcmd=*&action=view*
</pre>
Wenn man wünscht, das ein Script auf einer Seite auf gar keinen Fall aufgerufen werden soll so kann man das wie folgt konfigurieren:
<pre>
// @exclude 	   *http://game.horiversum.org/game/main/main.php?cmd=start*
</pre>
Die häufigste Ursache dafür, das ein Script nicht funktioniert, liegt an diesen beiden Konfigurationen.<br>
Weitere Konfigurationsmöglichkeiten sind dann für jedes Script anders und dort beschrieben, wo auch der Quellcode zur Verfügung gestellt wird.