activePlayerCount

Type Event
Revision Release 2024.3703
Keywords steam, steamworks, activePlayerCount
See also steamworks.requestActivePlayerCount()
steamworks.*

Overview

Event providing the number of players that are currently playing the game globally, excluding the currently logged in user.

This event can only be received by a function callback that has been passed to the steamworks.requestActivePlayerCount() function.

Properties

event.count

event.isError

event.name

Example

local steamworks = require( "plugin.steamworks" )

-- Called by the "steamworks.requestActivePlayerCount()" function with the result
local function onReceivedActivePlayerCount( event )
    if ( event.isError ) then
        -- Request failed; typically happens when there is no Internet access
        print( "Failed to fetch number of active players." )
    else
        -- Print the number of active players to the log
        print( "Number of people playing this game: " .. tostring(event.count) )
    end
end

-- Fetch the number of players currently playing this game
-- Requires an active Internet connection to succeed
-- Will provide the requested result to the given function
steamworks.requestActivePlayerCount( onReceivedActivePlayerCount )