labalaba not only another IRC Livereporter for UT2003 :-)
=========================================================

Current Version 
===============

Version: V 1.1
Builddate: 17.12.2002

What is it?
===========
labalaba is a combines the features of a irc livereporter for UT2003 with Servercontrolling over IRC in one tool.

Whats the difference to other reporters
=======================================
labalaba uses more detailed messages and some colors to get at least some parts of "match atmosphere"
into the irc channels. 

Screenshots ?
=============
There are 2 screenshots included in this .zip file. One TDM Screenshot from a real Match. 
And one shot from a ctf botmatch with 12 players on Orbital2(Round off time on, Locmsg on).

How do i install it?
====================
Copy the laba.u and laba.int to your UT2003\System folder.
Edit your UT2003.ini or Server.ini
add a line
ServerActors=laba.labaSA
to your [Engine.GameEngine] section. This will automatically add the laba.labamuta to everygame. Of course you could do this manually ... then you have to take care that laba.labamuta is activated.

Include the content of laba.ini in your UT2003.ini or server.ini and adjust the parameters to your needs.
In the last section of this file you'll find a brief explanation of the .ini part.

How does the Authentication work
================================

QuakeNet(Commands using QAuth):
In the QuakeNet there is already an auth Service, called Q. So i just used the QAuth thingie to allow or disallow access to the commands of the bot.
To execute a command use !COMMAND. 
Note: the default Command Tag "!" is changeable via the myIRCtag var in the server .ini

Other IRC Networks(Privmsg Commands):
Note: In order to use this you have to set the labaAdminpw var in the server .ini.

You could command the bot with using /msg BOTNICK cmd PASS COMMAND.
COMMAND is one of the following available commands.



Tell me some IRC Commands of the bot!
=====================================

HELP, displays the available commands
RED TEAMNAME, sets the Name for Team Red
BLUE TEAMNAME, sets the Name for Team Blue
MUTE, mutes the Bot
UNMUTE, unmutes the Bot
INFO, get Info about the current match i.e. Mode, Map, Mutators
CLEARTOPIC, clears the topic
SETTOPIC ON, Bot may set/modify the Topic
SETTOPIC OFF, Bot must not set/modify the Topic
ADDTOTOPIC ON, Bot extends Topic with Finalscores of map
ADDTOTOPIC OFF, Bot does not append things to the topic
CHAN CHANNEL, changes the Channel to CHAN
NICK NICKNAME, changes the nickname to NICKNAME
ROUNDTIME ON/OFF, round off the matchtime
PUMSG ON/OFF, report Powerup Pickups
COMBOMSG ON/OFF, report Combo casts
LOCMSG ON/OFF, display Teamlocation in messages

UT2003 Admin Commands:
KICK PLAYERNAME, Kick PLAYERNAME
BAN PLAYERNAME, KickBan PLAYERNAME
SAY TEXT, Say TEXT on the Server
MAP MAPNAME, change map to MAPNAME
MODE MODENUM, change from 1on1 to tdm, ctf, ... see !MODES for a list
MODES, list all available modes

SET PACKAGE.CLASS VAR VALUE, sets the value of a var
GET PACKAGE.CLASS VAR, get the value of a var
ADDBOTS BOTNUM, adds some bots

Still Questions, Bugreports or suggestions for Improvements ?
=============================================================
Contact me via irc #ut.esu or via mail mr.frost@justageek.de

		- Mr.Frost

Thanks to:
==========
Titan, Joker, cohen, Falk, Ulath, mAgix, all idlers in #ut.esu and all those people i forgot :)

APPENDIX
========

