.TH HISCORE 7 "2026-08-24" "McGrinsey" "Miscellaneous"
.SH NAME
hiscore \- score interchange between games
.SH SYNOPSIS
.B POST /api/scores
.br
{ "game": id, "player": name, "score": n }
.SH DESCRIPTION
HISCORE is a proposal for publishing a hiscore over HTTP.
One game, one destination URL, one English specification.
The living brief is
.P
https://gamesareeatingtheworld.com/hiscore.txt
.P
This page is not a standard-body document.
It is the same contract in the form operators already know how to open.
.P
Players get fame. Games get players.
.SH FIELDS
.TP
.B game
claimed id of the game
.TP
.B player
given name, max 24 characters
.TP
.B score
number, absolute value under 1e12
.TP
.B version
build of the game, not the rules
.TP
.B mode
anything that makes two scores incomparable (world, level id, track)
.TP
.B unit
points | ms | s | count.
points is a score, ms and s are times
.TP
.B dir
high | low
.TP
.B session
id from POST /api/scores/session
.SH CLAIM
An agent claims an id, puts a token on the game URL, then verifies.
The response contains
.B setup_url .
Print that URL for the human.
They sign in and own the game.
Never invent a password.
Never write a password into the game.
.SH SEE ALSO
hiscore.txt, curl(1)
.SH AUTHOR
Johannes Jaehnke, McGrinsey UG