1 void ka_SpawnBall(void);
2 void ka_TouchEvent(void);
3 void ka_RespawnBall(void);
4 void ka_DropEvent(entity);
5 void ka_TimeScoring(void);
6 void ka_EventLog(string, entity);
10 float ka_ballcarrier_waypointsprite_visible_for_player(entity);
12 void ka_Initialize() // run at the start of a match, initiates game mode
17 precache_sound("keepaway/pickedup.wav");
18 precache_sound("keepaway/dropped.wav");
19 precache_sound("keepaway/respawn.wav");
20 precache_sound("keepaway/touch.wav");
22 ScoreRules_keepaway();
26 void ka_Reset() // used to clear the ballcarrier whenever the match switches from warmup to normal
29 if(self.owner.classname == "player")
30 ka_DropEvent(self.owner);
35 void ka_SpawnBall() // loads various values for the ball, runs only once at start of match
37 if(!g_keepaway) { return; }
41 e.model = "models/orbs/orbblue.md3";
42 precache_model(e.model);
44 setsize(e, '-16 -16 -20', '16 16 20'); // 20 20 20 was too big, player is only 16 16 24... gotta cheat with the Z (20) axis so that the particle isn't cut off
45 e.classname = "keepawayball";
46 e.damageforcescale = autocvar_g_keepawayball_damageforcescale;
47 e.takedamage = DAMAGE_YES;
48 e.solid = SOLID_TRIGGER;
49 e.movetype = MOVETYPE_BOUNCE;
50 e.glow_color = autocvar_g_keepawayball_trail_color;
54 e.touch = ka_TouchEvent;
58 InitializeEntity(e, ka_RespawnBall, INITPRIO_SETLOCATION); // is this the right priority? Neh, I have no idea.. Well-- it works! So.
61 void ka_RespawnBall() // runs whenever the ball needs to be relocated
63 if(gameover) { return; }
64 vector oldballorigin = self.origin;
66 if(MoveToRandomMapLocation(self, DPCONTENTS_SOLID | DPCONTENTS_CORPSE | DPCONTENTS_PLAYERCLIP, DPCONTENTS_SLIME | DPCONTENTS_LAVA | DPCONTENTS_SKY | DPCONTENTS_BODY | DPCONTENTS_DONOTENTER, Q3SURFACEFLAG_SKY, 10, 1024, 256))
68 makevectors(self.angles);
69 self.movetype = MOVETYPE_BOUNCE;
70 self.velocity = '0 0 200';
71 self.angles = '0 0 0';
72 self.effects = autocvar_g_keepawayball_effects;
73 self.think = ka_RespawnBall;
74 self.nextthink = time + autocvar_g_keepawayball_respawntime;
76 pointparticles(particleeffectnum("electro_combo"), oldballorigin, '0 0 0', 1);
77 pointparticles(particleeffectnum("electro_combo"), self.origin, '0 0 0', 1);
79 WaypointSprite_Spawn("ka-ball", 0, 0, self, '0 0 64', world, self.team, self, waypointsprite_attachedforcarrier, FALSE, RADARICON_FLAGCARRIER, '0 1 1');
80 WaypointSprite_Ping(self.waypointsprite_attachedforcarrier);
82 sound(self, CH_TRIGGER, "keepaway/respawn.wav", VOL_BASE, ATTN_NONE); // ATTN_NONE (it's a sound intended to be heard anywhere)
86 ka_RespawnBall(); // finding a location failed, retry
90 void ka_TouchEvent() // runs any time that the ball comes in contact with something
92 if(gameover) { return; }
94 if(trace_dphitq3surfaceflags & Q3SURFACEFLAG_NOIMPACT)
95 { // The ball fell off the map, respawn it since players can't get to it
99 if(other.deadflag != DEAD_NO) { return; }
100 if(other.classname != "player")
101 { // The ball just touched an object, most likely the world
102 pointparticles(particleeffectnum("kaball_sparks"), self.origin, '0 0 0', 1);
103 sound(self, CH_TRIGGER, "keepaway/touch.wav", VOL_BASE, ATTN_NORM);
106 else if(self.wait > time) { return; }
108 // attach the ball to the player
110 other.ballcarried = self;
111 setattachment(self, other, "");
112 setorigin(self, '0 0 0');
114 // make the ball invisible/unable to do anything/set up time scoring
115 self.velocity = '0 0 0';
116 self.movetype = MOVETYPE_NONE;
117 self.effects |= EF_NODRAW;
118 self.touch = SUB_Null;
119 self.think = ka_TimeScoring;
120 self.nextthink = time + autocvar_g_keepaway_score_timeinterval;
121 self.takedamage = DAMAGE_NO;
123 // apply effects to player
124 other.glow_color = autocvar_g_keepawayball_trail_color;
125 other.glow_trail = TRUE;
126 other.effects |= autocvar_g_keepaway_ballcarrier_effects;
128 // messages and sounds
129 ka_EventLog("pickup", other);
130 Send_KillNotification(other.netname, "", "", KA_PICKUPBALL, MSG_KA);
131 WriteByte(MSG_BROADCAST, SVC_CENTERPRINT);
132 WriteString(MSG_BROADCAST, strcat(other.netname, "^7 has picked up the ball!"));
133 sound(self.owner, CH_TRIGGER, "keepaway/pickedup.wav", VOL_BASE, ATTN_NONE); // ATTN_NONE (it's a sound intended to be heard anywhere)
136 PlayerScore_Add(other, SP_KEEPAWAY_PICKUPS, 1);
139 WaypointSprite_AttachCarrier("ka-ballcarrier", other, RADARICON_FLAGCARRIER, '1 0 0');
140 other.waypointsprite_attachedforcarrier.waypointsprite_visible_for_player = ka_ballcarrier_waypointsprite_visible_for_player;
141 WaypointSprite_UpdateRule(other.waypointsprite_attachedforcarrier, 0, SPRITERULE_DEFAULT);
142 WaypointSprite_Ping(other.waypointsprite_attachedforcarrier);
143 WaypointSprite_Kill(self.waypointsprite_attachedforcarrier);
146 void ka_DropEvent(entity plyr) // runs any time that a player is supposed to lose the ball
149 ball = plyr.ballcarried;
151 if(!ball) { return; }
154 setattachment(ball, world, "");
155 ball.movetype = MOVETYPE_BOUNCE;
156 ball.wait = time + 1;
157 ball.touch = ka_TouchEvent;
158 ball.think = ka_RespawnBall;
159 ball.nextthink = time + autocvar_g_keepawayball_respawntime;
160 ball.takedamage = DAMAGE_YES;
161 ball.effects &~= EF_NODRAW;
162 setorigin(ball, plyr.origin + '0 0 10');
163 ball.velocity = '0 0 200' + '0 100 0'*crandom() + '100 0 0'*crandom();
164 ball.owner.ballcarried = world; // I hope nothing checks to see if the world has the ball in the rest of my code :P
167 // reset the player effects
168 plyr.glow_trail = FALSE;
169 plyr.effects &~= autocvar_g_keepaway_ballcarrier_effects;
171 // messages and sounds
172 ka_EventLog("dropped", plyr);
173 Send_KillNotification(plyr.netname, "", "", KA_DROPBALL, MSG_KA);
174 WriteByte(MSG_BROADCAST, SVC_CENTERPRINT);
175 WriteString(MSG_BROADCAST, strcat(plyr.netname, "^7 has dropped the ball!"));
176 sound(other, CH_TRIGGER, "keepaway/dropped.wav", VOL_BASE, ATTN_NONE); // ATTN_NONE (it's a sound intended to be heard anywhere)
179 // PlayerScore_Add(plyr, SP_KEEPAWAY_DROPS, 1); Not anymore, this is 100% the same as pickups and is useless.
182 WaypointSprite_Spawn("ka-ball", 0, 0, ball, '0 0 64', world, ball.team, ball, waypointsprite_attachedforcarrier, FALSE, RADARICON_FLAGCARRIER, '0 1 1');
183 WaypointSprite_UpdateRule(ball.waypointsprite_attachedforcarrier, 0, SPRITERULE_DEFAULT);
184 WaypointSprite_Ping(ball.waypointsprite_attachedforcarrier);
185 WaypointSprite_Kill(plyr.waypointsprite_attachedforcarrier);
188 float ka_ballcarrier_waypointsprite_visible_for_player(entity e) // runs on waypoints which are attached to ballcarriers, updates once per frame
191 if(other.classname == "spectator")
192 return FALSE; // we don't want spectators of the ballcarrier to see the attached waypoint on the top of their screen
194 // TODO: Make the ballcarrier lack a waypointsprite whenever they have the invisibility powerup
199 void ka_TimeScoring()
201 if(self.owner.ballcarried)
202 { // add points for holding the ball after a certain amount of time
203 if(autocvar_g_keepaway_score_timepoints)
204 PlayerScore_Add(self.owner, SP_SCORE, autocvar_g_keepaway_score_timepoints);
206 PlayerScore_Add(self.owner, SP_KEEPAWAY_BCTIME, (autocvar_g_keepaway_score_timeinterval / 1)); // interval is divided by 1 so that time always shows "seconds"
207 self.nextthink = time + autocvar_g_keepaway_score_timeinterval;
211 void ka_EventLog(string mode, entity actor) // use an alias for easy changing and quick editing later
213 if(autocvar_sv_eventlog)
214 GameLogEcho(strcat(":ka:", mode, ((actor != world) ? (strcat(":", ftos(actor.playerid))) : "")));
217 MUTATOR_HOOKFUNCTION(ka_Scoring)
219 if((frag_attacker != frag_target) && (frag_attacker.classname == "player"))
221 if(frag_target.ballcarried) { // add to amount of times killing carrier
222 PlayerScore_Add(frag_attacker, SP_KEEPAWAY_CARRIERKILLS, 1);
223 if(autocvar_g_keepaway_score_bckill) // add bckills to the score
224 PlayerScore_Add(frag_attacker, SP_SCORE, autocvar_g_keepaway_score_bckill);
226 else if(!frag_attacker.ballcarried)
227 if(autocvar_g_keepaway_noncarrier_warn)
228 centerprint(frag_attacker, "Killing people while you don't have the ball gives no points!");
230 if(frag_attacker.ballcarried) // add to amount of kills while ballcarrier
231 PlayerScore_Add(frag_attacker, SP_SCORE, autocvar_g_keepaway_score_killac);
234 if(self.ballcarried) { ka_DropEvent(self); } // a player with the ball has died, drop it
238 MUTATOR_HOOKFUNCTION(ka_GiveFragsForKill)
240 frag_score = 0; // no frags counted in keepaway
241 return 1; // you deceptive little bugger ;3 This needs to be true in order for this function to even count.
244 MUTATOR_HOOKFUNCTION(ka_PlayerPreThink)
246 // clear the item used for the ball in keepaway
247 self.items &~= IT_KEY1;
249 // if the player has the ball, make sure they have the item for it (Used for HUD primarily)
251 self.items |= IT_KEY1;
256 MUTATOR_HOOKFUNCTION(ka_PlayerUseKey)
258 if(MUTATOR_RETURNVALUE == 0)
267 MUTATOR_HOOKFUNCTION(ka_PlayerDamage) // for changing damage and force values that are applied to players in g_damage.qc
269 if(frag_attacker.ballcarried) // if the attacker is a ballcarrier
271 if(frag_target == frag_attacker) // damage done to yourself
273 frag_damage *= autocvar_g_keepaway_ballcarrier_selfdamage;
274 frag_force *= autocvar_g_keepaway_ballcarrier_selfforce;
276 else // damage done to noncarriers
278 frag_damage *= autocvar_g_keepaway_ballcarrier_damage;
279 frag_force *= autocvar_g_keepaway_ballcarrier_force;
282 else if not(frag_target.ballcarried) // if the target is a noncarrier
284 if(frag_target == frag_attacker) // damage done to yourself
286 frag_damage *= autocvar_g_keepaway_noncarrier_selfdamage;
287 frag_force *= autocvar_g_keepaway_noncarrier_selfforce;
289 else // damage done to other noncarriers
291 frag_damage *= autocvar_g_keepaway_noncarrier_damage;
292 frag_force *= autocvar_g_keepaway_noncarrier_force;
298 MUTATOR_HOOKFUNCTION(ka_RemovePlayer)
300 if(self.ballcarried) { ka_DropEvent(self); } // a player with the ball has left the match, drop it
304 MUTATOR_HOOKFUNCTION(ka_PlayerPowerups)
306 // In the future this hook is supposed to allow me to do some extra stuff with waypointsprites and invisibility powerup
307 // So bare with me until I can fix a certain bug with ka_ballcarrier_waypointsprite_visible_for_player()
309 self.effects &~= autocvar_g_keepaway_ballcarrier_effects;
312 self.effects |= autocvar_g_keepaway_ballcarrier_effects;
317 MUTATOR_DEFINITION(gamemode_keepaway)
319 MUTATOR_HOOK(MakePlayerObserver, ka_RemovePlayer, CBC_ORDER_ANY);
320 MUTATOR_HOOK(ClientDisconnect, ka_RemovePlayer, CBC_ORDER_ANY);
321 MUTATOR_HOOK(PlayerDies, ka_Scoring, CBC_ORDER_ANY);
322 MUTATOR_HOOK(GiveFragsForKill, ka_GiveFragsForKill, CBC_ORDER_ANY);
323 MUTATOR_HOOK(PlayerPreThink, ka_PlayerPreThink, CBC_ORDER_ANY);
324 MUTATOR_HOOK(PlayerDamage_Calculate, ka_PlayerDamage, CBC_ORDER_ANY);
325 MUTATOR_HOOK(PlayerPowerups, ka_PlayerPowerups, CBC_ORDER_ANY);
326 MUTATOR_HOOK(PlayerUseKey, ka_PlayerUseKey, CBC_ORDER_ANY);
330 if(time > 1) // game loads at time 1
331 error("This is a game type and it cannot be added at runtime.");
339 error("This is a game type and it cannot be removed at runtime.");