Type Function Return value Boolean Revision Release 2024.3703 Keywords steam, steamworks, leaderboard, requestLeaderboardInfo See also steamworks.requestLeaderboardEntries() steamworks.requestSetHighScore() leaderboardInfo steamworks.*
Asynchronously fetches information about one leaderboard such as its entry count, display/value type, sort order, etc.
Returns true if the request was successfully sent to Steam. Note that this does not necessarily mean that the requested operation will succeed. For example, this function will return true if there is no Internet connection. So, the listener must check the received event.isError property to determine if the requested operation succeeded.
Returns false if given invalid arguments or if the steamworks.isLoggedOn property is false.
steamworks.requestLeaderboardInfo( params )
Table. Table containing parameters — see the next section for details.
The params table can contain the following:
String. The unique name of the leaderboard to fetch information from. On the Steamworks website, this is the leaderboard string set under the Name column.
Function. Function which will receive the result of the request via a leaderboardInfo event.
local steamworks = require( "plugin.steamworks" )
local function onReceivedLeaderboardInfo( event )
if ( event.isError ) then
-- The request has failed
print( "Failed to fetch leaderboard info." )
else
-- Print the received leaderboard information to the log
print( "Leaderboard Name: " .. event.leaderboardName )
print( "Entry Count: " .. tostring(event.entryCount) )
print( "Sort Method: " .. event.sortMethod )
print( "Display Type: " .. event.displayType )
end
end
-- Fetch information about one leaderboard
-- Requires an active Internet connection to succeed
-- Provides the requested result to the given "listener" function
local requestSettings =
{
leaderboardName = "My Leaderboard Name",
listener = onReceivedLeaderboardInfo
}
steamworks.requestLeaderboardInfo( requestSettings )