Files
tidewall/src/sim/match.gd
T
claudeandClaude Opus 5.5 6e1c87fe32 M3: Eliminations, spectating and results
The simulation now names what ended each player: weapon, fall, drown or tide, from
the cause of the blow that took the last health. Hits carry the weapon's item code.

Match keeps a kill feed (eliminator, cause, weapon, tick), per-player stats (damage
dealt and taken between opponents, eliminations, never teammates), and a summary()
with place, eliminations, damage and survival time. Players who fall on the same
tick share the better place and are marked tied. When the last players fall
together, the tie-break raises one team to first and the rest share the next place.

Eliminated players spectate: first whoever knocked them out, then a living
teammate, then the next living player in join order. When a target falls or
leaves, the view follows its eliminator or moves on, on the same step. Spectators
can cycle forwards and back. In results everyone watches the winner.

The headless server logs every placement and the match summary.

Closes #26

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 23:13:15 -05:00

470 lines
17 KiB
GDScript

## A server's match flow: lobby, countdown, drop, play and results, then back to the
## lobby for a new match on a new island. Everything is driven by step(), one call per
## server tick, so it is deterministic and has no scene-tree or clock dependency.
##
## Participants are identified by handles the server chooses (a connection, a local
## player or a bot). Joining and leaving can happen in any phase: a join during a match
## waits in the lobby for the next one, and leaving during a match counts as being
## eliminated where they stood. Each match gets a fresh Simulation, built while the
## lobby waits, so nothing carries over from the last one.
class_name Match
extends RefCounted
const LOBBY: int = 0
const COUNTDOWN: int = 1
const DROP: int = 2
const PLAY: int = 3
const RESULTS: int = 4
const PHASE_NAMES: Array[String] = ["lobby", "countdown", "drop", "play", "results"]
## Bots added to fill a match get handles counting down from here, so they never clash
## with a server's own handles, which are positive.
const FIRST_BOT_HANDLE: int = -1
var rules: MatchRules
## The seed the server was started with. Match 0 uses it as is; later matches derive
## their own from it and their index.
var session_seed: int = 0
## How many matches have started. The current or next match's index is this, or this
## minus one once it has started.
var matches_started: int = 0
var phase: int = LOBBY
## Ticks spent in the current phase.
var phase_ticks: int = 0
## The current match's simulation during the drop, play and results. In the lobby and
## countdown, the next match's simulation, generated and waiting for players.
var sim: Simulation
## Participant handles in join order, and which of them are bots.
var participants: Array[int] = []
var bot_handles: Dictionary = {}
## Handles playing in the current match, and their entity IDs both ways.
var entity_of: Dictionary = {}
var handle_of: Dictionary = {}
## Handle -> team index, for the current match.
var team_of: Dictionary = {}
## Finishing order of the current match, last place first: {"handle", "place", "tied",
## "by", "cause", "item", "left", "tick"}. "by" is the eliminating handle, or 0; "cause" a
## SimEntity.CAUSE_NAMES entry, or "left"; "item" the weapon that last hit them, or -1;
## "tick" the simulation tick they were placed on. Players who fall on the same tick
## share the better place and are marked "tied" (standard competition ranking).
var placements: Array[Dictionary] = []
## The kill feed: one entry per elimination or leave, oldest first, with the fields of a
## placement record.
var kill_feed: Array[Dictionary] = []
## Handle -> {"eliminations", "damage_dealt", "damage_taken"} for the current match.
## Damage counts only hits between opponents.
var stats: Dictionary = {}
## Eliminated participant handle -> the living handle they're watching. A target that
## falls is replaced on the same step; see _retarget().
var spectating: Dictionary = {}
## The winning handles, empty for no winner (everyone left, or no one played).
var winners: Array[int] = []
## What happened during the last step(): phase changes, joins, leaves, placements.
var events: Array[Dictionary] = []
var _next_bot_handle: int = FIRST_BOT_HANDLE
## Handles placed during the current step, for breaking a tie when the last players
## fall together.
var _placed_this_step: Array[int] = []
## How many started the current match.
var _match_size: int = 0
## The current match's handles in join order, leavers included.
var _roster: Array[int] = []
## Handle -> item code of the weapon that last hit them, this match.
var _last_weapon: Dictionary = {}
func _init(seed_value: int, match_rules: MatchRules = null) -> void:
session_seed = seed_value
rules = match_rules if match_rules != null else MatchRules.new()
sim = Simulation.new(match_seed(0))
## The seed of match `index`: the session seed for the first, then a hash of it and the
## index, kept non-negative.
func match_seed(index: int) -> int:
if index == 0:
return session_seed
return (session_seed ^ SimRng._hash_name("match:%d" % index)) & 0x7FFFFFFFFFFFFFFF
## The current or next match's seed.
func current_seed() -> int:
return sim.rng.match_seed
func phase_name() -> String:
return PHASE_NAMES[phase]
func in_match() -> bool:
return phase == DROP or phase == PLAY
## Adds a participant. Returns false if the handle is already here or the lobby is
## full. During a match they wait for the next one.
func join(handle: int, bot: bool = false) -> bool:
if participants.has(handle) or participants.size() >= rules.max_players:
return false
participants.append(handle)
if bot:
bot_handles[handle] = true
events.append({"type": "joined", "handle": handle, "bot": bot})
return true
## Removes a participant. In a match, they're placed as if eliminated and their player
## leaves the simulation. Returns false if the handle isn't here.
func leave(handle: int) -> bool:
if not participants.has(handle):
return false
participants.erase(handle)
bot_handles.erase(handle)
events.append({"type": "left", "handle": handle})
if entity_of.has(handle):
var entity_id: int = entity_of[handle]
var player: SimEntity = sim.entities.find(entity_id)
if in_match() and player != null and not player.eliminated:
_place(handle, 0, true, _match_size - placements.size(), false)
sim.remove_player(entity_id)
handle_of.erase(entity_id)
entity_of.erase(handle)
spectating.erase(handle)
if in_match():
_update_spectators()
return true
## Passes a participant's command to the simulation. Returns false outside a match, for
## a handle that isn't playing, or if the simulation rejected it.
func submit_command(handle: int, command: PlayerCommand) -> bool:
if not in_match() or not entity_of.has(handle):
return false
return sim.submit_command(entity_of[handle], command)
## Handles still in the match and not eliminated, in join order.
func alive() -> Array[int]:
var living: Array[int] = []
if not in_match() and phase != RESULTS:
return living
for handle: int in entity_of:
var player: SimEntity = sim.entities.find(entity_of[handle])
if player != null and not player.eliminated:
living.append(handle)
return living
## Advances one server tick.
func step() -> void:
events.clear()
_placed_this_step.clear()
phase_ticks += 1
match phase:
LOBBY:
if participants.size() < rules.min_players:
phase_ticks = 0
elif participants.size() >= rules.max_players or phase_ticks >= rules.lobby_ticks:
_enter(COUNTDOWN)
if rules.countdown_ticks <= 0:
_start()
COUNTDOWN:
if participants.size() < rules.min_players:
_enter(LOBBY)
elif phase_ticks >= rules.countdown_ticks:
_start()
DROP, PLAY:
sim.step()
_collect_damage()
_collect_eliminations()
if phase == DROP and sim.drop.finished:
_enter(PLAY)
_check_finished()
_update_spectators()
RESULTS:
if phase_ticks >= rules.results_ticks:
_reset()
func _enter(next: int) -> void:
events.append({"type": "phase", "from": PHASE_NAMES[phase], "to": PHASE_NAMES[next], "match": current_seed()})
phase = next
phase_ticks = 0
## Fills empty places with bots, puts every participant on the barge and places loot.
func _start() -> void:
if rules.fill_with_bots:
while participants.size() < rules.max_players:
var handle: int = _next_bot_handle
_next_bot_handle -= 1
join(handle, true)
var size: int = maxi(rules.team_size, 1)
for index: int in participants.size():
var handle: int = participants[index]
var entity_id: int = sim.add_player()
entity_of[handle] = entity_id
handle_of[entity_id] = handle
team_of[handle] = index / size
stats[handle] = {"eliminations": 0, "damage_dealt": 0, "damage_taken": 0}
_match_size = participants.size()
_roster = participants.duplicate()
sim.start_drop()
sim.start_tide()
sim.place_loot()
matches_started += 1
_enter(DROP)
events.append({"type": "match_started", "match": current_seed(), "index": matches_started - 1, "players": participants.size()})
_check_finished()
## Adds up damage between opponents and remembers each victim's last weapon.
func _collect_damage() -> void:
for event: Dictionary in sim.events:
if event["type"] != "player_hit" or not handle_of.has(event["victim"]):
continue
var victim: int = handle_of[event["victim"]]
var attacker: int = int(handle_of.get(event["player"], 0))
if attacker == 0 or attacker == victim or team_of[attacker] == team_of[victim]:
continue
var amount: int = int(event["armor"]) + int(event["health"])
stats[attacker]["damage_dealt"] += amount
stats[victim]["damage_taken"] += amount
_last_weapon[victim] = int(event.get("item", -1))
## Places everyone the simulation eliminated this tick. They share the best place of
## the range they fall into: with five standing and two falling together, both are 4th.
func _collect_eliminations() -> void:
var fallen: Array[Dictionary] = []
for event: Dictionary in sim.events:
if event["type"] == "eliminated" and handle_of.has(event["player"]):
fallen.append(event)
if fallen.is_empty():
return
var place: int = _match_size - placements.size() - fallen.size() + 1
for event: Dictionary in fallen:
var by: int = int(handle_of.get(event["by"], 0))
var handle: int = handle_of[event["player"]]
_place(handle, by, false, place, fallen.size() > 1, String(event.get("cause", "none")))
if by != 0 and by != handle and team_of[by] != team_of[handle]:
stats[by]["eliminations"] += 1
## Records a participant's finishing place, adds them to the kill feed and gives them
## someone to spectate.
func _place(handle: int, by: int, left: bool, place: int, tied: bool, cause: String = "left") -> void:
for placed: Dictionary in placements:
if placed["handle"] == handle:
return
var record: Dictionary = {
"handle": handle, "place": place, "tied": tied, "by": by,
"cause": "left" if left else cause, "item": int(_last_weapon.get(handle, -1)) if by != 0 else -1,
"left": left, "tick": sim.tick,
}
placements.append(record)
kill_feed.append(record)
if not left:
_placed_this_step.append(handle)
spectating[handle] = 0
var event: Dictionary = record.duplicate()
event["type"] = "placed"
events.append(event)
## Ends the match when at most one team has anyone standing, or when the tide's time
## limit runs out. If the last players fall on the same tick, or time runs out with
## several still standing, the tie-break picks the winner, so every match that started
## with players has one.
func _check_finished() -> void:
if not in_match():
return
var living: Array[int] = alive()
var teams: Dictionary = {}
for handle: int in living:
teams[team_of[handle]] = true
var timed_out: bool = sim.tide != null and sim.tide.stage_at(sim.tick) == Tide.OVER
if teams.size() > 1 and not timed_out:
return
winners.clear()
if teams.size() >= 1:
var best: int = living[0] if teams.size() == 1 else _tie_break(living)
for handle: int in living:
if team_of[handle] == team_of[best]:
winners.append(handle)
# Anyone else still standing at the time limit is placed by the tie-break, worst last.
var losers: Array[int] = []
for handle: int in living:
if not winners.has(handle):
losers.append(handle)
while not losers.is_empty():
var worst: int = _tie_break(losers, true)
losers.erase(worst)
_place(worst, 0, false, _match_size - placements.size(), false, "tide")
elif not _placed_this_step.is_empty():
# Everyone fell on the same tick: the tie-break raises one team back to first,
# and the rest of that tick's fallers share the place below the winners.
var best: int = _tie_break(_placed_this_step)
for handle: int in _placed_this_step:
if team_of[handle] == team_of[best]:
winners.append(handle)
var kept: Array[Dictionary] = []
var shared: Array[Dictionary] = []
for record: Dictionary in placements:
if winners.has(record["handle"]):
continue
kept.append(record)
if _placed_this_step.has(record["handle"]):
shared.append(record)
for record: Dictionary in shared:
record["place"] = winners.size() + 1
record["tied"] = shared.size() > 1
placements = kept
for handle: int in winners:
placements.append({
"handle": handle, "place": 1, "tied": winners.size() > 1, "by": 0,
"cause": "none", "item": -1, "left": false, "tick": sim.tick,
})
spectating.erase(handle)
_enter(RESULTS)
events.append({"type": "match_ended", "match": current_seed(), "winners": winners.duplicate(), "timed_out": timed_out})
## The best of `handles` by the tie-break: most health, then highest feet, then the
## earliest to join. With `worst`, the worst instead.
func _tie_break(handles: Array[int], worst: bool = false) -> int:
var chosen: int = handles[0]
for handle: int in handles:
if handle == chosen:
continue
var better: bool = _beats(handle, chosen)
if better != worst:
chosen = handle
return chosen
func _beats(a: int, b: int) -> bool:
var pa: SimEntity = sim.entities.find(entity_of[a])
var pb: SimEntity = sim.entities.find(entity_of[b])
if pa.health != pb.health:
return pa.health > pb.health
if not is_equal_approx(pa.position.y, pb.position.y):
return pa.position.y > pb.position.y
return participants.find(a) < participants.find(b)
## Back to the lobby: bots leave, the match's bookkeeping is cleared, and the next
## match's island is generated.
func _reset() -> void:
for handle: int in bot_handles.keys():
participants.erase(handle)
bot_handles.clear()
entity_of.clear()
handle_of.clear()
team_of.clear()
placements.clear()
kill_feed.clear()
stats.clear()
spectating.clear()
_roster.clear()
_last_weapon.clear()
winners.clear()
_next_bot_handle = FIRST_BOT_HANDLE
_match_size = 0
sim = Simulation.new(match_seed(matches_started))
_enter(LOBBY)
## The living handle `handle` is watching, or 0 if they aren't spectating or nobody is
## left to watch.
func spectate_target(handle: int) -> int:
return int(spectating.get(handle, 0))
## Moves an eliminated participant's view to the next (`direction` 1) or previous (-1)
## living player in join order. Returns the new target, or 0.
func cycle_spectate(handle: int, direction: int = 1) -> int:
if not spectating.has(handle):
return 0
var living: Array[int] = alive()
if living.is_empty():
return 0
var step: int = 1 if direction >= 0 else -1
var at: int = _roster.find(spectate_target(handle))
if at < 0:
at = _roster.find(handle)
for offset: int in range(1, _roster.size() + 1):
var candidate: int = _roster[posmod(at + offset * step, _roster.size())]
if living.has(candidate):
spectating[handle] = candidate
return candidate
return 0
## Gives every spectator whose target is gone or has fallen a new one. During results,
## spectators watch a winner who is still standing, if there is one.
func _update_spectators() -> void:
var living: Array[int] = alive()
if phase == RESULTS and not winners.is_empty():
living = winners.duplicate()
for handle: int in spectating.keys():
var target: int = spectating[handle]
if living.has(target):
continue
spectating[handle] = _retarget(handle, target, living)
if spectating[handle] != target:
events.append({"type": "spectating", "handle": handle, "target": spectating[handle]})
## Who a spectator watches next: whoever eliminated the player they were watching (or
## themselves, the first time), then a living teammate, then the next living player in
## join order after the old target. 0 when nobody is left.
func _retarget(handle: int, old_target: int, living: Array[int]) -> int:
if living.is_empty():
return 0
var followed: int = old_target if old_target != 0 else handle
for record: Dictionary in placements:
if record["handle"] == followed and living.has(record["by"]):
return record["by"]
for candidate: int in living:
if team_of.get(candidate, -1) == team_of.get(handle, -2):
return candidate
var at: int = maxi(_roster.find(followed), 0)
for offset: int in range(1, _roster.size() + 1):
var candidate: int = _roster[(at + offset) % _roster.size()]
if living.has(candidate):
return candidate
return 0
## The match summary, best place first: one Dictionary per participant of the current
## match with "handle", "bot", "team", "place", "tied", "eliminations", "damage_dealt",
## "damage_taken", "survival_ticks", "survival_seconds", "by", "cause" and "left".
## Players still standing have place 0 and survival up to now.
func summary() -> Array[Dictionary]:
var rows: Array[Dictionary] = []
var record_of: Dictionary = {}
for record: Dictionary in placements:
record_of[record["handle"]] = record
for handle: int in _roster:
var record: Dictionary = record_of.get(handle, {})
var placed_tick: int = int(record.get("tick", sim.tick))
var row: Dictionary = stats.get(handle, {"eliminations": 0, "damage_dealt": 0, "damage_taken": 0}).duplicate()
row["handle"] = handle
row["bot"] = bot_handles.has(handle)
row["team"] = int(team_of.get(handle, -1))
row["place"] = int(record.get("place", 0))
row["tied"] = bool(record.get("tied", false))
row["survival_ticks"] = placed_tick
row["survival_seconds"] = float(placed_tick) / Tuning.TICK_RATE_HZ
row["by"] = int(record.get("by", 0))
row["cause"] = String(record.get("cause", ""))
row["left"] = bool(record.get("left", false))
rows.append(row)
rows.sort_custom(func(a: Dictionary, b: Dictionary) -> bool:
var pa: int = a["place"] if a["place"] > 0 else 0
var pb: int = b["place"] if b["place"] > 0 else 0
if pa != pb:
return pa < pb
return _roster.find(a["handle"]) < _roster.find(b["handle"]))
return rows