Kategorie:GM-Scripte

How to GreaseMonkey - 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:

// ==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==

Dabei bedeuten:

// ==UserScript==
// ==/UserScript==

Start und Ende des "Konfigurations-Kopfes"

// @name           Haendlerrechner_0.60
// Version: 0.2b
// ==/UserScript==

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.

// @namespace      goetterheimat

Auch dieser Namespace ist nicht sonderlich wichtig - er dient nur zur Unterscheidung der Scripte falls man mal mehrere mit gleichem Namen hat.

// @include 	   *game.horiversum.org/game/main/main.php?cmd=message&send=sent&subcmd=*&action=view*

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:

// @include 	   *

Der Eintrag hängt davon ab, wir ihr Horizon aufgerufen habt. Aktuell gibt es nur eine bekannte Seite:
www.Horiversum.org
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.
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:

// @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*

Wenn man wünscht, das ein Script auf einer Seite auf gar keinen Fall aufgerufen werden soll so kann man das wie folgt konfigurieren:

// @exclude 	   *http://game.horiversum.org/game/main/main.php?cmd=start*

Die häufigste Ursache dafür, das ein Script nicht funktioniert, liegt an diesen beiden Konfigurationen.
Weitere Konfigurationsmöglichkeiten sind dann für jedes Script anders und dort beschrieben, wo auch der Quellcode zur Verfügung gestellt wird.