DCWatch v:0.2.0 Copyright (c) 2005 - 2006, CyB - Project Author (
[email protected]) Hompage: http://dcwatch.dccafe.org Relased under terms of the GNU public license http://www.gnu.org/licenses/gpl.html http://www.hup.hu/wiki/wiki.phtml?title=GPL
Elérhetőségek: DCWatch honlap: http://dcwatch.dccafe.org DCWatch fórum: http://forum.4242.hu
DCWatch csapat: • • • •
CyB - DCWatch fejlesztő [
[email protected]] FleetCommand - Lua scriptek [
[email protected]] sumo - Dokumentáció [
[email protected]] mavika - DCWatch weboldal [
[email protected]]
DC Hubok: • •
DCWatch fejlesztői HUB: dchub://4242.hu:1411 Elite Hub, ahol megnézheted működés közben a BOT-ot: dchub://elite.4242.hu:4242
============================================================================= A DCWatch egy, a Direct Connect hálózaton működő roBOT program. A program Java környezetben készül General Public License keretében. A program pluginokkal bővíthető, testreszabható, így szinte teljes ellenőrzés alatt lehet vele tartani a hubot, és több másik hubbal lehet egyszerre kapcsolatot tartani a segítségével. A bot és pluginjai teljesen protokollfüggetlenek, NMDC és ADC hubokon egyaránt használhatóak.
T artalom: 1. 2. 3. 4. 5. 6.
Verzió információ Telepítés Csatlakozás Kiadható parancsok (main és pm) Pluginek Lua Scriptek
1: Verzió információ
Jelenlegi verzió, DCWatch 0.2.0: • • • • • • • • • • •
Gyorsabb hálózati kapcsolat (Java NIO segítségével); Több hub-ra is tud csatlakozni; Futásidőben csatlakoztatható/eltávolítható plugin-ek; File kereső plugin (DCW 0.1 alapján); Remote Console plugin (egyelőre DC kliensen keresztül); Multi-chat plugin (egyszerre több hubon); Felhasználó kereső plugin (egyszerre több hubon); Lua plugin (Lua scriptek futtatása, BCDC++ támogatás); Részletesebb statisztika (memória, hálózat); Átdolgozott hibakereső mód (file, display); Átdolgozott hibakezelés, részletes hibaüzenetek (file, display).
DCWatch fejlesztési fázisai: •
DCWatch 0.1.2d + Lomtárat is tud keresni (néha lomtárnak ismeri fel a Windows egyéb szemetét) + Lehet az usereknek priviben jelezni, hogy baj van a megosztással (ajánlott kis hubokra, ahol fontos az userszám) + Átalakult a TAG is. (R - Run: Yes/No, A - Action: Kick/Private) (pl.:
) + Description tartalmazza a dcw verziót. # a 0.1.2c -stop/-start bugja javítva lett. * Új parancsok: -recycle, -kick, -private
•
DCWatch 0.1.2c + szabadon állítható, hogy mi miatt kickeljen # pár apró bug javítva lett (főleg a design-ban) * új parancsok: -incomplete, -media, -installed
•
DCWatch 0.1.2b + kickek logolása file-ba (ezután akkor is van reportfile, ha nem küld PM-et) + bővült kereső engine (.part, .getright, .gho, uninst.isu, eauninstall.exe) # userlista bug javitva (csak egy usert mutatott a listában) # status bug javitva (Byte/sec-ben irta az átlag sebességet, mértékegység meg KiB volt) # users bug javitva (ugyanolyan néven több user is a listába kerülhetett)
•
DCWatch 0.1.2a + reportolás testreszabható, az operátor dönti el hogy akar-e reportot (-show, - hide) + a status oldal megjeleniti a bot állapotát
+ usercount privátban is érvényes * új parancsok: -show, -hide, -userlist, -status, -usercount •
DCWatch 0.1.2 + help oldal készült (-help) + ki/be kapcsolható kereső engine (-start, -stop) + reportol PM message-ben + ki tud lépni a bot parancsra (-quit) # minden tipusra 15m-re bannol * új paracsok: -start, -stop, -uptime, -version, -help
2: Telepítés
2.1. Windows: A program futtatásához szükség van Java futtatókörnyezetre (Java 2 Runtime Environment). Letölthető innen: http://www.java.com/en/download/windows_xpi.jsp A scriptek futtatásához szükség van LuaJava kiegészítőre (a telepítőcsomag tartalmazza), vagy: Letölthető innen: http://dcwatch.dccafe.org/dcw/tools/luajava.rar MySQL kapcsolat eléréséhez szükség van MySQLConnector-ra (a telepítőcsomag tartalmazza), vagy: Letölthető innen: http://dcwatch.dccafe.org/dcw/tools/mysql.rar Letöltés után a programot tömörítsd ki. Telepíteni nem kell, a program önállóan futtatható.
2.2. Linux: A program futtatásához szükség van Java futtatókörnyezetre (Java 2 Runtime Environment). Letölthető innen: http://java.com/en/download/linux_manual.jsp A scriptek futtatásához szükség van LuaJava kiegészítőre (a telepítőcsomag tartalmazza), vagy: Letölthető innen: http://dcwatch.dccafe.org/dcw/tools/luajava.rar MySQL kapcsolat eléréséhez szükség van MySQLConnector-ra (a telepítőcsomag tartalmazza), vagy: Letölthető innen: http://dcwatch.dccafe.org/dcw/tools/mysql.rar Letöltés után a programot tömörítsd ki. Telepíteni nem kell, a program önállóan futtatható.
3: Csatlakozás Mielőtt a programot elindítod és csatlakoznál vele a hubhoz, ahol majd használni szeretnéd a botot, érdemes egy új nicket regelni neki a hubon, lehetőleg opjoggal.
A program alapesetben az 5000-es portot használja kereséshez, ezt érdemes a tűzfalon (esetleg routeren, ha van) kiengedni, különben a fájlkereső plugin nem fog találatot visszaadni, nem fog helyesen működni. Az alapértelmezett port helyett más is megadható, ha ez foglalt, vagy másikat szeretnénk valami más okból. Ehhez az „-udp=port” kapcsolót kell használnunk.
3.1: Windows Kitömörítés után, a program a "DCWLauncher.exe" fájl futtatásával indítható. A program ablakában megadhatóak a futtatáshoz szükséges paraméterek.
3.1.a: Kötelező paraméterek: DCWatch
dcw_<megfelelő_verziószám>*
Java VM
Java VM parancsok, memória optimalizálás, stb**
Settings
Settings.xml file megadása*** Kontroll hub megadása, ha a botot egy külön hubon szeretnéd ellenőrizni. Ezt mimdemképpen meg kell adni, ha nincs külön hub a futtatáshoz, akkor az ala hubcímet kell megadni, amin a bot futni fog majd
Control
Parameters
Opcionális paraméterek megadása
* = pl.: dcw_0-2-0-060310 ** = ha a bot több hubon is fut majd és egyszerre több feladatot lát el, megnövekedhet a memória igénye. Ezt lehet optimalizálni Java VM parancsokkal, amik meghatározzák a maximálisan lefoglalható memória méretét és annak kihasználtságát. pl.: „ -Xms128m –Xmx256m” *** = A csomagban egy alap Settings .xml található, ami kézzel is szerkeszthető, tartalmaznia kell a hub címét és portját, a bot hubon használt nickjét, és ha szükséges, akkor a jelszavát is. A későbbiekben ebben a fájban más adatok is tárolva lesznek, ezért erről érdemes rendszeresen biztonsági másolatot készíteni.
More
Ebben az opcionális ablakban lehet a betöltött Settings.xml filet szerkeszteni manuálisan
3.1.b: Opcionális paraméterek: -nousers
Usermanager tiltása Ettől a program gyorsabb lehet, viszont nem fogja tudni mennyi user van a hubon
-languagefile
Megfelelő nyelvi file beállítása
-debug
Debug mód bekapcsolása
-debugfile
A debug mód információinak megadott fájlba történő logolása
-cpu
Engedélyezi a cpu statisztikát
-memory
Engedélyezi a ram statisztikát, csak Java 1.5 vagy nagyobb verzióval működik helyesen
-udp
Az alapértelmezettől eltérő UDP port megadása
-tcp
Az alapértelmezettől eltérő TCP port megadása
-noautostart
Letiltja az autómatikus hubralépést. Így konzolból lehet a botot állítani, anélkül hogy az fellépne a hubokra. Plugin felvétel, eltávolítás, settings file szerkesztés, stb
A DCWRunner.exe egy *.ini fájlba menti a beállításokat (DCWRunner.ini). Ez kézzel is szerkeszthető.
3.2: Linux: Kitömörítés után, a program konzolból indítható java alkalmazásként, a kötelező paraméterek megadásával.
3.2.a: Kötelező paraméterek: -nick
A bot hubon használt nickje
-host
A hub címe
-port
A hub portja
-path
A program elérési útvonala
-settings
Settings.xml file megadása
.
3.2.b: Opcionális paraméterek: -nousers
Usermanager tiltása Ettől a program gyorsabb lehet, viszont nem fogja tudni mennyi user van a hubon
-languagefile
Megfelelő nyelvi file beállítása
-debug
Debug mód bekapcsolása
-debugfile
A debug mód információinak megadott fájlba történő logolása
-ip
A bot IP címe. (aktív módú keresések miatt kell)
-pass
Regisztrált nick esetén a jelszó
-udp
Az alapértelmezettől eltérő UDP port megadása
-tcp
Az alapértelmezettől eltérő TCP port megadása
-noautostart
Letiltja az autómatikus hubralépést. Így konzolból lehet a botot állítani, anélkül hogy az fellépne a hubokra. Plugin felvétel, eltávolítás, settings file szerkesztés, stb
A paraméterek után a változót egyenlőségjellel elválasztva, space nélkül kell megadni. Például: java -jar dcw_<*megfelelő_verziószám*>.jar -nick=DCWatch -host=tehubod.host.hu -port=6464 -path=/home/user/dcwatch/ -ip=255.255.255.255 -pass=jelszavad –settings=Settings.xml <*megfelelő_verziszám*> = pl.: dcw_0-2-0-060310
