]> icculus.org git repositories - divverent/nexuiz.git/blob - data/entities.def
leileilol's effect updates
[divverent/nexuiz.git] / data / entities.def
1 // Nexuiz  entity definition file for GTKRadiant\r
2 // Based on draft by Suicide 20 7.30.99 and inolen 9-3-99\r
3 // Upgraded by Jakob MG (tZork): jakob@webxpress.se\r
4 // (visible models added by raYGunn - paths provided by Suicide 20)\r
5 // (terrain information added to func_group entity by Paul Jaquays)\r
6 // Q3Map2 entitys/keys added by ydnar\r
7 // Version: 0.1\r
8 // Last updated: 2005-11-02\r
9 \r
10 //=============================================================================\r
11 \r
12 // Q3Map2 entities\r
13 \r
14 //=============================================================================\r
15 \r
16 /*QUAKED _decal (0 1.0 0) ?\r
17 -------- KEYS --------\r
18 "target" : the name of the entity targetted at for projection\r
19 -------- SPAWNFLAGS --------\r
20 (none)\r
21 -------- NOTES --------\r
22 Compiler-only entity that specifies a decal to be projected. Should contain 1 or more patch meshes (curves) and target an info_null entity. The distance between the center of the _decal entity and the target is the axis and distance of projection.\r
23 */\r
24 \r
25 /*QUAKED _skybox (0.77 0.88 1.0) (-4 -4 -4) (4 4 4)\r
26 -------- KEYS --------\r
27 "angle" : rotation angle of the sky surfaces.\r
28 "angles" : Individual control of PITCH, YAW, and ROLL (default 0 0 0).\r
29 "_scale" : scaling factor (default 64), good values are between 50 and 300, depending on the map.\r
30 -------- SPAWNFLAGS --------\r
31 (none)\r
32 -------- NOTES --------\r
33 Compiler-only entity that specifies a the origin of a skybox (a wholly contained, seperate area of the map), similar to some games' portal skies. When compiled with Q3Map2, the skybox surfaces will be visible from any place where sky is normally visible. It will cast shadows on the normal parts of the map, and can be used with cloud layers and other effects.\r
34 */\r
35 \r
36 //=============================================================================\r
37 FUNC_* ENTITIES\r
38 //=============================================================================\r
39 \r
40 /*QUAKED func_bobbing (0 .5 .8) ? X_AXIS Y_AXIS\r
41 Solid entity that oscillates back and forth in a linear motion. By default, it will have an amount of displacement in either direction equal to the dimension of the brush in the axis in which it's bobbing. Entity bobs on the Z axis (up-down) by default. It can also emit sound if the "noise" key is set. Will crush the player when blocked.\r
42 -------- KEYS --------\r
43 speed : amount of time in seconds for one complete oscillation cycle (default 4).\r
44 height : sets the amount of travel of the oscillation movement (default 32). \r
45 phase : sets the start offset of the oscillation cycle. Values must be 0 < phase < 1. Any integer phase value is the same as no offset (default 0).\r
46 noise : path/name of .wav file to play. Use looping sounds only (eg. sound/world/drone6.wav - See Notes).\r
47 model2 : path/name of model to include (eg: models/mapobjects/jets/jets01.md3).\r
48 origin : alternate method of setting XYZ origin of sound and .md3 model included with entity (See Notes).\r
49 light : constantLight radius of .md3 model included with entity. Has no effect on the entity's brushes (default 0).\r
50 color : constantLight color of .md3 model included with entity. Has no effect on the entity's brushes (default 1 1 1).\r
51 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
52 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
53 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
54 -------- Q3MAP2 KEYS --------\r
55 _targetname : Used to attach a misc_model entity to this entity.\r
56 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
57 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
58 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
59 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
60 -------- Q3MAP2 TERRAIN KEYS --------\r
61 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
62 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
63 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
64 -------- SPAWNFLAGS --------\r
65 X_AXIS : entity will bob along the X axis.\r
66 Y_AXIS : entity will bob along the Y axis.\r
67 -------- NOTES --------\r
68 In order for the sound to be emitted from the entity, it is recommended to include a brush with an origin shader at its center, otherwise the sound will not follow the entity as it moves. Setting the origin key is simply an alternate method to using an origin brush. When using the model2 key, the origin point of the model will correspond to the origin point defined by either the origin brush or the origin coordinate value.\r
69 \r
70 Target this entity with a misc_model to have the model attached to the entity (set the model's "target" key to the same value as this entity's "targetname").*/\r
71 \r
72 //=============================================================================\r
73 \r
74 /*QUAKED func_button (0 .5 .8) ?\r
75 When a button is touched by a player, it moves in the direction set by the "angle" key, triggers all its targets, stays pressed by an amount of time set by the "wait" key, then returns to it's original position where it can be operated again.\r
76 -------- KEYS --------\r
77 angle : determines the direction in which the button will move (up = -1, down = -2).\r
78 target : all entities with a matching targetname will be triggered.\r
79 speed : speed of button's displacement (default 40).\r
80 wait : number of seconds button stays pressed (default 1, -1 = return immediately).\r
81 lip : lip remaining at end of move (default 4 units).\r
82 health : (default 0) if set to any non-zero value, the button must take damage (any amount) to activate.\r
83 light : constantLight radius of .md3 model included with entity. Has no effect on the entity's brushes (default 0).\r
84 color : constantLight color of .md3 model included with entity. Has no effect on the entity's brushes (default 1 1 1).\r
85 model2 : path/name of model to include (eg: models/mapobjects/pipe/pipe02.md3).\r
86 origin : alternate method of setting XYZ origin of .md3 model included with entity (See Notes).\r
87 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
88 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
89 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
90 -------- Q3MAP2 KEYS --------\r
91 _targetname : Used to attach a misc_model entity to this entity.\r
92 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
93 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
94 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
95 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
96 -------- Q3MAP2 TERRAIN KEYS --------\r
97 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
98 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
99 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
100 -------- NOTES --------\r
101 Setting the origin key is simply an alternate method to using an origin brush. When using the model2 key, the origin point of the model will correspond to the origin point defined by either the origin brush or the origin coordinate value.\r
102 \r
103 Target this entity with a misc_model to have the model attached to the entity (set the model's "target" key to the same value as this entity's "targetname").*/\r
104 \r
105 //=============================================================================\r
106 \r
107 /*QUAKED func_door (0 .5 .8) ? START_OPEN - CRUSHER\r
108 Normal sliding door entity. By default, the door will activate when player walks close to it or when damage is inflicted to it.\r
109 -------- KEYS --------\r
110 angle : determines the opening direction of door (up = -1, down = -2).\r
111 speed : determines how fast the door moves (default 100).\r
112 wait : number of seconds before door returns (default 2, -1 = return immediately)\r
113 lip : lip remaining at end of move (default 8)\r
114 targetname : if set, a func_button or trigger is required to activate the door.\r
115 health : (default 0) if set to any non-zero value, the button must take damage (any amount) to activate.\r
116 dmg : damage to inflict on player when he blocks operation of door (default 4). Door will reverse direction when blocked unless CRUSHER spawnflag is set.\r
117 team: assign the same team name to multiple doors that should operate together (see Notes).\r
118 light : constantLight radius of .md3 model included with entity. Has no effect on the entity's brushes (default 0).\r
119 color : constantLight color of .md3 model included with entity. Has no effect on the entity's brushes (default 1 1 1).\r
120 model2 : path/name of model to include (eg: models/mapobjects/pipe/pipe02.md3).\r
121 origin : alternate method of setting XYZ origin of .md3 model included with entity (See Notes).\r
122 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
123 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
124 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
125 -------- Q3MAP2 KEYS --------\r
126 _targetname : Used to attach a misc_model entity to this entity.\r
127 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
128 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
129 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
130 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
131 -------- Q3MAP2 TERRAIN KEYS --------\r
132 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
133 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
134 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
135 -------- SPAWNFLAGS --------\r
136 START_OPEN : the door will spawn in the open state and operate in reverse.\r
137 CRUSHER : door will not reverse direction when blocked and will keep damaging player until he dies or gets out of the way.\r
138 -------- NOTES --------\r
139 Unlike in Quake 2, doors that touch are NOT automatically teamed. If you want doors to operate together, you have to team them manually by assigning the same team name to all of them. Setting the origin key is simply an alternate method to using an origin brush. When using the model2 key, the origin point of the model will correspond to the origin point defined by either the origin brush or the origin coordinate value.\r
140 \r
141 Target this entity with a misc_model to have the model attached to the entity (set the model's "target" key to the same value as this entity's "targetname").*/\r
142 \r
143 //=============================================================================\r
144 \r
145 /*QUAKED func_group (0 .5 .8) ?\r
146 This is not an entity as such. It is strictly an editor utility to group world brushes and patches together for convenience (selecting, moving, copying, etc). You cannot group entities with this.\r
147 -------- OLD TERRAIN KEYS (note: obsolete with Q3Map2) --------\r
148 alphamap : this is the path/name for the art file used to guide the mapping of textures on the terrain surface.\r
149 layers : this integer value is the number unique root shaders that will be use on the terrain.\r
150 shader : this is the path to the metashader used to assign textures to the terrain entity.\r
151 terrain : this is an on/off flag. When set to 1, the entity becomes a terrain entity. Note: unecessary when compiling with Q3Map2. See Q3Map2 keys.\r
152 -------- Q3MAP2 KEYS --------\r
153 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
154 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
155 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
156 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
157 -------- Q3MAP2 TERRAIN KEYS --------\r
158 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
159 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
160 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
161 -------- NOTES --------\r
162 The TAB key can be used to flip through the component pieces of a selected func_group entity, isolating individual components. To make a func_group into a terrain entity, refer to the Terrain Construction documentation.*/\r
163 \r
164 //=============================================================================\r
165 \r
166 /*QUAKED func_plat (0 .5 .8) ?\r
167 Rising platform the player can ride to reach higher places. Plats must always be drawn in the raised position, so they will operate and be lighted correctly but they spawn in the lowered position. The plat will stay in the raised position until the player steps off. There are no proper sounds for this entity, only beep noises. It will spawn in the game and work properly but it sounds silly (see Notes).\r
168 -------- KEYS --------\r
169 speed : determines how fast the plat moves (default 150).\r
170 lip : lip remaining at end of move (default 16). Has no effect if "height" is set.\r
171 height : if set, this will determine the total amount of vertical travel of the plat.\r
172 dmg : damage to inflict on player when he blocks operation of plat (default 4). Plat will reverse direction when blocked.\r
173 targetname : if set, the trigger that points to this will raise the plat each time it fires. The plat raises and comes back down a second later if no player is on it.\r
174 light : constantLight radius of .md3 model included with entity. Has no effect on the entity's brushes (default 0).\r
175 color : constantLight color of .md3 model included with entity. Has no effect on the entity's brushes (default 1 1 1).\r
176 model2 : path/name of model to include (eg: models/mapobjects/pipe/pipe02.md3).\r
177 origin : alternate method of setting XYZ origin of .md3 model included with entity (See Notes).\r
178 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
179 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
180 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
181 -------- Q3MAP2 KEYS --------\r
182 _targetname : Used to attach a misc_model entity to this entity.\r
183 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
184 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
185 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
186 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
187 -------- Q3MAP2 TERRAIN KEYS --------\r
188 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
189 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
190 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
191 -------- NOTES --------\r
192 By default, the total amount of vertical travel of a platform is implicitly determined by the overall vertical size of the brushes of which it's made minus the lip value. But if the "height" key is used, then the total amount of vertical travel of the plat will be exactly that value regardless of the shape and size of the plat and regardless of the value of the "lip" key. Using the "height" key is the best method for any kind of platforms and the only possible one for thin plats which need to travel vertical distances many times their own thickness. Setting the origin key is simply an alternate method to using an origin brush. When using the model2 key, the origin point of the model will correspond to the origin point defined by either the origin brush or the origin coordinate value.\r
193 \r
194 There is a way to make plats play proper sounds. Just create a sound\movers\plats folder under baseq3 and put 2 sounds named pt1_strt.wav and pt1_end.wav in it. Those can be the renamed sounds from the Q2 plats or renamed copies of the sound\movers\doors sounds you can extract from your pak0.pk3 file or new custom sounds if you're up to it. Thanks to Fragzilla for the tip.\r
195 \r
196 Target this entity with a misc_model to have the model attached to the entity (set the model's "target" key to the same value as this entity's "targetname").*/\r
197 \r
198 //=============================================================================\r
199 \r
200 /*QUAKED func_rotating (0 .5 .8) ? - - X_AXIS Y_AXIS\r
201 Solid entity that rotates continuously. Rotates on the Z axis by default and requires an origin brush. It will always start on in the game and is not targetable.\r
202 -------- KEYS --------\r
203 speed : determines how fast entity rotates (default 100).\r
204 noise : path/name of .wav file to play. Use looping sounds only (eg. sound/world/drone6.wav).\r
205 model2 : path/name of model to include (eg: models/mapobjects/bitch/fembotbig.md3).\r
206 origin : alternate method of setting XYZ origin of entity's rotation axis and .md3 model included with entity (default "0 0 0" - See Notes).\r
207 light : constantLight radius of .md3 model included with entity. Has no effect on the entity's brushes (default 0).\r
208 color : constantLight color of .md3 model included with entity. Has no effect on the entity's brushes (default 1 1 1).\r
209 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
210 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
211 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
212 -------- Q3MAP2 KEYS --------\r
213 _targetname : Used to attach a misc_model entity to this entity.\r
214 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
215 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
216 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
217 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
218 -------- Q3MAP2 TERRAIN KEYS --------\r
219 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
220 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
221 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
222 -------- SPAWNFLAGS --------\r
223 X_AXIS : entity will rotate along the X axis.\r
224 Y_AXIS : entity will rotate along the Y axis.\r
225 -------- NOTES --------\r
226 You need to have an origin brush as part of this entity. The center of that brush will be the point through which the rotation axis passes. Setting the origin key is simply an alternate method to using an origin brush. It will rotate along the Z axis by default. You can check either the X_AXIS or Y_AXIS box to change that. When using the model2 key, the origin point of the model will correspond to the origin point defined by either the origin brush or the origin coordinate value.\r
227 \r
228 Target this entity with a misc_model to have the model attached to the entity (set the model's "target" key to the same value as this entity's "targetname").*/\r
229 \r
230 //=============================================================================\r
231 \r
232 /*QUAKED func_train (0 .5 .8) ?\r
233 Trains are moving solids that follow a string of path_corner entities. Trains in Q3A are very basic, they also require an origin brush (see Notes).\r
234 -------- KEYS --------\r
235 speed : speed of displacement of train (default 100 or overridden by speed value of path).\r
236 target : this points to the first path_corner of the path which is also the spawn location of the train's origin.\r
237 model2 : path/name of model to include (eg: models/mapobjects/pipe/pipe02.md3).\r
238 origin : alternate method of setting XYZ origin of the train's brush(es) and .md3 model included with entity (See Notes).\r
239 light : constantLight radius of .md3 model included with entity. Has no effect on the entity's brushes (default 0).\r
240 color : constantLight color of .md3 model included with entity. Has no effect on the entity's brushes (default 1 1 1).\r
241 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
242 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
243 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
244 -------- Q3MAP2 KEYS --------\r
245 _targetname : Used to attach a misc_model entity to this entity.\r
246 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in this entity (default 1.0).\r
247 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
248 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
249 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
250 -------- Q3MAP2 TERRAIN KEYS --------\r
251 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
252 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
253 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.\r
254 -------- NOTES --------\r
255 1. Trains always start on in the game.\r
256 2. Trains do not damage the played when blocked.\r
257 3. Trains cannot emit sound.\r
258 4. Trains are not triggerable or toggle-able.\r
259 5. Trains cannot be block-stopped just by getting in their way, the player must be wedged between the train and another obstacle to block it.\r
260 \r
261 Setting the origin key is simply an alternate method to using an origin brush. When using the model2 key, the origin point of the model will correspond to the origin point defined by either the origin brush or the origin coordinate value.\r
262 \r
263 Target this entity with a misc_model to have the model attached to the entity (set the model's "target" key to the same value as this entity's "targetname").*/\r
264 \r
265 //=============================================================================\r
266 INFO_* ENTITIES\r
267 //=============================================================================\r
268 \r
269 /*QUAKED info_player_team1 (1 0 1) (-16 -16 -24) (16 16 45) INITIAL\r
270 CTF Spawn Points for Nexuiz\r
271 -------- KEYS --------\r
272 angle : direction in which player will look when spawning in the game. Does not apply to bots.\r
273 -------- SPAWNFLAGS --------\r
274 INITIAL : makes the spawnpoint the initial place for the player to spawn at the beginning of the game.*/\r
275 ---------NOTES----------\r
276 *note: These function just like info_player_deathmatch, but for one team only.  If you don't make team spawnpoints, info_player_deathmatch is used instead.\r
277 \r
278 //=============================================================================\r
279 \r
280 /*QUAKED info_player_team2 (1 0 1) (-16 -16 -24) (16 16 45) INITIAL\r
281 CTF Spawn Points for Nexuiz\r
282 -------- KEYS --------\r
283 angle : direction in which player will look when spawning in the game. Does not apply to bots.\r
284 ------- SPAWNFLAGS --------\r
285 INITIAL : makes the spawnpoint the initial place for the player to spawn at the beginning of the game.*/\r
286 ---------NOTES----------\r
287 *note: These function just like info_player_deathmatch, but for one team only.  If you don't make team spawnpoints, info_player_deathmatch is used instead.\r
288 \r
289 //=============================================================================\r
290 \r
291 /*QUAKED info_notnull (0 .5 0) (-8 -8 -8) (8 8 8)\r
292 Used as a positional target for entities that can use directional pointing. A target_position can be used instead of this but was kept in Q3A for legacy purposes.\r
293 -------- KEYS --------\r
294 targetname : must match the target key of entity that uses this for pointing.\r
295 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
296 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
297 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).*/\r
298 \r
299 //=============================================================================\r
300 \r
301 /*QUAKED info_null (0 .5 0) (-8 -8 -8) (8 8 8)\r
302 Used as a positional target for light entities to create a spotlight effect. A target_position can be used instead of this but was kept in Q3A for legacy purposes.\r
303 -------- KEYS --------\r
304 targetname : must match the target key of entity that uses this for pointing.\r
305 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
306 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
307 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).*/\r
308 \r
309 //=============================================================================\r
310 \r
311 /*QUAKED info_player_deathmatch (1 0 1) (-16 -16 -24) (16 16 45) INITIAL\r
312 Normal player spawning location for Q3A levels.\r
313 -------- KEYS --------\r
314 angle : direction in which player will look when spawning in the game. Does not apply to bots.\r
315 target : this can point at a target_give entity for respawn freebies.\r
316 nobots : when set to 1, bots will never use this spawn point to respawn in the game.\r
317 nohumans : when set to 1, human players will never use this spawn point to respawn in the game.\r
318 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
319 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
320 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
321 -------- SPAWNFLAGS --------\r
322 INITIAL : makes the spawnpoint the initial place for the player to spawn at the beginning of the game.*/\r
323 \r
324 //=============================================================================\r
325 \r
326 \r
327 /*QUAKED info_player_start (1 0 0) (-16 -16 -24) (16 16 45)\r
328 Player spawn location. It works in Quake III Arena, but it is not used in the Id maps. Use info_player_deathmatch instead.\r
329 -------- KEYS --------\r
330 angle : direction in which player will look when spawning in the game.\r
331 target : this can point at a target_give entity for respawn freebies.*/\r
332 \r
333 //=============================================================================\r
334 \r
335 //QUAKED info_spectator_start (1 0 0) (-16 -16 -24) (16 16 45)\r
336 //Spectator spawn location. Doesn't appear to work in game. Commented out.\r
337 //-------- KEYS --------\r
338 //notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
339 //notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
340 //notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
341 \r
342 //=============================================================================\r
343 ITEM_* ENTITIES\r
344 //=============================================================================\r
345 \r
346 /*QUAKED item_shells (.3 .3 1) (-16 -16 -16) (16 16 16)\r
347 ammo get over it, shall i say no more\r
348 -----------KEYS------------\r
349 -----------SPAWNFLAGS-----------\r
350 ---------NOTES----------\r
351 ammo how hard can it be*/\r
352 \r
353 //===================================================================\r
354 \r
355 \r
356 /*QUAKED item_rockets (.3 .3 1) (-16 -16 -16) (16 16 16)\r
357 ammo get over it, shall i say no more\r
358 -----------KEYS------------\r
359 -----------SPAWNFLAGS-----------\r
360 ---------NOTES----------\r
361 ammo how hard can it be*/\r
362 \r
363 //===================================================================\r
364 \r
365 /*QUAKED item_cells (.3 .3 1) (-16 -16 -16) (16 16 16)\r
366 ammo get over it, shall i say no more\r
367 -----------KEYS------------\r
368 -----------SPAWNFLAGS-----------\r
369 ---------NOTES----------\r
370 ammo how hard can it be*/\r
371 \r
372 //===================================================================\r
373 \r
374 /*QUAKED item_minst_cells (.3 .3 1) (-16 -16 -16) (16 16 16)\r
375 ammo get over it, shall i say no more\r
376 -----------KEYS------------\r
377 -----------SPAWNFLAGS-----------\r
378 ---------NOTES----------\r
379 minstagib ammo (prevents auto-replacement of nex & rocket launcher when used)*/\r
380 \r
381 //===================================================================\r
382 \r
383 /*QUAKED item_bullets (.3 .3 1) (-16 -16 -16) (16 16 16)\r
384 ammo get over it, shall i say no more\r
385 -----------KEYS------------\r
386 -----------SPAWNFLAGS-----------\r
387 ---------NOTES----------\r
388 ammo how hard can it be*/\r
389 \r
390 //===================================================================\r
391 \r
392 /*QUAKED item_speed (.3 .3 1) (-16 -16 -16) (16 16 16)\r
393 haste clone\r
394 -----------KEYS------------\r
395 -----------SPAWNFLAGS-----------\r
396 ---------NOTES----------\r
397 makes user faster, and jump higher*/\r
398 \r
399 //===================================================================                           \r
400 \r
401 /*QUAKED item_strength (.3 .3 1) (-16 -16 -16) (16 16 16)\r
402 gibs are funny\r
403 -----------KEYS------------\r
404 -----------SPAWNFLAGS-----------\r
405 ---------NOTES----------\r
406 quad damage clone*/\r
407 \r
408 //===================================================================                           \r
409 \r
410 /*QUAKED item_invincible (.3 .3 1) (-16 -16 -16) (16 16 16)\r
411 who touched my ass\r
412 -----------KEYS------------\r
413 -----------SPAWNFLAGS-----------\r
414 ---------NOTES----------\r
415 can't damage the user*/\r
416 \r
417 //===================================================================                    \r
418 \r
419 /*QUAKED item_slowmo (.3 .3 1) (-16 -16 -16) (16 16 16)\r
420 i dunno\r
421 -----------KEYS------------\r
422 -----------SPAWNFLAGS-----------\r
423 ---------NOTES----------\r
424 slows down the server for 5 seconds*/\r
425 \r
426 //===================================================================      \r
427 \r
428 /*QUAKED item_health1 (.3 .3 1) (-16 -16 -16) (16 16 16)\r
429 i dunno\r
430 -----------KEYS------------\r
431 -----------SPAWNFLAGS-----------\r
432 ---------NOTES----------\r
433 health small*/\r
434 \r
435 //===================================================================                            \r
436 \r
437 /*QUAKED item_health25 (.3 .3 1) (-16 -16 -16) (16 16 16)\r
438 i dunno\r
439 -----------KEYS------------\r
440 -----------SPAWNFLAGS-----------\r
441 ---------NOTES----------\r
442 health 25 points*/\r
443 \r
444 //===================================================================     \r
445 \r
446 /*QUAKED item_health100 (.3 .3 1) (-16 -16 -16) (16 16 16)\r
447 i dunno\r
448 -----------KEYS------------\r
449 -----------SPAWNFLAGS-----------\r
450 ---------NOTES----------\r
451 health 100 points*/\r
452 \r
453 //===================================================================     \r
454 \r
455 /*QUAKED item_armor1 (.3 .3 1) (-16 -16 -16) (16 16 16)\r
456 i dunno\r
457 -----------KEYS------------\r
458 -----------SPAWNFLAGS-----------\r
459 ---------NOTES----------\r
460 armor ? points*/\r
461 \r
462 //===================================================================   \r
463 \r
464 /*QUAKED item_armor25  (.3 .3 1) (-16 -16 -16) (16 16 16)\r
465 i dunno\r
466 -----------KEYS------------\r
467 -----------SPAWNFLAGS-----------\r
468 ---------NOTES----------\r
469 armor ? points*/\r
470 \r
471 //=================================================================== \r
472   \r
473 /*QUAKED item_flag_team1 (.3 .3 1) (-16 -16 -16) (16 16 16)\r
474 Team a CTF flag\r
475 -----------KEYS------------\r
476 angle   :       direction the flag will point\r
477 model   :       model of the flag (default: models/ctf/flag_red.md3 or models/ctf/flag_blue.md3)\r
478 noise   :       sound played when flag is stolen (default: "ctf/take.wav")\r
479 noise1  :       sound played when flag is returned by a teammate (default: "ctf/return.wav")\r
480 noise2  :       sound played when flag is captured (default: "ctf/capture.wav")\r
481 noise3  :       sound played when flag returns itself (default: "ctf/respawn.wav")\r
482 -----------SPAWNFLAGS-----------\r
483 ---------NOTES----------\r
484 Team 1 flag*/\r
485 //===================================================================   \r
486 \r
487 /*QUAKED item_flag_team2 (.3 .3 1) (-16 -16 -16) (16 16 16)\r
488 Team 2 CTF flag\r
489 -----------KEYS------------\r
490 angle   :       direction the flag will point\r
491 model   :       model of the flag (default: models/ctf/flag_red.md3 or models/ctf/flag_blue.md3)\r
492 noise   :       sound played when flag is stolen (default: "ctf/take.wav")\r
493 noise1  :       sound played when flag is returned by a teammate (default: "ctf/return.wav")\r
494 noise2  :       sound played when flag is captured (default: "ctf/capture.wav")\r
495 noise3  :       sound played when flag returns itself (default: "ctf/respawn.wav")\r
496 -----------SPAWNFLAGS-----------\r
497 ---------NOTES----------\r
498 Team 2 flag*/\r
499 //===================================================================   \r
500 \r
501 \r
502 //=============================================================================\r
503 LIGHT ENTITY\r
504 //=============================================================================\r
505 \r
506 /*QUAKED light (.65 .65 1) (-8 -8 -8) (8 8 8) LINEAR NOANGLE UNUSED1 UNUSED2 NOGRIDLIGHT\r
507 Non-displayed point light source. The -pointscale and -scale arguments to Q3Map2 affect the brightness of these lights. The -skyscale argument affects brightness of entity sun lights.\r
508 -------- KEYS --------\r
509 _light OR light: overrides the default 300 intensity.\r
510 _color : weighted RGB value of light color (default white - 1.0 1.0 1.0).\r
511 target : Lights pointed at a target will be spotlights.\r
512 radius: overrides the default 64 unit radius of a spotlight at the target point.\r
513 -------- Q3MAP2 KEYS --------\r
514 _sun : Set this key to 1 on a spotlight to make an infinite sun light.\r
515 fade : Fades light attenuation. Only affects linear lights.\r
516 scale : Scales light attentation, from SOF2/JK2. Scales the "light" value.\r
517 -------- SPAWNFLAGS --------\r
518 LINEAR : Use a linear falloff. Default is inverse distance squared (more realistic).\r
519 NOANGLE : Ignore angle attenuation.\r
520 NOGRIDLIGHT : Do not affect the lightgrid (dynamic entity lighting).*/\r
521 \r
522 //=============================================================================\r
523 \r
524 MISC_* ENTITIES\r
525 \r
526 //=============================================================================\r
527 \r
528 /*QUAKED misc_model (1 .5 .25) (-16 -16 -16) (16 16 16)\r
529 Generic placeholder for inserting MD3 models in game. Requires compilation of map geometry to be added to level. If the map is compiled with Q3Map2, then ASE, 3DS, OBJ and other model formats are supported.\r
530 -------- KEYS --------\r
531 angle: direction in which model will be oriented.\r
532 model : path/name of model to use (eg: models/mapobjects/teleporter/teleporter.md3).\r
533 -------- Q3MAP2 KEYS --------\r
534 angles : Individual control of PITCH, YAW, and ROLL (default 0 0 0).\r
535 modelscale : Floating-point value used to scale a model up or down (default 1.0).\r
536 modelscale_vec : Floating-point vector used to scale a model's axes individually (default 1.0 1.0 1.0).\r
537 _remap : Used to remap textures/shaders in the model. To remap all shaders to a given shader, use "*;models/mymodel/mytexture". To remap a specific shader, use "models/mymodel/old;models/mymodel/new".\r
538 target : Used to attach the misc_model to a brush entity, where its "targetname" key is the same value.\r
539 _lightmapscale : Floating point value scaling the resolution of lightmaps on this model (if model is using lightmapped shaders) (default 1.0).\r
540 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
541 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
542 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix.\r
543 */\r
544 \r
545 //=============================================================================\r
546 \r
547 /*QUAKED misc_portal_camera (1 .5 .25) (-8 -8 -8) (8 8 8) SLOWROTATE FASTROTATE\r
548 Portal camera. This camera is used to project its view onto a portal surface in the level through the intermediary of a misc_portal_surface entity. Use the "angles" key or target a target_position or info_notnull entity to set the camera's pointing direction.\r
549 -------- KEYS --------\r
550 angles: this sets the pitch and yaw aiming angles of the portal camera (default 0 0). Use "roll" key to set roll angle.\r
551 target : point this to a target_position entity to set the camera's pointing direction.\r
552 targetname : a misc_portal_surface portal surface indicator must point to this.\r
553 roll: roll angle of camera. A value of 0 is upside down and 180 is the same as the player's view.\r
554 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
555 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
556 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
557 -------- SPAWNFLAGS --------\r
558 SLOWROTATE : makes the portal camera rotate slowly along the roll axis.\r
559 FASTROTATE : makes the portal camera rotate faster along the roll axis.\r
560 -------- NOTES --------\r
561 Both the setting "angles" key or "targeting a target_position" methods can be used to aim the camera. However, the target_position method is simpler. In both cases, the "roll" key must be used to set the roll angle. If either the SLOWROTATE or FASTROTATE spawnflag is set, then the "roll" value is irrelevant.*/\r
562 \r
563 //=============================================================================\r
564 \r
565 /*QUAKED misc_portal_surface (1 .5 .25) (-8 -8 -8) (8 8 8)\r
566 Portal surface indicator. This will "lock on" the brush face closest to it and identify as a portal. The view displayed on the portal surface is the view of the misc_portal_camera that this entity targets. Also used for mirrors (see Notes).\r
567 -------- KEYS --------\r
568 target : point this to a misc_portal_camera that "sees" the view you want to display on the portal.\r
569 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
570 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
571 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
572 -------- NOTES --------\r
573 The entity must be no farther than 64 units away from the portal surface to lock onto it. To make a mirror, apply the common/mirror shader to the surface, place this entity near it but don't target a misc_portal_camera.*/\r
574 \r
575 //=============================================================================\r
576 \r
577 /*QUAKED misc_teleporter_dest (1 .5 .25) (-32 -32 -24) (32 32 -16)\r
578 Teleport destination location point for trigger_teleporter entities.\r
579 -------- KEYS --------\r
580 angle : direction in which player will look when teleported.\r
581 targetname : make the trigger_teleporter point to this.\r
582 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
583 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
584 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).*/\r
585 \r
586 //=============================================================================\r
587 \r
588 PATH_* ENTITIES\r
589 \r
590 //=============================================================================\r
591 \r
592 /*QUAKED path_corner (.5 .3 0) (-8 -8 -8) (8 8 8)\r
593 Path corner entity that func_trains can be made to follow.\r
594 -------- KEYS --------\r
595 target : point to next path_corner in the path.\r
596 targetname : the train following the path or the previous path_corner in the path points to this.\r
597 speed : speed of func_train while moving to the next path corner. This will override the speed value of the train.\r
598 wait : number of seconds func_train will pause on path corner before moving to next path corner (default 0 - see Notes).\r
599 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
600 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
601 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
602 -------- NOTES --------\r
603 Setting the wait key to -1 will not make the train stop on the path corner, it will simply default to 0.*/\r
604 \r
605 //=============================================================================\r
606 \r
607 //=============================================================================\r
608 TARGET_* ENTITIES\r
609 //=============================================================================\r
610 \r
611 \r
612 /*QUAKED target_position (0 .5 0) (-8 -8 -8) (8 8 8)\r
613 Aiming target for entities like light, misc_portal_camera and trigger_push (jump pads) in particular.\r
614 -------- KEYS --------\r
615 targetname : the entity that requires an aiming direction points to this.\r
616 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
617 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
618 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
619 -------- NOTES --------\r
620 To make a jump pad, place this entity at the highest point of the jump and target it with a trigger_push entity.*/\r
621 \r
622 //=============================================================================\r
623 \r
624 /*QUAKED target_push (.5 .5 .5) (-8 -8 -8) (8 8 8) BOUNCEPAD\r
625 This can be used to create jump pads and launch ramps. The direction of push can be set by the "angles" key or pointing to a target_position or info_notnull entity. Unlike trigger_push, this is NOT client side predicted and must be activated by a trigger.\r
626 -------- KEYS --------\r
627 angles: this sets the pitch and yaw aiming angles of push entity (default 0 0). The roll angle does not apply.\r
628 speed : speed of push (default 1000). Has no effect if entity targets an aiming entity.\r
629 targetname : the activating trigger points to this. Push originates from the location of the trigger.\r
630 target : this points to the aiming entity to which the player will jump.\r
631 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
632 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
633 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
634 -------- SPAWNFLAGS --------\r
635 BOUNCEPAD : if set, trigger will play bounce noise instead of beep noise when activated (recommended).\r
636 -------- NOTES --------\r
637 To make a jump pad or launch ramp, create a trigger_multiple where the jump must originate. Place the target_push directly above the trigger_multiple and place the target_position entity at the highest point of the jump. Target the trigger_multiple to the target_push and target the target_push to the target_position/info_notnull (or set the target_push's "angles" key). Note that the "angle" key also works.*/\r
638 \r
639 //=============================================================================\r
640 \r
641 \r
642 \r
643 \r
644 /*QUAKED target_speaker (0 .7 .7) (-8 -8 -8) (8 8 8) LOOPED_ON LOOPED_OFF GLOBAL ACTIVATOR\r
645 Sound generating entity that plays .wav files. Normal non-looping sounds play each time the target_speaker is triggered. Looping sounds can be set to play by themselves (no activating trigger) or be toggled on/off by a trigger.\r
646 -------- KEYS --------\r
647 noise : path/name of .wav file to play (eg. sound/world/growl1.wav - see Notes).\r
648 wait : delay in seconds between each time the sound is played ("random" key must be set - see Notes).\r
649 random : random time variance in seconds added or subtracted from "wait" delay ("wait" key must be set - see Notes).\r
650 targetname : the activating button or trigger points to this.\r
651 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
652 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
653 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
654 -------- SPAWNFLAGS --------\r
655 LOOPED_ON : sound will loop and initially start on in level (will toggle on/off when triggered).\r
656 LOOPED_OFF : sound will loop and initially start off in level (will toggle on/off when triggered).\r
657 GLOBAL : sound will play full volume throughout the level.\r
658 ACTIVATOR : sound will play only for the player that activated the target.\r
659 -------- NOTES --------\r
660 The path portion value of the "noise" key can be replaced by the implicit folder character "*" for triggered sounds that belong to a particular player model. For example, if you want to create a "bottomless pit" in which the player screams and dies when he falls into, you would place a trigger_multiple over the floor of the pit and target a target_speaker with it. Then, you would set the "noise" key to "*falling1.wav". The * character means the current player model's sound folder. So if your current player model is Visor, * = sound/player/visor, if your current player model is Sarge, * = sound/player/sarge, etc. This cool feature provides an excellent way to create "player-specific" triggered sounds in your levels.\r
661 \r
662 The combination of the "wait" and "random" keys can be used to play non-looping sounds without requiring an activating trigger but both keys must be used together. The value of the "random" key is used to calculate a minimum and a maximum delay. The final time delay will be a random value anywhere between the minimum and maximum values: (min delay = wait - random) (max delay = wait + random).*/\r
663 \r
664 //=============================================================================\r
665 \r
666 /*QUAKED target_teleporter (0 .5 0) (-8 -8 -8) (8 8 8)\r
667 Activating this will teleport players to the location of the targeted misc_teleporter_dest entity. Unlike trigger_teleport, this entity must be activated by a trigger and does NOT allow client prediction of events.\r
668 -------- KEYS --------\r
669 targetname : activating trigger points to this.\r
670 target : this must point to a misc_teleporter_dest entity.\r
671 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
672 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
673 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).*/\r
674 \r
675 //=============================================================================\r
676 TEAM_* ENTITIES\r
677 not in nexuiz.\r
678 //=============================================================================\r
679 \r
680 TRIGGER_* ENTITIES\r
681 \r
682 //=============================================================================\r
683 \r
684 \r
685 /*QUAKED trigger_hurt (.5 .5 .5) ? START_OFF - SILENT NO_PROTECTION SLOW\r
686 Any player that touches this will be hurt by "dmg" points of damage once per server frame (very fast). A sizzling sound is also played while the player is being hurt.\r
687 -------- KEYS --------\r
688 dmg : number of points of damage inflicted to player per server frame (default 5 - integer values only).\r
689 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
690 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
691 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
692 -------- SPAWNFLAGS --------\r
693 START_OFF needs to be triggered (toggle) for damage\r
694 SILENT : supresses the sizzling sound while player is being hurt.\r
695 NO_PROTECTION : player will be hurt regardless of protection (see Notes).\r
696 SLOW : changes the damage rate to once per second.\r
697 -------- NOTES --------\r
698 The invulnerability power-up (item_enviro) does not protect the player from damage caused by this entity regardless of whether the NO_PROTECTION spawnflag is set or not. Triggering a trigger_hurt will have no effect if the START_OFF spawnflag is not set. A trigger_hurt always starts on in the game.*/\r
699 \r
700 //=============================================================================\r
701 \r
702 /*QUAKED trigger_multiple (.5 .5 .5) ?\r
703 Variable size repeatable trigger. It will fire the entities it targets when touched by player. Can be made to operate like a trigger_once entity by setting the "wait" key to -1. It can also be activated by another trigger that targets it.\r
704 -------- KEYS --------\r
705 target : this points to the entity to activate.\r
706 targetname : activating trigger points to this.\r
707 wait : time in seconds until trigger becomes re-triggerable after it's been touched (default 0.2, -1 = trigger once).\r
708 random : random time variance in seconds added or subtracted from "wait" delay (default 0 - see Notes).\r
709 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
710 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
711 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
712 -------- NOTES --------\r
713 When the random key is set, its value is used to calculate a minimum and a maximum delay. The final time delay will be a random value anywhere between the minimum and maximum values: (min delay = wait - random) (max delay = wait + random).*/\r
714 //=============================================================================\r
715 \r
716 /*QUAKED trigger_relay (.5 .5 .5) (-8 -8 -8) (8 8 8)\r
717 This fixed size trigger cannot be touched, it can only be fired by other events.  It can contain killtargets, targets, delays, and messages.\r
718 */\r
719 \r
720 //=============================================================================\r
721 \r
722 /*QUAKED trigger_push (.5 .5 .5) ?\r
723 This is used to create jump pads and launch ramps. It MUST point to a target_position or info_notnull entity to work. Unlike target_push, this is client side predicted.\r
724 -------- KEYS --------\r
725 target : this points to the target_position to which the player will jump.\r
726 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
727 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
728 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).\r
729 -------- NOTES --------\r
730 To make a jump pad or launch ramp, place the target_position/info_notnull entity at the highest point of the jump and target it with this entity.*/\r
731 \r
732 //=============================================================================\r
733 \r
734 /*QUAKED trigger_teleport (.5 .5 .5) ?\r
735 Touching this will teleport players to the location of the targeted misc_teleporter_dest entity. This entity allows client prediction of events.\r
736 -------- KEYS --------\r
737 target : this must point to a misc_teleporter_dest entity.\r
738 notfree : when set to 1, entity will not spawn in "Free for all" and "Tournament" modes.\r
739 notteam : when set to 1, entity will not spawn in "Teamplay" and "CTF" modes.\r
740 notsingle : when set to 1, entity will not spawn in Single Player mode (bot play mode).*/\r
741 \r
742 //=============================================================================\r
743 WEAPON_* ENTITIES\r
744 //=============================================================================\r
745 \r
746 /*QUAKED weapon_shotgun (1 0 .5) (-16 -16 -16) (16 16 16)\r
747 shot gun, shall i say no more\r
748 -----------KEYS------------\r
749 -----------SPAWNFLAGS-----------\r
750 ---------NOTES----------\r
751 a weapon how hard can it be*/\r
752 \r
753 //===================================================================\r
754 \r
755 /*QUAKED weapon_machinegun (1 0 .5) (-16 -16 -16) (16 16 16)\r
756 machinegun, shall i say no more\r
757 -----------KEYS------------\r
758 -----------SPAWNFLAGS-----------\r
759 ---------NOTES----------\r
760 a weapon how hard can it be*/\r
761 \r
762 //===================================================================\r
763 \r
764 /*QUAKED weapon_grenadelauncher (1 0 .5) (-16 -16 -16) (16 16 16)\r
765 grenade launcher, shall i say no more\r
766 -----------KEYS------------\r
767 -----------SPAWNFLAGS-----------\r
768 ---------NOTES----------\r
769 a weapon how hard can it be*/\r
770 \r
771 //===================================================================\r
772 \r
773 /*QUAKED weapon_electro (1 0 .5) (-16 -16 -16) (16 16 16)\r
774 electro, shall i say no more\r
775 -----------KEYS------------\r
776 -----------SPAWNFLAGS-----------\r
777 ---------NOTES----------\r
778 a weapon how hard can it be*/\r
779 \r
780 //===================================================================\r
781 \r
782 /*QUAKED weapon_crylink (1 0 .5) (-16 -16 -16) (16 16 16)\r
783 crylink, shall i say no more\r
784 -----------KEYS------------\r
785 -----------SPAWNFLAGS-----------\r
786 ---------NOTES----------\r
787 a weapon how hard can it be*/\r
788 \r
789 //===================================================================\r
790 \r
791 /*QUAKED weapon_hagar (1 0 .5) (-16 -16 -16) (16 16 16)\r
792 hagar, shall i say no more\r
793 -----------KEYS------------\r
794 -----------SPAWNFLAGS-----------\r
795 ---------NOTES----------\r
796 a weapon how hard can it be*/\r
797 \r
798 //===================================================================\r
799 \r
800 /*QUAKED weapon_rocketlauncher (1 0 .5) (-16 -16 -16) (16 16 16)\r
801 rocketlauncher, shall i say no more\r
802 -----------KEYS------------\r
803 -----------SPAWNFLAGS-----------\r
804 ---------NOTES----------\r
805 a weapon how hard can it be*/\r
806 \r
807 //===================================================================\r
808 \r
809 /*QUAKED weapon_nex (1 0 .5) (-16 -16 -16) (16 16 16)\r
810 nexgun launcher, shall i say no more\r
811 -----------KEYS------------\r
812 -----------SPAWNFLAGS-----------\r
813 ---------NOTES----------\r
814 a weapon how hard can it be*/\r
815 \r
816 //===================================================================\r
817 \r
818 //=============================================================================\r
819 WORLDSPAWN ENTITY\r
820 //=============================================================================\r
821 \r
822 /*QUAKED worldspawn (0 0 0) ?\r
823 Only used for the world.\r
824 -------- KEYS --------\r
825 message : text to print at user logon. Used for name of level.\r
826 music : path/name of looping .wav file used for level's music (eg. music/sonic5.wav).\r
827 _ambient OR ambient : Adds a constant value to overall lighting. Use is not recommended. Ambient light will have a tendency to flatten out variations in light and shade.\r
828 _color : RGB value for ambient light color (default is 0 0 0).\r
829 gravity : gravity of level (default is normal gravity: 800).\r
830 gridsize : granularity of the lightgrid created by q3map. Value is three integers separated by spaces, representing number of units between grid points in X Y Z. Default gridsize value is 128 128 256. Use larger powers of 2 to reduce BSP size and compile time on very large maps.\r
831 _blocksize : q3map always splits the BSP tree along the planes X=_blocksize*n and Y=_blocksize*n. Default _blocksize value is 1024. Increase the blocksize using larger powers of 2 to reduce compile times on very large maps with a low structural brush density.\r
832 -------- Q3MAP2 KEYS --------\r
833 _minlight : Minimum light value, levelwide. Uses the _color key to set color. Does not add unlike ambient.\r
834 _minvertexlight : Minimum vertex lighting, levelwide.\r
835 _mingridlight : Minimum lightgrid (dynamic entity lighting) levelwide.\r
836 _keeplights : Keep light entities in the BSP. Normally stripped out by the BSP process and read from the .map file by the lighting phase.\r
837 _noshadersun : Ignore q3map_sun/sun directives in sky shaders and ONLY use entity sun lights.\r
838 _farplanedist : Limit on how many units the vis phase of compilation can see. Used in combination with level-wide fog, it can help reduce r_speeds on large, open maps.\r
839 _foghull : Shader to use for "fog hull." Foghull shader should be a sky shader. Omit the "textures/" prefix.\r
840 _lightmapscale : Floating point value scaling the resolution of lightmaps on brushes/patches in the world. Can be overridden in func_group (or other entities) (default 1.0).\r
841 _cs OR _castshadows : Allows per-entity control over shadow casting. Defaults to 0 on entities, 1 on world. 0 = no shadow casting. 1 = cast shadows on world. > 1 = cast shadows on entities with _rs (or _receiveshadows) with the corresponding value, AND world. Negative values imply same, but DO NOT cast shadows on world.\r
842 _rs OR _receiveshadows : Allows per-entity control over shadow reception. Defaults to 1 on everything (world shadows). 0 = receives NO shadows. > 1 = receive shadows only from corresponding keyed entities (see above) and world. < 1 = receive shadows ONLY from corresponding keyed entities.\r
843 _celshader : Sets the cel shader used for this geometry. Note: omit the "textures/" prefix. Overridable in entities.\r
844 -------- Q3MAP2 TERRAIN KEYS --------\r
845 _indexmap OR alphamap : Path/name for the art file used to guide the mapping of textures on the terrain surface.\r
846 _layers OR layers : Integer value is the number unique root shaders that will be use on the terrain.\r
847 _shader OR shader : Path to the metashader used to assign textures to the terrain entity. Note: Omit the "textures/" prefix.*/\r
848 \r
849 //===================================================================\r
850 \r
851 /*QUAKED func_ladder (0 .5 .8)?\r
852 a ladder, need i say no more\r
853 ------- KEYS ---------\r
854 ------- NOTES --------\r
855 graba trigger brush and put it infront of the part that you want the player to climb\r
856 */\r
857 \r
858 //=============================================================================\r
859 /*QUAKED dynlight (0 1 0) (-8 -8 -8) (8 8 8) START_OFF NOSHADOW FOLLOW\r
860 Dynamic light.\r
861 Can do one of these things: sit still and be just a silly light, travel along a path, follow an entity around, attach to a tag on an entity.\r
862 It can spin around it's own axis in all the above cases.\r
863 If targeted, it will toggle between on or off.\r
864 keys:\r
865 "light_lev" light radius, default 200\r
866 "color" light color in rgb and brightness, 1 1 1 produces bright white, up to 255 255 255 (nuclear blast), recommended values up to 1 1 1, default 1 1 1\r
867 "style" lightstyle, same as for static lights\r
868 "angles" initial orientation\r
869 "avelocity" a vector value, the direction and speed it rotates in\r
870 "skin" cubemap number, must be 16 or above\r
871 "dtagname" will attach to this tag on the entity which "targetname" matches "target". If the "target" is either not an md3 model or is missing tags, it will attach to the targets origin. Note that the "target" must be visible to the light\r
872 "targetname" will toggle on and off when triggered\r
873 "target" if issued with a target, preferrably path_corner, it will move along the path. If also issued with the FOLLOW spawnflag, then this is the entity it will follow. If issued with the "tagname" key it will attach it to this targets tag called "tagname", does not work together with FOLLOW or path movement\r
874 "speed" the speed it will travel along the path, default 100\r
875 flags:\r
876 "START_OFF" light will be in off state until targeted\r
877 "NOSHADOW" will not cast shadows in realtime lighting mode\r
878 "FOLLOW" will follow the entity which "targetname" matches "target"\r
879 */\r
880 \r
881 /*QUAKED trigger_cmd (.5 .5 .5) ? \r
882 Any player that touches this will have the .cdm command executed\r
883 -------- KEYS --------\r
884 cmd : the command\r
885 -------- NOTES --------\r
886 */\r
887 \r
888 //=============================================================================\r
889         Runematch ents\r
890 //=============================================================================\r
891 \r
892 /*QUAKED runematch_spawn_point (.3 .3 1) (-16 -16 -16) (16 16 16)\r
893 Spawnpoiny for runes in a runematch.\r
894 -----------KEYS------------\r
895 -----------SPAWNFLAGS-----------\r
896 ---------NOTES----------\r
897 rune spwanpoint.\r
898 */\r
899 \r
900 //=============================================================================\r
901         Domination ents\r
902 //=============================================================================\r
903 \r
904 /*QUAKED dom_team (.3 .3 1) (-16 -16 -16) (16 16 16)\r
905 Domination  team\r
906 -----------KEYS------------\r
907 netname         name of team (Red Team).  Set to "" or don't define for the required blank team.\r
908 cnt             color of the team.  See the "Helpful Extras" section for info.\r
909 model           When this team captures control points, the points turn to this model.  If this is the neutral team, points start out as this model.\r
910 noise           Sound to be played on the control point when it's captured.  Only players nearby will hear it.\r
911 noise1          Sound to be played to all players when the control point is captured.  Also good for an annoncer voice ("Red Team has captured a control point")\r
912 -----------SPAWNFLAGS-----------\r
913 ---------NOTES----------\r
914 In order to get Domination working well in your map, you need to place dom_team and dom_controlpoint entites.  You *must* have at least 3 dom_team entities - 2 minimum teams and one blank one (empty netname and no team).  You can have up to 4 teams (5 dom_team entities).\r
915 */\r
916 \r
917 /*QUAKED dom_controlpoint (.3 .3 1) (-16 -16 -16) (16 16 16)\r
918 Domination  controlpoint\r
919 -----------KEYS------------\r
920 message         message to be displayed to all players when this point is captured, preceded by the team's name.  This defaults to " has captured a control point".  You can specify different names for each point, for example " has captured the Lava Room".\r
921 origin          where in the map this point is\r
922 wait            How often this point gives its controlling team frags.\r
923 frags           How many frags this point gives each wait cycle.\r
924 -----------SPAWNFLAGS-----------\r
925 ---------NOTES----------\r
926 In order to get Domination working well in your map, you need to place dom_team and dom_controlpoint entites.  You *must* have at least 3 dom_team entities - 2 minimum teams and one blank one (empty netname and no team).  You can have up to 4 teams (5 dom_team entities).\r
927 */\r