PlayerSpendCap

A player's self-set spend cap (06 §2a): a daily/monthly ceiling globally or per app. The effective runtime limit is min(developer policy, self-cap, wallet balance); hitting a cap pauses that player's mods with PLAYER_SPEND_CAP, never their play.

type PlayerSpendCap {
  userId: BigInt!
  scope: String!
  scopeRef: BigInt
  dailyLimitCents: BigInt
  monthlyLimitCents: BigInt
  currentDayUsageCents: BigInt!
  currentMonthUsageCents: BigInt!
}

Fields

PlayerSpendCap.userId ● BigInt! non-null scalar

The owning player user id.

PlayerSpendCap.scope ● String! non-null scalar

Cap scope: 'global' or 'app'.

PlayerSpendCap.scopeRef ● BigInt scalar

The app id for app scope; null for global.

PlayerSpendCap.dailyLimitCents ● BigInt scalar

Daily ceiling in cents; null = no daily cap.

PlayerSpendCap.monthlyLimitCents ● BigInt scalar

Calendar-month ceiling in cents; null = no monthly cap.

PlayerSpendCap.currentDayUsageCents ● BigInt! non-null scalar

Spend counted against the daily cap so far today.

PlayerSpendCap.currentMonthUsageCents ● BigInt! non-null scalar

Spend counted against the monthly cap so far this month.

Returned By

playerSpendCaps query ● setPlayerSpendCap mutation