/\/\atchmod 2000
Version .02 Beta
Welcome to the second beta release of /\/\atchmod 2000 for Quake 3 Arena. /\/\atchmod 2000 is designed to be extremely configurable and flexible. It will allow hosts to configure single weapons play to all weapons play. As well as hosting official matches. This release is a server side mod, it does not require the client to download any files, later releases will incorporate a client side (downloadable) mod, for additional features. We added MatchPlay mode in this build to support OGL, and other online Gaming Ladder's. Eventually, after ID Software, re-releases their point release, many of the needed CVARs will be put into a menu system making it easier to administrate.
Bug Fixes Id's:
Fixed crash on "no pedistal"
Fixed map bug crash (if map does not exists!)
Changed Banning to a text file.
Bug Fixes MM ver .1:
weaponflags
railgun damage type-O
Features in this release are:
MatchPlay !
Control files to revert back to a preset config should a server be left in the Match Play state unattended for 300 seconds
Vote Match Operators (to use allow_vote must be 1)
Cannot kick by vote Server Operators
Overtime Type CVAR , 1 is sudden death!, 2 is timed (then sudden death for second round of overtime, 0 is disabled) Team/MatchPlay
Overtime Time CVAR for length of Minutes of overtime if timed
Definable default_cfg CVAR
Weapons Quickswitch
Configurable Off-Hand Grapple (bind a key to +button5, IE /bind mouse3 "+button5" ) and the ability to turn it on or off on a sever via CVAR
Rail Arena Mode (One Hit Rail)
Weapon Flags (for weapon banning)
Weapons Stay
Banned Items
Banned Ammo
Banned Runes (i.e. Invisibility, Regeneration, Haste)
Spawn Timers (i.e. Armor, Health, Ammo)
Text Filtering (file can be edited to add more words)
Warm Up Mode (at the start of each map, even DM FFA)
Server Operators Lists and the ability to have it on or off
PC Installation
Unzip the MM2000v02.zip files in you default Quake 3 directory, (i.e. C:\Program Files\Quake III Arena\ ) Installed files are:
gagamex86.dll (root q3a directory) - Matchmod 2000 Mod
textfilter.cfg (\baseq3\) - Banned text file
mmctf.cfg (\baseq3\) - Sample Cfg File
mmdm.cfg (\baseq3\) - Sample Cfg File
mm2000help.htm (\baseq3\) - This doc
<username.txt>(\baseq3\passwords) - Operators Individual TXT Files
Starting up a dedicated server
Create a desktop shortcut to your quake3.exe file. Right click on the icon and select properties, then click on the shortcut tab. In the target line you will see the path of the quake3.exe file in " " . At the end of this line add a space, followed with this:
+set dedicated 4 +set com_hunkmegs 24 +exec mmctf.cfg
The number following "+set dedicated #" will set the type of server game you wish to host, 2 is FFA DM mode, 3 is TeamPlay mode, 4 is CTF mode. Also we have included 2 sample server cfg files, one for CTF and one for DM, these can be modified to fit your server needs.
(NOTE: This command line is generic and should be sufficient for most dedicated servers, additional variables may be needed depending on your computer configuration and/or ISP connection, please read Q3A documentation if you have problems.)
Matchmod 2000 Server Variables
These are server commands and variables that are unique to Matchmod 2000, these are also included in the mm2000.cfg file and can be modified to fit your needs.
seta grapple 0/1 - Default 0 , 1 enables off handed grapple.
seta overtime 0/1/2 - Default 0 Disabled, 1 is sudden death! , 2 is timed (then sudden death for second overtime).
seta ot_time <value> - If using a timed Overtime Period, Default is 3 , 3 minutes. Must not be 0!
seta default_cfg "STRING" = Default dm.cfg . This MUST be set to run your default server config file after match play timeout or server mode restart!
seta quickswitch 0/1 - Default off . Quick Weapon Switching
seta g_opIPs 0/1 - setting this to 1 allows a server to have Server Operators, 0 is off or No Server Operators. Default on .. allows "Operators" When on the access is controlled by the g_opIPs.cfg file
seta grapple 0/1 - setting this to 1 will enable grappling, the client will have to bind a key to "+button5" without quotes, to use grapple, this is a off-hand grapple "hook" will look like a lightning bolt when activated.
seta grapple_fire 800/1990 - this setting will set the speed of the grapple. 800 is slow, 1990 is the fastest
seta grapple_speed 750/1990 - (flight speed of hook)750/slow 1990 fast
seta grapple_pull_speed 750/1990 - (750)is slow 1990 will slam you into stuff )
seta matchmod 0/1 - setting this to 1 will put the server in rail gun only mode. This is one hit / one kill mode, regardless of health and/or armor of the "fragee"
seta railwait 5/1500 - this sets the reload time of the railgun, 1500 is slow, 5 is WICKED FAST!!!!!!!
seta use_mm_warmup 0/1 - this will enable a warm-up time at the beginning of each map, very useful for starting matches.
seta mm_warmup 30 - this sets warm up time (in seconds) at the beginning of each map, the last 3 seconds are audibly counted on client side.
seta filtering 0/1 - setting 1 will enable text filtering, from the text listed in the textfilter.cfg file. This file can be edited to add words to filter.
seta s_armor 25- sets the respawn time (in seconds) of the armor after it has been picked up. Default is 25
seta s_team_weapon 30 - sets the respawn time (in seconds)
seta s_health 35 - sets the respawn time (in seconds) of health after it has been picked up. Default is 35
seta s_ammo 40 - sets the respawn time (in seconds) of all ammo after it has been picked up. Default is 40
seta s_holdable 60 - sets the respawn time (in seconds) of the holdable items after it has been picked up.
seta s_megahealth 120 - sets the respawn time (in seconds) of the megahealth after it has been picked up. Default is 120
seta s_powerup 120 - sets the respawn time (in seconds) of all power ups after it has been picked up. Default is 120
Weapon Bans
gauntlet 1 shotgun 2 grenade launcher 4 rocket launcher 8 lightning gun 16 railgun 32 plasma gun 64 BFG 128 0 indicates no bans. To ban specific weapons, add the corresponding numbers together, for example, if you wanted to ban the BFG, the Rail Gun, and the Gauntlet, add 128 + 32 + 1 = 161 the command would be
seta weaponflags "161"
Item Bans
armour shard 1 combat armour 2 body armour 4 small health 8 health 16 large health 32 mega health 64 teleporter 128 medkit 256 quad 512 environment suit 1024 0 indicates no bans. To ban specific items, add the corresponding numbers together. For example, if you wanted to ban the Medkit, the Teleporter, and the Quad, add 256 + 128 + 512 = 896 the command would be
seta banned_items "896"
Ammo Bans
shells 1 bullets 2 grenades 4 cells 8 lightning 16 rockets 32
0 indicates no bans. To ban specific items, add the corresponding numbers together. For example, if you wanted to ban rockets, bullets and cells, add 32 + 2 + 8 = 42 the command would be
seta ammoflags "42"
Rune Bans
haste 1 invisibility 2 regeneration 4 teleporter 8
0 indicates no bans. To ban specific items, add the corresponding numbers together. For example, if you wanted to ban the haste, teleporter and the invisibility, add 1 + 8 + 2 = 11 the command would be
seta runeflags 11
Starting Weapons
shotgun 1 machine gun 2 grenade launcher 4 rocket launcher 8 lightning gun 16 railgun 32 plasma gun 64 BFG 128
This will set which weapons a client will start with, at the beginning of a map and after re-spawn. Example, if you wanted all clients to have the BFG, the Railgun and the shotgun add the corresponding numbers together 128 + 32 + 1 = 161 the command would be
seta start_weapons "161"
New Server commands:
ban <name@ip> - Can use wildcards ! (ban *@123.12.34.*:*)
addop <name> <ip> - Use full IP! (addop RaVeN 123.456.78.9:27960)
Player commands:
/players - list all the players connect to server.
/bind <key> +button5 - (Off hand grapple if enabled)
Additional Vote Options
/callvote matchop <Name> - Call a player vote to promote Named player to Match Operator if passed and there is Not an Operator/Match Operator already on the server!If a player is Server Operator he cannot be kicked by vote.
But a Match Operator can be kicked by vote.
Match Operator Commands
m_help - Displays Match Operator command list /description to your console! This list.
m_timelimit <minutes> - Match Time limit
m_begin - Start Match
m_matchplay 1/2 - 1 = Teamplay Match, 2 = CTF Match. If already in Matchr restarts in Normal mode
m_stop - Ends Match
m_restart - restarts match, no countdown
m_map <mapname> - Changes map
m_team <playername> red/blue/spectator - Forces Team Switch
m_unlock - Unlocks teams. Matchplay only!
m_lock - Locks teams. Matchplay only!
m_caplimit <value> - Flag Capture Limit if CTF Match
m_friendlyFire - 1 on, 0 off
m_password <string> - Server Password (Operators only)!
m_fraglimit <value> - Fraglimit Type Match rather than timed
players - List all players on Server
m_kick <playername> - Matchplay only for Match ops /always for operators
m_decline - Removes your operator/match op status
m_overtime 0/1/2 - Match Overtime Method (1 sudden death, 2 timed, 0 off)
m_ot_time <value> - If Overtime is Timed in minutes (default is 3)m_weaponspawn <value> - (weapon spawning time) OGL says 5 !
Administering A Match
When you join a MatchMod server that allows voting.
Simply "/callvote matchop <yourplayerName>" if vote is passed, restart server to matchplay mode with "/m_matchplay X" replacing the X with 1 for Teamplay Match or 2 for CTF Match. When you reconnect the server will be in "warm-up mode".
(NOTE: if match is not started within 300 seconds(5 minutes),
the server will auto restart to original CVAR "default_cfg" config.)
Have players join up to teams, the start match with "/m_begin" it will give a 10 second countdown then start match! (teams will auto LOCK! ,see unlock commands below) After match is played the server does NOT switch map !, it stays in intermission (for up to 5 minutes,(will restart in default_cfg) to play level again simply "/m_begin",
or to switch to another map simply "/m_map <mapname(ie:q3ctf2)>" which will start the process over.
NOTE:
If server is left un-attended it WIll try to execute the "default_cfg" (in 5 minutes), to restart the server in normal mode!
Overtime rules:
Set overtime mode by console, rcon or "/m_overtime <1/2/0>"(default is OFF)
If the team caps (CTF) or frags (TP) are equal at the end of the timelimit, the server will try to run overtime mode.
If "overtime cvar is 1" it will be sudden death overtime, (next frag (TP) or Cap (CTF) Wins)
If "overtime cvar is 2" it goes into timed (set time by "/m_ot_time <value>"default is 3),
If at the end of this overtime period there is no clear winner, the server goes to Sudden death!.
Thank you for using Matchmod 2000, if you have any questions or comments please post them on our discussion board, www.planetquake.com/matchmod
We hope this mod suites most sysop's/player's needs, it will become more configurable as we progress!
Special thanks to our newest addition "AnthonyJ" for his expert coding skills! also thanks to Willi (grapple code), The clan's USA, RWD, SfQ for the time trying to break it !
Rhea(OSP) various help, and MrElusive(ID) for helping us get the new file functions worked out !
Of course PlanetQuake.com (Hellchick) for hosting us (they got their networks problems fixed !!)
If we forgot someone it was not intentional.
Doug "RaVeN" Buckley
theraven@planetquake.com
icq# 9197172
The MatchMod Development Team is:
RaVeN, GiZZed, Bodo, RivrStyx, GiGanToPitHiCus, Flanders, & AnthonyJ