Kombat Teams Documentation

Kombat Teams is a QUAKEWORLD ONLY patch by kemiKal_sWeMoB, Cenobite and Fang which means to simplify all forms of deathmatch games (1-1, 2-2, 4-4, 3-3-3, 31-1 etc.).

It's a public release and provided with absolutely no warranties. The authors take no responsibility for the behaviour and functionality of it.
If you have any problems with 2.10 or suggestions then mail cenobite at address below.

kemiKal: kemikal@kemikal.com
cenobite: cenobite@barrysworld.com
fang: tjp@cc.jyu.fi

The latest official version of Kombat Teams can always be found on: http://www.barrysworld.com/kteam

Getting Started

Firstly, you will have to download the Mod and also all the Server files that are needed. See below for all these site links. You will need a decent spec server if you wish to handle Big Games but if you only plan on running a small server than if you use Linux then you can run this mod comfortably.

Where to get it

The Mod itself is available from the following site www.barrysworld.com/kteam. You will also need to have QuakeWorld Server which is available from www.quakeworld.net. Currently, QuakeWorld can be run on a variety of Server Platforms such as Windows (all versions) and various Flavours of Unix.

Installation

Get the mod obviously =], then create a directory called "kteam" in your quakedirectory and copy all files supplied with the patch into it. Edit the "server.cfg" file to your liking and start the server by typing "qwsv +gamedir kteam". There are various configs supplied with this Patch to allow you to get the server up and running as quickly as possible. These configs are supplied with the patch and will be in the /examples/ directory.

Please refer to the quakeworld server documentation if you want your server to show up on any of the masterservers available. For best server performance, run your server on a machine using unix (or any of its clones) or a PC running WINDOWS NT. Please make sure that you use the QuakeWorld 2.3 server to run the patch. You can obtain QuakeWorld Server from here.

Once you have started up the server then you will be ready to connect to the Server with a Client and start playing. If you have any problems with the mod please read the documentation first.

Mod Commands

Player Commands

These are commands that can be typed by the player at the console to change the way the mod is set up. This is only if the server is *not* in master mode. If it is then alot of these commands are locked out.

About

Shows you the version number of the patch and a small note.

admin

If admins are allowed on the server, this is how you become one. A six digit code will then be entered..
Each digit is entered by an impulse command between 1 and 9.

Berzerk

Toggles berzerk mode.
Berzerk mode is meant to release agression built up after a cautious game.
When only "k_btime" seconds remains of the game, all players gets QUAD/OCTA powered
for the remainder of the match and the whole level starts strobing.
The first 2 seconds, everyone enjoys a bit of satan's power.
(The 2 seconds of 666 was put in to prevent disastrous berzerk rocketjumps)

Break

This command can do various things depending on the State of the Server :

PREGAME	tells the server that you're not ready after all.
COUNTDOWN	stops the countdown (maybe to change some settings).
MATCH	toggle your vote for match-break (if you've got a majority voting with you, the match will stop and results won't be logged).

discharge

Toggles if players should be allowed to "discharge" in water.
If disabled, players will loose all their cells on discharge but not
actually harm anyone.

Steps through deathmatch-modes 1-5.

droppack
k_dp 0/1

Toggles whether or not Backpacks Drop when you kill someone.

dropquad
k_dq 0/1

Toggles whether or not Quad Drops when you kill the person with Quad.

dropring
k_dr 0/1

Toggles whether or not Ring Drops when you kill the person with Ring.

efficiency

Prints player efficiences during or after a game

fairpacks
k_frp 0/1/2

Toggles if backpacks will contain former-weapon-in-hand or former-best-weapon. Or now drops the last weapon they fired.

fragsdown

Fraglimit -10 (minimum is 0).

fragsup

Fraglimit +10 (will not rise above 100 frags)

k_soundX

Where X is a value between 1 and 6.
Plays a soundfile on all your teammates computers (if they've got k_sound set to 1). If you want your client to play sounds that your teammates triggers, type (in the console):
setinfo k_sound 1

Your teammates must have the files "ktsound1.wav" - "ktsound6.wav" in their "id1/sound" directory or they won't hear anything regardless of the k_sound flag.

Remember: If you trigger ktsound1.wav, it will play the ktsound1.wav that
resides on your teammates disk/s, not the one on yours.

*** The default samples are:
ktsound1.wav "Home"
ktsound2.wav "Cellar"
ktsound3.wav "Tower"
ktsound4.wav "Help/Assist"
ktsound5.wav "Warning"
ktsound6.wav "Report"

The standard soundbanks can be found at http://www.kemikal.com.

To be able to use your samples on any server running KT1.96 or higher - put the samples in your "ID1/sound" directory (if "sound" doesn't exist, create it yourself).

Alternatively you can create subdirectories inside ID1/sound called "male", "female" etc. and put the desired soundbanks into these - then during game you can tell Kombat Teams that you want a female voice by typing (in the console):
setinfo k_sdir "female"

list

Prints a list of not ready players, can be done once every 10 seconds.

lock

Steps through the ServerLock-types.
See Lock Types in Technical Notes.

maps

Displays custom maps supported by the server.

overtime

Switches between either Overtime mode being off or on.

overtimeup

Increments the time to add on until it reaches 10 then loops back to 1.

pickup

Toggles your vote for a "pickup" game.
See Pickup in Technical Notes.

powerups

Toggles the availability of powerups during game (quad/666/ring/env.suit).
Pre game, quad and 666 will glow if powerups are enabled and not if not :) Also allows you to have a powerup jammer where it will spawn items =/- 3 seconds.

ready

Tell the server that you're ready for some action.

reset

Resets server to default (see Server Reset in Technical Notes).

report

Reports your Armour, Health and Current Weapon to all TeamMates.

rules

Prints vital information (selected goodies from this document) depending on what is enabled and what is not.

silence
k_spectalk 0/1

Toggles the ability for spectators to talk to players during the match.
In addition to this it also allows/disallows the spectator -> player voice feature of qizmo (fpd 64).

scores

Prints teamscores during game including players that dropped
Also shows current remaining matchtime.
It will only show scores in matches that involves 2 teams and at least 3 players on match-start. Shows minutes with seconds as XX.

spawn666

Toggles player invulnerability on respawn during match.
The invulnerability (666) will last for 2 secs but the player will not glow to give away spawn position.
Should the player attack with any weapon but axe or shotgun during these 2 seconds, his/her 666 will vanish.

spawn

Toggles between

0.	QuakeWorld Standard Respawns
1.	Kteam SpawnSafety
2.	Kombat Team Respawns

See Spawn Explanation in Technical Notes section .

speed

Toggles sv_maxspeed which sets how fast players can run (320/k_highspeed).

stats

Prints playerstats during or after a game.

status2

Prints match-settings such as Spectalk Settings, Qizmo Settings and Lock Settings.

status

Prints most frequently changed Match Settings.

timedown1

Timelimit -1 (will not go under 5 mins).

timedown

Timelimit -5 (will not go below 5 minutes)

timeup1

Timelimit +1 (will not rise above 60 minutes).

timeup

Timelimit +5 (will not rise above "k_timetop" minutes).

timex

Where X = 5, 10, 15, 20, 25 or 30.
Sets timelimit accordingly (will not go above "k_timetop" minutes).

Steps through teamplay-modes 0-3.

who

Prints playerlist which shows which are players are ready (and which team) and which are not.

whonot

Prints playerlist which shows which are players have not readied yet.

whoskin

Prints a playerlist showing all the skins that players are using.

Spectator Commands

These are the commands that the mod allows you to use when you connect to a server as a Spectator.

Admin Commands

admin	Relieves you of your Admin rights.
Forcebreak	Forces match to end. Results will be logged as usual but "%forcebreak%<adminname>" will tell statistics-programs that the match was ended unnaturally and by whom.
Forcekick	If k_allowkick is set to 1 then you are allowed to kick on the server. When you start it shows you how to navigate/kick players. impulse 1(axe) kicks current player impulse 2(sg) moves to next player impulse 3(ssg) exits from kick mode You can kick any player and spectator. If you miss a player/spectator keep hitting impulse 1 and it will go back to the start.
Forcepause	Toggles pause during match.
Forcestart	Gives players 10 seconds to ready themselves, after which they get kicked if they're still not ready. Readied admins may type break to interrupt the countdown. Countdown then commences as usual. *PLEASE NOTE* If you do start a match this was it locks the server out from new people joining so be warned.
Lockmap	Toggles maplock. If maplock is enabled, only admins may change map.
Master	Toggles mastermode. In mastermode, only admins may change matchsettings (dm/tp/powerups etc). Mastermode also functions as a maplock.
Prewar k_prewar 0/1	Toggles the "k_prewar" flag. When k_prewar = 1: players can fire prior to match (actually they can fire during too :)) When k_prewar = 0: players can't fire prior to match (this is the discipline setting)

NOTE: spectator admins can also use the following commands:
/tp /dm /powerups /timeup /timedown /spawn /silence /qtimer /qlag /qenemy /reset /maps

Qizmo Commands

! Note that the Qizmo commands uses a serverinfo key called "fpd" that is common to almost all other proxies such asl: Cheapo, ProxyLite etc..

The command is named after the Qizmo because the "fpd" key was introduced by its authors.

!! for more information on Qizmo, Cheapo, ProxyLite and NF proxy then go to the respective pages.

Server Config

A sample server.cfg is included in the KOMBAT TEAMS package, please use that and modify it as your heart desires. Settings such as startup values for deathmatch, teamplay and settings for other standard QW servervariables are in there. You should consult the documentation for QWSV for settings that relate directly to Quakeworld Settings. The following Flags are used by Kteam :

Localinfo	dq 0	drop quad off (1 to enable)
Localinfo	dr 0	drop ring off (1 to enable)
Localinfo	dp 1	drop backpacks on (0 to disable)
Localinfo	k_spw 2	Kombat Teams respawns (see technical notes)
Localinfo	k_pow 1	powerups on (0 to disable)
Localinfo	k_dis 1	discharge on (0 to turn off)
Localinfo	k_666 0	respawn 666 off (1 to enable)
Localinfo	k_bzk 0	berzerk off (1 to enable)
Localinfo	k_btime 20	berzerk time
Localinfo	k_frp 0	best weapon backpacks (1 to enable)
Localinfo	k_lockmap 0	prevent players from changing map (1 = lock, 0 = no lock)
Localinfo	k_lockmin 0	minimum number of teams in game
Localinfo	k_lockmax 32	maximum number of teams in game
Localinfo	k_membercount 0	minimum number of players in each team to start match
Localinfo	k_prewar 1	enable playerfire before matchstart (0 to disable)
Localinfo	k_ann 0	announce spectators during game (0 to disable)
Localinfo	k_kfp 0	"kill" flood protection off (1 to enable)
Localinfo	k_sready 1	players glow when not ready (0 to disable)
Localinfo	k_exclusive 1	number of players gets locked on gamestart (0 to disable)
Localinfo	k_count 20	number of seconds for the countdown to last
Localinfo	k_admins 1	allow admins (0 to disallow)
Localinfo	k_admincode 666666	6 digit admin code (digits between 1 and 9 only)
Localinfo	k_spectalk 1	spectators can talk to players during game (0 to silence)
Localinfo	k_dm2mod 1	modified deathmatch 2 mode (see technical notes)
Localinfo	k_duel 0	kombat teams set to duel mode (no teamplay change) 1 = active
Localinfo	k_timetop 60	maximum time that can be allocated for a game by the players
Localinfo	k_highspeed 370	/speed toggles between sv_maxspeed 320 and k_highspeed
Localinfo	k_defmap dm4	server default map (see ALIEN MAPS)
Localinfo	k_master 0	mastermode off (1 to enable, see admin commands for details)
Localinfo	k_idletime 0	idle bot off (see IDLE BOT)
Localinfo	k_maxrate	Set max rate allowed on the server
Localinfo	k_minrate	Set min rate allowed on the server
Localinfo	k_allowkick	if 1 = admins can kick with /forcekick else they cant.
Localinfo	k_overtime	If 0 no overtime, 1 add on X minutes set below
Localinfo	k_exttime	Sets amount of time to use for overtime.
Localinfo	k_motd 1	first line of text in the motd (preceeded only by "Welcome to")
Localinfo	k_motd 2	second line of text in the motd (preceeded by "Welcome to" and k_motd1)

You can add in Support for Custom Maps by using the following commands in your Server config file

You have to make sure that there is no gaps in the list of maps. A sample map list is included in the /configs/maps.cfg file. Oh and dont forget no gaps! Also see the section entitled Alien Maps for some more Map related Information.

Technical Notes

