Files
aevolution/Cellular_Region_Changes.md
dingoandClaude Opus 5.5 34f544942f docs: cellular region and movement redesign with ADR-0177 and implementation plan
Records the maintainer's region decisions: regions linked to a world area rather
than a voxel, currents and a world-derived thermal map as conditions rather than
stock, capped regions, fresh-life region choice, scaled emergence and a protected
logout anchor. ADR-0098, 0172 and 0173 note the amendments. Adds the movement
draft decisions (fixed-point motion state, player-dropped 007 anchor) and the
phased implementation plan with a Git tuning file and bubble merging.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 16:13:20 -04:00

661 lines
46 KiB
Markdown

# Cellular region changes
Status: discussion draft, 2026-10-21. Companion to
[Cellular_mutation_draft.md](Cellular_mutation_draft.md) and
[Cellular_movement_draft.md](Cellular_movement_draft.md). This document proposes
region changes needed for liquid movement, circulating food, and meaningful
thermal adaptations. It changes no runtime rules, public APIs, schema versions,
live worlds, or milestone status. No commit, push, or deployment is authorized
while the maintainer reviews these drafts.
## Purpose and scope
Make the early cellular habitat a readable, interactive liquid environment.
Regions should support useful travel, feeding routes, reproduction, and early
colonies rather than rewarding long periods of waiting on a pool.
The discussion establishes the following design direction:
- Cells propel themselves through liquid; food and cells also respond to flow.
- Quiet areas and stronger currents coexist. Main currents can circulate around
a region instead of carrying everything into one boundary.
- Generate each region procedurally with 2-n currents, each with its own direction
and speed. Currents can intersect; the maximum count and speed ranges need trials.
- Movement needs acceleration, passive deceleration, active braking, and turning.
- Generate a regional thermal map. The cell has its own temperature, and the UI
provides a compass, temperature gauge, and heat-map-style environmental colors.
- Thermal mismatch increases survival E use exponentially; cells can acclimate or
evolve cold, heat, and overall thermal adaptations. Extreme freezing/boiling
exposure can cause immediate death. Current cell temperature, preferred cell
temperature, and environmental temperature all contribute; the equation and
numeric thresholds remain open for balancing.
- Passing cells disturb nearby food bubbles in their direction of travel, with
distance falloff and decay of the induced drift.
- Ordinary active founders should be able to fund their first birth in about
three minutes. The intended solitary-cell stage is roughly 30-60 minutes,
without making a multicellular transition mandatory for every strategy.
Specific field layouts, temperatures, response curves, costs, representations,
phase ordering, and implementation stages below remain **proposals**. This is a
gameplay model to tune for useful choices, not a requirement for full fluid or
biochemical simulation. Presentation can be expressive without expanding the
authoritative simulation beyond what gameplay needs.
The scope is cellular 2D habitat behavior and its environmental ownership. No
macroscopic renderer, shared 2D/3D collision model, automatic World0 upgrade,
prebuilt wildlife, or new third-party dependency is introduced.
### Maintainer responses to the original ten questions
Recorded from the region review on 2026-10-21. These establish draft gameplay
direction, not runtime admission or a replacement for existing architecture.
| Original question | Recorded direction | Remaining scope |
| --- | --- | --- |
| 1. Motion/current values | Trial and error; include currents of different speeds. | Tune founder handling and current ranges in playtests. |
| 2. Current generation | Procedural regions with 2-n currents; determine direction per current; intersections allowed. | Bounded count, generation, intersection composition, and representation. |
| 3. Boundaries/contact | N/A for this gameplay discussion. | Retain technical ownership/contact constraints; do not reopen as a required player-facing feature. |
| 4. Thermal model/UI | Procedural thermal map; compass and temperature gauge; cells have an actual temperature and a preferred temperature. | Field accounting/response and readable presentation of all three temperatures. |
| 5. Thermal effects | Current cell, preferred cell, and environmental temperatures all matter. Drastic changes require more E; mismatch from preference keeps costs elevated after adjustment. Mutations modify cold, heat, or overall handling; extreme exposure can kill immediately. | Balance the combined exponential response, acclimation rates, protection costs, and death thresholds. |
| 6. Flow and speed | With the flow is faster; against it is slower; outside flow is baseline. | Relative-vector behavior, braking/reversing controls, and numeric tuning. |
| 7. Visible cues | Cellular mechanics have visual cues; terrain resembles a thermal heat map. | Readable palette, compass/gauge details, and local perception integration. |
| 8. Offline/lifecycle | Logout takes effect after a delay, then the cell is anchored, protected from engulfment, and frozen. See the follow-up decisions below. | Delay duration and resume behavior. |
| 9. Colony roles | Requires playtesting. | Viable support roles and whether distinct propulsion adaptations add value. |
| 10. Unattended feeding | Lower priority; expected to be slower and risky because other cells can engulf the player. | Verify in playtests; no separate anti-AFK layer proposed. |
### Maintainer follow-up decisions
Recorded 2026-10-21 and documented as accepted direction in
[ADR-0177](docs/adr/0177-cellular-regions-world-linkage.md), which amends
ADR-0172 and ADR-0173 for new cellular rules.
| Topic | Decision | Still open |
| --- | --- | --- |
| Current energy | Currents are a fixed environmental condition. No mechanical energy accounting; drifting never credits usable E. | None for playtests. |
| Thermal backing | A static maintained thermal map, not owned thermal energy. | Owned thermal energy only if gameplay later needs changing temperatures. |
| Versions and worlds | New rules start in new, disposable DEV worlds; no migration of existing DEV worlds. | None. |
| Habitat size and world link | A region is linked to an area of its world, not to one voxel. Its thermal map is that area's world thermal map scaled down. | Mapping scale and region dimensions. |
| Region capacity | Regions do not grow. Each has a hard organism cap; the world adds regions. Births are refused at the cap. Engulfment and death reopen slots. Operators can cull wildlife through an admin interface when a capped region has had no players for extended days. | Cap value; equation for adding a region to the world versus attaching it to a new world. |
| Region choice | A fresh cell is offered a choice of region when it begins. | Selection presentation. |
| Emergence exchange | Matter that emerges is lost to the cellular region (a recorded export). The organism enters the world scaled to world values. | Conversion scale, after regions per world and matter per region are known. |
| Emergence target | Rank several candidates in the region's mapped world area closest to the preferred temperature with needed nutrients; choose one at random. Finite resources self-penalize crowding. | Candidate count and ranking weights. |
| Group emergence | The emerging organism chooses individual or bulk. Bulk joins a selection queue; organisms emerging together with the same or close biology share one target pick. | Queue timing and similarity threshold. |
| Logout | A logout delay keeps the cell in play and vulnerable; logging out while about to be engulfed does not save it. Afterwards the cell is anchored, cannot be engulfed, is not moved by flow, and its metabolism and thermal response stop. | Delay duration. |
## Existing architecture and the changes needed
Read this proposal against:
- [Project vision](docs/PROJECT_VISION.md).
- [World architecture](docs/architecture/WORLD_ARCHITECTURE.md).
- [Environmental units and compartments](docs/world/ENVIRONMENTAL_UNITS.md).
- [Existing optional environmental fields](docs/world/ENVIRONMENTAL_FIELDS.md).
- [Energy and matter accounting](docs/biology/ENERGY_MODEL.md).
- [Bounded cellular motion trial](docs/adr/0102-cellular-spatial-trial.md).
- [Open energy, food bubbles, and pools proposal](docs/adr/0136-open-energy-and-scattered-nutrients.md).
- [Cellular environmental ownership](docs/adr/0172-cellular-environment-ownership.md).
- [Joint environmental batch](docs/adr/0173-cellular-environment-batch.md).
- [Local environmental scheduling](docs/architecture/ENVIRONMENTAL_SCHEDULING.md).
- [Photosynthesis producers](docs/adr/0175-photosynthesis-producers.md).
| Existing boundary | Required extension or decision |
| --- | --- |
| The spatial trial resolves phenotype-limited movement intentions and contact. | Add explicit velocity/response semantics for propulsion, turning, slowing, currents, and anchoring. Do not reinterpret old movement records. |
| The cellular environment owns tagged water, dissolved nutrients, and nested organic inventories. | Add currents and the thermal map as seeded environmental conditions under the same spatial authority. They are not stock and not a second resource store. |
| Waste heat and radiative export have accounting meanings. | Keep them unchanged. The thermal map is a maintained condition derived from the world, not accumulated waste heat. Specify the biological response. |
| The habitat sits inside one environmental voxel (ADR-0172). | Link the region to a world area instead, with a hard organism cap (ADR-0177). |
| Optional M6 fields and processes are scoped experiments. | Their existence does not automatically provide live cellular flow, temperature, feeding conversions, or damage. |
| Existing environmental intervals have explicit tick and replay boundaries. | Any new coupled process needs its own documented ordering, bounds, persistence, and restored continuation. |
| Presentation consumes immutable environmental/biological views. | Publish readable flow and temperature information without moving simulation authority into the client. |
These are design gaps to resolve before implementation, not permission to silently
extend an accepted ADR. New motion, thermal, and durability behavior need scoped
decisions and explicit versions. New rules start in new DEV worlds; existing DEV
worlds are disposable and are not migrated.
## Region layout and geometry
Keep the distinction between a logical region, its cellular habitat, environmental
field resolution, and any underlying world voxel/chunk. A current does not need
to follow server partitions, and a visual river-like path is not a new ownership
boundary or a solid corridor.
The habitat remains a bounded 2D area with a declared effective depth. Changing its
area, depth, or sampling resolution does not create water, nutrients, energy, or
extra organisms. Under ADR-0177 the habitat is no longer tied to one world voxel:
it is linked to an area of its world and can be as large as currents, quiet
pockets, and eddies need. Its size grows only by design, not with population; a
hard organism cap bounds each region and the world adds regions instead.
Proposed features within one habitat:
| Feature | Gameplay purpose | Design constraint |
| --- | --- | --- |
| Quiet pockets | Learn steering, collect initial food, and reproduce. | Still provide useful exits and resources; do not become the universally best AFK location. |
| Main circulating route | Carry food and provide a recognizable travel route. | Allow crossing/exiting; avoid a forced one-way ride. |
| Rejoining branches | Offer shortcuts, interception routes, and different risks. | Communicate where routes lead within perception limits. |
| Local eddies | Create recurring encounters and food gathering areas. | Do not trap all food permanently or manufacture replenishment. |
| Anchoring | Support anchored and stationary colony strategies. | The 007 anchor is player-triggered and holds where it hits; no prepared surface is needed. |
| Thermal gradients | Make habitat choice and thermal specialization useful. | Readable transitions and reachable alternatives; no hidden lethal line at a field boundary. |
Do not make every quiet area cold, every fast current hot, or every rich food site
hazardous. Independent combinations allow several viable strategies. Reproduction
needs enough physical space for resulting organisms, including when the parent
and offspring are being carried by a current.
## Flows
### Local velocity and circulation
Define local flow as a velocity vector sampled at an authoritative position and
tick, in the same spatial frame and compatible units as cell movement. Distinguish:
`world velocity = local liquid velocity + swimming velocity relative to liquid`
This decomposition does not mean adding current repeatedly as unlimited swimming
acceleration. Coupling to changing flow, response time, sampling, interpolation,
rounding, and motion limits need a defined model. Ordinary cells and loose bubbles
already drift; a mutation must add something beyond that baseline to be useful.
Generate 2-n current routes/areas per region from explicit procedural configuration
and seed, with an individually determined direction and speed for each. Evaluate
several speeds through trial and error rather than selecting one universal current
speed. The maximum n, route width, speed distribution, and quiet-area coverage remain
tunable and bounded before implementation. Seeded generation does not grant infinite
water, nutrients, or energy.
Currents may intersect. Cells and food must experience one consistent resulting
local flow at an intersection, not whichever current happens to be processed last.
Vector composition with bounded magnitudes is a candidate, not a selected rule;
opposing cancellation, crossing deflection, and limit handling need trials.
Use the same field/sample semantics for affected objects, subject to their explicit
response and attachment rules.
A bounded seeded velocity field is a possible representation; full computational
fluid dynamics is not required. Keep transitions readable and compatible with
boundaries. A static field means unchanging flow directions/strengths, not stationary
water. Whether currents later vary over time remains open and must preserve replay.
Main routes can loop inside the habitat, with slow pockets and rejoining branches.
This is a proposed initial layout, not a requirement that every future region be
hydrologically closed. There is no edge wrap or teleport returning a bubble to
the opposite side. Avoid outward flow that is merely clamped at a wall, producing
an artificial pile of every cell and food item.
At solid boundaries, the chosen flow/motion representation needs consistent
nonpenetration and no unintended stock loss. Future open boundaries need actual
handoff of organisms and material, not despawn-at-source/spawn-at-destination.
Cross-region flow belongs to a later explicitly qualified ownership contract.
### Propulsion and slowing
At the same supported propulsion output and body state, travelling with the current
increases progress through the region; travelling against it reduces progress.
Outside a current, ambient flow is zero and ordinary swimming is at the cell's
baseline for those conditions. Acceleration/braking transients still apply. Cross-flow
deflects world movement according to the eventual vector model; this is not a
universal scalar speed bonus. A sufficiently strong opposing current can prevent
upstream progress without reducing the cell's swimming capacity relative to water.
Do not separately add a matching speed buff/debuff after applying flow. Equal
output may have the same propulsion E/time while the time and E needed to reach a
fixed world destination differ. Station keeping still requires funded opposing work.
| Action/state | Required behavior | Cost meaning |
| --- | --- | --- |
| Propelling | Accelerate relative to liquid within available output and steering limits. | Fund applied output; do not charge maximum propulsion at every nonzero speed. |
| Releasing propulsion | Lose relative swimming speed through passive resistance while continuing to drift. | No active propulsion expenditure; dissipation is not usable cellular energy. |
| Active braking/reversing | Use opposing propulsion to slow or reverse faster. | Pay for actual opposing output. |
| Station keeping | Swim against flow to hold a position in the region. | Continuous funded work, not the default meaning of no input. |
| Anchored (007) | The player drops the anchor; the cell holds at the point it hits. | Construction, drop/release, load, and holding-capacity rules must be explicit. |
| Attached colony | Combine useful propulsion with total arrangement load/resistance. | No automatic speed multiplier from member count; no duplicate charge for shared work. |
Use the [movement draft's](Cellular_movement_draft.md) calculated profile:
propulsion and steering machinery, body shape, mass, and resistance produce speed, acceleration, passive
slowing, active braking, turning, and operating cost. Founder reference displays
can read 100% under fixed reference conditions; actual values still need tuning.
Zero/absent capabilities are not 100%, and account age confers no movement bonus.
Exact control behavior remains open: automatic versus deliberate braking,
reverse-thrust controls, how heading changes at different speeds, and how an
energy-starved cell passively drifts. Start with responsive founder handling;
extended uncontrollable coasting should not be required to learn the game.
### Environmental driving and energy
Decided: currents are a fixed environmental condition, like incident light. They
are not stock and carry no mechanical energy accounting; no driving source,
entitlement, or work/dissipation ledger is needed. Forces against an anchor or
attached body are likewise mechanical rules, not energy transfers.
Drifting never credits a cell's usable E reserve, and no process harvests flow
energy. Propulsion expenditure still transfers reserve E to heat as today.
## Food and material transport
| Material/object | Proposed behavior | Accounting requirement |
| --- | --- | --- |
| Loose nutrient/energy bubbles | Move with local flow under a stated response model; retain identity and finite stock. | Movement changes position, not amount or channel. |
| Finite resource pools | Can remain fixed where explicitly declared. | No replenishment from an animation or passing current; any resupply needs a source debit/import. |
| Living cells | Drift plus their funded relative swimming, subject to contact/attachment. | Existing bodies/reserves remain the same owned inventory while moving. |
| Corpses/detritus | Use explicit mobility/attachment rules, or the supported corpse-to-bubble process. | Conversion occurs once; no spendable corpse and duplicate bubbles. |
| Dissolved compartments | Only move/convert through defined conservative processes. | Bubble advection does not automatically implement dissolved transport or make dissolved stocks edible. |
| Visual particles/trails | Illustrate flow without being collectible resource objects. | Must not appear as edible stock or create a second food system. |
### Drift caused by passing cells
In addition to ambient currents, a passing cell disturbs nearby food bubbles so
they drift somewhat in the direction the cell was travelling. This is part of
the recorded gameplay direction, not just a client animation. The influence
decreases with distance from the passing cell, and the extra bubble drift speed
falls off over time, returning toward ordinary local-current drift.
Separate base flow from the temporary induced motion:
`bubble world velocity = ambient flow response + temporary cell-induced drift`
This is a conceptual decomposition, not a selected numerical solver. Influence
radius, near/far falloff, decay time, maximum induced speed, and dependence on cell
speed, size, or propulsion output need playtesting. Specify whether the disturbance
uses world travel or swimming relative to water; do not silently settle that choice.
Use a bounded deterministic combination when several cells pass the same bubble,
without dependence on connection or iteration order.
The disturbance changes position/motion, not nutrient identity or amount. It can
occur outside a main current too. It must not pull distant food through other cells,
grant unlimited extra collection range, or stack permanent velocity on every pass.
Like currents, it has no energy accounting and is never a source of usable cellular
E. Persist or deterministically reconstruct
any temporary bubble motion needed for identical restored continuation.
Equal drift does not make a cell catch a nearby bubble. Players still need useful
relative motion or contact. Active play can involve intercepting a cluster,
matching its drift while feeding, then exiting toward a quiet reproduction site.
Collecting a bubble should not automatically impose a generic speed penalty.
High flow or propulsion must not skip contact with food or pass through cells.
Choose swept contact or bounded motion subdivisions with explicit work limits;
do not change the biological tick duration or skip feeding costs to hide tunneling.
Contention and transfer order must remain stable and independent of connection
order. Collisions, sticking, pushing, and engulfment need their own supported
rules rather than one generic "speed through other cells" percentage.
Decided 2026-10-21: bubbles that touch merge into one bubble holding both
inventories, keeping the lower id, with radius from total stock. A tunable size cap
stops further merging. Merges resolve in id order. Each update carries a tunable
number of moving bubbles, nearest first; the client advances the rest with the
shared flow field. See the [implementation plan](Cellular_Region_Movement_Plan.md).
## Thermal conditions
### What temperature means
The selected draft direction is a **procedurally generated thermal map**, plus an
actual temperature state for each cell. Use explicit seed/configuration and
continuous/readable spatial differences. The map describes local environmental
temperature; it is not the cell's own temperature and is not a new edible resource.
The UI must expose a compass and temperature gauge for navigation and make thermal
differences visible in the habitat rather than rendering flat-color terrain.
Temperature is an environmental condition, not usable E or an amount of food.
The existing heat sink does not by itself define local temperature: we need an
explicit thermal reference, heat capacity, spatial ownership, and exchange model.
Stored units should follow the repository's dimensional conventions; a Celsius
display can be derived for readability. No gameplay temperature values are selected
by this draft, and missing thermal state is not zero kelvin or a safe default.
Decided backing: the region's thermal map is the thermal map of its linked world
area, scaled down to the habitat (ADR-0177). It is a static maintained condition,
not owned thermal energy, and needs no energy exchange accounting. Owned thermal
energy with heat capacity is deferred until gameplay needs temperatures that
change, for example colonies warming their surroundings. Waste heat is never
recovered into usable cell E.
### Layout, sources, and transport
Use broad, readable differences rather than a random checkerboard of lethal cells.
A founder-accessible comfortable area can border cooler/warmer opportunities with
gradual transitions. Extreme areas should initially be optional routes, not the
only source of a nutrient every founder needs to reproduce.
Because the map is maintained, currents do not carry heat and gradients stay
fixed. A warm vent illustration is presentation, not an energy source. Existing
radiative exports must not also be counted as heating local liquid.
Thermal map resolution may differ from flow or food resolution. Sampling,
organism footprint overlap, and boundary continuity need explicit semantics.
### Effects on organisms
The maintainer clarified that **all three temperatures contribute**, rather than
choosing a single reference:
| Temperature | Meaning | Role in the response |
| --- | --- | --- |
| Environmental temperature | The local liquid temperature experienced by the cell. | Determines current exposure and the conditions the body is adjusting to. |
| Current cell temperature | The cell's actual present temperature. | Responds over time; its difference from the environment contributes to the difficulty of handling a transition. |
| Preferred cell temperature | The cell's favored operating temperature, distinct from its actual temperature. | Keeps off-preference living more costly even after actual temperature approaches the environment. |
There are two connected cost behaviors to preserve when choosing an equation:
- **Transition/handling cost:** drastic changes between the current body state and
surrounding temperature require more E to handle. Rapidly entering a very different
environment can be especially demanding. This component can diminish as the cell
adjusts, depending on its acclimation and mutations.
- **Persistent off-preference cost:** settling toward the environmental temperature
does not automatically restore baseline. If the resulting conditions remain far
from the preferred temperature, survival still costs more than living near preference.
The overall thermal penalty should increase exponentially with relevant unsupported
mismatch, subject to balancing. Do not select an exponent, coefficient, comfort width,
or cap simply to fill this draft. Whether the terms add, multiply, share one response
curve, or use another relationship remains open. Avoid counting the same sustained
stress twice just because both body-to-preference and environment-to-preference
differences can describe it.
Use `survival E/time = baseline survival E/time * thermal multiplier` only as a
conceptual placeholder. The multiplier depends on all three temperatures, the cell's
acclimation state, and relevant mutations. It approaches 1 when conditions are well
handled and near preference; a supported adaptation can reduce or remove extra
thermal cost over its useful range. Ordinary movement, construction, and other
activity costs remain separate; do not indiscriminately multiply every resource
cost by a thermal factor.
Cells can **acclimate** over time or acquire **mutations** that change how well
they handle temperature. Actual temperature adjustment must not automatically
overwrite preferred temperature to equal the surroundings. Acclimation is
physiological adjustment, distinct from selecting structural offspring adaptations
or automatically rewriting the inherited genome. Its range/rate, whether it can
shift a preferred operating range within limits, and inheritance behavior need
balancing and explicit rules. Neither adjustment nor acclimation instantly erases
all extremes.
Example behavior, without choosing temperatures or coefficients: a cell leaves
its preferred environment for a much hotter area. It initially pays a high handling
cost. Its actual temperature then rises and its handling cost can decrease, but
remaining in that hot area still has an off-preference cost. A heat-adapted descendant
can reduce that burden; a cold specialist need not receive the same benefit.
| State relative to the organism's supported range | Proposed gameplay response | Decision still needed |
| --- | --- | --- |
| Current body and environment near preference | Survival E use approaches ordinary baseline. | Comfort band, baseline calibration, and the combined equation. |
| Abrupt transition away from current body temperature | Increased handling E demand while the cell responds. | Response rate, acclimation limits, mutation effects, and how abruptness enters the equation. |
| Body adjusted but environment/body still off preference | Extra survival cost persists despite a smaller body/environment difference. | Sustained stress curve and specialist/generalist tolerance. |
| Extreme freezing/boiling exposure | Can cause immediate permanent death, including rapid entry into an extreme area. | Organism-specific lethal thresholds and whether ambient or actual cell temperature triggers the event. |
This explicitly revises the earlier suggestion that thermal boundary crossings
should never kill instantly. Extreme areas may be immediately lethal; do not
silently grant a universal exposure grace period. Communicate danger before entry
through visible thermal cues, the gauge, and navigation. Ordinary gradients and
founder routes should remain usable without requiring entry into those extremes.
No universal 0/100-degree thresholds are adopted; temperature values and environmental
conditions must be explicitly chosen. Body-temperature change, acclimation, exposure,
and lethal thresholds are related but distinct. Partial footprint exposure still
needs defined treatment.
Thermal protection must occupy actual tissue or require actual operating resources
if shedding it is to save anything. A specialist can give up breadth for better
local performance only through a specified response/recipe. The current tolerance
parameter must not silently acquire new low/high/optimum meanings under old schemas.
Provide cold-specific, heat-specific, and overall thermal adaptation options.
Heat and cold handling may differ in the same cell. A broader adaptation may handle
both well enough to leave no extra thermal penalty across the supported practical
range. That does not silently grant immunity to every lethal threshold or eliminate
the actual construction/upkeep cost of the adaptation. Specify any such protection
explicitly; useful traits still need the catalog's meaningful tradeoffs.
The exact effects on handling cost, persistent cost, acclimation, preferred range,
and lethal limits need later review against the balanced equation. Do not revise
the 150 mutation entries incidentally while the maintainer reviews other groups.
Do not apply new temperature effects to food spoilage, nutrient conversion,
reproduction, mutation rates, or photosynthesis merely because a field now exists.
Each coupling needs a defined benefit, drawback, accounting treatment, and version.
## Mutation opportunities supported by the region
The mutation catalog remains the source for individual tradeoffs; this document
lists what the environment must provide for those offers to mean anything.
| Draft IDs | Environmental requirement | Offer/context treatment |
| --- | --- | --- |
| 001-005 propulsion/steering | Useful routes, readable resistance, acceleration/braking, and actual output costs. | Productive travel/interception/crossing can raise weights; inputs alone do not farm offers. |
| 006 active braking propulsion, proposed replacement | Funded opposing propulsion with useful capacity beyond ordinary founder braking. | Stop/reverse demands weight the option; old Current sail stays archived pending a distinct benefit. |
| 007, 099 anchoring | Currents that make holding position useful; paid anchor construction, drop, and release. | Costly station keeping/dislodging is relevant context; no need to suffer injury first. |
| 008 coasting-biased body, proposed replacement | Stored relative velocity and a body-resistance change distinct from 005 streamlining. | Useful open coasting can favor it; overshooting/precise-stop demands can reduce weight. Former food sensing is reclassified for later review. |
| 104 flow sensing | A useful information benefit beyond the visible current cues promised to all cells. | Sensing is information, not swimming speed; do not require it to see basic flow. |
| 009 shed propulsion | Real ongoing stationary supply or supported carried role. | Photosynthesis/pool proximity alone is insufficient; nutrient access must work. |
| 010 specialized colony propulsion | Attached movement/load and machinery beyond ordinary member propulsion. | Does not require 009; ordinary attached movement is not gated on 010. |
| 024-025, 100 light adaptation/sensing | Meaningful, perceivable spatial light differences. | Light is separate from temperature; shade is not automatically cold. |
| 091-095 thermal specialization | Real temperature-dependent benefits and disadvantages, plus reachable habitat choices. | Observed useful thermal conditions/transitions weight offers; dangerous exposure is not a prerequisite. |
| 097 shed thermal protection | Existing costly protection and functional thermal gameplay. | Stable safe conditions can favor shedding; no offer when there is no actual saved cost. |
| 098 protective rest | Supported hazards, funded protection, finite survival, and reactivation. | Optional specialization, not an enforced inactive opening. |
A region with thermal effects disabled offers no thermal adaptations. A thermal
map with only decorative color is still disabled for this purpose. Hard availability
comes before behavior/context weights; merely discovering an area does not create
the missing environmental mechanics.
## Readability and controls
- Flow cues should communicate direction and strength before the cell is committed.
Use trails, suspended specks, and actual food motion without making every visual
speck look collectible.
- Render terrain/habitat colors as a thermal heat map with readable cold-to-hot
differences instead of a flat background. Basic cellular conditions and interactions
have visible indicators/cues; their readability does not require a sensory mutation.
- Provide a compass and temperature gauge for navigating the cell. Distinguish local
ambient temperature, actual cell temperature, and preferred temperature/range.
Final gauge layout remains open, but it should explain why E demand stays high
after a cell's actual temperature has adjusted to an off-preference location.
- Distinguish comfortable, stressful, and dangerous conditions for the controlled
organism using contours/patterns and labels as well as color. Food channel colors
must remain distinguishable; visible heat must not hide current direction.
- Show whether the cell is swimming, drifting, actively braking, holding position,
or anchored. A world-space speed readout alone can conceal propulsion expenditure.
- Explain a changing budget: for example, station keeping uses E while passive
drift does not use propulsion E; basal maintenance remains separate.
- Respect perception/interest limits. A readable local current/thermal view does
not grant an exact global map or reveal out-of-range food.
- Any later sensory adaptation needs a benefit beyond these baseline visual cues;
it cannot merely restore information already promised to every cellular player.
- Show biological state under shared presentation rules for NPCs and players;
do not add account/owner labels to make flow or thermal behavior understandable.
The renderer consumes immutable views with frame, tick, revision, and field presence.
It can interpolate presentation, but client animation cannot move authoritative
food/cells, determine temperature injury, or alter collection outcomes.
## Ownership, lifecycle, and persistence
Keep one authoritative owner per patch of space, including cells and their local
environment. Several regions scale the world; one global fluid owner is not implied.
Environmental fields, organic stock, corpses, independent descendants, and transfer
escrow must remain disjoint resource representations.
Before a coupled implementation, specify and persist or deterministically derive:
- Field definitions, units, frame/mapping, immutable seed/configuration, and rules.
- The linked world area and scaling used for the thermal map, so it reconstructs
exactly; currents and the map have no time-dependent stock or entitlement.
- Actual movement state needed for acceleration, braking, and restored continuation.
- Attachment state, loads, member identities, and valid release/breakage outcomes.
- Temperature/exposure state needed by the chosen organism response model.
- Atomic flow/thermal/resource/movement outcomes and their recorded replay inputs.
Choose one explicit tick order for environmental exchange, motion/contact, feeding,
metabolism, thermal response, reproduction, and terminal transfers. The list here
does not select that order. Restore, recorded replay, and differently partitioned
batches must produce the same authoritative outcomes under the chosen rules.
No database write per simulation tick is required by this proposal.
Cross-region transport needs paired conservation and durable authority handoff.
It must include the relevant organism motion/thermal state and any in-transit stock;
an adjacent field's read-only view cannot authorize spending its inventory. The
initial closed circulation experiment can defer open transport without declaring
future regional boundaries impermeable world walls.
Offline controlled organisms still cannot move, feed, reproduce, mutate, or progress
passively. Logout takes effect after a delay; during it the cell stays in play and
vulnerable, so logging out while about to be engulfed does not prevent it. After
the delay the cell is anchored in place, cannot be engulfed, is not moved by
currents, and its metabolism and thermal response are frozen. There is no offline
catch-up on return. Independent NPC relatives continue under ordinary active-world
rules. Resume restores the cell's frozen velocity and temperature state; its
surroundings may have changed.
## Region capacity and world linkage
Each region maps to an area of its world and takes its thermal map from that area.
Regions do not grow with population. A hard organism cap bounds each region:
- At the cap, births are refused. Engulfment and death return matter to the region
and reopen slots for players and wildlife alike.
- If a capped region has had no players for extended days, an operator can cull
wildlife through an admin interface. Culling is a recorded operator action, not
automatic despawning presented as selection.
- The world adds regions as demand requires. A later equation decides whether a
new region joins the same world or a region attaches to a new world.
- A fresh cell is offered a choice of region when it begins, so friends can share one.
A new region starts without life under player-origin biology; its founders shape it.
## Emergence into the world
When an organism evolves out of the 2D stage, it leaves its cellular region:
- Its matter is a recorded export and is lost to the cellular scale. The organism
enters the world scaled to world values. The conversion scale is selected once
the number of regions per world and the matter per region are known.
- Target selection uses the region's mapped world area. Rank several candidates
closest to the organism's preferred temperature with the nutrients it needs and
choose one at random. Finite world resources penalize crowded sites; no separate
spreading rule is added.
- The emerging organism chooses individual or bulk emergence. Bulk joins a
selection queue; organisms emerging together with the same or close biology share
one target pick. Because players and wildlife look alike by design, this does not
depend on knowing who is a player.
Thermal adaptation in the cellular stage therefore shapes where an organism starts
in the world.
## Pacing and ecological checks
All fresh primitive lives receive equivalent starting biology. Starting locations
need useful reachable food, a tolerable thermal setting, and sufficient control
to follow more than one viable route. This does not require permanent protected
zones or invulnerable founders.
Evaluate net E and each material channel over actual routes, including propulsion,
maintenance, flow encounters, and newborn investment. Faster E collection alone
does not satisfy the three-minute first-birth target if P or another material
creates a long wait. Thermal protection must not become a required prerequisite
for every founder's ordinary reproduction route.
The maintainer expects unattended feeding to be slower than active gathering and
risky because other organisms can engulf an unattended cell. Treat a separate
anti-AFK system as low priority; do not add input challenges, forced movement,
unattended-play timers, or new surveillance mechanics for this draft. Verify the
assumption through playtesting rather than claiming predation guarantees it in
every population. The mutation draft's proposed activity-credit rules remain a
separate review item, not a new anti-AFK feature approved by this decision.
Compare active collection with fixed-pool camping and passive drifting in trials.
If a circuit or pool outperforms active routes, tune food, flow, intake, and costs
before adding an anti-idle layer. Viable stationary producers still need useful
interactions and births without meaningless movement/input requirements.
Observe whether offspring establish, compete, feed, die, recycle, and form supported
groups. Flow must not sweep every newborn away before attachment is possible or
concentrate all life into one dominant trap. Finite resource depletion and deaths
remain ecological outcomes; do not conceal failures by automatically spawning food
or wildlife. Adjust documented openings/inflows and trial parameters instead.
## Proposed implementation segments, after design review
These are possible bounded segments for later work, not authorization to code,
commit, push, migrate, or deploy during this document review.
| Segment | Concrete result | Qualification needed before broadening |
| --- | --- | --- |
| Design contracts | Agree motion/flow, thermal accounting/response, boundaries, and rule-version scope. | Reconcile existing ADRs, resource owners, public contracts, and lifecycle behavior. |
| Portable flow and propulsion | Deterministic fields, funded motion/braking, loose-food movement, and conservative contact. | Bounds, conservation, no tunneling, no free station keeping, replay/restore. |
| Portable thermal model | Explicit thermal sources/capacity/exchange and one readable biological response. | Energy accounting, gradients, warning time, supported adaptation tradeoffs. |
| Coupled region integration | One-owner joint outcomes, durable state, publication, recovery, and supported attachments. | Atomicity, crash/retry safety, batch equivalence, offline policy, version admission. |
| Client presentation | Readable local flow/thermal cues and movement/energy feedback. | Matches authority and perception; founder handling evaluated interactively. |
| Controlled pacing experiment | New disposable/versioned test region with ordinary founding and births. | First-birth distributions, active-vs-passive feeding, adaptation usefulness, colony opportunity timing. |
Keep the headless simulation independent of graphics, networking, storage, Steam,
and Kubernetes. Specialized dependencies need the repository's evidence/ADR process;
none are proposed merely to supply a fluid effect. This design does not change
foundation-proof scope or authorize any World0 action.
## Future verification checklist
These are checks a later implementation must perform, not results claimed here:
- Still liquid, uniform flow, circulating flow, and smooth transition cases.
- Procedural 2-n current generation, differing speeds/directions, intersections,
and identical reconstruction from saved generation configuration.
- Relative swimming versus world movement; braking does not imply free station keeping.
- Useful founder control across ordinary currents, with no high-speed contact skips.
- Finite food survives repeated circuits without gain, loss, or boundary piles.
- Passing-cell food drift has bounded distance falloff and temporal decay, combines
predictably across cells, and restores identically without changing food stock.
- Attachment, release, force/load handling, and ordinary multi-cell propulsion.
- Thermal map reconstruction from the linked world area, gradient crossings, and
scaling continuity.
- Region cap birth refusal, slot reopening, operator culling records, emergence
export and target selection, and logout delay followed by protected anchoring.
- Combined three-temperature E response: transition cost can diminish after
adjustment while off-preference cost persists; near-preference operation approaches
baseline. Check the balanced exponential curve without double-counting stress.
- Bounded acclimation, lethal extreme entry, and meaningful asymmetric cold/heat
and broad thermal-adaptation effects, including any supported zero-extra-cost range.
- Heat-map cues, compass, and gauge distinguish ambient/cell state and communicate
hazards before entry without requiring a mutation for basic visibility.
- Unsupported/missing fields rejected or explicitly disabled, never treated as safe defaults.
- Deterministic motion/thermal continuation through restore, retry, and batch partitioning.
- One-owner and cross-boundary conservation, including escrow and terminal events.
- No offline controlled-organism drift, feeding, exposure catch-up, or earned mutation credit.
- Perception limits and equivalent biological presentation for player/NPC organisms.
- Ordinary first-birth timing across seeds and novice routes, plus progression-time tails.
## Remaining tuning and implementation details
The original ten responses are recorded near the beginning. Do not present settled
procedural generation, visible cues, flow-speed effects, or exponential thermal
cost as unanswered gameplay questions. Remaining work is:
- **Thermal equation:** combine current cell, preferred cell, and environment
temperatures with acclimation and mutations. Preserve extra cost for drastic
transitions and sustained off-preference conditions; the coefficients and exact
relationship require balancing, not another choice of a single reference.
- **Playtesting:** founder/current speed ranges, crossing/escape control, proposed
006 braking and 008 coasting tradeoffs, exponential
E curve, acclimation rates/limits, lethal thresholds, colony roles, and whether
active feeding naturally outperforms risky unattended feeding.
- **Generation and composition:** maximum n, route/thermal-map generation rules,
intersecting-current composition, bounded work, and recorded configuration.
- **Food disturbance tuning:** induced-drift radius, strength, distance falloff,
decay, multiple-cell combination, and world-versus-relative driving velocity.
- **Thermal map scaling:** how the world area's thermal map is scaled to the habitat;
ambient/cell response and lethal-event semantics.
- **Controls/presentation:** exact coasting/braking/reversing/anchoring inputs in
the focused movement draft, and gauge layout, with baseline visible cues established.
- **Lifecycle:** logout delay duration and spawn placement within a chosen region.
- **Capacity and emergence:** region cap value, region-or-world creation equation,
emergence conversion scale, candidate count, and bulk-queue timing/similarity.
- **Engineering contracts:** ownership/contact, conservative boundaries, deterministic
recovery, explicit version changes, and eventual cross-region transport. The
maintainer marked original question 3 N/A for the gameplay discussion; these
existing technical constraints remain without becoming new required gameplay.
## Document validation scope
Check local reference targets, Markdown structure, unique headings, required design
sections, and whitespace. Preserve the separately reviewed mutation draft. These
checks establish document integrity only; no fluid behavior, thermal response,
ecological balance, implementation availability, or pacing result is qualified by
creating this file.