---snip---
[laba.labamuta]
// irc server to use
IRCServer=irc.de.quakenet.org:6667
// irc nick
IRCNick=blahdoh
// irc ident
IRCIdent=labalaba
// reporting chan
IRCChan=#ut.esu
// irc server pass
IRCPASS=
// send Delay between messages
fSendDelay=2.200000
// initial irc command
IRCInitialCommand=PRIVMSG Q@CServe.QuakeNet.org :auth h4x0r muhpuh
// bot adminpw (Privmsg Commands), empty pw=disabled
labaAdminpw=
// Q AuthList(QAuth Commands), leave this empty to disable QAuth Features
QAuthList=:MrFrost:RR|Titan:
// Command tag(QAuth Commands)
myIRCtag=!
// the used irc colors ; todo: more explanation here
myIRCcolors[0]=12
myIRCcolors[1]=4
myIRCcolors[2]=13
myIRCcolors[3]=9
myIRCcolors[4]=1
myIRCcolors[5]=3
myIRCcolors[6]=12
myIRCcolors[7]=8
myIRCcolors[8]=13
// how often the Teamscore is reported(Timeinterval, default = 60 secs)
ScoreTimes=60
// Display the Individual Scores every ScoreIndividualCount*ScoreTimes Seconds
ScoreIndividualCount=2
// if the bot should set a new topic with the current game info
bSetTopic=False
// if the bot should just add the score of a played game to the topic
bAddtoTopic=True
// mute the bot or not ;)
bmute=False
// enables some simple commands like KICK, BAN, MAP, MODE, MODES
bSimpleCommands=True
// enables advanced commands like SET, GET, ADDBOTS
badvcommands=True
// report Pickups of Powerups
bReportPUPickups=True
// report Teamlocation in Messages
bshowlocs=True
// round off the match time
bRoundOffTime=true
// report Combos(TTM version only)
bReportCombos=True
// use the Default DeathMessages
bDefaultDeathmsgs=False
// name the teams
TeamBlueName=Blue
TeamRedName=Red
// example mode list
Modes[0]=dm-cOmPrEsSeD?game=XGame.xTeamGame?mutator=xWeapons.MutNoSuperWeapon,XGame.MutNoAdrenaline?TimeLimit=15?MaxLives=0?GoalScore=0?bWeaponStay=false?bPlayersMustBeReady=True?bForceRespawn=True?SpawnProtectionTime=0.000000?MaxPlayers=2?MaxSpectators=2
Modes[1]=dm-antalus?game=XGame.xTeamGame?mutator=xWeapons.MutNoSuperWeapon?TimeLimit=20?MaxLives=0?GoalScore=0?bWeaponStay=false?bPlayersMustBeReady=True?bForceRespawn=True?SpawnProtectionTime=0.000000?MaxPlayers=8?MaxSpectators=0?friendlyfirescale=1
Modes[2]=ctf-maul?game=XGame.xCTFGame?mutator=xWeapons.MutNoSuperWeapon?TimeLimit=20?MaxLives=0?GoalScore=0?bWeaponStay=True?bPlayersMustBeReady=True?bForceRespawn=True?SpawnProtectionTime=0.000000?MaxPlayers=10?MaxSpectators=0?Translocator=True?FriendlyFireScale=0
Modes[3]=dm-antalus?game=XGame.xTeamGame?mutator=xWeapons.MutNoSuperWeapon,ttm2001v1.TTM_MutMain?TimeLimit=20?MaxLives=0?GoalScore=0?bWeaponStay=false?bPlayersMustBeReady=True?bForceRespawn=True?SpawnProtectionTime=0.000000?MaxPlayers=8?MaxSpectators=0?friendlyfirescale=1
Modes[4]=ctf-maul?game=XGame.xCTFGame?mutator=xWeapons.MutNoSuperWeapon,ttm2001v1.TTM_MutMain?TimeLimit=20?MaxLives=0?GoalScore=0?bWeaponStay=True?bPlayersMustBeReady=True?bForceRespawn=True?SpawnProtectionTime=0.000000?MaxPlayers=10?MaxSpectators=0?Translocator=True?FriendlyFireScale=0
Modes[5]=
ModeNames[0]=CPL 1on1, Superweapons off, Adrenaline off
ModeNames[1]=TDM 4on4, Superweapons off, TTM off
ModeNames[2]=CTF 5on5, Superweapons off
ModeNames[3]=TDM 4on4, Superweapons off, TTM on
ModeNames[4]=CTF 5on5, Superweapons off, TTM on
ModeNames[5]=
---snap---