If this is set to anything above 0 then it checks players on connect to see if their rate is either above or below the allowed settings. It also checks throughout game to see if anyone is trying to fool kteam :)

If it is switched on then when game ends it will check the scores. If they are equal it will add on the time specified in k_exttime. If the game is again a draw after that time has counted down it will add it on again etc.. Could be some long games heh.

If k_duel is set to 1, the server will not allow teamplay changes. Meaning, if you're running a 1-1 server - set k_duel to 1 and teamplay to 0. Also, /forcestart or the idle bot forcestart usually requiers you to join an existing team while counting down, this is not the case in duel mode.

Modified Deathmatch 2 Mode

Setting the flag "k_dm2mod" in the server.cfg to 1 removes all armor on the map at matchstart if deathmatch mode 2 is chosen. The normal dmm2 is available by setting the same serverflag to "0".

Respawn Types

Kombat Teams respawns differs from the normal QW respawns (also available in the patch) in that they spawn players on a spawnpoint even though someone else is occupying it. There's exceptions to this rule however, a player that has just spawned is considered a no spawn-target for 120 gameticks and a player can never spawn on the same spot twice in a row (unless the map contains less than 2 spawnpoints or all spawnpoints are full).

For the first 3 seconds of a match, Kombat Teams respawns will attempt to avoid spawnfrags entirely (note that this is only for the spawntype "Kombat Teams respawns"). To have yourself spawned at what you consider to be a bad spawn before the match starts as not to get there won't work, the patch doesn't take pregame spawns into account. This type of respawns is by default enabled in KT since the patch's main function is to handle teamgames and we don't want any camping on important spots (like RA on dm4 for example).

With the release of version 2.07, "KT SpawnSafety" was introduced. KT SpawnSafety means to avoid telefrags during games as much as possible (even if all spawnpoints are full) and tries to avoid spawning you at the same spot twice in a row.

Level Exiting

