Skip to content

Document ghost state continuity and tournament timeout#691

Merged
themuffinator merged 1 commit intomainfrom
codex/document-ghost-player-system
Jan 9, 2026
Merged

Document ghost state continuity and tournament timeout#691
themuffinator merged 1 commit intomainfrom
codex/document-ghost-player-system

Conversation

@themuffinator
Copy link
Owner

Motivation

  • Clarify how the ghost reconnect system preserves player state beyond position to reduce confusion on rejoin.
  • Make explicit that reconnects restore a player’s score, stats, and inventory when a ghost spawn succeeds.
  • Call out tournament behavior so players and hosts understand that disconnects can trigger a short timeout window.
  • Improve player-facing documentation consistency across the repo by updating both places the guidance appears.

Description

  • Updated docs/wiki/players.md and wiki/Players.md to expand the ghost player system section and restructure it into How it works, Persistence rules, and Player tips.
  • Changed the persistence wording to explicitly state that when a ghost spawn succeeds your score, stats, and inventory are restored, and preserved the existing note about g_ghost_min_play_time.
  • Added a concise Tournament timeouts note under player tips to document the brief reconnect window used in tournament matches.
  • Kept the existing safety-first respawn checks and fallback behavior documentation (blocked ghost spot logs and normal spawn fallback).

Testing

  • No automated tests were run because this is a documentation-only change.
  • Documentation builds or linters were not invoked as part of this change.
  • Files changed: docs/wiki/players.md and wiki/Players.md were updated and inspected locally for the new text.
  • No runtime or gameplay tests were executed because no code was modified.

Codex Task

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant