TrinityCore na Linuxu

Kompilace TrinityCore na Linuxu

V tomto návodu je pro jednoduchost použit pracovní adresář /opt/trinitycore.

mkdir /opt/trinitycore
cd /opt/trinitycore

Instalace balíčků

Pro správnou a bezproblémovou instalaci je nutno mít nainstalované tyto programy:

Pro Debian/Ubuntu:

sudo apt-get install g++ gcc make cmake libmysql++-dev subversion mercurial openssl libssl-dev \
zlib1g-dev libtool libmysqlclient15-dev patch build-essential mysql-client libreadline5-dev

Pro Fedora/Centos:

yum install cpp gcc gcc-c++ make cmake subversion mercurial openssl openssl-devel patch mysql-devel \
mysql-server mysql mysql-libs readline readline-devel compat-readline5-devel compat-readline5 zlib-devel

Sestavení ACE

Domovské stránky projektu ACE(The ADAPTIVE Communication Environment) [1]

Nejnovější verze můžete získat odsud: [2]

Doporučení: Stahujte nejnovější dostupnou verzi. Kompatibilita nejnovějších Trinity revizí nemusí být se staršími ACE.

Konkrétní příklad stažení:

wget http://download.dre.vanderbilt.edu/previous_versions/ACE-5.7.6.tar.gz

A teď rozbalit:

tar xvzf ACE-5.7.6.tar.gz

Přejmenujeme adresář na jednoduší jméno a přesuneme se dovnitř

mv ACE_wrappers ACE
cd ACE

Sestavení programu provedem

mkdir build
cd build
../configure --prefix=/opt/trinitycore/.sys/
make
make install

Tímto se ACE zkompiluje a nainstaluje a je připraven pro použití.

Kompilace libSSL

Toto je velmi důležitý krok, protože bez této knihovny se vám Trinity sice zkompiluje ale NEpůjde!!

mkdir -p /opt/trinitycore/.sys/sources && cd /opt/trinitycore/.sys/sources

Tímto příkazem jsme připravili složku pro zdrojové soubory této knihovny. Nyní je stáhneme, rozbalíme a přesuneme se do jejich složky:

wget http://www.openssl.org/source/openssl-0.9.8k.tar.gz
tar -xvf openssl-0.9.8k.tar.gz
cd openssl-0.9.8k

A opět známá konfigurace:

./config --prefix=/opt/trinitycore/.sys shared

A nyní už jen knihovnu zkompilovat a nainstalovat:

make
sudo make install

Tímto je knihovna připravena k použití.

Kompilace TrinityCore

Pomocí nástroje pro práci s verzovacím systémem Mercurial stáhneme kopii repozitáře zdrojových kódů:

hg clone https://trinitycore.googlecode.com/hg trinitycore

Také je možno zadat přímo číslo konkrétní revize:

hg clone --rev 1234 https://trinitycore.googlecode.com/hg trinitycore

Kódy lze stáhnout také přímo z webu [3]

Aplikace patche

Můžete volitelně aplikovat patche pro TrinityCore, které najdete někde na Internetu. Přesunete se do složky, kam jste právě stáhli trinity pomocí

cd ./trinitycore

Aplikace patche:

Vlastní aktualizace:

patch -p0 < soubor.patch

GIP patch:

git apply soubor.patch

Samotné sestavení

Trinity už máme staženou, nyní se přesuneme do její složky příkazem (pokud jsme to už neudělali spolu s aplikací patche):

cd ./trinitycore

A můžeme začít vesele kompilovat:

cmake -DPREFIX=/opt/trinitycore/build -DACE_LIBRARY=/opt/trinitycore/.sys/lib/libACE.so \
-DACE_INCLUDE_DIR=/opt/trinitycore/.sys/include/ -DSSLLIB=/opt/trinitycore/.sys/lib/libssl.so

Vysvětlení některých parametrů:

• -DACE_LIBRARY=/opt/trinitycore/.sys/lib/libACE.so -- cesta k vaší knihovně libACE.so
• -DSSLLIB=/opt/trinitycore/.sys/lib/libssl.so -- cesta k vaší knihovně libssl.so
• -DACE_INCLUDE_DIR=/opt/trinitycore/.sys/include/ -- cesta k adresáři include libACE
• -DDO_MYSQL=1 -- sestavit s podporou mysql
• -DDO_SCRIPTS=1 -- sestavit s podporou skriptování
• -DDO_RA=1 -- sestavit s podporou vzdáleného přístupu
• -DDO_CLI=1 -- sestavit s podporou pro příkazový řádek
• -DPREFIX=/opt/trinitycore/build/ -- cesta, kde bude uloženo sestavené jádro
• -DCONF_DIR=/opt/trinitycore/build/etc -- cesta, kde budou uloženy vaše konfigurační soubory (volitelné)

make
sudo make install

Pokud máte vícejádrový procesor, tak můžete použít také

make -j <počet jader>

A Trinity máme zkompilovanou. Nyní je ve vašem domovském adresáři ve složce build Trinity!

Konfigurace serveru

Ve složce build/etc máte 2 konfigurační soubory:

• trinitycore.conf.dist
• trinityrealm.conf.dist

Tyto soubory nejprve příkazem sudo chmod 777 * udělejte zapisovatelnými, poté je přejmenujte - smažte .dist a poté je otevřete. U obou je hned zezačátku několik řádků nastavení databáze. Ty musíte správně vyplnit:

LoginDatabaseInfo     = "127.0.0.1;3306;jmenouzivateledatabaze;heslouzivateledatabaze;realmd"
WorldDatabaseInfo     = "127.0.0.1;3306;jmenouzivateledatabaze;heslouzivateledatabaze;world"
CharacterDatabaseInfo = "127.0.0.1;3306;jmenouzivateledatabaze;heslouzivateledatabaze;characters"

Tyto hodnoty pravdivě vyplňte.

V souboru trinityrealm.conf je tento řádek:

LoginDatabaseInfo = "127.0.0.1;3306;jmenouzivateledatabaze;heslouzivateledatabaze;realmd"

Tyto údaje vyplňte pravdivě.

Nyní následuje jedna z neojtravnějších pasáží :D

Extrahování DBC souborů a map z klienta

Když teď zkusíme zapnout Trinity (jen tak mimochodem, binární soubory jsou ve složce build/bin), samozřejmě nebude fungovat. Chybí nám totiž vyextrahované soubory z WoW! Ve složce se zdrojovými soubory Trinity je složka contrib a v ní složka extractor. Program v této složce, jmenuje se ad.exe, teď využijeme.

POZNÁMKA: Mě nikdy ad nefungoval, a nechtěl jsem nic znovu kompilovat, takže jsem použil program ad.exe. Pokud vám ad také nefunguje, použijte ad.exe místo ad v následujících krocích:

Zkopírujeme ad do složky s WoW. Až tam budeme, spustíme program příkazem

./ad

V případě že používáte ad.exe, spusťte jej pomocí programu wine (

Pro Debian/Ubuntu:

sudo apt-get install wine

Pro Fedoru/Centos:

yum install wine

) příkazem

wine ad.exe

Až program ad skončí (řád desítek minut), budete mít ve složce s WoW 2 nové složky: maps a dbc. Obě tyto složky zkopírujeme do složky bin - build/bin. Nyní už KONEČNĚ náš vytoužený server funguje? Kdepak. Ještě není nahraná databáze!

Nahrání databáze TDB

Trinity Core využívá vlastní databázi, podobnou (velmi) databázi udb. Co uděláme nejdřív: Vytvoříme v naší MySQL databázi 3 databáze: realmd, world, characters. Nyní musíme tyto databáze naplnit daty:

Do databáze realmd vložíme SQL soubor z Trinity složky build/share/trinity/sql/realmd.sql Pokud vám to nepůjde, opět celé složce změňte práva na 777 - viz. výše. Do databáze characters vložíme soubor ze stejné složky jako realmd, ale SQL se jménem (překvapivě) characters. To samé provedeme s databází world.

Ale ještě stále nejsme u konce! Ještě nám chybí data do databáze world (to co jsme nahráli byla jen struktura). Teď si poctivě stáhneme celou databázi world:

http://svn.assembla.com/svn/trinitydatabase/trunk/full_db/

Stahujeme vždy databázi s nejvyšším číslem! V době psaní tohoto návodu byla nejvyšší databáze 0.0.5 - pro revize Trinity 5254.

Až celý velký soubor stáhneme, rozbalíme ho. Poté celý soubor vložíme do databáze world (je možné že to bude chvíli trvat).

Nyní už máme databázi konečně připravenou k použití. Noo, ne tak docela. Ještě chybí update a scripty. Ve složce se SQL soubory (build/share/trinity/sql - opět připomínám) je i složka updates. Z ní musíme nahrát všechny update od revize databáze (v tomto případě 5254) do té nejnovější - aby byla databáze aktuální!

V této složce je ještě jedna složka - FULL. V ní jsou opravdu FULL scripty do world databáze. Tak je všechny postupně vložíme do world databáze.

Tak jestli jste se dostali až sem, máte zkompilovanou Trinity, a můžete jí pustit souborem build/bin/trinity-core a trinity-realm. Jestli chcete mít server přístupný veřejnosti, jděte ještě do databáze realmd, a v tabulce realmlist změnte localhost na vaši veřejnou IP adresu. Nyní je váš server připraven k použití a je přístupný.

Jak používat příkazy

Vcelku jednoduše. Jak zapnete program trinity-core, načte se celá databáze a server je zapnut. Příkazy pak píšete do konzole - čili do okna trinity-core - čili do toho, co vám vyskočilo, když jste zapli trinity-core. Dostupné příkazy v konzoli vám ukáže příkaz

help

. Příkazy jsou téměř stejné jak na MaNGOSu.

Až si vytvoříte v konzoli účet, přidejte mu ještě GM oprávnění příkazem account set gmlevel 3 a account set addon 2 (pokud máte WotLK). Pak si změňte realmlist a můžete vesele hrát. Příkazy dostupné ve hře si buď najděte tady na fóru v sekci MaNGOS nebo ve hře příkazem

.help

Restartér

Dovolil jsem si vzít několik let starý bash kód, který zde někde napsal uživatel Charlie, a trochu ho upravil:

#!/bin/sh

while true
do
  PID1=$(pidof trinity-core)
  if (( PID1 < 1 ))
  then
        screen -A -m -d -S trinity-core ./trinity-core -c ../etc/trinitycore.conf
        echo Trinity core daemon je offline. Probíhá opětovný start daemona.
  fi
  PID2=$(pidof trinity-realm)
  if (( PID2 < 1 ))
  then
       screen -A -m -d -S trinity-realm ./trinity-realm -c ../etc/trinityrealm.conf
       echo Trinity realm daemon je offline. Probíhá opětovný start daemona.
  fi
  sleep 10
done

Vytvořte si v té samé složce, jako máte server (trinity-core a trinity-realm), soubor

restarter.sh

Tento soubor si otevřete (třeba v programu gedit), a zkopírujte do něj výše uvedený kód. Pak soubor vklidu uložte a zavřete.

O co se jedná?

Je to restartér - program, který každých 10 sekund zkontroluje, jestli trinity server a trinity realm běží. Pokud ne, zapne je (zapnout se do programu screen). Screen je taková zvláštní aplikace, která umožňuje běh různých takovýchto daemonů na pozadí. Zkrátka nám jde o to že server se sám nahodí do 10ti sekund :)

Jak program použít?

Jděte do složky s vaším trinity serverem (a restartérem), otevřete v ní terminál (příkazový řádek), a zadejte:

bash restarter.sh

Nyní vám v tomto okně běží restartér, který vás při pádu trinity upozorní (vypíše text), a sám server nahodí!

POZOR: V případě že máte konfigurační soubory umístěny jinak než je standartní po instalaci serveru, upravte cesty ve vašem restartéru, jinak vám nebude fungovat!

Související

• Diskuse k tomuto návodu ve fóru

Externí odkazy

• Howto linux tc2