Skip to content
Ball2DDocs

Documentation

Guides

Complete, working rooms you can copy and adapt.

Each guide builds one room behavior end to end with the SDK, from the first line to shutdown. The code runs as written on Node.js 24 with ball2d/node and an API key.

Room recipes

Chat commands

Give admins !start, !swap and !mute commands and keep them out of the chat.

Balance teams automatically

Put every new player on the smaller team and rebalance when someone leaves.

Record every match

Save a recording of each match to disk and read it back.

Operations

Keep a room online

Reopen your room when it closes, with backoff that respects the service's limits.

Run under a process manager

Start the host at boot, restart it on failure and stop it cleanly.