v3 state

RegulationKicks

// kicks each side takes before sudden death (win by 1), or at most

DefaultWinBy

// goals a challenger must win by, unless the creator chose 1 or 3

MaxWinBy

CreatorPercent

// of the pot, paid to the game's creator when it is won

MinDeposit

// ugnot to seed a pot (1 GNOT)

MinEntryFee

// ugnot (0.1 GNOT)

DefaultTimeout

// blocks a challenger may sit idle

MinTimeout

MaxTimeout

engine

instance

Instance

Instance returns the implementation, for a caller that registers it explicitly rather than relying on init.

init.12

winBys

// game id -> int

WinBy

WinBy is how many goals a challenger must win game gameID by: as chosen at creation, or 1 for a game created before this implementation.

setWinBy

setWinBy records a new game's margin. It crosses into this realm: the engine's methods run as the shots realm, which may not write this realm's table.

takeWinBy

takeWinBy removes "winBy=N" from a config string, returning N (DefaultWinBy if absent) and the rest for penalty.ParseConfig.

checkConstants

checkConstants allows a game four small changes from the default constants, and nothing else: the chain's mixes are the equilibrium of the default game, and every change opens a gap a skilled player can use. Within these ranges a player who plays the best moves wins 11-14% of shootouts (against 11% under the defaults); outside them up to 40%, which no pot survives. The ranges, as the web client offers them: goal width goalWidth 6400..7000 mm keeper size keeperScale 1117..1235 (95..105% of 1176) keeper agility diveMin and diveMax at 90..105% of 2600 and 5200, together (diveMax = 2 x diveMin) shot speed ballMaxSpeed 34000..37400 mm/s (100..110%) It returns why cfg is refused, or "".

decided

decided says whether a shootout is over, and who won it. Win by 1 is a normal shootout (penalty.Shootout's rules, sudden death included). For a larger margin it is SidePlayer once the player is sure to finish winBy goals ahead after RegulationKicks each, SideChain once they no longer can, and 0 while it is open.

settled

settled is an ended session as it stays on chain: everything but its kicks (see SETTLING).

entropy

entropy is the kick's 32-byte seed: SHA-256 of the block time and the kick's identity (see the package comment for what that does and does not guarantee).

mustGame

session

session reads the live session of a game as this realm's own copy.

ownGame

ownGame and ownSession rebuild values read through shots.Store in this realm. What Store hands back was allocated by the shots realm, and the VM refuses writes to another realm's objects (a pointer-method update such as Shootout.Record trips its cross-realm check), so the engine only ever mutates copies it built itself; PutGame/PutSession copy them back.

ownSession

mustPlayersSession

itoa

u64

chainPlan

chainPlan is a keeper plan of the chain's mix: cum is the cumulative weight out of 65536 (the seed's first two bytes pick the first entry above them), the rest the plan's four uint16 under the default constants.

chainKick

chainKick is a kick of the chain's mix, in the realm's units for the default goal: aim mm, contact milli-radii, power per-mille.

chainKeeper

The equilibrium mixes for the default constants (a double-oracle solution of the shooter-keeper game on the physics engine; the value is a 78.5% conversion rate). Plans: a third wait and read the shot; the rest dive fast across the goal, mid-height or low. Kicks: low and hard 2.2 m out, top corners, high down the middle.

chainKicks

pick

pick is the index of the first entry whose cumulative weight is above u.

seedU16

keeperFor

keeperFor is the chain's keeper plan for a kick. Under constants with other mode bands (StarShare, ReadShare) a plan keeps its mode: a read stays a read, and a dive keeps its place within the dive band.

kickFor

kickFor is the chain's kick, its aim scaled to the game's goal and its contact kept inside the game's selectable disc.

isqrt