GunSpec

Game Balance

Game development tools for validating game stats against real-world specifications. Identify firearms where your game balance deviates significantly from expected values.

Auth RequiredStudio+

Returns outliers and distribution warnings across the game stat set, for spotting firearms that are over- or under-tuned relative to the rest of the catalog.

GET/v1/game/balance-report

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

  • numberdefault20

    How far from the mean a stat must sit to be flagged

    Range
    0 – 100
    Example

  • object[]

    The response payload.

  • string

    Slug of the firearm this row belongs to.

  • string

    Display name of the firearm this row is about.

  • object[]

    Every stat on this firearm that sits further from the mean than threshold.

  • string

    Which statistic this row is about, named as the field is: weightEmptyG, damage.

  • number

    This firearm value for the stat.

  • number

    Arithmetic mean across the records counted.

  • number

    Standard deviation across the records counted.

  • number

    Standard deviations from the mean. Positive is above it; the sign says which way the firearm is out of line.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Requires Studio tier or higher.

Only firearms with at least one deviation exceeding the threshold are included in the response.

Expected values are derived from real-world specs (muzzle energy, weight, dimensions, etc.) normalized to a 0-100 scale within each firearm category.

A lower threshold surfaces more deviations, useful for fine-tuning. A higher threshold only flags major outliers.

Minimum tier
Studio+
Monthly quota
150,000/mo
Rate limit
120/min
Daily cap
10,000

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.