Lobbies
Finding lobbies
Search for lobbies and filter the results down to the ones you want.
The node
Use Find Lobbies (Async). It takes a Steam Lobby Search Query and returns an array of results.
Each result already carries what a browser needs: the lobby ID, how many players are in it, the member limit, the owner, and every key the host published. You do not need a follow up call per lobby.
| Result field | Meaning |
|---|---|
| Lobby Id | Pass this to Join Lobby |
| Member Count | Players currently inside |
| Member Limit | Maximum players |
| Owner | The host's Steam ID |
| Metadata | Every key and value the host published |
Building the query
Fill in a Steam Lobby Search Query struct:
| Field | What it does |
|---|---|
| String Filters | Match a published key against text |
| Numeric Filters | Match a published key against a number |
| Near Value Filters | Sort results by closeness to a number, rather than excluding any |
| Minimum Free Slots | Only lobbies with at least this many open slots |
| Distance | How far to search geographically |
| Max Results | Cap on results, 1 to 50 |
String filters
Each entry has a Key, a Value, and a Comparison. To find only lobbies running your game mode:
modedeathmatchThis only matches lobbies where the host called Set Lobby Data with key mode and value deathmatch.
Numeric filters
Same shape, with an integer value and comparisons like Equal, Not Equal, Greater Than and Less Than. Useful for a published skill rating or map size.
Near value filters
These do not remove anything. They sort. A near value filter on skill with target 1200 puts lobbies closest to 1200 first, without hiding the rest.
Distance
| Value | Meaning |
|---|---|
| Close | Same immediate region only |
| Default | Same continent |
| Far | Nearby continents |
| Worldwide | Everywhere. Highest ping, most results. |
A minimal search flow
name key.No results is not an error
An empty array with a successful result means the search worked and nothing matched. That is the normal state when you are the first person online.
Before assuming something is broken, check: