Skip to main content

Server-Side Move Timers

Here are several use cases we support:

  1. Asynchronously trigger a timeout event and modify the roomState
  2. Cancel an existing timer trigger while handling a move
caution

Potential Limitations:

  1. You can only have 1 active timer at a time.
  2. Time guarantees for timers are on the order of seconds, with a minimum relative due date of 5 seconds

It is recommended that if you want to do chess style timers, you will have to update the timer as each player moves, and continue to track time when player moves.

caution

This work is planned. Join discord to provide more details on your use case.

Workaround​

Current workaround recommended is to have clients use the clock synced time functions client.now() and make a client.makeMove() request whenever clients detect the match is over.

Clients will race to notify the server, which is okay because you can fail all other clients that called client.makeMove() by adding simple validation that checks if the timeout is already handled.

This is currently used in the Semantle Battle game.