Skip to main content
Computational Ludology

AI Formal Specifications Hub

Documented games in this catalog are paired with a companion formal specification (.ai.md) defining its state space, action grammar, stochastic transitions, and termination guarantees.

2028 formal models1108 engine-ready41 zero gap-fills

Engine Suitability Classifications

Formal Modeling Methodology & Conventions

4 Mathematical Fidelity Classes

  • direct: 1:1 mathematical isomorphism where rules map directly to finite state automata.
  • discretized: Continuous physical pitches or bounds mapped to 2D coordinate lattices.
  • probabilistic-proxy: Motor skills (throwing accuracy, physical agility) modeled via stochastic Bernoulli/Gaussian distributions.
  • abstracted: Complex social roleplay or oral catechisms abstracted to qualitative signaling models.

The [gap-fill] Marker

Traditional folk games were transmitted orally across generations and often have uncodified tie-breakers, boundaries, or turn order conventions.

When mathematical simulation requires an unambiguous transition that primary folklore sources omitted, we supply the minimum necessary closure and strictly mark it as [gap-fill]. Implementers always know exactly which lines come from the corpus and which are engineering closures.

Open JSON Datasets

Every game in the corpus is available as structured JSON for AI researchers, game simulators, and developers. All datasets are free to use — see licence for terms. The corpus currently holds 2,028 games with 20% high-confidence sourcing — inspect the full breakdown on the coverage dashboard.

API Reference

Minimal dataset — fastest download:

curl https://gamesofcountries.com/api/dataset?format=minimal

Filter by country (ISO 2-letter code):

curl https://gamesofcountries.com/api/dataset?country=gh

Per-country shorthand endpoint:

curl https://gamesofcountries.com/api/dataset/gh

Aggregate statistics:

curl https://gamesofcountries.com/api/dataset/stats