KT removes all "level-exits" at the start of each match. You will be able to walk through those teleporters without anything happening. Pre-game, you can still change level by walking through them (if the server's "samelevel" is set accordingly).

Player Reporting

(player): a:0 h:100 sg:25
no armor, 100 health and a shotgun with 25 shells

(player): ga:30 h:30 rl:5
30 worth of green armor, 30 health and rocket launcher with 5 rockets

(player): ra:200 h:250 rl:100 [-quad-]
200 units of red armor, 250 health, a rocket launcher with 100 rockets and the player is quadpowered

ARMOR TYPES: green (GA) yellow (YA) and red (RA)
WEAPONS: (this is the importancy order from lowest to highest)
axe (AXE) shotgun (SG) nailgun (NG) super shotgun (SSG) super nailgun (SNG)
grenade launcher (GL) lightning gun (LG) rocker launcher (RL).

WHAT'S WITH ALL THOSE "his glasses" AND "his death" TEXTS? :

Quake (and QW) uses male orientated messages that may or may not annoy you depending on your gender. Since the legend tells that there are a few girls and women out there gibbing with the rest of us, KT's got a function that displays genderbased messages accordingly. Your gender is determined as MALE by default but can be set to female by typing (in the console):

Gender

Controls genderbased messages such as "checks his glasses".
Gender is always considered male unless gender equals "f". Thus:
setinfo gender m = "checks his glasses" "was telefragged by his teammate" etc.
setinfo gender f = "checks her glasses" "was telefragged by her teammate" etc.
setinfo gender allelse = "checks his glasses" "was telefragged by his teammate" etc.

k_sdir
See "k_soundX" under "player commands explained".

k_nick
If defined, it changes the output format of /report.
"(yournamehere):" at the start of the line get replaced
with k_nick. Example:
Your name is "kemiKal_sWeMoB", you set your k_nick to "-kK-". Now, in Kombat Teams versions previous to 2.10 you would see:
(kemiKal_sWeMoB): a:0 h:100 sg:25

In version 2.10 or above however (if you got k_nick defined), it will read:
-kK- a:0 h:100 sg:25

* "k_flags":
Add flagvalues together to customize your settings.

example: type "setinfo k_flags 3" in console to enable teamsounds and
autoscreenshot (("k_sound" = 1 + "k_sshot" = 2) = 3).

FLAGVALUES:
-----------
1 = "k_sound" See "k_soundX" under "player commands explained"
2 = "k_sshot" Automatically take screenshot scoreboard at the end of a game

Team Telefrags

If you get telefragged by one of your teammates, s/he doesn't get any frags for it but you get a death registred (not a -1 on frags but a +1 on deaths).

LockTypes

OFF = no locking.
ALL = lockout all players trying to enter if game is in progress.
TEAM = lockout all players trying to enter during match if their team is not set to one of the teams playing.

Server Settings that functions as locks of a sort, are:

k_lockmin (minimum number of teams in game)
k_lockmax (maximum number of teams in game)
k_membercount (minimum number of players in each team)
k_exclusive (if set, maxplayers is locked on matchstart)

Server Reset

On /reset, KT will execute the file "configs/reset.cfg" on the server.

The ZIPped package of Kombat Teams should contain this directory and file. That file is to be considered as the server "defaults" and can be freely reconfigured as the server admin sees fit.

If the server allow admins, admins may also execute special admin configs on the server, where the server keeps settings for different leagues, gametypes etc. This is done like this:

Since KT support maps that some people might not have on their harddrive it also allows the Serveradmin to set a defaultmap to which it will change to when the last player on the server logs out.

In older versions of KT players could log off during mapchange which could leave the server empty on an unwanted map; KT now checks a minute after mapchange if the server is empty or not -

if it is, KT switches back to k_defmap.
Alternatively of course, the admin (you) can allow map downloading. The localinfo value to set defaultmap is called "k_defmap".

If activated (by setting k_idletime above 0) he will wait for at least 50% of the players on the server to go ready, after that he will nag on the others to go ready every 5 seconds thereafter (and seconds 4, 3, 2 and 1).

After "k_idletime" seconds have passed (since 50% of the players got ready) the idlebot will kick all players that have failed to go ready and start normal countdown if more than 2 players remain on the server.

It is only recommended that you use the idlebot for public servers that are 1vs1 or 2vs2 oriented.

A simple function. If a majority (> 50%) of the players vote for "pickup", KT will set all the players skins to "base", their color to 0 (white) and their team to "" (nothing). For this to work the server has to not be in Master Mode. If an admin types this command the everyone is automatically set to the above.

Thanks to

McCoy
Bannor
Tomppa
Zoid
Strider

Thank you!
----------
All members of TSL, JeePster, oKKun, HonK,
FuN: Agorn - Awful Swede - Haywire - Zevlion - Kurgan,
Fang, Axu, Perkele, Adze, HellsAngel, Paralyzer,
Yyrkoon, Descenman, Heksen, CrazyMac, Rodan, oWl,
Garfield, SLOP, Sister Death, Sandman, Blom,
Paul Chambers, Thoth, Postman Phat, Zarjazz, Acquiesce,
Nator, Spin, Zibbo, Frick, CiC , CausticRob J, Amok,
Jezaja, X-Man, TC-Dade, Deeper, Lion, Jimbob.

A big "thank you" to all you people using the patch as players and/or admins; this modification
has depended on your input and will continue to do so.

If you wish to comment on this Document or point out any faults then you can contact author at :

admin	If admins are allowed on the server, this is how you become one. A six digit code will then be entered.. Each digit is entered by an impulse command between 1 and 9.
Cam	Shows info on Kombat Team's built-in camera functions.
Join	Reconnects to server as a player (Same as Typying spectator 0 and reconnect in console).
Scores	Prints teamscores during game including players that dropped Also shows current remaining matchtime. It will only show scores in matches that involves 2 teams and at least 3 players on match-start.
Status	Prints most frequently changed Match Settings.
Status2	Prints match-settings such as Spectalk Settings, Qizmo Settings and Lock Settings.
Who	Prints playerlist which shows which are players are ready (and which team) and which are not.
Whonot	Prints playerlist which shows which are players have not readied yet.
Whoskin	Prints a playerlist showing all the skins that players are using.

qtimer	fpd XOR 2. Toggles lockout of the Qizmo powerup timers.
qlag	fpd XOR 8. Toggles lockout of the Qizmo lag-set features.
qenemy	fpd XOR 32. Toggles lockout of the Qizmo enemies in the vicinity reporting.
qpoint	fpd XOR 128. Toggles lockout of the Qizmo item-point function. (%x %y reporting).

Localinfo	1000	death32c
Localinfo	1001	base32b

Kombat Teams 2.10 Documentation

Introduction