
Version: 1.3
Written by: GaB|Mindcrime (in real life Remy Wetzels <mindcrime@chello.nl>)
Copyright: 2002-2004 by Remy Wetzels

Mindcrime's IRC Live Reporter Bot.
==================================

Erstmals werde ich mich entschuldigen fuer mein schlechtes Deutsch... ;)

Dies sind instruktionen um schnell den bot laufen zu lassen unter RTCW/OSP
wenn man als spectator oder spieler zu ein server connected um ein match
LIVE auf den IRC kanal sehen zu lassen.

Ich gehe davon aus das derjenige der das spiel zeigen will:

- IRC kennt und wie man (in mIRC) damit umgeht
- Das spiel live uebertragen will in ein IRC kanal auf Quakenet
- Weiss wie man in RTCW console kommt
- Nach ein OSP server connected (um da zu spectaten/spiel)
- Den bot unter Windows benutzt (fuer Linux user muesste es einfacher sein)

Eigentlich braucht man den bot nur 1 mal gut einzustellen. Wenn man das
gemacht hat braucht man eigentlich nur noch eine feste list zu durchlaufen
um wieder live zu uebertragen.

Einmaliger Setup:
-----------------

Als erstens download den bot. When man die setup version hat starte
setup.exe und installier den bot. Auf die festplatte sollten jetzt minimum
da sein:

- WolfBot.exe: das windows front-end
- WolfCMD.exe: der eigentliche bot
- irccolors_rtcw.cfg: einstellungen fuer farben (spielzeit, spielstats)
- mapinfo_rtcw.xml: daten ueber die rtcw maps

Wenn der version noch da NICHT 1.0 ist (als 1.0Q3 oder aelter), download von:
http://rtcwbot.jackvance.com/ und ueberschreib den alten... Wenn der webserver
down ist, frag GaB|Mindcrime oder BIN^HIN in ein privquery (bin immer
in #gab.rtcw).

Wenn man noch nie den bot benutzt hat (oder nen logfile gemacht hat):

1) Such dir nen OSP server
2) Start RTCW
3) Connect zu den OSP server
4) Wenn du connected bist, type in console:
   /logfile 2
   (wenn du kurz wartest bis nen kill oder ander nachricht in console kommt
    das sollte was kommen wie:

   Logfile opened on Nov 08 22:22:22 2002

5) Geh einige minuten spielen
6) Stop RTCW

Wenn du das gut gemacht hast dan sollte in mappe RTCW/osp eine datei
rtcwconsole.log stehen. Den brauchen wir fuer test spaeter.

Jetzt starte WolfBot.exe. Du bekommst nen screen wie images/wolfbot10q3_01.jpg
oder images/wolfbot10_01.jpg (neue version).
Drueck rechts oben auf "expert mode". Man sieht jetzt mehrere felder...

Wenn du ein fehler bekommst beim aufstarten dan download entweder die
setup version oder hol dir die Microsoft Visual Basic 6.0 runtime dateien
bei Microsoft. Ein link steht auf die RTCWBot pages in download bereich.

Setze die folgende werter in die felder (BITTE KEINE ANDERE, WEIL ES WERDEN
ZU OFT FEHLER GEMACHT WODURCH DER BOT NICHT CONNECTEN KANN ZUM NETZWERK):

IRC OPTIONS

Irc Server: irc.de.quakenet.org
Irc    Port: 6667
Irc Channel: #rtcw-liga.live
Irc Chankey:
Irc Nickname: RTCWLBotXX          (fuer XX nen ziffer setzen 00-99)			
Irc Language: Deutsch
Irc Username: MindBot             (NICHT AENDERN, DAS IST NICHT DER NICK!!!)
Q Usercode:
Q Password:

BOT PASSWORD:

mach hier ein passwort rein (ohne lehrzeichen!!)

BOT OPTIONS:

enable OSP: AUS				(JA! Hier auf komm ich spaeter zurueck)
show [kills/deaths]: AN			(nur bei neue 1.0)
team mode: AUS
messages on: AUS
start from EOF: AUS
continue from line: AUS, wert 0	(der wert sieht man in neue version nicht)
quiet mode: AUS

RECHTS VON CONFIG OPTIONS:

Clientlog: AN
Loglanguage: Wenn in RTCW console die kills auf Englisch angezeigt werden
             (XXX was killed by YYY's MP40) muss man English waehlen, wenn
             auf Deutsch (XXX wuerde getoetet von YYY - MP40) dan waehle
             Deutsch.

CLIENTLOG OPTIONS:

show match time: AN			(nur bei neue 1.0)
show stats after: AN, wert 0

CONFIG OPTIONS:

game logfile: klick auf 'BROWSE' und selektiere den existierende RTCW/osp/rtcwconsole.log.
              wenn du auf open klickst sollte das pfad zu den datei ins feld eingefuellt
              sein.
wait before opening: AUS
delete before opening: AUS		(nur bei neue 1.0)
game mapfile: klick auf 'BROWSE' und selektiere den mapinfo_rtcw.xml datei, die du in die
              mappe wo du den bot installiert hast, finden kannst
color configfile: klick auf 'BROWSE' und selektiere den irccolors_rtcw.cfg datei, die du in die
              mappe wo du den bot installiert hast, finden kannst
game server:

Das sollte jetzt aussehen so wie images/wolfbot10q3_02_de.jpg oder images/wolfbot10_02_de.jpg
(neue version).

Ok, du hast jetzt den setup fuer nen test:

1. Geh *mit mIRC* zum #rtcw-liga.live kanal
2. Druecke auf START in den WolfBot.
   Es sollte ein DOS-BOX kommen der sich gleich minimalisiert...

   In den DOS-BOX werden nach einige zeit nachrichten kommen wie:

   XXX lines read...

   Wenn da was anderes steht wie:

   Error read_buf ..

   oder die DOS-BOX geht gleich wieder weg, dan hat der bot ein problem
   um zum IRC kanal zu connecten. Das kommt entweder das er nicht 
   zum IRC server connecten kann, oder du hast falsche IRC daten in
   die IRC options eingetrage (schon existierenden nickname, falscher
   kanalname)
3. Nach einige sekunden (das kann bis zu einer minute (oder 2) dauern manchmal!)
   sollte der bot auf das kanal kommen. Er sollte da die kills zeigen den
   gemacht sind als du vorher gespielt hast (nachdem du /logfile 2 in RTCW
   console gemacht hast).
4. Wenn das so ist, dan ist dieser test gelungen. Wenn nicht dan ist
   denk ich mal ein problem da was in punkt 2. beschrieben ist.
5. Beende die DOS-BOX durch die DOS-BOX zu oeffnen (in menu balken unten)
   und rechts oben auf kreuz zu klicken. Der Bot wird aus den kanal gehen
   und IRC beenden.

Du hast wenn es gut ist noch immer den Wolfbot.exe drehen.

Fuer live uebertragungen musst du jetzt noch einige dingen aendern damit es
auch richtig gut geht auf nen OSP server und das er auch LIVE uebertraegt
das naechste mal:

Aendere bei BOT OPTIONS:

start from EOF: AN    (continue from line sollte automatisch verschwinden)
enable OSP: AN

Aendere bei CONFIG OPTIONS:

delete before opening: AN		(nur bei neue 1.0)

Jetzt sollte alles so etwa aussehen wie images/wolfbot03_de.jpg.

Oeffne mit NOTEPAD die datei irccolors_rtcw.cfg und aendere (nur wenn du
nicht die neue 1.0 version hast):

# see also [playerstats] for the colors
# 1 = show, 0 = don't show
showplayerstats=0

in

# see also [playerstats] for the colors
# 1 = show, 0 = don't show
showplayerstats=1

Das wird waehrend das spiels live die kills/deaths von spieler sehen lassen.

Wiederholen den test hieroben nochmal. Aber was ist jetzt:

- Der bot kommt nach einige sekunden auf das kanal und meldet sich mit:

  [16:04:10] <RTCWLBot>  Mindcrime's RTCW LiveBot v1.0 

  aber danach nix mehr. (nach eine minute macht er auch wieder sowas)

Das ist ok. So sollte es auch sein.

Sorg dafuer das du den DOS-BOX wieder schliesst. (ES SOLLTE IMMER NUR 1
DOS-BOX MIT DEN BOT GLEICHZEITIG DREHEN)

Du hast jetzt den setup richtig um den bot fuer LIVE OSP matches zu starten.
Um die option in den bot zu speichen musst du jetzt einmal den WolfBot.exe
beenden (durch rechtsoben auf den X zu druecken) und beim BOX:

Save Options?

Auf JA (oder YES) zu klicken.

Wenn du den WolfBot.exe wieder startest wirst du sehen das er alle
daten behalten hat... (Jedenfalls sollte es so sein)

Live matchuebertragungen machen:
--------------------------------

Wenn du nen live match uebertragen willst solltest du die folgenden schritte
JEDESMAL machen:

1. Entferne (mit dein explorer in windows) den alten RTCW/osp/rtcwconsole.log
   (oder lass das automatisch machen durch "delete before opening" an in die
    neue version)
2. Starte den bot (aendere vielleicht den IRC Channel und IRC Nickname)
3. Vergewissere dich das er auf das IRC kanal kommt (Es ist nicht schlim
   das er meldet das die logdatei nicht vorhanden ist, du hast den alten
   ja gerade entfernt)
4. Start RTCW
5. Connect zum OSP server
6. Wenn du connected bist, type in RTCW console:
   /logfile 2
7. PUNKT 7 IST OPTIONAL:

   mach entweder
   a)
   mach nen video restart durch in console zu typen:
   /vid_restart

   oder
   b)
   Abhaengig von mapname, type in RTCW console:
   /lbot map mp_beach

   moegliche mapnamen:

   mp_assault
   mp_base
   mp_beach
   mp_castle
   mp_chateau
   mp_dam
   mp_depot
   mp_destuction
   mp_keep
   mp_ice
   mp_rocket
   mp_sub
   mp_tram
   mp_trenchtoast
   mp_village

   (eigentlich jede mappe die in mapinfo_rtcw.cfg definiert ist)

   Der bot sollte sich in deine RTCW console melden mit:

   Mindcrime's RTCW LiveBot: MAP SET TO mp_beach...
   Mindcrime's RTCW LiveBot: MAPTIME SET TO 08:00...

   Diesen punkt 7. brauchst du nur einmal zu machen. Es ist optional
   aber hierdurch weiss der bot welche mappe am diesen moment gespielt
   wird. Bei jeden mapwechsel nachher weiss der bot automatisch
   welche mappe benutzt wird.
8. PUNKT 8 IST OPTIONAL:
   
   Wenn das OSP spiel jetzt anfaengt (when man FIGHT! hoert) dan
   wird der bot starten das spiel in IRC zu uebertragen. Seit 0.8
   kan er auch objective/dynaplants/flaggen anzeigen in das kanal.
   Das einzige was man nicht sehen kan in IRC ist wer auf welche
   seite spielt und was der derzeitige zwisschen stand ist.
   Deswegen ist es gut um waehrend das spiels bei ende einer runde
   oder an anfang einer runde die zwisschenstand durch zu geben
   und wer jetzt als Axis/Allies anfaengt.

   Man kann das machen durch in die RTCW console zu typen:

   Entweder
   a) Man benutzt das 'say' commando in RTCW Console:
   /lbot say hier kannst du was sagen

   Der bot wird "hier kannst du was sagen" auf das IRC kanal zeigen.
   Man koennte sowas sagen wie:

   /lbot say RTCW-Liga MP-1: GaB-m][: 3-0 (ice 2-0/village 1-0)
   /lbot say SW runde 4 folgt... GaB fangen an als Allies 

   Nach jeden /lbot say XXX meldet der bot sich mit:

   Mindcrime's RTCW LiveBot: DONE...

   b) Man benutzt die 'score red', 'score blue' und 'showscore' RTCW
   console commands (oder IRC commands):
   /lbot score red 4
   Der bot setzt die score von Red/Axis team zu 4

   /lbot score blue 2
   Der bot setzt die score von Blue/Allies team zu 2

   /lbot showscore [HIER KAN OPTIONAL EIN TEKST STEHEN]
   Wenn dieser command benutzt wird, wird in IRC gezeigt:

   
   [HIER KOMT DER OPTIONALE TEKST]
   SCORE: Red - Blue: 4 - 2

9. Warte bis das spiel zu ende ist... :)
10. Stop RTCW
11. Stop den DOS-BOX
12. Stop den Wolfbot.exe

ES GIBT NOCH VIELE ANDERE /lbot COMMANDS. DIE SIND BESCHRIEBEN IN
CONSOLECOMMAND.TXT.

Einige gut zu gebrauchen commands:

- !renameteam red NAME    oder  /lbot renameteam red NAME

  Gibt das Red/Axis team den namen NAME
  Bei !showscore wird diesen name gezeigt

- !renameteam blue NAME   oder  /lbot renameteam blue NAME

  Gibt das Blue/Allies team den namen NAME
  Bei !showscore wird diesen name gezeigt

- !swapteams oder /lbot swapteams

  Hiermit wechselst du die namen und die scores von beide teams.

CHECK AUCH DIE IRCCOMMANDS.TXT FUER ALLE IRC COMMANDO'S.
Fuer mIRC gibt es auch nen script so das man ueber die maustaste
alle commando's machen kann.

