Concepts
Public tables
Copy page
List your game's open tables in Lia's lobby, so anyone on Lia can find a game and sit down, not just friends. Your server runs the table; Lia keeps the listing, the blocks and the reports.
Invites bring friends in. Public tables bring in anyone: your server lists a table that's waiting for players, people find it from your app or from Lia's own lobby, and your server seats them through Lia. Lia's own Lia XO works this way.
#How it works
- Your server lists a table
POST /lobby/tableswith its id, its host, the seats and a title. Lia only keeps the listing; the game, its seats and its rules stay on your server. - People find itIn your app with
Lia.lobby.tables(), or in Lia's own lobby in the Apps Center, which opens your app with the startParamlobby-<table id>. - Your server seats them
POST /lobby/tables/:id/sitwith the player's id. Lia refuses people the host blocked or who blocked the host, and full tables. - The table leaves the listWhen the last seat is taken, when your server takes it out, or when its listing ends by itself.
#Safe with strangers
- No chat. Strangers at a table see each other's username and play together; they can't message each other through Lia.
- Blocks hold. Nobody sees the tables of someone they blocked or who blocked them, and
/sitrefuses them. - Reports.
Lia.lobby.report(playerId, reason)reports a player to the Lia team (for their name, unfair play, abuse or anything else). Reporting also blocks them for the person, so neither sees the other's tables again. - Titles are filtered like everything else people read on Lia.
#Limits
| Limit | Why |
|---|---|
A host has at most 3 open tables in your app at a time (429 too_many_tables) | Nobody fills the lobby with their own tables. |
| A listing lasts 60 seconds to an hour (30 minutes by default), then ends by itself | The list only shows games that are really waiting. |
| A table has 2 to 10 seats | |
| A title is up to 40 characters | It has to fit Lia's lobby. |
stake and pot are for show, up to 10,000 LIA | Lia doesn't hold them: charge stakes with your own product on Lia's pay sheet. |
| One person can make 20 reports a day | Reports stay meaningful. |
Lia.lobby.tables() returns up to 50 tables a page | Use next for more. |
#In test
With your test key, tables are listed in test mode and only your testers see them. Live tables only appear while your app is live, and only live apps' tables appear in Lia's own lobby.
Multiplayer with invites adds a public table to the two player room, and the SDK and server references have every field.