Skip to main content
Formal Specification

Hoop Games — Formal Specification

New Zealand · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: discretizedGap-fills: 4
# Pīrori — AI-optimized specification ## General idea Two unrelated games under one name. The hoop game is a two-team rally driving a rolling hoop back and forth with sticks; the flax-toy contest is an attrition duel between two spinning objects that ends when one breaks. Only the second has an attested end condition. ## Formal model - **Abstraction taken:** the hoop becomes a position and a velocity on a line between two teams; a stick strike reverses and re-energises it, with success probabilistic. For the flax toy, each spin-collision applies wear, and breakage is a threshold event. - **Player/agent count:** two teams for the hoop; two individuals for the toy duel. - **Turn model:** the hoop game is ticked; the toy duel resolves as repeated collisions. ## Formal rules R1. **Hoop game.** Two teams face each other, every player holding a stick. R2. The hoop travels toward one team; a player of that team may `strike()` to drive it back. R3. A strike succeeds with probability `p(skill, hoop_speed)`; on failure the hoop passes the team's line. [gap-fill] No accuracy model is given. R4. [gap-fill] A hoop passing a team's line scores one point to the other team, and play restarts. Te Ara records the activity but no scoring at all, so this is added purely to give the game an outcome. R5. [gap-fill] The game is played to an agreed target. No target is attested. R6. **Flax-toy duel.** Two players each set a rolled-flax pīrori spinning by its threaded strings. R7. The two spinning toys are brought into contact repeatedly; each contact applies wear to both, with a probability of breaking that rises with accumulated wear. R8. The duel ends when one pīrori breaks; its owner loses. This end condition **is** attested. R9. [gap-fill] Simultaneous breakage is possible and is scored a draw. ## Edge cases - **Tie at the end condition:** in the toy duel, R9 covers simultaneous breakage. In the hoop game a tie is possible only because R5's target is invented; with no attested scoring there is nothing to tie. - **Player with no legal move:** a hoop-game player out of position may not reach the hoop; another teammate may strike, and if none can, R4 resolves it as a concession. Neither toy-duel player is ever without an action while their pīrori is intact. - **Repetition / cycles:** the hoop rally can continue indefinitely. R4 bounds an individual rally; only R5's invented target bounds the game. The toy duel cannot cycle, since wear is monotonically increasing. - **Simultaneous claims:** two teammates striking the same hoop resolve to the nearer player; the strike is applied once, not twice. - **Mid-round elimination and turn-order repair:** neither game eliminates players. The toy duel eliminates an *object*, which ends the game outright. - **Resource exhaustion:** in the toy duel, structural integrity is the consumable and its exhaustion is the win condition — an unusually literal case. - **Termination guarantee:** the toy duel terminates with probability 1, because wear increases monotonically and breakage probability rises with it. The hoop game does **not** terminate on attested rules alone. ## State representation Persistent: for the hoop game, the two team lines and the distance between them; for the duel, the wear threshold. Per-player: stick reach, skill; for the duel, pīrori wear accumulated. Per-turn ephemeral: hoop position and velocity; or the collision being resolved. Information set: fully observable in both games. ## Action space - `strike()` — precondition: hoop-game player is within reach of the hoop. - `spin_up()` — precondition: toy duel, at the start of a round. - `engage()` — precondition: both pīrori are spinning and intact. ## Playability notes - **Single-player-vs-AI:** the hoop game works as a team-versus-team problem with simple positioning. The toy duel has essentially no decision — once both are spinning, the outcome is a race between two wear processes. - **Group games (n>2):** the hoop game reduces to 1v1 and keeps its structure. The duel is 2 by construction. - **Physical-skill model:** strike success as a function of hoop speed; and, for the duel, a wear-per-collision parameter reflecting how well the toy was made. - **What is lost:** that these are two different games sharing a name. A reader taking `pīrori` as one entity will build a confused model — and note that `potaka` is a third name for the hoop, colliding with the spinning-top entry. The naming here is genuinely ambiguous in the source and should not be tidied away. ## Implementation hints Implement the two games separately; they share nothing but a word. The toy duel is the better first milestone because it has a real, attested end condition — build the wear model and confirm it terminates. For the hoop game, be aware that four of its rules are gap-fills, and strip them to see that the attested game is only "two teams beat a hoop back and forth with sticks".

Download as JSON

Download the full game corpus entry for this game as structured JSON.

Download JSON
Cite this page

Hoop Games (New Zealand). (n.d.). Games of Countries. https://gamesofcountries.com/games/nz-new-zealand/pirori

@misc{gamesofcountries-nz-new-zealand-pirori,
  title = {Hoop Games (New Zealand)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/nz-new-zealand/pirori}
}