Formal Specification
Weaver's Chain — Formal Specification
Serbia · singing-circle · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: abstractedGap-fills: 3
# Kolariću Paniću — AI-optimized specification
## General idea
A cooperative topological graph transformation game where a 1D linear chain of `N` linked agents executes a deterministic sequence of arch-threading permutations to transition from an open state to a crossed-arm "braided" state, and then reverses the sequence to return to the original open state without severing any edge in the graph.
## Formal model
- **Abstraction taken:** The physical bodily twisting and singing performance are abstracted into a 1D topological graph with vertices and undirected edges . Each vertex maintains a binary state .
- **Player/agent count:** `N` cooperative agents (`N >= 4`, default `N = 6`).
- **Turn model:** Step-based synchronous or sequential progression along the chain.
## Formal rules
R1. Initialization: Graph initialized with nodes in linear order . Node 0 is Leader (`kolovođa`); Node is Anchor. All nodes initialize to . Edge connectivity parameter .
R2. Winding Sequence (Phase 1):
- For target node from down to 1:
- The chain of nodes threads through the gate formed by edge .
- [gap-fill] Node state updates to .
- Edge integrity check: Probability of maintaining grip . If edge fails, .
R3. Knot State: When all nodes have , the chain is declared fully knotted.
R4. Unwinding Sequence (Phase 2):
- For target node from 1 up to :
- The chain reverses trajectory through gate .
- Node state updates to .
R5. Win Condition: If all nodes return to and , the cooperative team achieves victory.
R6. [gap-fill] Failure Condition: If any edge breaks (), the round fails with 0 points scored.
## Edge cases
- Tie at the end condition: Not applicable; pure cooperative single-team performance.
- A player with no legal move: Not applicable; state transitions are fixed deterministic sequence steps.
- Repetition / cycles: Bounded; Phase 1 takes exactly steps; Phase 2 takes exactly steps. Maximum execution length is steps.
- Simultaneous claims on the same resource or position: Not applicable; nodes maintain fixed topological order.
- Player elimination mid-round / turn order repair: [gap-fill] If an agent disconnects, the node is pruned from graph and edges are bridged.
- Resource exhaustion: Not applicable; no consumable resources.
- Termination guarantee: Guaranteed by the strict linear iteration counter spanning total steps.
## State representation
- Persistent state: `node_states: list[enum[UNBRAIDED, BRAIDED]]`, `edge_status: bool`, `current_phase: enum[WINDING, UNWINDING]`, `current_k: int`.
- Per-step ephemeral state: `step_grip_maintained: bool`.
- Observable information: Fully observable public state.
## Action space
- `step_through_gate(node_id: int)`: Cooperative verification action per movement step.
## Playability notes
- Single-player-vs-AI: Needs adaptation; natural as a puzzle game where a single player navigates a linked chain through spatial gates.
- Group games (n>4): Operates natively with 4 to 20 agents.
- Physical-skill games: Motor flexibility and handhold strength mapped to the parameter.
- What is lost in the adaptation: The social joy, melodic singing in unison, and physical contact of traditional folk dancing are entirely replaced by graph state transitions.
## Implementation hints
Categorized as `non-simulable` / procedural graph script. Useful as an educational simulation of knot theory, topological permutations, and cooperative robotic chain maneuvering. First milestone: implement state list `[0]*N` transitioning to `[1]*N` and back to `[0]*N`.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Weaver's Chain (Serbia). (n.d.). Games of Countries. https://gamesofcountries.com/games/rs-serbia/kolaricu-panicu
@misc{gamesofcountries-rs-serbia-kolaricu-panicu,
title = {Weaver's Chain (Serbia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/rs-serbia/kolaricu-panicu}
}