Wersja z 19:20, 17 cze 2006

Instalacja

Wymagania

- Najnowsze wydanie MetaModa - Najnowsze wydanie AMX Mod lub AMX Mod X - Dostep do bazy danych MySQL - Hosting na strone (z obslugą PHP oraz z magic_quotes_gpc On) - Smarty templating system - AmxBans

WWW

• Skopiuj zawartosc folderu web do swojego katalogu z www (np: /usr/local/www/www.yoursite.com/htdocs/amxbans )

• Sciagnij najnowsza stabilna wersje : Smarty

• Skopiuj zawartość katalogu lib ze smarty (razem z katalogami) do lib w katalogu smarty (na serverze www)

• Upewnij sie, ze uzytkownik obslugujacy server www ma prawa zapisu do katalogu smarty/templates_c oraz do pliku include/config.inc.php (jesli go niema nalezy stworzyc; w praktyce dajemy na ten katalog i plik uprawnienia chmod 777)

• Upewnij sie, ze posiadasz baze danych do przechowywania baz AMXBans (IP, login, haslo, nazwa bazy)

UWAGA ! Pod linuxem podawaj jako IP localhost', a nie jak jest wpisane 127.0.0.1

• Otworz w dowolnej przegladarce plik setup.php (np: http://www.twojastrona.pl/amxbans/admin/setup.php) i wypelniaj polecenia.

UWAGA ! Zadna z juz istniejacych tabel nie zostanie nadpisana.

• Jesli uaktualniasz AMXBans'a do najnowszej wersji upewniej sie ze podajesz te same dane do bazy co przy poprzedniej instalacji
• Usun plik setup.php z katalogu admin. Interfejs www sie nie wlaczy jesli nie wykonasz tej czynnosci.

Pluginy

AMX

• Wypakuj admin_mysql.sma i amxbans.sma do addons/amx/examples/source (lub skopiuj juz skompliowane wersje do /addons/amx/plugins). Upewnij sie, ze istniejacy plik admin_mysql.amx zostal nadpisany.

UWAGA ! Plik admin_mysql.sma jest to lekko zmodyfikowana wersja orginalnego pliku. Zmieniony zostal system zapisywania w bazie danych, aby kilka serverow moglo obslugiwac te same tabele.

• Skompiluj pluginy (jesli chcesz uzywac swoich)

• Dodaj wpisy do obu pluginow w addons/amx/plugins/plugins.ini (bezposrednio pod admincmd.amx ). admin_mysql.amx bedzie prawdopodobnie juz wpisany, w tym wypadku usun ; sprzed nazwy.

• Zrestartuj server i sprawdz czy oba pluginy sie zaladowaly prawidlowo (wpisz amx list w konsoli)

• Teraz mozesz juz uzywac strony www

AMXX

• wypakuj admin.sma, amxbans.sma i amxbans_menu.sma do addons/amxmodx/scripting (lub skopiuj juz skompliowane wersje do addons/amxmodx/plugins ). Upewnij sie, ze istniejacy plik admin.amxx zostal nadpisany.

UWAGA ! Plik admin_mysql.sma jest to lekko zmodyfikowana wersja orginalnego pliku. Zmieniony zostal system zapisywania w bazie danych, aby kilka serverow moglo obslugiwac te same tabele.

• Skompiluj pluginy (jesli chcesz uzywac swoich)

• Dodaj wpis amxbans.amxx do addons/amxmodx/configs/plugins.ini (bezposrednio pod admin.amxx ).
• Dodaj wpis amxbans_menu.amxx na koncu pliku

• Umiesc amxbnas.txt w addons/amxmodx/data/lang

• Zrestartuj server i sprawdz czy oba pluginy sie zaladowaly prawidlowo. Powinienes otrzymac w konsoli linię

[amxbans.amxx] AMXBans amxx_3.1 is online

a jesli nie masz dostepu do konsoli to sprawdz w logach amxmodx'a.

• Teraz mozesz juz uzywac strony www

Konfiguracja

Skrypt Db pruning

Ten skrypt jest opcjonalny.

• otworz plik move_bans.pl
• wpisz dane dotyczace twojej bazy danych (IP, login, haslo, nazwa bazy)

• uruchomiaj skrypt regularnie (np: poprzez wpis w crontabie), aby dodac do crona mozesz uzyc wpisu

*/15 * * * * /home/amxbans/mv_bans.pl

Ten wpis bedzie prune'owal baze co 15 min.

Dodawanie adminow

• W AMXBans sa dwa rodzaje adminow:

• • WebAdmins – ci admini ma dostep tylko do strony www (na wczesniej oreslonych levelach)
  • AMXadmins – ci admini sa to admini serverow gier (zwykly admin w grze)

UWAGA ! Jesli nie chcesz z jakiegos powodu uzywac adminow przez AMXBans (z MySql'a) bo np wolisz z users.ini, to musisz odnalesc w pliku /include/config.inc.php linie

$CFG->admin_management

i ustawic ja na no . Jesli tak zrobisz nie musisz ladowac pluginu admin_mysql.amx (w AMX'ie)

Jesli jednak bedziesz uzywal AMXBans'a do adminow (serverowych), tu jest wyjasnienie poszczegolnych pol do wypelnienia:

• Nickname/SteamID/IP – wpiszujesz tu nick/steamid/IP gracza musiz tez wziasc pod uwage poznijsze ustawienie flag pod ten wpis
  • password – wpisujesz tu haslo dla admnia, jesli dajesz admina na SteamID/IP to nie ma koniecznosci wpisywania hasla.
  • Access - tu wpisujesz flagi uprawnien admina
  • Flags - flagi rozpoznawanie typu wpisu (np: czy admin na IP czy na steamid)
  • SteamID – tu wpisujesz SteamID admina, jest to wykorzystywane przy wyswietlaniu na www
  • nickname – tu wpisujesz nick admina, jest to wykorzystywane przy wyswietlaniu www

Flagi do "access"

a - immunity (can't be kicked/banned/slayed/slaped and affected by other commmands)
b - reservation (can join on reserved slots)
c - amx_kick command
d - amx_ban and amx_unban commands
e - amx_slay and amx_slap commands
f - amx_map command
g - amx_cvar command (not all cvars will be available)
h - amx_cfg command
i - amx_chat and other chat commands
j - amx_vote and other vote commands
k - access to sv_password cvar (by amx_cvar command)
l - access to amx_rcon command and rcon_password cvar (by amx_cvar command)
m - custom level A (for additional plugins)
n - custom level B
o - custom level C
p - custom level D
q - custom level E
r - custom level F
s - custom level G
t - custom level H
u - menu access
z – user

Flagi do "Flags"

a - disconnect player on invalid password
b - clan tag
c - this is steamid
d - this is ip
e - password is not checked (only name/ip/steamid needed) 

Komendy

To są komendy konsolowe w grze.

• amx_ban <czas_bana_w_minutach> <nick|steamid> <powod>

(banuje na steamid)

• amx_banip <czas_bana_w_minutach> <nick|steamid> <powod>

(banuje podany nick/steamid na IP)

• amx_find <nick|steamid>

(sprawdza czy dane steamid jest dodane w bazie danych)

• amxbans_menu

(otwiera menu amxbans, dziala tylko w amxx)

• amx_reloadreasons

(przeladowuje 'powody' z bazdy danych na server)

Obsluga innych pluginow przez AMXBans

ATAC

ATAC (Advanced Team Attack Control)

• Otworz plik 'amx_atac.sma' i wyszukaj linie

'//Reomved due to steam equal("4294967295", kAuthid) (around line 725)' 

i zaraz pod nia: znajdz te linie:

if( atac_banvia == 2 ) // If LAN or IP ban via IP
   server_cmd("addip %i %s;writeip;kick #%d", atac_bantime, kIP, userid)
else
   server_cmd("banid %i #%d kick;writeid", atac_bantime, userid) 

i zamien je na:

if( atac_banvia == 2 ) // If LAN or IP ban via IP
   server_cmd("addip %i %s;writeip;kick #%d", atac_bantime, kIP, userid)
else
   server_cmd("amx_ban %i %s Team kill violation", atac_bantime, kAuthid) 

jak juz to zrobisz zapisz plik i go skompiluj

• przenies skompilowany plik (nazwany amx_atac.cfg) do .../addons/amxx/plugins
• Zrestaruj server

HLGuard

HLG (Half-Life Guard)

• Otworz plik 'hlg_net.cfg' (addons/hlguard/configs)
• w sekcji:

// Aimbot Warning System Detection Actions 

znajdz linie

hlg_aimbot "banid 60.0 %w kick;wait;writeid" 

zmien ja na

hlg_aimbot "amx_ban 0 %w Suspected Aimbot"

• w sekcji:

// Alias Detection Actions 

znajdz linie

hlg_action "t:found:10" "banid 1440.0 %w kick;wait;writeid;hlg_setcounter check up" 

zmien ja na

hlg_action "t:found:10" "amx_ban 1440.0 %w %y"

hlg_action "t:found:10" "hlg_setcounter check up"

znajdz linie

hlg_action "b:found:10" "banid 0.0 %w kick;wait;writeid;hlg_setcounter check up" 

zmien ja na

hlg_action "b:found:10" "amx_ban 0.0 %w %y"

hlg_action "b:found:10" "hlg_setcounter check up"

• w sekcji

// Nameban Actions 

znajdz linie

hlg_action "q:found:10" "amx_ban 1440.0 %w Name violation"

zmien ja na

hlg_action "q:found:10" "amx_ban 1440.0 %w Name violation" 

UWAGA ! Jesli chcesz by Blacklista HLG wciaz dzialala: Nie zmieniaj

'hlg_blacklist "15" "banid 1440.0 %w kick;wait;writeid"' 

/ w sekcji '// Blacklist Check Actions' /

Podziękowania

• trawiator