app.golfthesky.round

One Golf the Sky round, published by the player into their own repo. The record stores every shot rather than a score: the game's ball physics are deterministic, so re-simulating the shots reproduces the round exactly. Owning the record is the identity proof, and replaying it is the score proof — strokes and ticks in this record are advisory and never trusted by a leaderboard.

Repository @golfthesky.app did:plc:4ukvmcc7pscat4djemk4ckfl namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritygolfthesky.app
Indexed

Record

record · key tid

Properties

courseId

requiredstring

Permanent identity of the course played. Append-only: ids are never reordered, renamed, or reused.

  • maxLength: 64
  • knownValues: skyline-links

createdAt

requiredstring · datetime

field

integer

How many players were in that live round.

  • minimum: 1

holes

requiredarray
  • maxLength: 18
itemsref
Reference

mode

string

solo: against local bots. live: against other players on a synced clock — the only mode in which placing means anything.

  • knownValues: solo | live

placing

integer

Advisory finishing position in a live round, 1 = won.

  • minimum: 1

players

array

Everyone else who played this round, each with their own shot logs, so a replay of this one record shows the whole field. Bots carry a did of the form bot:N. Advisory, like placing: only the owner's own holes are theirs to prove.

  • maxLength: 7
itemsref
Reference

simVersion

requiredinteger

Which physics produced these shots. A verifier must replay under the matching version or refuse the round.

  • minimum: 1

target

integer

The pills (hole wins) the round was played to.

  • minimum: 1
  • maximum: 9

#hole

object

Properties

holeId

requiredstring

Permanent identity of the hole within the course.

  • maxLength: 64
  • knownValues: opening-drive | dogleg | sky-ramp | slick-slope | bunker-alley | island-hop | first-light | sticky-situation | ice-cave | archipelago | clockwork | mill-race | skyhook | paddle-alley | crater

shots

requiredstring

The whole hole as the only input the game takes. Comma-separated `<dtick>.<angle>.<mod>.<power>` entries: dtick is 120 Hz ticks since the previous entry, angle is milliradians counter-clockwise from +x (0–6283), mod is the ball type applied to that swing (0 none, 1 sticky, 2 super, 3 nitro, 4 air brakes, 5 sniper), power 1–100. An entry with power 0 is an event, not a swing: mod 4 is an Air Brakes tap, mod 5 a Mulligan. Power-ups cost energy; a verifier recomputes energy from the clock (starts at 4, +1 every 360 ticks, max 10; costs sticky 4, super 3, nitro 4, brakes 5, mulligan 6, sniper 6) and refuses a log that overspends. Example: `360.785.0.80,540.0.4.0`.

  • maxLength: 8000

strokes

requiredinteger

Advisory stroke count, including out-of-bounds penalties.

  • minimum: 0

ticks

integer

Advisory: the tick the ball dropped. Absent if the hole was never finished.

  • minimum: 1

#player

object

Properties

did

requiredstring

Their DID, or bot:N for a local bot.

  • maxLength: 300

handle

requiredstring

Their handle when the round was played (advisory).

  • maxLength: 100

holes

requiredarray
  • maxLength: 18
itemsref
Reference

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A hole built in the Golf the Sky designer, living in the repo of whoever built it. The geometry is a list of parts from the game's parts library (blocks, slopes, hills, free shapes, rings, ponds, greens — some of them moving) with a tee and a cup, carried as encoded JSON because the coordinates are fractional. Anyone can play it from a link; the record is where it lives.

  • A single Race the Sky time-trial run, published by the player into their own repo. The record stores the raw input log rather than a result: the game's physics are deterministic, so re-simulating the log reproduces the run exactly. Owning the record is the identity proof, and replaying it is the time proof — the claimed time in this record is advisory and is never trusted by a leaderboard.

  • One Hats Off run, published by the player into their own repo. The record stores every shot rather than a score: the sim is deterministic, so re-running the fire log against the same seed on the same level reproduces the run exactly. Owning the record is the identity proof, and replaying it is the score proof — wave, cured and the rest are advisory and never trusted by a leaderboard.