DCWatch v:0.2.0 Copyright (c) 2005-2006, CyB - Project Author (cyb@elitemail.hu) 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ő [cyb@elitemail.hu] FleetCommand - Lua scriptek [fleet@elitemail.hu] sumo - Dokumentáció [husumo@elitemail.hu] mavika - DCWatch weboldal [mavika@freemail.hu] 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. Verzió információ 2. Telepítés 3. Csatlakozás 4. Kiadható parancsok (main és pm) 5. Pluginek 6. 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.: <DCW V:0.1.2d,H:1,R:No,A:Kick>) + 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 Java VM Settings Control Parameters dcw_<megfelelő_verziószám>* Java VM parancsok, memória optimalizálás, stb** 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 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 -languagefile -debug -debugfile -cpu -memory -udp -tcp -noautostart Usermanager tiltása Ettől a program gyorsabb lehet, viszont nem fogja tudni mennyi user van a hubon Megfelelő nyelvi file beállítása Debug mód bekapcsolása A debug mód információinak megadott fájlba történő logolása Engedélyezi a cpu statisztikát Engedélyezi a ram statisztikát, csak Java 1.5 vagy nagyobb verzióval működik helyesen Az alapértelmezettől eltérő UDP port megadása Az alapértelmezettől eltérő TCP port megadása 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 -host -port -path -settings A bot hubon használt nickje A hub címe A hub portja A program elérési útvonala Settings.xml file megadása. 3.2.b: Opcionális paraméterek: -nousers -languagefile -debug -debugfile -ip -pass -udp -tcp -noautostart Usermanager tiltása Ettől a program gyorsabb lehet, viszont nem fogja tudni mennyi user van a hubon Megfelelő nyelvi file beállítása Debug mód bekapcsolása A debug mód információinak megadott fájlba történő logolása A bot IP címe. (aktív módú keresések miatt kell) Regisztrált nick esetén a jelszó Az alapértelmezettől eltérő UDP port megadása Az alapértelmezettől eltérő TCP port megadása 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