Parties

Only available in the main GodotSteam branches

Functions

cancelReservation

cancelReservation( uint64_t beacon_id, uint64_t steam_id )

To cancel a reservation (due to timeout or user input), call this. Steam will open a new reservation slot.

Returns: void

Note: The user may already be in-flight to your game, so it's possible they will still connect and try to join your party.

changeNumOpenSlots

changeNumOpenSlots( uint64_t beacon_id, uint32 open_slots )

If a user joins your party through other matchmaking (perhaps a direct Steam friend, or your own matchmaking system), your game should reduce the number of open slots that Steam is managing through the party beacon. For example, if you created a beacon with five slots, and Steam sent you two reservation_notification callbacks, and then a third user joined directly, you would want to call changeNumOpenSlots with a value of 2 for open_slots. That value represents the total number of new users that you would like Steam to send to your party.

Triggers a change_num_open_slots call result.

Returns: void

createBeacon

createBeacon( uint32 open_slots, uint64_t location_id, int type, string connect_string, string metadata )

Create a beacon. You can only create one beacon at a time. Steam will display the beacon in the specified location, and let up to open_slots users "follow" the beacon to your party.

If users join your party through other matchmaking, adjust the number of remaining open slots using changeNumOpenSlots.

Triggers a create_beacon call result.

Returns: void

destroyBeacon

destroyBeacon( uint6_t beacon_id )

Call this method to destroy the Steam party beacon. This will immediately cause Steam to stop showing the beacon in the target location. Note that any users currently in-flight may still arrive at your party expecting to join.

Returns: bool

getAvailableBeaconLocations

getAvailableBeaconLocations( uint32 max )

Get the list of locations in which you can post a party beacon.

Returns: array

Contains a list of:

beacon_data (dictionary)
- type (int)
- location_id (uint64_t)

getBeaconByIndex

getBeaconByIndex( uint32 index )

Use with getNumActiveBeacons to iterate the active beacons visible to the current user. Argument [index is a zero-based index, so iterate over the range [0, getNumActiveBeacons() - 1]. The return is a beacon_id that can be used with getBeaconDetails to get information about the beacons suitable for display to the user.

Returns: uint64_t

getBeaconDetails

getBeaconDetails( uint64_t beacon_id )

Get details about the specified beacon. You can use the Friends API to get further details about owner_id, and getBeaconLocationData to get further details about location_id. The metadata contents are specific to your game, and will be whatever was set (if anything) by the game process that created the beacon.

Returns: dictionary

Contains the following keys:

beacon_id (uint64_t)
owner_id (uint64_t)
type (int)
location_id (uint64_t)
metadata (string)

getBeaconLocationData

getBeaconLocationData( int location_id, int location_type, int location_data )

Query general metadata for the given beacon location. For instance the Name, or the URL for an icon if the location type supports icons (for example, the icon for a Steam Chat Room Group).

Returns: string

getNumActiveBeacons

getNumActiveBeacons()

Get the number of active party beacons created by other users for your game, that are visible to the current user.

Returns: uint32

joinParty

joinParty( uint64_t beacon_id )

When the user indicates they wish to join the party advertised by a given beacon, call this method. On success, Steam will reserve a slot for this user in the party and return the necessary "join game" string to use to complete the connection.

Triggers a join_party call result.

Returns: void

onReservationCompleted

onReservationCompleted( uint64_t beacon_id, uint64_t steam_id )

When a user follows your beacon, Steam will reserve one of the open party slots for them, and send your game a reservation_notification callback. When that user joins your party, call onReservationCompleted to notify Steam that the user has joined successfully.

Triggers a reservation_notification callback.

Returns: void

Signals

These callbacks require you to run Steam.run_callbacks() in your _process() function to receive them.

active_beacons_updated

Notification that the list of active beacons visible to the current user has changed.

Returns: void

available_beacon_locations_updated

Notification that the list of available locations for posting a beacon has been updated.

Returns: void

change_num_open_slots

Call result for changeNumOpenSlots.

Returns:

result (int)

create_beacon

This callback is used as a call response for createBeacon. If successful, your beacon has been posted in the desired location and you may start receiving reservation_notification callbacks for users following the beacon.

Returns:

result (int)
beacon_id (uint64_t)

join_party

This callback is used as a call response for joinParty. On success, you will have reserved a slot in the beacon-owner's party, and should use connect_string to connect to their game and complete the process.

Returns:

result (int)
beacon_id (uint64_t)
steam_id (uint64_t)
connect_string (string)

reservation_notification

After creating a beacon, when a user "follows" that beacon Steam will send you this callback to know that you should be prepared for the user to join your game. When they do join, be sure to call onReservationCompleted to let Steam know.

Returns:

beacon_id (uint64_t)
steam_id (uint64_t)

Enums

SteamPartyBeaconLocationType

Enumerator	Value
STEAM_PARTY_BEACON_LOCATIONTYPE_INVALID	0
STEAM_PARTY_BEACON_LOCATIONTYPE_CHAT_GROUP	1
STEAM_PARTY_BEACON_LOCATION_TYPE_MAX

SteamPartyBeaconLocationData

Enumerator	Value
STEAM_PARTY_BEACON_LOCATION_DATA	0
STEAM_PARTY_BEACON_LOCATION_DATA_NAME	1
STEAM_PARTY_BEACON_LOCATION_DATA_URL_SMALL
STEAM_PARTY_BEACON_LOCATION_DATA_URL_MEDIUM
STEAM_PARTY_BEACON_LOCATION_DATA_URL_LARGE