Benutzer-Werkzeuge

Webseiten-Werkzeuge


eventscripts:scriptinstallation

Scriptinstallation

Die Scriptsinstallation bei Eventscripts gestaltet sich fast immer gleich. Zuerst sind immer die Voraussetzungen nachzusehen. Manche Scripts benötigen z.B. noch ES-Tools.

  • Der Addon-Manager von Eventscripts hat bei jedem Script immer den gleichen Aufbau. Dort sind die Anforderungen aufgelistet. Jedes Script hat eine Beschreibung, Installationsanleitung, Versionshinweise und ein Link zum Forum-Beitrag des Scriptes zur Diskussion.
  • Im Forum für Eventscripts sind auch noch eine Vielzahl von Plugins zu finden. Hier entscheiden die Entwickler selber, welchen Aufbau der Beitrag hat.

Arten von Scripts

Eventscript

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.

Python Eventscript

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.

Beispiel

Als Beispiel nehmen wir das Script Landmine.

Anforderungen

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.

Script herunterladen und entpacken

Nachdem alle Voraussetzungen erfüllt sind, kann das Script mit Download Current Version heruntergeladen und danach entpackt werden.

Konfiguration

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.

Upload zum Server

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.

Script einbinden

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.

1) Name des Scripts
eventscripts/scriptinstallation.txt · Zuletzt geändert: 2010/01/24 13:16 von DeaD_EyE