Skip to main content

PlayerComputeUsage

The caller's player-compute spend and quota view for one app (P2): unit usage in the current clock hour/day, the effective policy limits, compile-quota utilization, and the replica-synced wallet/spend-cap gate state. Units follow the platform formula GREATEST(cpu ms, fuel/22M); player automation units are included.

type PlayerComputeUsage {
  appId: BigInt!
  hourUnitsUsed: BigInt!
  dayUnitsUsed: BigInt!
  unitsPerHour: BigInt
  unitsPerDay: BigInt
  compilesThisHour: Int!
  maxCompilesPerHour: Int!
  gateStatus: String!
  gateReason: String
}

Fields

`PlayerComputeUsage.appId` ● `BigInt!` non-null scalar

The app this view covers.

`PlayerComputeUsage.hourUnitsUsed` ● `BigInt!` non-null scalar

Compute units consumed in the current clock hour (modules + automations, all owned grids aggregated).

`PlayerComputeUsage.dayUnitsUsed` ● `BigInt!` non-null scalar

Compute units consumed in the current clock day.

`PlayerComputeUsage.unitsPerHour` ● `BigInt` scalar

Effective units_per_hour developer-policy cap; null when the app sets no hourly quota.

`PlayerComputeUsage.unitsPerDay` ● `BigInt` scalar

Effective units_per_day developer-policy cap; null when the app sets no daily quota.

`PlayerComputeUsage.compilesThisHour` ● `Int!` non-null scalar

Compile submissions counted in the current clock hour.

`PlayerComputeUsage.maxCompilesPerHour` ● `Int!` non-null scalar

Effective max_compiles_per_hour policy cap.

`PlayerComputeUsage.gateStatus` ● `String!` non-null scalar

Replica-synced management player gate for this app: 'active', 'grace', or 'denied'. Non-active pauses this player's modules only; play is untouched.

`PlayerComputeUsage.gateReason` ● `String` scalar

Typed pause reason when gated: PLAYER_WALLET_EMPTY, PLAYER_SPEND_CAP, PLAYER_QUOTA_EXHAUSTED, or PLAYER_COMPUTE_KILLED.

Returned By

playerComputeUsage query

Fields
Returned By