ludic/packages/ludic.fire/README.md
Orkuncakilkaya 0af0ef681f ludic.fire: a camp fire's fuel, lit and out, the rain on it, and its reach
Minutes of fuel that burn down in game time, twice as fast in the rain with
nothing over the ring, and the hours it held under cover. Lighting and feeding
are decided (fire_decide), costed in wood (fire_cost) and applied
(fire_apply) apart, so a machine that does not own the world can ask the one
that does. Warmth and cooking by distance are queries. FIRE_LIT,
FIRE_WENT_OUT and FIRE_LOW_FUEL are facts; the rain, the tarp, the ban and
who owns the world come through the FireWorld port. Its own save section.
Uses ludic_base only; 8 tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 06:08:53 +03:00

2.4 KiB

ludic.fire

A camp fire: minutes of fuel that burn down in game time, twice as fast in the rain with nothing over the ring, the hours it held under cover, the warmth it gives at a distance and whether it will cook. Uses ludic.base and nothing else.

import "ludic.fire"

The package never draws the fire, never says a line and never touches a pack: lighting and feeding are three steps so a machine that does not own the world can ask the one that does - fire_decide(wood) says what it would come to, fire_cost(how) what it costs in wood, and fire_apply(how) does it (only on the owner). The game takes the wood and says the line.

The port

export port FireWorld {            # every member has a default, so any may be left out
  owns_world: fn() -> bool         # does this machine burn it? (unbound: yes)
  is_wet: fn() -> bool             # rain or snow is falling on the ring (unbound: no)
  sheltered: fn() -> bool          # something is over the ring (unbound: no)
  allowed: fn() -> bool            # no fire ban (unbound: yes)
}

API

fire_config(light_wood, light_minutes, log_minutes, low_minutes), fire_config_reach(warm, cook) the numbers (3 logs, 120 minutes, 60 a log, low under 15; warms within 3.6 m, cooks within 3.5 m)
fire_decide(wood) -> int, fire_cost(how) -> int, fire_apply(how), fire_light_wood() FIRE_NO_WOOD, FIRE_NO_LOG, FIRE_BANNED, FIRE_SOAKED, FIRE_LIGHT, FIRE_FEED
fire_lit(), fire_fuel(), fire_low(), fire_rain_hours() the fire (fuel in game minutes)
fire_warms(dist), fire_cooks(dist) lit, and a body that close is warmed / can cook on it
fire_run(gh) gh game hours of burning (the system's tick)
fire_out(), fire_set_burning(fuel), fire_set_rain_hours(h) quietly out, or burning, or the rain hours outright (the night, staging, tests)
fire_told(lit, fuel, say) what the owner says the fire is; going out is a fact when say
fire_morning(), fire_reset() the rain hours start again; a new trip
fire_facts() -> Queue<FireFact> { what, fuel }: FIRE_LIT, FIRE_WENT_OUT, FIRE_LOW_FUEL
fire_system() -> System "fire", PH_SIMULATE: reset, tick, and its save section (fire_save, fire_load: lit, fuel, the rain hours)

Tests

ludic test packages/ludic.fire