Die Scriptsinstallation bei Eventscripts gestaltet sich fast immer gleich. Zuerst sind immer die Voraussetzungen nachzusehen. Manche Scripts benötigen z.B. noch ES-Tools.
Das Script selber kann ein Eventscript oder ein Python Eventscript sein. Beide Arten gehören immer in ein Unterverzeichnis1) nach addons/eventscrips/
. Der Dateiname eines normalen Eventscripts ist folgendermaßen aufgebaut es_scriptname.txt. Es können sich noch weitere Unterverzeichnisse und Dateien im Scriptverzeichnis befinden.
Ein Python-Script hat keinen Präfix und endet auf .py
. Dabei handelt es sich um den Quellcode. Wird ein solches Script das erste mal ausgeführt, erzeugt Eventscripts einen Zwischencode, welcher im Scriptverzeichnis gespeichert wird und dann ausgeführt wird. Dabei ist zu beachten, dass der Server Schreibrechte auf das Scriptverzeichnis hat. Im Regelfall sind Server so konfiguriert, dass Benutzer in ihr eigen angelegtes Verzeichnis schreiben dürfen. Manche Admins machen den Fehler und laden so ein Script als Root
hoch und wundern sich, wieso das Script nicht ausgeführt werden kann. Klar, der Server darf in diesem Fall dann nicht in das Scriptverzeichnis schreiben, kann den Zwischencode nicht speichern, was zur Folge hat, dass das Script nicht ausgeführt werden kann.
Als Beispiel nehmen wir das Script Landmine.
Die Anforderungen stehen im Addon-Manager bei Requires:
. In diesem Fall wird EventScripts 2.0
oder neuer und ES_Tools Version .420
benötigt. Beide Angaben sind verlinkt und führen direkt zu den Plugins.
Nachdem alle Voraussetzungen erfüllt sind, kann das Script mit Download Current Version
heruntergeladen und danach entpackt werden.
Jetzt steht die Konfiguration an. In diesem Fall kann die Datei landmines.cfg
, welche sich in cfg/landmines/
befindet, konfiguriert werden. Fast jedes Eventscript stellt bestimmte Konsolen-Variablen zu Verfügung, um leichter eine Konfiguration vornehmen zu können. Der Vorteil ist, dass die Konsolen-Variablen zur Laufzeit des Scriptes geändert werden können. Manche Eventscripts greifen auch auf Konfigurationsdateien zurück, die nur das Script selber abrufen kann.
Fast jedes Script ist so Archiviert, dass es nach dem Entpacken nur noch in das Modverzeichnis auf den Server kopiert werden muss. Dabei ist zu beachten, dass bei einem Root-Server der richtige Benutzer genommen wird. Wer das Script direkt als Root hochlädt, hat schon den ersten fatalen Fehler gemacht. Mieter eines normalen Gameservers brauchen sich darum nicht zu kümmern, da sie eh nur einen Zugang zu Server haben.
In der Beschreibung des Scripts steht folgendes:
Now write down es_xload landmines in your autoexec.cfg and restart your server!
Es soll also der Befehl es_xload landmines
zur autoexec.cfg
hinzugefügt und danach der Server neugestartet werden. Viele Scripts werden normal durch es_load
geladen. Der Befehl es_xload
lädt ein Script ohne Variablen im Script zu erweitern. D.h. für einfache Scripts die sowas nicht benötigen bringt es ein Performance-Schub.