If players get tired of a game in mid-play, and want to abandon it, the easiest course is for them all to simply quit their Volity clients. (The referee will mark the game as
abandoned, and eventually suspend it, and then destroy it entirely if nobody is present at the table.)
However, the players may want to kill the game in order to restart it. It should be convenient to do this without leaving the table or creating a new table.
Therefore, the referee accepts a volity.kill_game(boolean) RPC. This is effectively a game configuration request which can only be used when the game is suspended. If this is set true, then when the game unsuspends, it will immediately terminate. The referee will then cycle back to the setup state.
From the players' point of view, killing a game works like this:
- Some seated player sends volity.suspend_game(). The game is now suspended.
- Someone sends volity.kill_game(true). This is a config change, so all players are now unready.
- All seated players send volity.ready().
- The referee terminates the game and returns to the setup phase.