Formal Specification
Shinny — Formal Specification
Usa · stick-team · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: discretizedGap-fills: 5
# Shinny — AI-optimized specification
## General idea
A traditional team field hockey game featuring curved wooden sticks. It is discretized into a positional grid-iron team simulation where possession, passing lanes, and physical challenges are resolved via state transitions.
## Formal model
- **Abstraction taken:** The continuous open-field play is discretized into a 2D grid of size cells. Physical movement is turn-based/ticked. Players move to adjacent cells and pass the ball across grid vectors.
- **Player/agent count:** 2 teams, 5 agents each (reduced from large traditional teams for simulability).
- **Turn model:** Simultaneous-action execution. Each tick, all agents submit actions (Move, Pass, Shoot, Tackle), which are resolved in order.
## Formal rules
R1. The playing space is a grid of cells. The goals are centered on columns (Team B's goal) and (Team A's goal), spanning rows 3 to 5.
R2. The ball occupies a single cell and can be possessed by an agent in the same cell.
R3. Legal actions for an agent without the ball:
- `Move(dx, dy)`: Move 1 cell in any of the 8 cardinal/diagonal directions (precondition: destination is within grid and not blocked by teammate).
- `Tackle(target_agent)`: Attempt to steal the ball from an adjacent opponent.
R4. Legal actions for an agent with the ball:
- `Dribble(dx, dy)`: Move 1 cell carrying the ball.
- `Pass(target_agent_id)`: Propel the ball along a straight vector to a teammate.
- `Shoot()`: Propel the ball toward the opponent's goal.
R5. Resolution order per tick:
- Passes and Shots are resolved first.
- Moves and Dribbles are resolved second.
- Tackles are resolved last.
R6. [gap-fill] Tackles are resolved stochastically: , bounded in .
R7. [gap-fill] Foot-blocking: An agent can use a passive foot-block action to intercept a pass path vector, which has a flat 30% interception success rate.
R8. [gap-fill] Scoring: A shot entering the goal cells scores 1 point. After a goal, the game resets with the ball in the center.
R9. [gap-fill] Match terminates after 100 total ticks. The team with the highest score wins.
## Edge cases
- **Tie at the end condition:** [gap-fill] Tied score at tick 100 triggers a 20-tick sudden-death overtime round.
- **A player with no legal move:** If trapped or surrounded, the agent must pass or tackle.
- **Repetition / cycles:** Possible if teams repeatedly tackle and lose ball. Bounded by maximum ticks (100).
- **Simultaneous claims on the same resource or position:** If two agents move to the same unoccupied cell, the agent with higher dexterity wins the cell; the other remains in their original cell.
- **Player elimination mid-round; turn order repair:** Not applicable.
- **Resource exhaustion (pieces, tokens, space, time):** Not applicable.
- **Termination guarantee:** Guaranteed to terminate strictly at tick 100 (or at the end of overtime).
## State representation
- **Persistent state:**
```json
{
"score": [0, 0],
"tick_counter": 0,
"ball_position": [x, y],
"ball_carrier_id": int_or_null
}
```
- **Player state:** Array of 10 agents, each with: `{"id": int, "team": 0_or_1, "coords": [x, y], "strength": int, "dexterity": int}`
- **Ephemeral state:** Action buffer of 10 submitted actions.
## Action space
- `move(dx, dy)`
- `pass(agent_id)`
- `shoot()`
- `tackle(agent_id)`
- `foot_block()`
## Playability notes
- Single-player-vs-AI: Natural fit for standard cooperative multi-agent pathfinding and tactical reinforcement learning.
- Group games: Easily mapped to a 5v5 cooperative multi-player match.
- Physical-skill games: Passes and shots use vector ray-casting with a success probability dependent on distance.
## Implementation hints
Suggested first milestone: implement the grid representation and simultaneous movement collision resolution, followed by ball possession transfer logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Shinny (Usa). (n.d.). Games of Countries. https://gamesofcountries.com/games/us-usa/shinny
@misc{gamesofcountries-us-usa-shinny,
title = {Shinny (Usa)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/us-usa/shinny}
}