cs2-outnumbered/Outnumbered/Survival.cs
Kamal Tufekcic 8739fd3ac0
All checks were successful
CI / build (push) Successful in 35s
CI / lint (push) Successful in 32s
CI / release (push) Successful in 5m12s
CS# bug bypass for survival mode
2026-07-10 03:01:19 +03:00

980 lines
58 KiB
C#

using CounterStrikeSharp.API;
using CounterStrikeSharp.API.Core;
using CounterStrikeSharp.API.Modules.Timers;
using CounterStrikeSharp.API.Modules.Utils;
using Microsoft.Extensions.Logging;
using Outnumbered.Config;
using Outnumbered.Data;
using Outnumbered.Domain;
using Outnumbered.Engine;
namespace Outnumbered;
// Wave Survival ("Last Stand") — co-op, escalating bot waves on the small arms-race maps. The whole RPG core rides
// along unchanged. Design (research/survival-mode-design.md): VANILLA bots (100hp/100armor, never tougher) — the
// difficulty curve is (a) MORE bots up to AliveCap, and (b) the inherited handicap floor tightening every wave; the
// counter-pressure is the roguelite DRAFT (strong run-scoped cards via EffRun). You outscale until the floor + horde
// finally win. Combat XP is banked RAW per wave and granted to the main table at EACH wave clear (x prestige x waveMult),
// so players level + buy skills mid-run; an uncleared wave is forfeited on a wipe.
//
// State machine: Idle -> (humans present) -> Fighting wave N -> (kills == budget) -> ClearWave (grant wave XP) -> Break
// (revive + draft) -> wave N+1 -> ... -> clear WaveCount = WIN; all humans dead / wave timeout = LOSE -> map end.
public sealed class SurvivalDriver : IMatchDriver, IDraftDriver
{
private readonly OutnumberedPlugin _p;
public SurvivalDriver(OutnumberedPlugin p) => _p = p;
private enum WavePhase { Idle, Fighting, Break }
private readonly Dictionary<ulong, SurvivalRun> _runs = []; // per-player run state (RAM-only; run ends on disconnect)
private WavePhase _phase = WavePhase.Idle;
private int _wave; // current wave (0 = not started)
private int _killsThisWave;
private int _waveBudget; // kills needed to clear the current wave (locked at wave start)
private int _highestWaveCleared;
private bool _runActive;
private bool _ready; // the server is up + a map is loaded (set from OnMatchReset/OnMapSetup, NOT Load) — gates WaveTick
private bool _runEnded; // terminal latch: a run finished on THIS map -> no auto-restart until the next map
private double _phaseUntil; // Server.CurrentTime the break ends
private double _lastKillAt; // last credited kill — the stall-nudge + timeout measure PROGRESS, not wall-time
private double _lastNudgeAt; // last stall-nudge, so stalled bots aren't re-pulled every tick
private double _mapReadyAt; // don't start a run until the map has settled + players can spawn
private CounterStrikeSharp.API.Modules.Timers.Timer? _tick;
// TEAM cards (global_deal / global_take): ONE shared squad level each (0..Cap), incremented by ANY survivor's pick,
// applied to EVERY survivor via the cached multipliers (read per-hit from Handicap.MDeal/MTake -> kept as fields, not
// recomputed each call). Reset per run. RecomputeTeamMults runs on pick / run start (live PerPick edits take on next pick).
private int _teamDealLevel;
private int _teamTakeLevel;
private double _teamDealMult = 1.0;
private double _teamTakeMult = 1.0;
// Directed bot spawn placement (replaces mp_randomspawn): map spawn-point origins gathered once per map, so each streamed
// -in bot lands away from the squad instead of on their heads. Entity names span the DM/arms-race/classic spawn types;
// whichever the map actually has is used. Empty (no such entities) => placement is skipped (bots keep their team spawn).
private static readonly string[] SpawnEntityNames =
["info_deathmatch_spawn", "info_player_terrorist", "info_player_counterterrorist", "info_armsrace_counter", "info_armsrace_terrorist"];
private readonly List<Vector> _spawnPoints = [];
// ---- Field Medic teammate-revive (card-only: no FieldMedic card => none of this runs) ----
private CounterStrikeSharp.API.Modules.Timers.Timer? _reviveTick; // 0.1s heartbeat: proximity detect + channel progress (finer than the 0.5s WaveTick for a smooth bar/locator)
private readonly Dictionary<ulong, DownedInfo> _downed = []; // downed player's SteamId -> death spot + world beacon (created only while the squad has a medic)
private readonly Dictionary<ulong, ChannelState> _channels = []; // medic's SteamId -> the revive they're currently channeling
private readonly HashSet<ulong> _revivedForXpThisWave = []; // victims already paid a support-XP bounty this wave (one per saved teammate; reset at wave start)
private const double ReviveEdgeFrac = 0.82; // within this fraction of the radius = fine; beyond it = the amber "about to exit" warn
// A downed, revivable teammate: the death spot (revive lands them here, next to the reviver) + the world beacon over it.
private sealed class DownedInfo
{
public required Vector Pos { get; init; }
public required string Name { get; init; }
public bool KilledByBot { get; init; } // combat death (bot kill) vs suicide/fall/world — gates the reviver's XP bounty
public CPointWorldText? Beacon; // field, not property, so WorldText.Destroy(ref ...) can null it
public string LastText = ""; // last beacon text pushed (skip redundant SetMessage)
public void DestroyBeacon() => WorldText.Destroy(ref Beacon);
}
// One medic's in-progress channel (time-based: progress = (now - StartedAt) / channelSeconds, so it's smooth regardless of tick jitter).
private struct ChannelState
{
public ulong TargetSid;
public double StartedAt;
public bool NearEdge; // drifting toward the radius edge -> HUD amber warn
public bool WarnedEdge; // edge warn sound already played this crossing (one-shot)
}
// ---- IMatchDriver: identity ----
public string Id => "survival";
public IReadOnlyList<string> Maps =>
_p.Config.Survival.Maps.Count > 0 ? _p.Config.Survival.Maps : _p.Config.Match.Maps;
public bool WeaponShopEnabled => true; // players choose their guns; cards are a separate draft
public HandicapOverride? Handicap => _p.Config.Survival.Handicap;
public int MaxHumansOnCt => _p.Config.Survival.MaxHumansOnCt;
// Nobody auto-respawns: humans are revived at wave-clear (ReviveSurvivor); bots are spawned/streamed entirely by the
// wave machine (force-Respawn in UpdateBotQuota). Engine auto-respawn for bots is OFF so it can't fight the wave drain
// AND so we don't depend on it spawning bots (which it refuses after repeated T-side wipes — the wave-3 stall).
// mp_randomspawn OFF: bot spawn placement is done ourselves (DirectedBotSpawn -> a map spawn point away from the squad),
// because mp_randomspawn ignores distance-to-player and drops clusters on your head once ~20 bots are alive at once.
public string ExtraCvars => "mp_randomspawn 0;mp_respawn_on_death_ct 0;mp_respawn_on_death_t 0;";
public double HandicapProgress(PlayerData pd) => 0.0; // survival escalates via the wave FLOOR, not the progress axis
public bool OwnsBotPopulation => true; // the wave machine drives bot_quota, not the core's SyncBots
public bool RunInProgress => _runActive; // EnforceHumanTeam fail-closed: no mid-run joins
// Status API extras: the wave machine at a glance (site server cards show "Wave X/Y").
public object? StatusExtra() =>
new { Wave = _wave, WaveCount = _p.Config.Survival.WaveCount, Phase = _phase.ToString(), RunActive = _runActive };
// ---- loadout ----
public void GiveHumanLoadout(CCSPlayerController p) => _p.GiveChosenLoadout(p);
public void GiveBotLoadout(CCSPlayerController bot) => _p.GiveStandardBotLoadout(bot); // vanilla bots, vanilla HP — only the COUNT escalates
// ---- IMatchDriver: per-kill / death results ----
// A human killed a bot — wave progress. (PvE: a human's victim is always a bot.)
public void OnHumanKill(CCSPlayerController attacker, PlayerData apd)
{
if (!_runActive || _phase != WavePhase.Fighting) return;
_killsThisWave++;
_lastKillAt = Server.CurrentTime; // progress made -> reset the stall-nudge / timeout window
UpdateBotQuota(); // shrink the quota immediately so drain-zone kills aren't spuriously re-spawned (WaveTick clears the wave)
}
public void OnBotKill(CCSPlayerController bot) { } // a bot killed a human -> no wave progress; wipe handled in OnHumanDeath
public void OnHeadshotDeath(CCSPlayerController victim) { } // no ladder in survival
// A human died: no team switch (mp_respawn_on_death_ct 0 keeps them dead = auto death-spectate; revived at wave-clear).
// Field Medic: if the squad has a medic, mark this body revivable — capture the death spot (same corpse-position read the
// explode-on-kill card does in the death hook) and drop a beacon so a teammate can channel a mid-wave revive. Then run
// wipe detection next frame (count after the pawn is actually down; a downed-awaiting-revive player counts as not-alive,
// so an all-down squad still wipes — you can't revive if nobody's up).
public void OnHumanDeath(CCSPlayerController victim, PlayerData pd, CCSPlayerController? attacker)
{
if (!_runActive) return;
// Field Medic: register a revivable beacon, but ONLY for a CT participant (gate on victim.Team==CT, read NOW since
// team can change by the deferred frame) — this excludes a bug-2 spectator-park suicide of a mid-run T-joiner, which
// would otherwise become a revivable entry that pulls a non-participant onto CT (fail-closed bypass). killedByBot
// (captured here) gates the reviver's XP bounty so a suicide/fall can't be farmed. Capture the death spot NOW (a safe
// read, like the explode-on-kill card in this Pre hook) but DEFER the beacon ENTITY creation out of the Pre hook.
bool killedByBot = OutnumberedPlugin.IsBot(attacker); // PvE: only bots kill humans (FF is off); null/self => not combat
if (_phase == WavePhase.Fighting && victim.Team == CsTeam.CounterTerrorist && SquadHasMedic()
&& !_downed.ContainsKey(pd.SteamId) && victim.PlayerPawn.Value?.AbsOrigin is { } corpse)
{
var pos = new Vector(corpse.X, corpse.Y, corpse.Z);
string name = victim.PlayerName;
ulong sid = pd.SteamId;
Server.NextFrame(() =>
{
// re-check the run is live + they didn't disconnect in the death->frame gap (else a ghost beacon wastes a charge)
if (_runActive && _phase == WavePhase.Fighting && !_downed.ContainsKey(sid) && ControllerFor(sid) is not null)
_downed[sid] = new DownedInfo { Pos = pos, Name = name, KilledByBot = killedByBot, Beacon = CreateBeacon(pos) };
});
}
Server.NextFrame(() =>
{
if (_runActive && _phase == WavePhase.Fighting && AliveCtHumans() == 0)
EndRun("the squad was wiped out", win: false);
});
}
// A human left mid-run: every CLEARED wave's XP is already in their main table (granted at each wave clear), so there's
// nothing to bank here — the in-progress (uncleared) wave is forfeited. Drop the run + any downed/channel state they own.
public void OnHumanDisconnect(ulong steamId, PlayerData pd)
{
_runs.Remove(steamId);
_channels.Remove(steamId); // if they were mid-channel as a medic
if (_downed.Remove(steamId, out var info)) info.DestroyBeacon(); // if they were the one downed
}
// ---- IMatchDriver: cards (EffRun overlay) ----
// The active run is the snapshot's card source; null outside a run (Snapshot.Cards then null -> Domain reads 0).
public IStatBonusSource? CardSource(PlayerData pd) =>
_runActive && _runs.TryGetValue(pd.SteamId, out var run) ? run : null;
// Per-player card magnitude for the non-snapshot effect checks (burn/explode/cdr presence). Mirrors CardSource.
public double StatBonus(PlayerData pd, string key) => CardSource(pd)?.Bonus(key) ?? 0.0;
// ---- TEAM cards (global_deal / global_take): squad-wide, folded into MDeal / MTake (Handicap.cs) ----
private bool IsTeamCard(string key) => CardDef(key)?.IsTeam == true; // data-driven (SurvivalCardDef.IsTeam)
public double TeamDealMult() => _runActive ? _teamDealMult : 1.0; // +dmg dealt, compounding (>=1)
public double TeamTakeMult() => _runActive ? _teamTakeMult : 1.0; // -dmg taken, compounding (<=1)
// Current level of a card: team cards use the shared squad counter; everything else is the per-player pick count.
private int CardCount(SurvivalRun run, string key) =>
key == CardKeys.GlobalDeal ? _teamDealLevel :
key == CardKeys.GlobalTake ? _teamTakeLevel :
run.Cards.GetValueOrDefault(key);
// Recompute the cached team multipliers from the shared levels + the cards' live PerPick (compounding per level).
private void RecomputeTeamMults()
{
_teamDealMult = SurvivalEconomy.TeamMult(_teamDealLevel, CardDef(CardKeys.GlobalDeal)?.PerPick ?? 0.0, increase: true);
_teamTakeMult = SurvivalEconomy.TeamMult(_teamTakeLevel, CardDef(CardKeys.GlobalTake)?.PerPick ?? 0.0, increase: false);
}
private void ResetTeamBuffs() { _teamDealLevel = 0; _teamTakeLevel = 0; _teamDealMult = 1.0; _teamTakeMult = 1.0; }
// ---- IMatchDriver: the monotonic, escalate-only handicap floor (in t-space) ----
public double HandicapFloor(PlayerData pd) => // -1 = no floor (idle / between runs); monotonic in wave
_runActive ? SurvivalEconomy.HandicapFloor(_wave, _p.Config.Survival) : -1.0;
// ---- IMatchDriver: lifecycle ----
public void OnActivated()
{
// Runs during plugin LOAD — the engine globals aren't ready yet, so touching the engine here (e.g.
// Server.CurrentTime) SIGSEGVs the server. Only SCHEDULE the heartbeat (AddTimer is safe at Load); it stays
// gated by _ready until the first map setup arms it. _ready/_mapReadyAt are set in OnMatchReset + OnMapSetup.
_tick ??= _p.AddTimer(0.5f, WaveTick, TimerFlags.REPEAT); // the wave state machine heartbeat (also drives bot_quota)
_reviveTick ??= _p.AddTimer(0.1f, ReviveTick, TimerFlags.REPEAT); // finer revive-channel heartbeat (proximity + progress)
}
// Plugin Unload / hot-reload: kill the heartbeats so they can't leak or double-fire against a torn-down instance
// (a fresh driver schedules its own on the next Load), and destroy any live beacon entities. The framework doesn't
// reliably auto-kill plugin timers or our entities.
// Also drop _runActive/_phase so any Server.NextFrame closure still queued at teardown (beacon-create / wipe-check) fails
// its guard against this discarded instance instead of spawning an orphan beacon a fresh driver never learns about.
public void OnDeactivated() { _tick?.Kill(); _tick = null; _reviveTick?.Kill(); _reviveTick = null; _runActive = false; _phase = WavePhase.Idle; ClearRevives(); }
// Called once the map is set up (Driver.SetupMap — covers both normal map start and a hot-reload mid-map), i.e. the
// server is simulating and engine access is safe. This is what actually arms the wave machine.
public void OnMapSetup()
{
_ready = true;
_mapReadyAt = Server.CurrentTime + _p.Config.Survival.StartGraceSeconds;
GatherSpawnPoints(); // map entities are up by now (SetupMap runs ~3s after map start) -> cache bot spawn origins
}
public void OnMatchReset()
{
_runs.Clear(); ResetTeamBuffs(); ClearRevives();
_phase = WavePhase.Idle; _wave = 0; _killsThisWave = 0; _waveBudget = 0;
_highestWaveCleared = 0; _runActive = false; _runEnded = false; _phaseUntil = 0;
_ready = true; // OnMatchReset only runs on a real map start (server up) -> safe to read the clock + arm
_mapReadyAt = Server.CurrentTime + _p.Config.Survival.StartGraceSeconds;
}
// ---- the wave state machine ----
private void WaveTick()
{
if (!_ready) return; // don't touch the engine until a map is set up (the heartbeat can fire during boot)
ManageBots(); // keep the quota in sync with the current phase (also the SyncBots delegate target)
double now = Server.CurrentTime;
if (!_runActive)
{
// _runEnded gates the restart: after a run ends, TriggerMapEnd only schedules the changelevel ~6s later, and
// this heartbeat keeps firing on the dying map — without the latch a still-alive squad (a WIN) would spawn a
// phantom wave 1 (and a fresh, re-bankable run accumulator). Cleared on the next map (OnMatchReset).
if (!_runEnded && now >= _mapReadyAt && AliveCtHumans() > 0) StartRun();
return;
}
switch (_phase)
{
case WavePhase.Fighting:
if (AliveCtHumans() == 0) { EndRun("the squad was wiped out", win: false); break; }
if (_killsThisWave >= _waveBudget) { ClearWave(); break; }
// No KILLS for a while = the last bot(s) can't reach the squad (or everyone's standing still). Pull the
// stragglers to the players instead of failing the run. Only the genuine deadlock (still no kills
// WaveTimeoutSeconds after the last one, despite repeated nudges) fails out. Both windows measure
// time-since-last-KILL, not wall-clock.
if (now - _lastKillAt > _p.Config.Survival.StallNudgeSeconds && now - _lastNudgeAt > _p.Config.Survival.StallNudgeSeconds)
NudgeStalledBots(now);
if (now - _lastKillAt > _p.Config.Survival.WaveTimeoutSeconds) EndRun($"wave {_wave} stalled out", win: false);
break;
case WavePhase.Break:
// Unspent draft picks BANK to future breaks (RunPoints persists) — a missed break isn't a lost card;
// the player can spend the backlog in any later break. No forced auto-pick.
if (now >= _phaseUntil) StartWave(_wave + 1);
break;
}
}
private void StartRun()
{
_runActive = true; _highestWaveCleared = 0; _runs.Clear(); ResetTeamBuffs();
Server.PrintToChatAll($" {ChatColors.Gold}[Survival] {ChatColors.Default}LAST STAND — clear {ChatColors.Lime}{_p.Config.Survival.WaveCount}{ChatColors.Default} waves to win. Good luck.");
StartWave(1);
}
private void StartWave(int n)
{
var cfg = _p.Config.Survival;
_wave = n; _phase = WavePhase.Fighting; _killsThisWave = 0;
_lastKillAt = _lastNudgeAt = Server.CurrentTime;
int humans = Math.Max(1, AliveCtHumans());
_waveBudget = SurvivalEconomy.WaveBudget(n, humans, cfg);
_p.LogSurvival($"StartWave {n}: aliveTarget={AliveForWave(n)} budget={_waveBudget} curBots={BotCount()} humans={humans}");
_p.CloseAllShops(); // nobody frozen in a menu when the wave starts
RefreshMedicCharges(); // Field Medic revives refresh each wave (scaled by the medic's card level)
_revivedForXpThisWave.Clear(); // support-XP bounties reset per wave (one per saved teammate)
UpdateBotQuota();
Server.PrintToChatAll($" {ChatColors.Red}[Survival] WAVE {n}/{cfg.WaveCount} {ChatColors.Default}— {ChatColors.LightYellow}{_waveBudget}{ChatColors.Default} hostiles inbound. Hold the line!");
}
private void ClearWave()
{
var cfg = _p.Config.Survival;
_highestWaveCleared = _wave;
_p.LogSurvival($"ClearWave {_wave} (kills={_killsThisWave}/{_waveBudget}); break={cfg.WaveBreakSeconds}s -> next StartWave {_wave + 1}");
// Grant THIS cleared wave's XP now (per-wave): raw x prestige x waveMult(wave), straight to the main table, then
// reset each accumulator. Players spend the resulting points in the break (!skills). A wipe/leave mid-wave forfeits
// the in-progress wave — only a CLEARED wave banks. Iterate _runs by SteamId (not just CtHumans) so a participant
// who slipped to spectator/T isn't dropped.
List<ulong>? cleared = null;
foreach (var kv in _runs)
{
var run = kv.Value;
if (run.WaveXp <= 0) continue;
// Best-wave latch: same bound as the XP bank — you contributed damage THIS wave, you get wave credit.
// (A spectator idling in _runs from earlier waves earns nothing; improve-only keeps their real peak.)
(cleared ??= new(_runs.Count)).Add(kv.Key);
if (_p.PdBySteamId(kv.Key) is { } pd) _p.BankWaveXp(pd, run.WaveXp, _wave, ControllerFor(kv.Key));
run.WaveXp = 0;
}
// Before the victory early-return, or the final wave's clear would never reach the leaderboard.
if (cleared is not null) _p.RecordBestWaves(cleared, _wave);
if (_wave >= cfg.WaveCount) { EndRun($"VICTORY — all {cfg.WaveCount} waves cleared!", win: true); return; }
_phase = WavePhase.Break; _phaseUntil = Server.CurrentTime + cfg.WaveBreakSeconds;
UpdateBotQuota(); // Break -> cull the field for the break (steady pool, no kick)
ReviveDead();
ClearRevives(); // the wave is over: ReviveDead brought back the downed (non-hardcore); in hardcore they're out. Either way the beacons/channels go.
GrantCards();
Server.PrintToChatAll($" {ChatColors.Green}[Survival] Wave {_wave} cleared! {ChatColors.Default}{cfg.WaveBreakSeconds:0}s to prep — the draft pops up ({ChatColors.Gold}X{ChatColors.Default}/crouch to close).");
_p.AddTimer(0.75f, _p.OpenDraftForAll); // auto-pop the card overlay once the revive-spawns have settled
}
private void EndRun(string reason, bool win)
{
_p.LogSurvival($"EndRun: {reason} (win={win}, highestWaveCleared={_highestWaveCleared}, wave={_wave}, kills={_killsThisWave}/{_waveBudget})");
// Per-wave XP was already granted into the main table at each ClearWave; an in-progress (uncleared) wave is
// forfeited. So there's nothing to bank at run-end — just drop the runs.
_runs.Clear(); ClearRevives();
_runActive = false; _runEnded = true; _phase = WavePhase.Idle; _wave = 0;
UpdateBotQuota(); // quota 0
Server.PrintToChatAll($" {(win ? ChatColors.Gold : ChatColors.Red)}[Survival] {ChatColors.Default}{reason} (reached wave {_highestWaveCleared}).");
_p.TriggerMapEnd(win ? "Survival: VICTORY" : "Survival: run over");
}
// ---- Field Medic teammate-revive: the proximity channel machine ----
// Card-only: a downed teammate drops a world beacon; a medic (someone who drafted FieldMedic) who stands within
// ReviveRadius channels a revive over a level-scaled time — no keypress, proximity IS the input. Runs on the 0.1s
// _reviveTick so the bar/locator are smooth. All downed/beacon state is torn down at wave clear / run end / reset.
private readonly List<ulong> _channelReap = []; // reusable scratch for pruning stale channels (avoids a per-tick Keys alloc)
private const int BarCells = 10; // progress-bar width in glyph cells
private const float BeaconRise = 45f; // how far above the death spot the beacon floats
private const double MetersDivisor = 40.0; // units -> "m" for the locator readout (~player height per metre)
// The medic's FieldMedic card level (picks); 0 = not a medic.
private static int MedicLevel(SurvivalRun run) => run.Cards.GetValueOrDefault(CardKeys.FieldMedic);
// Anyone in the run drafted Field Medic? Gates beacon creation so a no-medic squad gets no useless "down" markers.
private bool SquadHasMedic()
{
foreach (var run in _runs.Values) if (MedicLevel(run) > 0) return true;
return false;
}
// Refresh every medic's per-wave revive charges from their card level (called at StartWave; use-them-or-lose-them).
private void RefreshMedicCharges()
{
foreach (var run in _runs.Values)
run.ReviveCharges = SurvivalEconomy.ReviveChargesForWave(MedicLevel(run), _p.Config.Survival);
}
// Tear down ALL downed/channel state + destroy every beacon entity (wave clear, run end, match reset, hot-reload).
private void ClearRevives()
{
foreach (var info in _downed.Values) info.DestroyBeacon();
_downed.Clear();
_channels.Clear();
}
private CPointWorldText? CreateBeacon(Vector pos)
{
// A world-ANCHORED panel (unlike the eye-relative HUD/shop panels) — squad-visible (no CheckTransmit hiding). The
// orientation is refreshed each tick in RefreshBeacons to face the nearest teammate.
var ent = WorldText.Create(48f, 0.35f, _p.Config.Hud.FontName,
System.Drawing.Color.FromArgb(255, 255, 80, 80), drawBackground: true, border: 0.15f,
PointWorldTextJustifyHorizontal_t.POINT_WORLD_TEXT_JUSTIFY_HORIZONTAL_CENTER);
if (ent is not null) WorldText.Place(ent, new Vector(pos.X, pos.Y, pos.Z + BeaconRise), new QAngle(0, 0, 90));
return ent;
}
// 0.1s heartbeat: advance every alive medic's proximity channel, then keep the beacons oriented + labelled.
private void ReviveTick()
{
if (!_ready) return;
if (!_runActive || _phase != WavePhase.Fighting || _downed.Count == 0)
{
if (_channels.Count > 0) _channels.Clear(); // no active reviving outside a fighting wave with downed players
return;
}
double now = Server.CurrentTime;
foreach (var medic in CtHumans())
if (medic.PawnIsAlive) ProcessMedic(medic, now);
PruneChannels();
RefreshBeacons();
}
// One medic's channel step: nearest downed teammate in range -> (re)start / advance / complete the channel, or drop it.
private void ProcessMedic(CCSPlayerController medic, double now)
{
var pd = _p.PdOf(medic);
if (pd is null) return;
var pawn = medic.PlayerPawn.Value;
if (!_runs.TryGetValue(pd.SteamId, out var run) || run.ReviveCharges <= 0 || MedicLevel(run) <= 0
|| pawn?.AbsOrigin is not { } mpos)
{ _channels.Remove(pd.SteamId); return; }
double radius = _p.Config.Survival.ReviveRadius, r2 = radius * radius;
var (best, bestD2) = NearestDowned(mpos, pd.SteamId);
if (best == 0 || bestD2 > r2) { _channels.Remove(pd.SteamId); return; } // nobody in range -> the channel drops
if (!_channels.TryGetValue(pd.SteamId, out var ch) || ch.TargetSid != best)
ch = new ChannelState { TargetSid = best, StartedAt = now }; // new target -> restart the channel
ch.NearEdge = bestD2 > r2 * ReviveEdgeFrac * ReviveEdgeFrac;
if (ch.NearEdge && !ch.WarnedEdge) { _p.PlayReviveWarn(medic); ch.WarnedEdge = true; } // one-shot edge beep
else if (!ch.NearEdge) ch.WarnedEdge = false;
_channels[pd.SteamId] = ch;
double dur = SurvivalEconomy.ReviveChannelSeconds(MedicLevel(run), _p.Config.Survival);
if (dur <= 0 || now - ch.StartedAt >= dur) CompleteRevive(medic, pd, run, best);
}
private void CompleteRevive(CCSPlayerController medic, PlayerData medicPd, SurvivalRun run, ulong targetSid)
{
_channels.Remove(medicPd.SteamId);
if (!_downed.Remove(targetSid, out var info)) return; // someone else revived them this tick -> don't spend a charge
run.ReviveCharges--;
double hpPct = SurvivalEconomy.ReviveHpFraction(MedicLevel(run), _p.Config.Survival);
var target = ControllerFor(targetSid);
// Land them on the REVIVER's spot (guaranteed-walkable ground the medic is standing on), not the raw death spot —
// which could be a hazard/kill-volume that would just re-drop and re-kill them, burning charges for nothing.
var landing = medic.PlayerPawn.Value?.AbsOrigin is { } mo ? new Vector(mo.X, mo.Y, mo.Z) : info.Pos;
_p.ReviveDownedAt(target, landing, hpPct); // respawn + teleport beside the reviver + set HP
info.DestroyBeacon();
_p.PlayReviveComplete(medic);
// Support-XP: a FLAT bounty (NOT routed through WaveXp, so it never rides the x24 wave multiplier), and ONLY for a
// genuine COMBAT death, ONCE per saved teammate per wave — rewards saving allies, not a death<->revive farm loop.
if (info.KilledByBot && _revivedForXpThisWave.Add(targetSid)) _p.GrantReviveXp(medicPd, medic);
string tname = target?.PlayerName ?? info.Name;
Server.PrintToChatAll($" {ChatColors.Green}[Survival] {ChatColors.Lime}{medic.PlayerName} {ChatColors.Default}revived {ChatColors.Lime}{tname}{ChatColors.Default}!");
_p.LogSurvival($"revive: {medic.PlayerName} -> {tname} @ {hpPct:P0} ({run.ReviveCharges} charge(s) left)");
}
// Drop channel state for medics who died / disconnected since the last tick (so a dead medic's channel can't keep a
// beacon falsely reading "reviving"). ProcessMedic already drops channels for out-of-range / out-of-charge medics.
private void PruneChannels()
{
if (_channels.Count == 0) return;
_channelReap.Clear();
foreach (var sid in _channels.Keys)
{
var c = ControllerFor(sid);
if (c is null || !c.PawnIsAlive) _channelReap.Add(sid);
}
foreach (var sid in _channelReap) _channels.Remove(sid);
}
// Keep each beacon facing the nearest teammate (mirrors the HUD's face-the-viewer angle convention) + reflect whether
// it's actively being revived. Beacons are shared entities, so they can only face ONE viewer — the nearest is the bet.
private void RefreshBeacons()
{
foreach (var kv in _downed)
{
var info = kv.Value;
if (info.Beacon is not { IsValid: true } b) continue;
var top = new Vector(info.Pos.X, info.Pos.Y, info.Pos.Z + BeaconRise);
// face the nearest teammate — the +270 convention is single-sourced in WorldText.FacePointAngle.
if (NearestAliveHuman(info.Pos)?.PlayerPawn.Value?.AbsOrigin is { } vp)
WorldText.Place(b, top, WorldText.FacePointAngle(top, vp));
string txt = ChannelTargets(kv.Key) ? $"⚕ {info.Name} — reviving…" : $"⚕ {info.Name}";
if (info.LastText != txt) { WorldText.SetText(b, txt); info.LastText = txt; }
}
}
private bool ChannelTargets(ulong downedSid)
{
foreach (var c in _channels.Values) if (c.TargetSid == downedSid) return true;
return false;
}
// The per-player HUD line (IMatchDriver): channel bar while reviving, edge warn while drifting, else the locator to the
// nearest downed teammate. "" for non-medics / no downed / out of charges. html = center-HTML (font tags) vs world text.
public string ReviveHudLine(CCSPlayerController p, PlayerData pd, bool html)
{
if (!_runActive || _phase != WavePhase.Fighting || _downed.Count == 0) return "";
if (!_runs.TryGetValue(pd.SteamId, out var run) || MedicLevel(run) <= 0) return ""; // not a medic
// channeling right now -> the bar (or the edge warning)
if (_channels.TryGetValue(pd.SteamId, out var ch) && _downed.TryGetValue(ch.TargetSid, out var tgt))
{
if (ch.NearEdge) return WarnLine(html);
double dur = SurvivalEconomy.ReviveChannelSeconds(MedicLevel(run), _p.Config.Survival);
double prog = dur <= 0 ? 1.0 : Math.Clamp((Server.CurrentTime - ch.StartedAt) / dur, 0.0, 1.0);
return BarLine(tgt.Name, prog, html);
}
if (run.ReviveCharges <= 0) return ""; // no charges left this wave -> nothing to prompt
// otherwise: locate the nearest downed teammate (arrow + distance)
if (p.PlayerPawn.Value is not { } pawn || pawn.AbsOrigin is not { } mpos) return "";
var (best, bestD2) = NearestDowned(mpos, pd.SteamId);
if (best == 0) return "";
var info = _downed[best];
int meters = SurvivalEconomy.LocatorMeters(Math.Sqrt(bestD2), MetersDivisor);
return LocatorLine(info.Name, CompassArrow(pawn, info.Pos), meters, html);
}
private static string BarLine(string name, double prog, bool html)
{
int filled = (int)Math.Round(Math.Clamp(prog, 0.0, 1.0) * BarCells);
string bar = new string('█', filled) + new string('░', BarCells - filled); // █ / ░
int pct = (int)Math.Round(prog * 100);
return html
? $"<font color='#7dff7d'>⚕ Reviving {Esc(name)} {bar} {pct}%</font>"
: $"⚕ Reviving {name} {bar} {pct}%";
}
private static string WarnLine(bool html) =>
html ? "<font color='#ffb000'>⚠ hold position — revive slipping</font>"
: "⚠ hold position — revive slipping";
private static string LocatorLine(string name, string arrow, int meters, bool html) =>
html ? $"<font color='#66ddff'>⚕ {Esc(name)} down {arrow} {meters}m</font>"
: $"⚕ {name} down {arrow} {meters}m";
// 8-way compass arrow from the medic's view toward a target. The bearing->sector math is pure + golden-tested in
// SurvivalEconomy.ArrowIndex; this wrapper only computes the live bearing from the pawn. (If left/right read mirrored
// in-engine, negate the (bearing - viewYaw) term.)
private static string CompassArrow(CCSPlayerPawn pawn, Vector target)
{
var o = pawn.AbsOrigin;
if (o is null) return "";
double bearing = Math.Atan2(target.Y - o.Y, target.X - o.X) * 180.0 / Math.PI;
string[] arrows = { "↑", "↖", "←", "↙", "↓", "↘", "→", "↗" }; // ↑ ↖ ← ↙ ↓ ↘ → ↗
return arrows[SurvivalEconomy.ArrowIndex(bearing - pawn.EyeAngles.Y)];
}
private static double Dist2(Vector a, Vector b) { double dx = a.X - b.X, dy = a.Y - b.Y, dz = a.Z - b.Z; return dx * dx + dy * dy + dz * dz; }
// Nearest downed teammate to `pos` (excluding `exceptSid` — you can't revive yourself); (0, +inf) if none.
// Shared by the channel machine (ProcessMedic) and the HUD locator so the "closest body" pick can't drift between them.
private (ulong sid, double dist2) NearestDowned(Vector pos, ulong exceptSid)
{
ulong best = 0; double bestD2 = double.MaxValue;
foreach (var kv in _downed)
{
if (kv.Key == exceptSid) continue;
double d2 = Dist2(pos, kv.Value.Pos);
if (d2 < bestD2) { bestD2 = d2; best = kv.Key; }
}
return (best, bestD2);
}
private static string Esc(string s) => s.Replace("&", "&amp;").Replace("<", "&lt;").Replace(">", "&gt;");
private static CCSPlayerController? NearestAliveHuman(Vector pos)
{
CCSPlayerController? best = null; double bestD2 = double.MaxValue;
foreach (var h in CtHumans())
if (h.PawnIsAlive && h.PlayerPawn.Value?.AbsOrigin is { } o)
{
double d2 = Dist2(pos, new Vector(o.X, o.Y, o.Z));
if (d2 < bestD2) { bestD2 = d2; best = h; }
}
return best;
}
// ---- bots: vanilla, count-throttled via bot_quota ----
public void ManageBots()
{
OutnumberedPlugin.ForceBotsToTerrorist(Utilities.GetPlayers()); // any bot on CT -> back to T (bot_join_team t only affects new bots)
UpdateBotQuota();
}
// Bots ALIVE at once this wave (the simultaneous pressure) — ramps from AliveBase up to AliveCap. Distinct from the
// kill budget: you face this many at a time (they respawn) until the wave's total kills are reached.
private int AliveForWave(int wave) => SurvivalEconomy.AliveForWave(wave, _p.Config.Survival);
// Keep a STEADY connected pool for the whole run: bot_quota stays at AliveCap and is NEVER toggled back to 0 between
// waves. Repeatedly kicking (quota 0) + re-adding bots churns the engine's fake-client slots, which run out after a
// few waves and then wedge ALL further adds. The pool stays connected (mostly dead at low waves); the per-wave ALIVE
// count is set by Respawn (refill) / CommitSuicide (cull). bot_add_t only bootstraps the pool ONCE at run start
// (0 -> AliveCap, near round start). DEADLOCK-FREE: _killsThisWave advances only on credited human kills,
// suicides/respawns don't, and ClearWave fires on kills >= budget.
private void UpdateBotQuota()
{
int cap = _p.Config.Survival.AliveCap;
Server.ExecuteCommand($"bot_quota {(_runActive ? cap : 0)}");
if (!_runActive) return;
var bots = OutnumberedPlugin.Bots().ToList();
if (bots.Count < cap) // bootstrap / replace any lost pool members — should fire ~once per run, not per wave
{
_p.LogSurvival($"pool: connected={bots.Count} cap={cap} -> +{cap - bots.Count} bot_add_t");
for (int i = bots.Count; i < cap; i++) Server.ExecuteCommand("bot_add_t");
}
int want = _phase == WavePhase.Fighting
? Math.Clamp(Math.Min(AliveForWave(_wave), _waveBudget - _killsThisWave), 0, cap)
: 0; // break / idle: clear the field
int alive = bots.Count(p => p.PawnIsAlive);
if (alive < want) // refill: spawn dead pool bots up to `want` (also the in-wave streaming respawn)
foreach (var b in bots)
{
if (alive >= want) break;
if (!b.PawnIsAlive) { DirectedBotSpawn(b); alive++; } // respawn + teleport away from the squad (anti-on-head)
}
else if (alive > want) // cull: kill excess down to `want` (break clear / over-count). Suicide => no kill credit
foreach (var b in bots)
{
if (alive <= want) break;
if (b.PawnIsAlive) { b.CommitSuicide(false, true); alive--; }
}
}
// The wave stalled (no kills for a while) — teleport the alive bots next to a random alive CT human so the wave can
// always be finished without the squad having to chase the last stragglers. Avoids "the match ended but bots are alive".
private void NudgeStalledBots(double now)
{
_lastNudgeAt = now;
var targets = CtHumans().Where(h => h.PawnIsAlive && h.PlayerPawn.Value?.AbsOrigin is not null).ToList();
if (targets.Count == 0) return;
int moved = 0;
foreach (var b in Utilities.GetPlayers())
{
if (!OutnumberedPlugin.IsLiveBot(b)) continue;
var botPawn = b.PlayerPawn.Value;
var dest = targets[Random.Shared.Next(targets.Count)].PlayerPawn.Value?.AbsOrigin;
if (botPawn is null || dest is null) continue;
// a modest offset around the player so they don't all telefrag the same point (small maps are open enough)
var pos = new Vector(dest.X + Random.Shared.Next(-128, 128), dest.Y + Random.Shared.Next(-128, 128), dest.Z + 24);
botPawn.Teleport(pos, null, new Vector(0, 0, 0));
moved++;
}
if (moved > 0) _p.LogSurvival($"wave {_wave} stalled (no kill {_p.Config.Survival.StallNudgeSeconds:0}s) — pulled {moved} bot(s) to the squad");
}
// ---- directed spawn placement (anti-clump / anti-on-head, replaces mp_randomspawn) ----
// Cache every map spawn-point origin once per map. Whichever entity type this map uses is found; if NONE match, the list
// stays empty and DirectedBotSpawn falls back to the plain respawn (team spawn) — with a warning so the map's spawn entity
// name can be added. Spawn geometry is static, so gathering once at map setup is enough.
private void GatherSpawnPoints()
{
_spawnPoints.Clear();
foreach (var name in SpawnEntityNames)
foreach (var e in Utilities.FindAllEntitiesByDesignerName<CBaseEntity>(name))
if (e is { IsValid: true } && e.AbsOrigin is { } o)
_spawnPoints.Add(new Vector(o.X, o.Y, o.Z));
if (_spawnPoints.Count == 0)
_p.LogSurvival($"WARN: no bot spawn points found ({string.Join("/", SpawnEntityNames)}) — directed placement disabled, bots use team spawn");
else
_p.LogSurvival($"gathered {_spawnPoints.Count} bot spawn points for directed placement");
}
// Respawn a pool bot, then (deferred a frame so the spawn settles) teleport it to a spawn point away from the squad.
private void DirectedBotSpawn(CCSPlayerController bot)
{
bot.SafeRespawn(); // CSSharp's Respawn() faults in SetPawn on a dead controller (see RespawnFix)
if (_spawnPoints.Count == 0 || _p.Config.Survival.MinSpawnDistance <= 0) return; // no candidates / disabled -> plain respawn
int slot = bot.Slot;
OutnumberedPlugin.NextFrameForSlot(slot, b =>
{
if (PickSpawnPoint() is { } pos && b.PlayerPawn.Value is { } pawn)
pawn.Teleport(pos, null, new Vector(0, 0, 0));
}, requireAlive: true);
}
// A spawn point at least MinSpawnDistance (HORIZONTAL) from every live survivor, picked at random among the valid ones so
// consecutive spawns scatter (bots approach from varied bearings, not one corner). If the map is too tight for any point
// to qualify, use the one that maximises the distance to the nearest survivor. null only if there are no spawn points.
private Vector? PickSpawnPoint()
{
if (_spawnPoints.Count == 0) return null;
var humans = CtHumans().Where(h => h.PawnIsAlive && h.PlayerPawn.Value?.AbsOrigin is not null)
.Select(h => h.PlayerPawn.Value!.AbsOrigin!).ToList();
if (humans.Count == 0) return _spawnPoints[Random.Shared.Next(_spawnPoints.Count)]; // nobody to avoid -> any point
double min2 = _p.Config.Survival.MinSpawnDistance * _p.Config.Survival.MinSpawnDistance;
var valid = new List<Vector>();
Vector? farthest = null;
double farthestNear2 = -1;
foreach (var sp in _spawnPoints)
{
double near2 = double.MaxValue; // squared distance to the CLOSEST survivor
foreach (var h in humans)
{
double dx = sp.X - h.X, dy = sp.Y - h.Y; // horizontal only (a point above/below is still "near")
double d2 = dx * dx + dy * dy;
if (d2 < near2) near2 = d2;
}
if (near2 >= min2) valid.Add(sp);
if (near2 > farthestNear2) { farthestNear2 = near2; farthest = sp; }
}
return valid.Count > 0 ? valid[Random.Shared.Next(valid.Count)] : farthest;
}
// HUD line for the active run: wave number + bots remaining to clear it (or the break state). "" when no run.
// Surfaced to the core via IMatchDriver.HudStatusLine so the HUD never type-checks the concrete driver.
public string HudStatusLine(PlayerData pd) => WaveHud();
private string WaveHud()
{
if (!_runActive) return "";
int cap = _p.Config.Survival.WaveCount;
if (_phase == WavePhase.Break) return $"WAVE {_highestWaveCleared}/{cap} CLEARED — break";
return $"WAVE {_wave}/{cap} — {Math.Max(0, _waveBudget - _killsThisWave)} bots left";
}
// ---- revive ----
private void ReviveDead()
{
if (!_p.Config.Survival.ReviveOnWaveClear) return;
foreach (var p in CtHumans())
if (!p.PawnIsAlive) _p.ReviveSurvivor(p);
}
// ---- the draft ----
private void GrantCards()
{
int per = Math.Max(1, _p.Config.Survival.CardsPerWave);
bool reviveOn = _p.Config.Survival.ReviveOnWaveClear;
foreach (var p in CtHumans())
{
// Hardcore (no revive): a permanently-dead player can never open/spend a pick — don't bank it or spam the chat.
// (In revive mode ReviveDead ran just above, so the dead are revived; gating on reviveOn covers the respawn lag.)
if (!p.PawnIsAlive && !reviveOn) continue;
var pd = _p.PdOf(p);
if (pd is null) continue;
var run = Run(pd);
if (!HasDraftableCard(run)) continue; // every card already maxed -> don't bank a pick that can never be spent
run.RunPoints += per;
EnsureDraw(run); // keep the existing offer if still valid (anti-cheese: skipping a wave must NOT reroll the draft)
// Show the running total (incl. any banked from missed breaks) so the player knows what's waiting.
p.PrintToChat($" {ChatColors.Gold}[Survival] {ChatColors.Lime}{run.RunPoints}{ChatColors.Default} card pick(s) available — press {ChatColors.Gold}X{ChatColors.Default} to draft (unspent picks carry over).");
}
}
// Any card still under its cap (per-player OR the shared team level) — gates the draft so it never auto-pops a
// frozen, empty overlay once everything's maxed.
private bool HasDraftableCard(SurvivalRun run) =>
_p.Config.Survival.Cards.Any(c => !string.IsNullOrWhiteSpace(c.Key) && CardCount(run, c.Key) < c.Cap);
private void Redraw(SurvivalRun run)
{
var cfg = _p.Config.Survival;
var pool = cfg.Cards.Where(c => !string.IsNullOrWhiteSpace(c.Key) && CardCount(run, c.Key) < c.Cap).ToList();
int n = Math.Min(Math.Min(Math.Max(1, cfg.DraftSize), 3), pool.Count); // cap at 3 — the overlay only renders 3 panels
run.DrawnThisBreak = pool.OrderBy(_ => Random.Shared.Next()).Take(n).Select(c => c.Key).ToList();
}
// Ensure the player has a draftable hand WITHOUT rerolling a still-valid one. ANTI-CHEESE: banking a pick across a
// wave must NOT reroll the offer (else a player skips waves to fish for the best cards). So only (re)draw when the
// current hand has no still-draftable card left — empty, or every drawn card is now maxed (e.g. a team card others
// maxed). The drawn hand persists on SurvivalRun across breaks, alongside the banked RunPoints.
private void EnsureDraw(SurvivalRun run)
{
if (run.RunPoints <= 0) return;
bool hasValid = run.DrawnThisBreak.Any(k => CardDef(k) is { } d && CardCount(run, k) < d.Cap);
if (!hasValid && HasDraftableCard(run)) Redraw(run);
}
// ---- shop-facing draft API ----
public bool DraftPending(CCSPlayerController p)
{
if (!_runActive || _phase != WavePhase.Break) return false;
var pd = _p.PdOf(p);
return pd is not null && _runs.TryGetValue(pd.SteamId, out var run) && run.RunPoints > 0 && HasDraftableCard(run);
}
// Unspent draft picks the player has banked (spendable in any break) — surfaced in the draft menu header.
public int PendingCards(CCSPlayerController p)
{
var pd = _p.PdOf(p);
return pd is not null && _runs.TryGetValue(pd.SteamId, out var run) ? run.RunPoints : 0;
}
// View data for one draft card (CardView lives in Modes.cs alongside IDraftDriver): name, current/cap picks, and
// either the current->next % value (the original stat cards) OR a custom Detail line (the effect cards).
public CardView? CardInfo(CCSPlayerController p, string key)
{
var pd = _p.PdOf(p);
if (pd is null || !_runs.TryGetValue(pd.SteamId, out var run)) return null;
var def = CardDef(key);
if (def is null) return null;
int have = CardCount(run, key); // per-player picks, or the shared team level
bool flat = def.Flat; // flat points (HP/armor caps + flat regen) vs % — data-driven
double next = (have + 1) * def.PerPick;
string? detail = EffectCardDetail(key, def, have); // null for the original stat cards -> Now/Next % shown
return new CardView(def.Name, have, def.Cap, have * def.PerPick, next, flat, detail);
}
// A human-readable effect line for the new logic cards (the Now/Next % display is meaningless for these). Values are
// shown AFTER the next pick (level have+1). Team cards COMPOUND (match RecomputeTeamMults), so their detail shows the
// real compounded total, not the additive sum. Returns null for the 12 stat cards (they keep the +Now% -> +Next% panel).
private string? EffectCardDetail(string key, SurvivalCardDef def, int have)
{
int lvl = have + 1; // value after the next pick
double add = lvl * def.PerPick; // linear per-pick total (the per-player leveled cards)
// Team cards COMPOUND, so show the real compounded total (not the additive sum); the deal/take direction is the
// only inherently-2-card distinction left.
if (def.IsTeam)
return key == CardKeys.GlobalTake
? $"squad -{(1.0 - SurvivalEconomy.TeamMult(lvl, def.PerPick, increase: false)) * 100.0:0}% dmg taken"
: $"squad +{(SurvivalEconomy.TeamMult(lvl, def.PerPick, increase: true) - 1.0) * 100.0:0}% dmg dealt";
// Burn's magnitude comes from the Burn* knobs (not the card PerPick), so it can't be a {0} template.
if (key == CardKeys.Burn)
{
var cfg = _p.Config.Survival;
return $"{cfg.BurnDamagePerSecond:0} HP/s for {cfg.BurnDurationSeconds:0}s";
}
// Field Medic scales off the Revive* knobs (charges/wave, channel time, revive HP%), not the card PerPick.
if (key == CardKeys.FieldMedic)
{
var cfg = _p.Config.Survival;
return $"revive allies · {SurvivalEconomy.ReviveChargesForWave(lvl, cfg)}/wave · {SurvivalEconomy.ReviveChannelSeconds(lvl, cfg):0.0}s · {SurvivalEconomy.ReviveHpFraction(lvl, cfg) * 100:0}% HP";
}
// Everything else: the data-driven Detail template ({0} = level x PerPick). Empty -> stat card -> Now/Next % panel.
return string.IsNullOrEmpty(def.Detail) ? null : string.Format(def.Detail, add);
}
// The current offered draw as (cardKey, displayLabel) — stable across a reopen within the same break (anti-reroll).
public List<(string key, string label)> CurrentDraw(CCSPlayerController p)
{
var res = new List<(string, string)>();
var pd = _p.PdOf(p);
if (pd is null || !_runs.TryGetValue(pd.SteamId, out var run)) return res;
foreach (var key in run.DrawnThisBreak)
{
var def = CardDef(key);
if (def is null) continue;
res.Add((key, $"{def.Name} [{CardCount(run, key)}/{def.Cap}]"));
}
return res;
}
public void PickCard(CCSPlayerController p, string key)
{
var pd = _p.PdOf(p);
if (pd is null || !_runs.TryGetValue(pd.SteamId, out var run) || run.RunPoints <= 0) return;
if (!run.DrawnThisBreak.Contains(key)) return;
var def = CardDef(key);
if (def is null || CardCount(run, key) >= def.Cap) return; // already maxed (per-player OR the shared team level)
run.RunPoints--;
if (IsTeamCard(key)) // squad-wide: bump the shared level, recompute the team multiplier, tell everyone
{
if (key == CardKeys.GlobalDeal) _teamDealLevel++; else _teamTakeLevel++;
RecomputeTeamMults();
int lvl = CardCount(run, key);
Server.PrintToChatAll($" {ChatColors.Gold}[Survival] {ChatColors.Lime}{p.PlayerName} {ChatColors.Default}raised {ChatColors.Lime}{def.Name} {ChatColors.Default}-> team {lvl}/{def.Cap}");
if (lvl >= def.Cap) foreach (var r in _runs.Values) r.DrawnThisBreak.RemoveAll(k => k == key); // pull the now-maxed team card from every hand
}
else
{
run.Cards[key] = run.Cards.GetValueOrDefault(key) + 1;
p.PrintToChat($" {ChatColors.Gold}[Survival] {ChatColors.Lime}{def.Name} {ChatColors.Default}-> {run.Cards[key]}/{def.Cap} ({run.RunPoints} pick(s) left)");
// ONLY a Max-HP/Max-Armor card touches the live pawn: raise the cap + top up by the card's bonus. NO full heal
// on any pick (that would erase the 50% revive penalty and reset the squad to full HP every wave).
if (key == StatKeys.MaxHp || key == StatKeys.MaxArmor) _p.GrantCardCapBonus(p, key, (int)def.PerPick);
}
if (run.RunPoints > 0) Redraw(run); else run.DrawnThisBreak.Clear();
}
// ---- helpers ----
private SurvivalRun Run(PlayerData pd)
{
if (!_runs.TryGetValue(pd.SteamId, out var r)) { r = new SurvivalRun(CardDef); _runs[pd.SteamId] = r; }
return r;
}
// Bank raw combat XP into the player's CURRENT-wave accumulator (granted at wave clear). Called from GrantCombatXp.
// The xp_mult card (+% run-XP, per-player) scales the RAW accumulation here, so it compounds with the per-wave
// prestige x waveMult chain applied at grant time.
public void AccumulateWaveXp(PlayerData pd, double amount)
{
if (!_runActive || amount <= 0) return;
Run(pd).WaveXp += SurvivalEconomy.AccrueWaveXp(amount, StatBonus(pd, CardKeys.XpMult));
}
private SurvivalCardDef? CardDef(string key)
{
foreach (var c in _p.Config.Survival.Cards) if (c.Key == key) return c;
return null;
}
private static IEnumerable<CCSPlayerController> CtHumans() =>
Utilities.GetPlayers().Where(p => OutnumberedPlugin.IsHuman(p) && p.Team == CsTeam.CounterTerrorist);
private static int AliveCtHumans() => CtHumans().Count(p => p.PawnIsAlive);
private static int BotCount() => Utilities.GetPlayers().Count(OutnumberedPlugin.IsBot);
// The connected controller for a SteamId (any team) — for the run-end chat line; null if they've left.
private static CCSPlayerController? ControllerFor(ulong sid) =>
Utilities.GetPlayers().FirstOrDefault(p => OutnumberedPlugin.IsHuman(p) && p.AuthorizedSteamID?.SteamId64 == sid);
}
// Plugin-side survival helpers (per-wave XP grant, revive, HP reapply) — here so they can reach the private XP/stat math.
public sealed partial class OutnumberedPlugin
{
// Diagnostic logging for the survival wave machine (console: "[Survival] ...").
internal void LogSurvival(string msg) => Logger.LogInformation("[Survival] {Msg}", msg);
// Grant ONE cleared wave's XP into the main table: rawWaveXp x prestige x waveMult(wave), NO cap, handicap-mult
// EXCLUDED (anti-launder: run XP must not re-couple to gameable K/D; anti-carry is automatic since waveXp is each
// player's OWN attributed damage). Per-wave so players level + earn skill points mid-run, and the XP lands in the main
// table immediately (a disconnect keeps every CLEARED wave — there's no separate run accumulator to restore).
internal void BankWaveXp(PlayerData pd, double waveXp, int wave, CCSPlayerController? p)
{
if (waveXp <= 0) return;
var cfg = Config.Survival;
long lump = SurvivalEconomy.WaveXpLump(waveXp, wave, pd.Prestige, cfg, Config.Progression);
if (lump <= 0) return;
AddConvertedXp(pd, lump, p);
p?.PrintToChat($" {ChatColors.Gold}[Survival] Wave {wave} XP: {ChatColors.Lime}+{lump:n0} {ChatColors.Default}(x{SurvivalEconomy.WaveMult(wave, cfg):F1}).");
}
// Shared revive core: respawn a dead CT ally, then (deferred, slot+SteamID-pinned so a within-frame slot-reuse can't hit
// the wrong player) optionally teleport them + set HP to hpPct of their max. mp_respawn_on_death_ct 0 keeps them down, so
// Respawn is manual. CT-only by construction (a non-CT target is refused, not force-switched) so a stray non-participant
// entry can never be pulled onto CT. The two revive flavors below own only their guard/pct/teleport specifics.
private void ReviveAt(CCSPlayerController p, double hpPct, Vector? teleportTo)
{
if (p is not { IsValid: true } || p.IsBot || p.PawnIsAlive || p.Team != CsTeam.CounterTerrorist) return;
if (p.AuthorizedSteamID?.SteamId64 is not { } sid) return;
var dest = teleportTo is { } t ? new Vector(t.X, t.Y, t.Z) : null;
p.SafeRespawn(); // CSSharp's Respawn() faults in SetPawn on a dead controller (see RespawnFix)
NextFrameForSlot(p.Slot, sid, pl =>
{
var pd = PdOf(pl); var pawn = pl.PlayerPawn.Value;
if (pd is null || pawn is null) return;
if (dest is not null) pawn.Teleport(dest, null, new Vector(0, 0, 0));
ApplyMaxHpArmor(pl, pd);
PawnWriter.SetHealth(pawn, Math.Max(1, (int)(MaxHpOf(pd) * hpPct)));
}, requireAlive: true);
}
// The automatic wave-clear revive: respawn in place (at a spawn point), configured HP%.
internal void ReviveSurvivor(CCSPlayerController p) => ReviveAt(p, Config.Survival.ReviveHpPercent, null);
// The Field Medic teammate-revive: respawn + teleport beside the reviver at a medic-scaled HP%. No-op if the target left.
internal void ReviveDownedAt(CCSPlayerController? p, Vector pos, double hpPct)
{
if (p is not null) ReviveAt(p, hpPct, pos);
}
// A FLAT support-XP bounty for a Field Medic revive: straight into the main table (NOT the per-wave accumulator, so it
// never rides the wave multiplier), prestige/handicap excluded — a fixed reward for saving a teammate, not a farm.
internal void GrantReviveXp(PlayerData pd, CCSPlayerController medic)
{
long lump = (long)Config.Survival.ReviveXp;
if (lump > 0) AddConvertedXp(pd, lump, medic);
}
internal void PlayReviveComplete(CCSPlayerController p) => PlaySound(p, Config.Sounds.ReviveComplete);
internal void PlayReviveWarn(CCSPlayerController p) => PlaySound(p, Config.Sounds.ReviveWarn);
// A survival Max-HP / Max-Armor card just took effect: raise the live cap and top current HP/armor up by the card's
// bonus ONLY — never a full heal (a full heal on any pick would erase the 50% revive penalty and reset the squad to
// full HP every wave). Other cards never touch current HP/armor.
internal void GrantCardCapBonus(CCSPlayerController p, string statKey, int bonus)
{
if (bonus <= 0) return;
var pd = PdOf(p);
var pawn = p.PlayerPawn.Value;
if (pd is null || pawn is null || !p.PawnIsAlive) return;
if (statKey == StatKeys.MaxHp)
{
int maxHp = MaxHpOf(pd); // already includes the just-picked card (run.Cards incremented first)
PawnWriter.SetMaxHealth(p, pawn, maxHp);
PawnWriter.SetHealth(pawn, Math.Min(maxHp, pawn.Health + bonus));
}
else if (statKey == StatKeys.MaxArmor)
{
PawnWriter.SetArmor(pawn, Math.Min(MaxArmorOf(pd), pawn.ArmorValue + bonus));
}
}
// PlayerData for a SteamId (the survival run-end bank resolves participants by id, not current team).
internal PlayerData? PdBySteamId(ulong sid) => _players.TryGetValue(sid, out var pd) ? pd : null;
}