Exports and Events

---

Integrations Guide

This resource exposes several server exports to help other scripts interact with the scoreboard and activity cooldown system.

Use them by calling exports['cornerstone_scoreboard']:ExportName(args...) from your own resource.

SetActivityBusy(activity, busy, playerId)

Sets whether an activity is currently busy. When busy is true and a playerId is provided, global and personal cooldowns start automatically.

exports['cornerstone_scoreboard']:SetActivityBusy('bankrobbery', true, source)

StartActivityCooldowns(activity, playerId)

Manually begins cooldowns for the given activity. Call this if your resource triggers the activity without using SetActivityBusy.

exports['cornerstone_scoreboard']:StartActivityCooldowns('storerobbery', source)

IsActivityAvailable(activity, playerId)

Returns true if the activity is not busy and neither global nor personal cooldowns prevent the player from starting it.

if exports['cornerstone_scoreboard']:IsActivityAvailable('oilrig', source) then
  -- let the player begin the job
end

GetActivityCooldownInfo(activity, playerId)

Provides a table describing the cooldown state for the activity and player.

local info = exports['cornerstone_scoreboard']:GetActivityCooldownInfo('pacific', source)
-- info = {
--   globalActive = boolean,
--   personalActive = boolean,
--   globalRemaining = '1m 30s',
--   personalRemaining = 'Ready'
-- }

IsGlobalCooldownActive(activity)

Checks if a global cooldown is running for the given activity.

local busy = exports['cornerstone_scoreboard']:IsGlobalCooldownActive('jewellery')

IsPersonalCooldownActive(playerId, activity)

Checks if the specified player has a personal cooldown for the activity.

if exports['cornerstone_scoreboard']:IsPersonalCooldownActive(source, 'boosting') then
  -- tell the player to wait
end

GetCurrentJobCounts()

Returns a table of job categories with their current counts.

local counts = exports['cornerstone_scoreboard']:GetCurrentJobCounts()
for k, data in pairs(counts) do
  print(k, data.count)
end