Finishing a game on the site¶
On the site, a player of the game finishes a game that's still going: they pick the winner, the win type and the number of turns, and the result and ratings come out the same as after /game finish.
On this page: Who sees the button, The finish dialog, Suggestions from the save, Players without a nation, Result, What can go wrong
Participants¶
This applies to the server the CivBot site works with.
- Player of the game — the owner of a seat in the game: opens the dialog on the game page, checks the fields and confirms the finish.
- Moderator without a seat in the game — only views the game on the site; finishes it in Discord with the
/game finishcommand. See Finishing a game. - Guest — doesn't see the game on the site: both the games list and the game page ask them to sign in with Discord.
- Site — shows the dialog, fills in a suggestion from the save and records the result.
- Bot — redraws the game card in the thread and the list of recent games.
Steps¶
sequenceDiagram
participant G as Player
participant S as Site
participant B as Bot
G->>S: presses “Finish the game”
S-->>G: shows the “Finish the game?” dialog with a suggestion from the save
G->>S: picks the winner, the victory and the turns
G->>S: presses “Finish the game” in the dialog
S-->>G: closes the dialog and shows the finished game
S->>B: reports the result
B-->>G: updates the game card in the thread and the list of recent games
- Open the game page. Sign in to the site with Discord, open your game in the “In progress” state and press “Finish the game”. The button is in the game header; when a save is attached to the game, the same button is also in the game's closing banner. Both open the same dialog.
- Check the fields. The “Finish the game?” dialog has three fields: “Winner”, “Victory” and “Turns”. An attached save can fill in values, but you decide.
- Pick a nation for those who still lack one. While any player has no nation, the confirm button is disabled. You can pick a nation right there in the dialog.
- Confirm. Press “Finish the game” at the bottom of the dialog. There's no separate second confirmation: after you press it, the game is finished, and the result can no longer be changed.
- Wait for the update in Discord. The game page updates at once, and the bot redraws the game card in the thread and the list of recent games within a few seconds (up to 15 s).
Who sees the button¶
Only a player of this game sees the “Finish the game” button, and only while the game is “In progress”. For everyone else, the game page has no button.
Moderator without a seat in the game
The site doesn't know Discord roles, so a moderator who doesn't play this game doesn't see the button. They finish the game in Discord with the /game finish command: there a moderator can finish any game on the server. See Finishing a game.
The button is also missing when the game is already finished, scrapped or closed: you can't change such games from the site.
The finish dialog¶
The “Finish the game?” dialog opens over the game page. Its intro explains: “The same as /finish in Discord: whoever finishes, here or there, the result and the ratings come out the same.” There are two buttons at the bottom: “Cancel” and “Finish the game”. While the site records the result, the button reads “Finishing…”, and the fields and “Cancel” are disabled.
| Field | What's in it | Hint |
|---|---|---|
| “Winner” | A menu of all players of this game, each row with a name and a nation | “Choose a player of this game” |
| “Victory” | One of five types | — |
| “Turns” | A whole number from 1 to 330 | “Turn”, with the note “from 1 to 330” |
Winner¶
You can pick only a player of this game as the winner. A menu row looks like “Orion · Arabia”; if the player has no nation yet, the row has only the name.
Victory¶
There are five types, and they're the same as in /game finish:
- “Science victory”;
- “Cultural victory”;
- “Diplomatic victory”;
- “Domination victory”;
- “Winner recognition”.
You can't type in your own type.
Turns¶
Type a whole number from 1 to 330 into the field. If the value is empty, isn't a whole number or is outside this range, no error appears on screen: the “Finish the game” button in the dialog just stays disabled.
The button turns on when a winner and a win type are picked, “Turns” holds a valid number and every player has a nation.
Under the fields, the dialog lists the consequences: “Ratings of every player are calculated, as /finish does in an FFA game”, “The game message in Discord is updated” and, with a warning mark, “The result can't be changed afterwards, here or in Discord”.
Suggestions from the save¶
If a save is attached to the game, it only suggests values: it records nothing itself. Above the fields there's a strip with an explanation, and fields that still match the save's suggestion carry the “from the save” tag. Change a field, and the tag disappears. Each time you open the dialog, the fields are filled in from the save again. Without a save, there's no strip and no prefilling. For more about saves, see Game saves on the site.
The save fills in the winner only when it knows exactly one winner and that player is matched to a seat in the game. It fills in the win type in three cases: a space race win gives “Science victory”, a conquest win gives “Domination victory”, and a cultural one gives “Cultural victory”. The turn is the turn of the victory, or, if there isn't one, the turn of the save.
The strip has five variants:
| Situation | What the strip says |
|---|---|
| The save recorded a victory, the fields are filled in | “Filled from the save of turn 212 — check it before you finish” |
| The save recorded a diplomatic victory | “The save of turn 212 records a Diplomatic victory of Vega: a UN vote or a conceded game, the file can't tell — choose the victory yourself” |
| The save recorded a time victory | “The save of turn 212 records a Time victory of Vega: winner and turns are filled in, choose the victory yourself” |
| The save's winner isn't matched to a player of the game | “The save records a victory on turn 212, but its winner isn't matched to a player of this game — choose the winner yourself” |
| The save has no result yet | “The save holds no result yet — fill in the fields yourself” |
The strip text contains the real turn number and the player's name. When the winner isn't matched or there's no result, the fields are empty.
Players without a nation¶
Before the game is finished, every player must have a nation: one picked in the game, or the one they played according to the save. If any player has no nation yet, a yellow block appears in the dialog with a title like “Orion has no nation yet” and the text “Every player needs a nation before the game is finished. Choose it here — the same choice as on their cards — or attach a save.”
Each such player has a row with the “Choose a nation” button. It opens the same nation list as the player's card on the game page:
- there's a “Search a nation” field;
- the list heading “Nation for Orion · 3 of 43, bans left out” shows how many nations are in this player's list (the first number) and how many there are in total (the second);
- a nation already picked by another player is marked “Vega's” and can't be chosen;
- if nothing fits, the list says “No nation matches”.
The pick is saved at once, just as on a player's card, and the bot redraws the card in Discord. When everyone has a nation, the block disappears. For picking in Discord, see Picking nations and swapping slots.
Result¶
After you confirm:
- the game gets the “Finished” state, and the site records the winner, the win type and the number of turns;
- in an FFA game, every player's rating changes just as after
/game finish, and in a Duel game the rating doesn't change; see How rating is calculated; - the dialog closes, and the game page shows the result;
- the game header gets a “Finished on the site” mark with the player's name and the date;
- the bot updates the game card in the thread and the list of recent games on the game panel.
If a save is already attached to the game, all players are matched and there are no pending substitutions, the site closes the game at once. Otherwise the game stays finished: when a save is attached, the banner under the header says what's missing before closing; without a save, you must attach one first. See Game page and Game saves on the site.
Rules and exceptions¶
The result is the same wherever the game is finished¶
The site and /game finish give the same result, the same checks and the same rating. Rating is awarded once: if a game is finished on the site and in Discord at the same time, the second finish doesn't go through.
A finished game can't be changed¶
After the finish, the result can't be changed, either on the site or in Discord. A closed game can't be changed from the site at all.
If the game is already finished¶
If someone else finishes the game while your dialog is open, the dialog shows a “This game is already finished” block with a single “Close” button. It says where the game was finished: “on the site” or “in Discord”.
What can go wrong¶
The dialog shows the server's refusals in a red block. Nothing is recorded.
- “The winner must be a player of this game.” You picked someone who doesn't have a seat in the game. Pick the winner from the menu.
- “A player still has no nation. Choose it above, then finish the game.” Someone lost their nation while the dialog was open. Pick it in the “No nation yet” block and try again.
- “Only players of this game can do this.” You don't have a seat in this game. A moderator finishes the game in Discord with the
/game finishcommand. - Nation pick errors in the dialog. If another seat just took the nation, it can no longer be picked for this seat, or the pick wasn't saved, the dialog says so; pick another nation or try again. See Game page.
- The “Finish the game” button in the dialog is disabled. No winner or win type is picked, “Turns” has no number from 1 to 330, or someone lacks a nation.
- The dialog shows “This game is already finished”. The game was finished in Discord or on the site before you (and maybe closed already): the result is already recorded, and there's nothing to do.
- There's no “Finish the game” button on the page. You aren't a player of this game, or the game isn't “In progress”. See Players, moderators and admins.
Related¶
- Game page
- Game saves on the site
- Finishing a game
- Picking nations and swapping slots
- How rating is calculated
- Players, moderators and admins
This page was translated with AI and checked against the bot's terms.