Skip to content

Map Course Tiers

GOKZ.TOP now stores v1 map tiers in map_course_tier instead of reading them from record_filter.

Model

  • Each exact course has one tier per mode.
  • TP and PRO no longer carry separate tiers.
  • record_filter rows only say whether a TP or PRO record is available for a course and mode.
  • Tier values are integers in the 0 to 8 range.
  • 0 is the shared fallback for unavailable, impossible, or unknown.

Admin Workflow

  • Open Admin -> Maps.
  • Expand a map row to see two panels.
  • Use Course tiers to edit the shared stage and mode tier matrix.
  • Use Availability rows to inspect exact 128-tick TP and PRO record filters separately.

Sync Rules

  • The one-time migration backfills map_course_tier from exact non-wildcard 128-tick record filters.
  • If legacy TP and PRO tiers disagree for the same course and mode, the backfill keeps the minimum positive tier. If neither side has a positive tier, it stores 0.
  • After backfill, non-VNL tiers are local/admin-managed.
  • VNL tiers continue syncing from the vanilla tier sheet.
  • GlobalAPI record-filter sync keeps mirroring availability rows, but it does not derive or overwrite non-VNL course tiers.

API Notes

  • v1 tier-bearing responses now return integer tiers only.
  • Missing course tiers and explicit 0 tiers both read back as 0.
  • /v0 compatibility payloads are unchanged.