| name | cave-world |
| description | Compose an arena + gate + season into one GameWorld — a whole simulation/economy that is itself a Link, so worlds nest inside worlds. Use for 'a world of agents', simulations, economies, agents that craft/compete/evolve. `GameWorld`. |
World — a whole simulation as one program
GameWorld composes the arena, the gate, and the season into one object — and it's a Link, so a world can be a player inside a bigger world (world_as_agent). Instantiate, subclass, or build from a small spec.
Native API (how you program)
from cave_teams import GameWorld, world_as_agent
w = GameWorld.from_spec({"rounds": 3, "seasons": 2, "reset_to": "board"}, agents, mutator, deity=deity)
inner = world_as_agent(w, derive_action)
mutator is a required Python callable — register_fn it and reference the name in the spec.
Via cave() (drive it from data)
{"op": "world",
"spec": {"rounds": 3, "seasons": 2, "reset_to": "board"},
"agents": {"a": <spec>}, "mutator": "my_mutator", "deity": <spec>}
If the spec is malformed, cave() returns {"status": "construction_error", "hint": "read the cave-world skill"} — the error names this skill.
See also
cave-blackboard · cave-season · cave-sim
Part of the cave-teams plugin — the language + full DSL is the cave-teams skill; drive any pattern from data with the cave skill.
