Skip to content
Athena User Guide
Esc
↑↓navigate↵open⌘Jpreview
On this page

Run the game

Open the game network, pause and resume play, change settings safely, and end the event.

The Game state card on the event overview shows the game’s phase, the last completed tick and the controls below. The same controls are available as athena ad game.

Phase Meaning
setup The event site is up; teams form and you prepare services. No ticks run, including while a network-open request waits for its prerequisites.
running Ticks run, checkers place and read flags, and captures score.
paused Ticks stop and no new scored check starts. Unfinished checks are cancelled and run again on resume; diagnostics still run.
ended Final scores are committed.

Open the network

Click Request open and confirm. The network opens once every prerequisite holds:

  • settings are synchronized,
  • the roster is locked,
  • the host is ready.

When it opens, every box is snapshotted, the event’s network policy is applied, and ticks start. The snapshot is the clean state a box restore goes back to. The request can’t be withdrawn.

While the request waits, the card lists the opening’s steps: one snapshot per box, then the egress seal. If one fails, for example because the host ran out of space for a snapshot, the step shows why and the opening stops there. Fix the cause, then click Retry opening: the failed steps run again, and boxes that were already snapshotted aren’t snapshotted twice. Clicking twice, or from two browsers, starts one retry. From the CLI, athena ad game opening shows the same steps and athena ad game retry-opening retries.

If you replace the host before the network opens, the new host snapshots every box and seals its own egress; nothing the old host did counts toward opening the new one.

Pause and resume

Click Pause game and give a reason; players see it. Ticks stop advancing, no new scored check starts, and flag submissions are refused with a retryable response until you resume. Diagnostics you dispatch still run. Click Resume to continue. The tick clock picks up where it stopped, so a pause costs no ticks.

When the game pauses, checks that haven’t finished are withdrawn and recorded as Cancelled, which counts neither for nor against the team, and they run again after you resume. A check whose deadline had already passed when the pause began is recorded as its result, Down, as it would have been without the pause. The paused time itself never becomes a failed check.

The platform also pauses the game by itself, and the reason shows on the card:

  • when the checker runner reports that it can’t run checks, for example because it has lost an image it needs;
  • when the event host or the checker runner stops reporting in, so checks can’t be run or trusted.

Resuming is always your decision. See When something fails.

Change settings

Open Settings → Game to change the tick length, flag validity, checker timeout and scoring weights. Each save is applied to the event and confirmed back before the page reports it saved; while a change is still synchronizing, the page says so and further changes wait.

Game settings freeze when the network opens. Everything scored from then on uses the settings in force at that moment. See Event settings for the fields and their limits.

End the event

The event ends at its scheduled end time. At the end:

  1. no new tick starts and new captures are refused;
  2. checks already running get until their own deadline to finish, so none is cut short unfairly;
  3. final scores are committed and the phase becomes ended;
  4. players are emailed that the event has ended, and when the event runs a Discord server the bot posts an end announcement and the final scoreboard;
  5. the host and every box are destroyed, and host billing stops;
  6. the final data export is built and verified.

The event’s data is kept until the final export has been verified, even if building it takes several attempts, and for a few minutes after the end while the final emails and Discord posts go out. Download it from Exports; see Export event data.

To end early, use Settings → Danger zone. Players lose access at once.

Was this page helpful?