Ghost++ - Hostbot

In diesem Tutorial zeige ich euch, wie ihr den Ghost oder Ghost++ auf Linux aufsetzt.
Mit dem Ghost++ habt ihr die Möglichkeit in Wacraft 3 Maps zu hosten.
Mit dem Ghost könnt ihr User, die z.B. afk sind kicken, es gibt ein Stats System, wo ihr euch anschauen könnt, wie oft ihr schon auf eurem Bot gespielt habt, könnt Leute bannen ...

Der Ghost++ hat auch einen automatischen Refresher, damit euer Spiel einen besseren Rank erzielt und weiter vorne angezeigt wird.

Eine Vorrausetzung für den Hostbot ist, dass ihr hosten könnt, dass also folgender Port in eurem Router/Firewall freigegeben ist: TCP - 6112!
Dem Ghost++ reicht dieser Port zum hosten, man muss hier nicht wie sonst 6122-6119 freigeben.
Wenn ihr nicht genau wisst, wie ihr die Ports freigebt, könnt ihr gerne folgendes Tutorial anschauen: "Wc3 - hosten".
Falls ihr einen Root oder Linux Vserver habt, müsst ihr auf eure Firewall gehen und den Port 6112 mit dem Verbindungstyp TCP freigeben.(beim VServer im ControlPannel auf Firewall und neue Regel erstellen)

Grundlagen/Vorbereitung

Benötigte Programme:

• Putty (SSH Windows Client) auf eurem Windows Rechner, damit ihr auf eurem Root/VServer Zugreifen/Befehle eingeben könnt
• Screen auf dem Linux Server

Ghost bringt keinen eigenen Daemon mit. Das heißt keinen Dienst bei dem der Ghost im Hintergrund weiter laufen kann.
Dies kann man aber mit Hilfe von Screen machen. Screen ist eine Art Fenstermanager für die SSH-Shell.
Screen richtet sozusagen eine weitere im Hintergrund laufende Shell ein, eine sogenannte Screen Session. Und genau in dieser Session können wir den Ghost im Hintergrund laufen lassen.
Das heist, wenn man Screen nicht benutzt, schließt sich der Ghost-Hostbot automatisch, nachdem man Putty schließt, weil der Prozess dann nicht weiter läuft, sondern beendet wird.

Sollte Screen auf eurem Linux Server nicht installiert sein:

• Bei Ubuntu sowie Debian
  linux:~# apt-get install screen
• bei Suse mittels yast im Menü Software
  
• bei CentOS z.B.
  linux:~# yum install screen
• (ggf. noch die Anwendungen zum entpacken der Archive installieren:)
  linux:~# apt-get install bzip2 (Wird benötigt um .bz2 Archive und andere zu entpacken)
  linux:~# apt-get install tar (Wird benötigt um .tar Archive und andere zu entpacken)

Zur Installation müssen wir uns mittels Putty eine Verbindung zum Server herrstellen und als root-Benutzer einloggen.

Hinweis: Es ist aus Sicherheitsgründen ratsam für Ghost einen eigenen Benutzer zu erstellen und ihn nicht als root-Benutzer laufen zu lassen. Hierfür gibt es verschiedene Möglichkeiten, dies machen wir wie folgt: Ich mache es immer so, dass ich einen Ordner z.B. "Programme" erstelle, für diesen einen Benutzer "programme" und dann alles was ich auf dem Server installieren möchte in diesem Ordner mit Unterverzeichnissen mache und mit dem Benutezr "programme" verwalte.

Dazu erstellen wir ersteinmal einen Benutzer namens programme:

linux:~# adduser programme

und erhalten in etwa so eine Nachricht:

Adding user `programme' ...
Adding new group `programme' (1001) ...
Adding new user `programme' (1004) with group `programme' ...
Creating home directory `/home/programme' ...
Copying files from `/etc/skel' ...
Enter new UNIX password: (ein Passwort eingeben)
new UNIX password: (euer Passwort wiederholen)
passwd: password updated successfully
Changing the user information for programme
Enter the new value, or press ENTER for the default (Hier einfach immer Enter drücken)
Full Name []:
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n] (Hier y + enter)
linux:~#

Jetzt haben wir einen Benutzer namens programme, eine Gruppe namens programme und den Homepfad /home/programme erstellt. (getestet mit Debian)

Installation von Ghost++

Jetzt müssen wir zunächst die einzelnen Pakete, die der Ghost benötigt installieren.
Das machen wir wie folgt (dauert eine Weile):

linux:~# apt-get install build-essential g++ libmysql++-dev wget unzip libbz2-dev libgmp3-dev

Dannach wechseln wir in das Verzeichnis /home/programme, erstellen zunächst ein Unterverzeichhnis namens Source und wechseln in das Verzeichnis:

linux:~# cd /home/programme
linux:~# mkdir Source
linux:~# cd Source


Für den Ghost wird Boost benötigt, dass wir jetzt noch manuell installieren müssen.

• Dazu downloaden wir es zunächst:
  linux:~# wget http://downloads.sourceforge.net/project/boost/boost/1.39.0/boost_1_39_0.tar.bz2
  (Diese Version sollte ausreichen, auch wenn es neuere gibt)
• Anschließend downloaden wir noch den Ghost:
  linux:~# wget http://ghostplusplus.googlecode.com/files/ghostplusplus_17.1.zip
  (Bei mir ist es nun die Version 17.1, die aktuelle Version bekommt ihr hier: Aktuelle Ghost Version)

Jetzt entpacken wir die 2 Archive (dauert ein paar Minuten):

linux:~# tar xjf boost_1_39_0.tar.bz2 (Mit ls den genauen Namen ermitteln und auf euren Namen anpassen)
linux:~# unzip ghostplusplus_17.1.zip

Dann schauen wir nach, welche Dateien/Ordner sich im aktuellen Verzeichnis befinden und gehen in den Ordner Boost, bei mir:

linux:~# ls
linux:~# boost_1_39_0 boost_1_39_0.tar.bz2 ghost ghostplusplus_17.1.zip
linux:~# cd boost_1_39_0


Anschließend starten wir mit folgendem Befehl die installation in das Verzeichnis /usr/lib/:

./bootstrap.sh --with-libraries=filesystem,program_options,system,regex,thread,date_time --libdir=/usr/lib/ (ein Command, alles zusammen übernehmen, keinen Absatz machen!)

Während/Nach der Installation erhalten wir in etwa so eine Meldung:

...
Bootstrapping is done. To build, run:
./bjam
To adjust configuration, edit 'project-config.jam'.
Further information:
- Command line help:
./bjam --help
- Getting started guide:
http://www.boost.org/more/getting_started/unix-variants.html
- Boost.Build documentation:
http://www.boost.org/boost-build2/doc/html/index.html

Jetzt noch folgende 2 Befehle eingeben:

linux:~# ./bjam //dauert ca. 3-5min
linux:~# ./bjam install //ca. 1min


Somit haben wir Boost installiert, verschieben den Ordner Ghost ins richtige Verzeichnis und löschen noch das komplette Source Verzeichnis:

linux:~# cd /home/programme/sources
linux:~# mv ghost /home/programme/
linux:~# cd /home/programme/
linux:~# rm -Rf sources

Jetzt installieren wir noch den Ghost:

linux:~# cd /home/programme/ghost/bncsutil/src/bncsutil/
linux:~# make
linux:~# cd /home/programme/ghost/StormLib/stormlib
linux:~# make
linux:~# make install

Jetzt müssen wir noch eine Datei im Ghost Ordner, auf das Verzeichnis, wo die Boost Dateien liegen anpassen.

• Dazu geben wir zunächst folgenden Befehl ein:
  linux:~# ls -l /usr/lib/libboost*.so
• und erhalten in etwa folgende Nachricht:
  /usr/lib/libboost_date_time-gcc43-mt-1_39.so -> libboost_date_time-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 42 Mar 16 18:03 /usr/lib/libboost_date_time-gcc43-mt.so -> libboost_date_time-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 43 Mar 16 18:03 /usr/lib/libboost_filesystem-gcc43-mt-1_39.so -> libboost_filesystem-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 43 Mar 16 18:03 /usr/lib/libboost_filesystem-gcc43-mt.so -> libboost_filesystem-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 48 Mar 16 18:03 /usr/lib/libboost_program_options-gcc43-mt-1_39.so -> libboost_program_options-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 48 Mar 16 18:03 /usr/lib/libboost_program_options-gcc43-mt.so -> libboost_program_options-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 38 Mar 16 18:03 /usr/lib/libboost_regex-gcc43-mt-1_39.so -> libboost_regex-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 38 Mar 16 18:03 /usr/lib/libboost_regex-gcc43-mt.so -> libboost_regex-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 39 Mar 16 18:03 /usr/lib/libboost_system-gcc43-mt-1_39.so -> libboost_system-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 39 Mar 16 18:03 /usr/lib/libboost_system-gcc43-mt.so -> libboost_system-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 39 Mar 16 18:03 /usr/lib/libboost_thread-gcc43-mt-1_39.so -> libboost_thread-gcc43-mt-1_39.so.1.39.0
lrwxrwxrwx 1 root root 39 Mar 16 18:03 /usr/lib/libboost_thread-gcc43-mt.so -> libboost_thread-gcc43-mt-1_39.so.1.39.0


Jetzt gehen wir in den Ordner Ghost und passen die Datei namens Makefile an:

linux:~# cd /home/programme/ghost/ghost
linux:~# vi Makefile

Die Makefile sieht in etwa so aus:

LFLAGS = -L. -L../bncsutil/src/bncsutil/ -L../StormLib/stormlib/ -lbncsutil -lpthread -ldl -lz -lStorm -lmysqlclient_r -lboost_date_time-mt -lboost_thread-mt -lboost_system-mt -lboost_filesystem-mt -lboost_regex-mt


Diese müssen wir jetzt mit den Pfaden vom vorherigen Befehl anpassen (Auf eure Pfade anpassen, falls sie anders sind):

LFLAGS = -L. -L../bncsutil/src/bncsutil/ -L../StormLib/stormlib/ -lbncsutil -lpthread -ldl -lz -lStorm -lmysqlclient_r -lboost_date_time-gcc42-mt -lboost_thread-gcc42-mt -lboost_system-gcc42-mt -lboost_filesystem-gcc42-mt -lboost_regex-gcc42-mt



Jetzt brauchen wir noch den Pfad zu einer Datei namens filesystem.hpp. Dazu geben wir zunächst den Befehl find ein und erhalten:

linux:~# find / | grep filesystem.hpp
linux:~# /usr/local/include/boost-1_39/boost/filesystem.hpp

Diesen Pfad müssen wir jetzt noch in der Makefile einfügen:

linux:~# cd /home/programme/ghost/ghost
linux:~# vi Makefile
[i] drücken
Folgendes bei CFLAGS hinzufügen:
CFLAGS = -I/usr/lib/ -I/usr/local/include/boost-1_39
[esc] drücken
:wq eingeben und [enter] drücken

Jetzt noch den Ghost entgültig installieren und 2 Dateien kopieren:

linux:~# make //ca. 1min
linux:~# cp /home/programme/ghost/bncsutil/src/bncsutil/libbncsutil.so /usr/lib
linux:~# cp /home/programme/ghost/StormLib/stormlib/libStorm.so /usr/lib

Anschließend kopieren wir noch die Datei ghost++ und starten sie mit ./ghost++:

linux:~# cp ghost++ ../
linux:~# ./ghost++

Wenn alles geklappt hat, müssten wir jetzt eine Nachricht wie diese hier bekommen:

[GHOST] started loading [ip-to-country.csv]
[GHOST] iptocountry data: 10% loaded
[GHOST] iptocountry data: 20% loaded
[GHOST] iptocountry data: 30% loaded
[GHOST] iptocountry data: 40% loaded
[GHOST] iptocountry data: 50% loaded
[GHOST] iptocountry data: 60% loaded
[GHOST] iptocountry data: 70% loaded
[GHOST] iptocountry data: 80% loaded
[GHOST] iptocountry data: 90% loaded
[GHOST] iptocountry data: 100% loaded
[GHOST] finished loading [ip-to-country.csv]
[GHOST] warning - no battle.net connections found and no admin game created
[GHOST] GHost++ Version 17.0 (with MySQL support)

Anschließend beenden wir den ghost wieder, indem wir [STRG & z] drücken:
[1]+ Stopped ./ghost++

Jetzt benötigen wir noch 4 Wacraft 3 Dateien. Dazu erstellen wir zunächst einen Ordner namens war3:

linux:~# cd /home/programme/ghost
linux:~# mkdir war3

Dann folgende Dateien aus dem Wacraft 3 Ordner in das Verzeichnis /home/programme/ghost/war3 mit FileZilla hochladen:
game.dll, Storm.dll, war3.exe and War3Patch.mpq

Ghost++ configurieren

Jetzt kommen wir zum 2. letzten Schritt:
Wir müssen jetzt noch die Ghost Einstellungen anpassen (Username, Cdkey usw...)
Dazu öffnen wir zunächst die Datei default.cfg mit linux:~# vi default.cfg oder laden uns die Datei mit FileZilla herunter und bearbeiten Sie mit Windows (übersichtlicher).
Anschließend ändern wir folgende Einstellungen, wie wir sie haben möchten und in manchen Fällen brauchen:

bot_war3path = war3
bot_hostport = 6112
bot_mapcfgpath = mapcfgs
bot_savegamepath = savegames
bot_mappath = maps
bot_replaypath = replays
replay_war3version = 26
replay_war3version = 26 (aktuelle Warcaft Version eingeben)
bot_virtualhostname = |cFF4080C0GHost (Ingame Name des Bots - Hexcode als Farbe)

Dann müssen wir noch die Datenbank festlegen, ich empfehle euch die Mysql Datenbank, die ihr auf eurem Root/VServer hoffentlich habt.
Dazu erstellt ihr auf eurem Server eine Datenbank z.B. namens Ghost und legt einen Benutezr an. Anschließend gebt ihr hier noch die Daten an un der Ghost erstellt automatisch die Tabellen:

##########################
# DATABASE CONFIGURATION #
##########################
db_type = mysql
db_mysql_server = localhost
db_mysql_database = ghost (auf eure Datenbank anpassen)
db_mysql_user = Ghost (auf eure Datenbank anpassen)
db_mysql_password = (euer Passwort)
db_mysql_port = 0
db_mysql_botid = 0

Dann noch euren bnet Server, eueren Account und euren CdKey eingeben.

bnet_server = europe.battle.net
bnet_cdkeyroc =
bnet_cdkeytft =
bnet_username = Clan_Hostbot
bnet_password =
bnet_firstchannel = (einen Channel festlegen, inden der Bot joinen soll)

Ghost starten

Um den Ghost zu starten, müssen wir ihn jetzt noch mit Screen, was wir ja am Anfang installiert haben starten.
Dazu legen wir zunächst eine Datei namens start.sh mit folgendem Inhalt an:

linux:~# cd /home/programme/ghost
linux:~# vi start.sh (öffnet und erstellt gleichzeitig die Datei)
Inhalt:
[i] Taste drücken, um in den Schreibmodus zu wechseln
Jetzt folgendes einfügen:
#!/bin/bash
cd /home/programme/ghost/

screen -A -m -d -S ghost++ /home/programme/ghost/ghost++
mit [esc] den Schreibmodus beenden und mit :wq abspeichern & beenden.

Jetzt noch 2 Dateien namens stop.sh und restart.sh anlegen:

linux:~# vi stop.sh
[i] Taste
Inhalt einfügen:
#!/bin/sh
screen -S ghost++ -X quit
[esc] und :wq

linux:~# vi restart.sh
[i]
Inhalt:
./stop.sh
./start.sh
[esc] & :wq

Jetzt starten wir noch den Bot mit linux:~# ./start.sh und unser Bot sollte sich ins Battlenet einloggen.
Falls bei euch irgentetwas nicht funktionieren sollte, schreibt mir unten im Gästebuch. Sollte bei der Installation alles funktioniert haben, aber er kommt nicht ins Battlenet, dann öffnet bitte die Datei ghost.log und postet hier die genaue Fehlermeldung.