Added scrollbar picture support (builtin).
[divverent/nexuiz.git] / gamemodes.txt
1 ========================\r
2 =   Game Mode Patch    =\r
3 =By Dan Hale, aka Wazat=\r
4 ========================\r
5 \r
6 This patch enables game modes like Capture the Flag and Domination, and adds more controls for all game modes.\r
7 \r
8 See Cvars.txt and mapping.txt in /data/ for more info.\r
9 \r
10 \r
11 ================\r
12 =Starting a map=\r
13 ================\r
14 \r
15 You can select a map from the menu and even build a maplist with it as normal.  To get the menu to list more maps, see the Adding Maps section.\r
16 \r
17 To change maps from the console or a dedicated server, you usually won't use "map" or "changelevel" anymore.  Instead use "exec maps/<filename>.mapcfg".  For example, to play domination on nexdm10, type "exec maps/dom_nexdm10.mapcfg".  This is the preferred method, though you can use "map" and "changelevel" if you need to.\r
18 \r
19 Note for dedicated servers:\r
20 Please look over cvars.txt and find out how to enable team balancing and other helpful features, as they won't take effect automatically in a dedicated server.  Your maplist should also list the mapcfg files (dm_nexdm03 rune_nexdm08 etc) instead of the .bsp files (nexdm03).\r
21 Also remember that you can edit the .mapcfg files in the pk3 to change fraglimits, timelimits, and other features.  If players begin complaining that maps don't last long enough you should probably do this (or set the frag overrides like g_domination_point_limit).  You can find out more about those in mapping.txt\r
22 \r
23 \r
24 ============\r
25 =Game Modes=\r
26 ============\r
27 \r
28 Classic Deathmatch\r
29 Team Deathmatch (TDM)\r
30 Domination\r
31 Capture the Flag\r
32 Runematch\r
33 \r
34 \r
35 Classic Deathmatch\r
36 ------------------\r
37 \r
38 Nothing's changed here.  It's the standard frag fest we all know and love.\r
39 \r
40 \r
41 Team Deathmatch (TDM)\r
42 ---------------------\r
43 \r
44 TDM places players on different teams, making them win or lose together.  There are some new options for this mode including balancing teams.\r
45 \r
46 \r
47 Domination\r
48 ----------\r
49 \r
50 Frags are not the focus.  Instead players must capture control points placed throughout the level.  You capture a control point by touching it, and it will change to your team's insignia.  The longer you control points and the more you have, the more your team will score.  On some levels there may be some control points that award more points than others, so be sure to prioritize!\r
51 \r
52 \r
53 Capture The Flag\r
54 ----------------\r
55 \r
56 In CTF the main goal is to steal the enemy flag and take it back to your base to capture it.  You must have your flag back at base to capture, and you must touch it while carrying the enemy flag.  That said, you must also guard your flag from being stolen by the enemy team, or you will not be able to capture their flag, and they might capture yours.\r
57 \r
58 \r
59 Rune Match\r
60 ----------\r
61 \r
62 Players must find runes scattered throughout the level.  The longer you hold a rune, the more points you'll get.  Runes also imbue their holder with special powers, such as increased defense or speed.  However, every rune also has a curse attached to it, which has the opposite effect of a rune.  So you may have increased attack but lowered defense!\r
63 Runes pair up with curses randomly, and recombine into new pairs when their holder dies and drops them.\r
64 \r
65 There are 5 runes and just as many curses.  Each rune has its own color, and its opposing curse is the same color but a different shape.  Below I've listed each of the runes and their opposing curses.\r
66 \r
67 Rune: Strength (RED)\r
68 Increases attack power\r
69 Curse: Weakness\r
70 Decreases attack power\r
71 \r
72 Rune: Defense (BLUE)\r
73 Increases defense\r
74 Curse: Vulnerability\r
75 Decreases defense\r
76 \r
77 Rune: Vitality (GREEN)\r
78 Increases maximum HP and health regeneration rate\r
79 Curse: Venom\r
80 Decreases maximum HP and increases health degeneration rate\r
81 \r
82 Rune: Speed (YELLOW)\r
83 Increases movement and attack speed\r
84 Curse: Slow\r
85 Decreases movement and attack speed\r
86 \r
87 Rune: Vampire (PURPLE)\r
88 Gain health when you attack other players\r
89 Curse: Empathy\r
90 Lose health when you attack other players\r
91 \r
92 \r
93 Rune Match is usually played as a free for all, so you generally won't have a team to help you.\r
94 \r
95 \r
96 ===========\r
97 Adding Maps\r
98 ===========\r
99 \r
100 This mod changes how maps are handled by the menu, so in order for a new map to be listed you need to add a .mapcfg file for it at the bare minimum (or hope the map's author has made one for you).  You can view existing mapcfgs in the maps folder, but here's a simple example of "dm_nexdm01.mapcfg":\r
101 \r
102 set fraglimit 20\r
103 set timelimit 15\r
104 changelevel nexdm01\r
105 \r
106 \r
107 In truth, the *only* thing a mapcfg needs is the changelevel command, but usually you'll also want to set the game mode and default fraglimit and timelimit.\r
108 \r
109 Mapcfgs are discussed in greater detail in mapping.txt\r
110 \r
111 \r
112 ==============\r
113 Grappling Hook\r
114 ==============\r
115 \r
116 Servers can now enable the grappling hook with "g_grapppling_hook" set to 1.  Bind a key to "+hook" to use it.  For example:\r
117 bind f "+hook"\r
118 \r
119 \r
120 ============\r
121 Menu Options\r
122 ============\r
123 \r
124 There are also new options available for these game modes:\r
125 \r
126 ------------\r
127 Common & TDM\r
128 ------------\r
129 \r
130 Join Message Display Time\r
131 How long to display the join message to tell players what game mode is being played and what team they are on.\r
132 \r
133 Auto-Balance Teams\r
134 When players join, automatically assign them to the smallest team to keep things balanced (they can still change teams, however)\r
135 \r
136 Force Balanced Teams\r
137 Players cannot switch to larger teams, and the game moves players around to make sure each team is more or less even in player numbers.  Players can switch to smaller or equally-sized teams, however.\r
138 \r
139 Prevent Team Imbalance\r
140 If a player tries to change teams, he must join a team of lesser size or else he will be forced back to his old team, unless there are bots in that team he can trade with.\r
141 \r
142 Changing team not allowed\r
143 Players cannot switch teams by themselves at all.  It is recommended you combine this with Force Balanced Teams, so that the game will move players around automatically if players leave and unbalance the teams.\r
144 \r
145 Team Deathmatch # of teams\r
146 The number of teams in Team Deathmatch (2 - 4).\r
147 \r
148 Score Transfer % on Change Team\r
149 When players choose to change teams, this is the percent of their score they get to keep (0 - 100).\r
150 \r
151 Friendly Fire\r
152 If a team game is being played, this controls whether allies can hurt themselves or each other\r
153 \r
154 Force Teamplay\r
155 Play a team game even if only normal deathmatch is selected\r
156 \r
157 \r
158 ----------\r
159 Domination\r
160 ----------\r
161 \r
162 Point Limit\r
163 (Overrides map settings) How many points a team needs to win the game\r
164 \r
165 No Scores From Kills\r
166 Players don't get points from kills, only from controlling domination points.  They do however still lose points if they kill themselves or a teammate.\r
167 \r
168 Domination Score Amount\r
169 (Overrides map settings) How many points a domination point gives to the team that owns it each time it pings.\r
170 \r
171 Score Frequency\r
172 (Overrides map settings) How often each domination point pings out points for its teammates.\r
173 \r
174 DomPoint Capture Delay\r
175 How long after being touched it takes for a Domination Point to be captured.\r
176 \r
177 Default # of teams\r
178 If playing on a normal DM map or non-Domination map, this is how many teams will be available to join.\r
179 \r
180 ----------------\r
181 Capture the Flag\r
182 ----------------\r
183 \r
184 Point Limit\r
185 (Overrides map settings) How many points a team must score to win\r
186 \r
187 Return Time\r
188 How long flag takes to return when dropped\r
189 \r
190 Capture Points (player)\r
191 How many points to give to the player who captured the flag in addition to what the whole team gets\r
192 \r
193 Capture Points (team)\r
194 How many points the whole team gets when they capture the flag\r
195 \r
196 Pickup Points\r
197 You get this many points simply for picking up the enemy flag\r
198 \r
199 Return Points\r
200 Points you recieve when you return your flag to base\r
201 \r
202 Rogue Team Return Points\r
203 Points a rogue team gets when returning the flag\r
204 \r
205 \r
206 ----------\r
207 Rune Match\r
208 ----------\r
209 \r
210 Point Limit\r
211 How many points a player needs to win a match\r
212 \r
213 Point Rate\r
214 How often each player carrying runes will score points\r
215 \r
216 Point Amount\r
217 How many points player gets per rune he's carrying\r
218 \r
219 Shuffle Time\r
220 How often runes change position when not picked up\r
221 \r
222 Respawn Time\r
223 How quickly runes respawn after being dropped\r
224 \r
225 Rune Settings\r
226 There are settings for each rune to modify its effects on the player when carries.\r
227 Most of these are ratios, meaning 0.5 is 50% and 1.2 is 120%.\r
228 \r
229 \r
230 =========\r
231 =Credits=\r
232 =========\r
233 \r
234 My name's Dan Hale, aka Wazat.  I'm responsible for writing the code and making the changes to the menu.  I also added lots of features like team balancing, which weren't there before.\r
235 \r
236 Black helped me with lots of menu stuff, and fixed it when I made a mess of things.  He got the map filter working, too.  Thanks, Black!\r
237 \r
238 Thanks to Kaz for pushing me to do this and giving feedback & suggestions.  It turned out great because of him.\r
239 \r
240 "Lardarse" Gregory R. Payne came up with the initial idea of Rune Match and helped me define it further from there.  In fact, probably most or all of the idea is his, and I take credit for coding it.\r
241 \r
242 Uber special thanks to Black for his awesome idea on how to do maplists and game mode selection by map.\r
243 \r
244 Special thanks to Randy, who provided the awesome team symbols for Domination & CTF.\r
245 \r
246 Thanks to people who beta tested, found bugs, and/or made suggestions:\r
247 Kaz, Lardarse, stahl (who helped me weed out the dedicated server bugs)\r
248 Probably others I've forgotten  :(\r
249 \r
250 \r
251 \r
252 \r
253 \r
254 =======\r
255 Changes\r
256 =======\r
257 \r
258 Version 1.1\r
259 -----------\r
260 \r
261 Dom points and CTF flags are now properly animated.\r
262 Fixed the grappling hook so it can be refired right after being released\r
263 Fixed the obnoxious "landing on floor" sound when using the hook\r
264 You should no longer take damage from using the grappling hook\r
265 Grappling hook flight and pull speed can now be set in the menu or by cvars\r
266 Fixed the management menu crashing when trying to save the Game settings (actually Black fixed it).\r
267 Black fixed the Map Filter too, so that it should properly change the currently selected map, and work in the maplist menu.\r
268 \r