docs: cellular gameplay revamp plans

Plans for the cellular revamp, from the maintainer's decisions of 2026-10-22:
an overview of every gameplay system, the mutation offer system with a
49-mutation catalog, reproduction (on-demand buds, mutation splits,
multicellular organisms, emergence), feeding and energy (per-channel
collection, matter as energy, the spent pool), predation and defense, and
body and maintenance. Nothing is implemented by this commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-10-22 17:49:38 -04:00
co-authored by Claude Opus 5.5
parent 39ac0bf31f
commit 628721dff4
6 changed files with 1113 additions and 0 deletions
+131
View File
@@ -0,0 +1,131 @@
# Cellular body and maintenance plan
Status: planning draft, 2026-10-22. Records the maintainer's decisions on body size,
body recipe, upkeep, density, growth and bud size. Part of the
[Cellular gameplay plan](Cellular_gameplay_plan.md). Replaces the 031-050 notes in
[Cellular_energy_photosynthesis_draft.md](Cellular_energy_photosynthesis_draft.md).
No code, runtime rule or live region is changed by it.
All indices below are stored in points with the founder at 100, and change in the
mutation plan's 5-point steps unless stated otherwise.
## 1. Size
The genome's `target_size` (the full-grown body mass) moves to points; 100 is today's
founder (8,000,000 fg).
| Larger | Smaller |
| --- | --- |
| Harder to engulf; can engulf bigger prey | Easier to engulf; limited to smaller prey |
| More upkeep (upkeep follows body mass) | Less upkeep |
| Costlier buds and regrowth | Cheaper buds and regrowth |
| Heavier, so slower to move | Lighter, so quicker |
| Bigger footprint, so it touches more food | Smaller footprint |
None of these are separate penalties; they follow from mass and size.
## 2. Body recipe
The body's share of each matter channel (C, N, P, O, in per thousand, summing to
1000) becomes a heritable trait. The founder's recipe is today's fixed composition.
- A recipe mutation moves a tunable step (trial 20 per thousand) from one channel to
another.
- Each channel has a tunable minimum share, so no body drops a channel entirely.
- The recipe changes what the body needs to build, regrow and bud. It has no
performance effect: its value is fitting the body to what the region supplies.
- Together with separate collection rates, this lets a lineage specialize, for example
a nitrogen-poor body that thrives where nitrogen is scarce.
## 3. Upkeep efficiency
Upkeep can be made cheaper but never zero:
```text
upkeep = essential part + adjustable part x 100 / upkeep efficiency
```
- The essential part is a tunable share of the founder's upkeep (trial 25%), which no
mutation reduces.
- Upkeep efficiency is an index, founder 100.
- Upkeep stays on the body only (feeding and energy plan).
Flexible upkeep (switching unused machinery off, draft 030) is postponed.
## 4. Density
Tissue density is an index, founder 100. Body mass is set by size, so density changes
how large the body is for that mass:
| Denser | Lighter |
| --- | --- |
| Smaller footprint for the same mass | Larger footprint for the same mass |
| Less surface, so slower collection and less membrane mass | More surface, so faster collection but more membrane mass and upkeep |
| Touches less food and fewer cells | Touches more food and more cells |
Body mass is unchanged by density; only membrane mass changes, because it follows the
surface.
Shape traits (elongated, flattened, rounded, flexible, rigid) and flexible adult size
are dropped: the body is a square and there is no shape or deformation model.
## 5. Growth
- Growth speed is an index, founder 100, scaling a tunable base rate (trial 5 per
thousand of full size per tick, today's value).
- Faster growth spends the same matter and energy in less time; it does not make
growth cheaper.
- After a mutation split, each half starts at the size its half of the body covers and
regrows at its growth speed.
## 6. Bud size
The reproduction capability sets the size of an on-demand bud, as a share of the
parent's body, in points (founder 100, which is 500 per thousand: half the body),
built from the parent's reserve. Extra offspring per bud come from litter (mutation
plan, section 9). Bigger buds cost more but start larger and are harder to engulf; smaller
buds are cheap but vulnerable.
## 7. Dropped
| Draft | Why |
| --- | --- |
| 031-034 storage | No storage caps. |
| 039-040 recycling and leakage | No tissue turnover or leakage model. |
| Dropping food to provision offspring | Splits already share resources. |
| 043-047 shape, 050 flexible size | No shape model. |
## 8. Genome indices and mutations
| Index | Founder | Mutations |
| --- | --- | --- |
| Size | 100 | Larger Body, Smaller Body (mutation plan, section 8) |
| Body recipe | Today's composition | Carbon-, Nitrogen-, Phosphorus- and Other-Thrifty Body (section 8) |
| Upkeep efficiency | 100 | Efficient Upkeep, Rapid Growth (section 8) |
| Density | 100 | Dense Tissue, Light Tissue (section 8) |
| Growth speed | 100 | Rapid Growth, Efficient Upkeep (section 8) |
| Bud share | 100 | Bigger Buds, Smaller Buds (section 9) |
## 9. Tunables
| Setting | Trial |
| --- | --- |
| Recipe step | 20 per thousand |
| Minimum share per channel | To be selected in playtesting |
| Essential upkeep share | 25% of the founder's upkeep |
| Base growth rate | 5 per thousand per tick |
| Size, density, efficiency and growth index bounds | To be selected in playtesting |
## 10. Implementation map
| Piece | State today |
| --- | --- |
| Size from `target_size` | Exists, in femtograms; points are new. |
| Body recipe | Fixed per development version; heritable shares are new. |
| Upkeep with an essential floor and efficiency | New. |
| Density | Fixed per development version; heritable index is new. |
| Funded regrowth | Exists (funded maturation, rules 9); the growth index is new. |
| Bud size from the reproduction capability | Exists; the new bud flow is in the reproduction plan. |
Every new behaviour goes in a new rules version; regions on earlier rules keep their
meaning.
+164
View File
@@ -0,0 +1,164 @@
# Cellular feeding and energy plan
Status: planning draft, 2026-10-22. Records the maintainer's decisions on how cells
collect resources and pay for energy. Part of the
[Cellular gameplay plan](Cellular_gameplay_plan.md). Replaces the collection and fuel
sections of [Cellular_feeding_draft.md](Cellular_feeding_draft.md) and the energy
sections of [Cellular_energy_photosynthesis_draft.md](Cellular_energy_photosynthesis_draft.md).
No code, runtime rule or live region is changed by it.
## 1. Resources
| Channel | Unit | Used for |
| --- | --- | --- |
| E (energy) | picojoules | Upkeep, thrust, construction, mutation costs |
| C (carbon) | femtograms | Body tissue; energy stand-in |
| N (nitrogen) | femtograms | Body tissue; energy stand-in |
| P (phosphorus) | femtograms | Body tissue; energy stand-in |
| O (other matter) | femtograms | Body tissue; energy stand-in |
Resources enter a region through its infall sources (as today), and come from light
for producers. They return to the region through deaths, kills (predation and defense
plan), mutation costs and the spent pool (section 3).
There are no storage caps. Reserve matter counts toward the cell's mass (section 4).
## 2. Collection
### Separate rates per channel
Each cell has a **collection index per channel** in its genome, with the founder at
100 on every channel:
```text
collection: energy 100, carbon 100, nitrogen 100, phosphorus 100, other 100
```
- A channel's collection rate is the founder's rate for that channel scaled by its
index (105 collects that channel 5% faster).
- The existing ingestion capability stays as the **shared limit**: total matter taken
per tick cannot exceed it, so raising every channel does not bypass the cell's
overall intake.
- Collection is still by contact, as today: the cell drains what it touches.
This gives lives real variation: a nitrogen gatherer and a carbon gatherer feed
differently in the same region. The founder rates, the shared limit and how they
interact need serious tuning.
## 3. Matter as energy
### The rule
When an energy cost is larger than the reserve's energy, the cell pays the remainder
with **reserve matter** instead. The matter is not converted into energy; it stands in
for it. It covers every energy cost: upkeep, thrust, growth and bud construction, and
the energy part of mutation costs.
- **Burn rate:** each channel has a tunable rate in femtograms per picojoule, divided
by the cell's burn efficiency for that channel (founder 100). Matter pays at a higher
rate than pure energy, so burning matter is always the expensive way to stay alive.
- **Only reserve matter burns.** The body is never burned.
- **Death:** a cell dies when its upkeep cannot be paid by energy or any reserve
matter.
### Which matter burns
- The cell burns the channel it has the **most** of (in femtograms). If that channel
runs out mid-payment, it moves to the next largest. Ties go in the order C, N, P, O.
- The player can **exclude** channels (for example, keep phosphorus for budding).
Excluded channels are not burned for thrust, construction or mutation costs. The
controlled cell keeps its exclusions through splits and buds; wildlife excludes
nothing.
- **Upkeep overrides exclusions.** If upkeep cannot be paid any other way, it burns
excluded matter rather than let the cell die with matter on board.
### Where the burned matter goes
Burned matter goes into the region's **spent pool**, one amount per channel. The pool
drips back into the region as new bubbles at random points, at a tunable rate. If the
region is at its deposit limit, the drip waits.
- The region keeps all its matter; nothing is destroyed.
- Burned matter cannot be collected straight back, so matter is not an endless energy
supply. The drip rate decides how scarce energy is.
- Energy paid with real energy still goes to heat, as today.
### Presentation
The energy display shows the reserve's energy plus what the usable (non-excluded)
matter can stand in for, and roughly how long the cell can live on it.
## 4. Mass
Carried reserve matter counts toward the cell's total mass, alongside its body. Mass
slows acceleration and turning and raises movement energy (see the reproduction plan's
mass rule). Hoarding mass for emergence makes an organism slower and costlier to move.
Upkeep is charged on the **body only**. Reserve matter adds to movement costs, not to
upkeep, so hoarding is paid for once.
## 4a. Energy-bubble efficiency
The founder's `energy_conversion` capability (400 per thousand, unused in cellular play
today) becomes the share of collected energy-bubble E the cell keeps as reserve
energy. The rest goes to heat. Matter is collected whole; this applies to E only.
This gives extraction mutations a real axis: a higher share means more energy per
bubble, paid for by the mutation's paired change.
Today a cell keeps 100% of bubble energy. At the founder's 400 per thousand it would
keep 40%, cutting its energy income by more than half. Either the founder's value or
the energy in bubbles must be retuned when this is turned on.
## 5. Photosynthesis
- **Unlock:** Acquire Photosynthesis becomes available after the cell has burned a
tunable amount of carbon as energy. The count carries to offspring, like affinity
scores.
- **Weights:** burning carbon raises its chance; burning other channels lowers it.
Cells that live on carbon drift toward becoming producers.
- **Mass:** producer tissue slows the cell through the mass model only. The legacy
speed penalty is dropped in the new rules.
- **Light:** constant; there is no day/night cycle and no spatial light. The light
specialists (024/025) are dropped.
## 6. Genome indices and mutations
| Index | Founder | Mutations (mutation plan, section 6) |
| --- | --- | --- |
| Collection per channel (E, C, N, P, O) | 100 each | Carbon, Nitrogen, Phosphorus and Other Matter Gatherer |
| Shared intake limit | 100 | Big Appetite, Small Appetite |
| Burn efficiency per matter channel | 100 each | Carbon, Nitrogen, Phosphorus and Other Matter Metabolism |
| Energy kept per bubble (`energy_conversion`) | 100 | Thorough Extraction, Rapid Extraction |
| Light capture | Absent; 100 when acquired | Acquire, Expand, Reduce and Shed Photosynthesis |
## 7. Tunables
| Setting | Trial |
| --- | --- |
| Founder collection rate per channel | From today's derived limits |
| Shared ingestion limit | Founder ingestion capability |
| Burn rate per channel (fg per pJ) | To be selected in playtesting |
| Spent-pool drip rate | To be selected in playtesting |
| Carbon burned before photosynthesis is offered | To be selected in playtesting |
## 8. Open questions
None.
## 9. Implementation map
| Piece | State today |
| --- | --- |
| Contact feeding with per-channel limits | Exists; limits derive from one ingestion rate. |
| Collection index per channel | New genome field (new genome schema). |
| Matter paying energy costs | New, in every place an energy cost is charged. |
| Burn order and player exclusions | New per-cell state and a new client control. |
| Region spent pool and drip | New region state; releases bubbles like infall. |
| Reserve matter in mass | New in handling and movement energy; upkeep unchanged. |
| Energy-bubble efficiency from `energy_conversion` | Capability exists; applying it to cellular E intake is new. |
| Carbon-burned count, inherited | New per-cell state. |
| Photosynthesis without the legacy speed penalty | New rules; light capture exists (rules 11+). |
Every new behaviour goes in a new rules version; regions on earlier rules keep their
meaning.
+105
View File
@@ -0,0 +1,105 @@
# Cellular gameplay plan
Status: planning index, 2026-10-22. Tracks every cellular gameplay system, its state,
and the maintainer's decisions. Each system gets its own plan; once all are settled,
the mutation catalog is reworked across them. After the cellular game is finished,
every mutation is reviewed for its effect on the 3D organism.
Plans so far:
- [Cellular_mutation_plan.md](Cellular_mutation_plan.md): what a mutation is, offers,
weights, costs, and the full catalog (49 mutations).
- [Cellular_reproduction_plan.md](Cellular_reproduction_plan.md): budding, mutation
splits, multicellular organisms, emergence.
- [Cellular_feeding_energy_plan.md](Cellular_feeding_energy_plan.md): collection,
matter as energy, the spent pool, photosynthesis.
- [Cellular_predation_defense_plan.md](Cellular_predation_defense_plan.md): engulfment,
what a predator gets, membrane defense.
- [Cellular_body_maintenance_plan.md](Cellular_body_maintenance_plan.md): size, body
recipe, upkeep, density, growth, bud size.
The earlier drafts (feeding, energy/photosynthesis, defense, movement, mutation) are
source material. They were written against superseded policies and are rewritten
into plans rather than merged.
## Systems
| System | Today | Status | Plan |
| --- | --- | --- | --- |
| Movement | Liquid motion with the movement arrangement | Planned | Mutation plan |
| Reproduction and multicellular | Budding into wildlife | Planned | Reproduction plan |
| Collection | One ingestion rate split into per-channel limits; contact feeding | Planned | Feeding and energy plan |
| Energy sources | Energy bubbles; light (rules 11+) | Planned | Feeding and energy plan |
| Engulfment | Instant; attacker mass vs prey mass x membrane | Planned | Predation and defense plan |
| Defense | Membrane thickness | Planned | Predation and defense plan |
| Body and maintenance | Upkeep from mass and membrane | Planned | Body and maintenance plan |
| Temperature | Tuning keys read, unused | **Postponed** | - |
| Sensing and communication | None | **Postponed** | - |
| Multicellular mutations | None | **Postponed** | - |
| Damage and repair | Damage field exists, unused | **Out for now** | - |
## Decisions, 2026-10-22
### Feeding and energy
- **Matter as energy.** When the reserve's energy cannot cover an energy cost, the
cell pays it with reserve matter instead, at a higher rate than pure energy. The
matter is not converted into energy; it stands in for it. A cell dies only when
neither energy nor usable matter can pay. The cell burns the channel it has most of;
the player can exclude channels. Burned matter goes to a region spent pool that drips
back as random bubbles.
- **Separate collection rates per channel** (E, C, N, P, O). More variation between
lives; needs serious tuning.
- **Carried reserve matter counts toward mass** for movement and movement energy, not
upkeep. Hoarding for emergence slows an organism down.
- **No storage caps.**
### Predation and defense
- **Engulfment stays instant** for this pass.
- **Prey recovery:** the predator absorbs up to its per-tick collection limit; half the
remainder becomes bubbles at the prey's spot, half goes to the spent pool.
- **Everyone engulfs**, wildlife included.
- **Membrane** is stored in points (founder 100); thicker membrane also slows
collection.
- **Reserve matter in engulf mass** is a tunable percentage (0% turns it off).
- **Armor is postponed.** Membrane thickness is the defense for now.
- Postponed with live capture: prey retention, slippery coating, adhesive grip,
defensive expulsion, siphoning.
### Photosynthesis
- **Legacy speed penalty dropped** in the new rules. Producer tissue slows a cell
through the mass model only.
- **Light specialists dropped** (024/025): there is no day/night cycle and no spatial
light.
- **Unlock:** offered after burning a tunable amount of carbon as energy; burning
carbon raises its chance, burning other channels lowers it.
### Body and maintenance
- **Size** moves to points; Larger and Smaller follow from mass.
- **Body recipe** (C/N/P/O shares) becomes heritable.
- **Upkeep efficiency** is in, with an essential floor; flexible upkeep is postponed.
- **Density** is kept as an index; all shape traits are dropped.
- **Growth speed** is a trait with a tunable base rate.
- **Bud size** comes from the reproduction capability.
- **Dropped:** storage (031-034), recycling and leakage (039-040), food provisioning.
### Catalog scope
- Mutation deep dive covers the planned systems: movement, feeding and energy,
predation and defense, body and maintenance, reproduction.
- **Draft groups 071-150 are on hold**: colonies and colony architecture, producers and
exchange, environmental adaptation, sensing, metabolic regulation, loss and
simplification, habitat specializations. Sensing and multicellular mutations are
postponed as systems.
## Order
1. Done: system plans for movement, reproduction, feeding and energy, predation and
defense, body and maintenance; the mutation catalog for this pass.
2. Build the plans in phases (build plan, to be written), then playtest at the end.
3. Later: temperature, damage and repair, armor, live capture, sensing, multicellular
mutations, draft groups 071-150.
4. After the cellular game: each mutation's effect on the 3D organism.
+399
View File
@@ -0,0 +1,399 @@
# Cellular mutation plan
Status: planning draft, 2026-10-22. Records the maintainer's decisions on what a
mutation is, how offers work, and the full catalog for this pass (49 mutations). Where this document
conflicts with [Cellular_mutation_draft.md](Cellular_mutation_draft.md) or
[Cellular_movement_draft.md](Cellular_movement_draft.md), this document wins. No code,
runtime rule or live region is changed by it.
For a single cell, accepting a mutation divides it: the offspring expresses the
mutation and both cells carry it in their heritable plan. A multicellular organism
expresses an accepted mutation directly, without dividing. See
[Cellular_reproduction_plan.md](Cellular_reproduction_plan.md), sections 4 and 6.
## 1. What a mutation is
A mutation is an opportunity to steer the evolution of your organism. Each one is a
catalog entry describing one change to the genome. Very few mutations are pure
upgrades: most carry a pro and a con, and both are shown to the player when choosing.
| Field | Meaning |
| --- | --- |
| Name / description | What the player sees. |
| Effect | The exact genome change, e.g. `output +5, efficiency -2`. |
| Pro / Con | Shown in the offer. Derived from the effect where possible, not a flat penalty. |
| Available | Prerequisites (anatomy, region features) and limits (never past an axis bound). |
| Increase trigger | Behaviour that raises the mutation's affinity score. |
| Decrease trigger | Behaviour that lowers it. |
| Cost | Tunable price in energy and matter, per channel (section 4). |
## 2. Offer cadence
Offers arrive periodically while the player is actively playing. One offer is pending
at a time; it stays available while the player moves and is not dismissed by a timer.
Tunable: `mutation.offer_interval_ms` (trial 25,000) and the definition of active play.
Both need playtesting.
## 3. Weights and the draw
### Affinity scores
- Every cell holds an integer **affinity score per mutation**, starting at 0.
- When a mutation's increase trigger completes, its score rises by that mutation's
`increase_points`; a decrease trigger lowers it by `decrease_points`. The trigger's
timer then restarts, so a held behaviour fires repeatedly.
- Scores are bounded to `[score_min, score_max]`.
- **No drift:** scores change only through triggers, never with time.
- **Inheritance:** offspring start with their parent's scores.
### From score to chance
1. **Eligible pool:** every mutation whose prerequisites are met and whose effect stays
within its limits. Ineligible mutations have no chance at all.
2. **Weight:** `weight = base_weight x multiplier(score)`. The multiplier is 1 at score 0
and rises or falls linearly to `max_multiplier` at `score_max` and `min_multiplier`
at `score_min`.
3. **Chance of appearing in the offer:** `p = clamp(k x weight, floor, cap)`, with `k`
solved so that the chances of the eligible pool sum to the number of options
(300% for three). `floor` = **0.001%** (anomalies always happen); `cap` = **70%**.
4. **Draw:** systematic sampling over the pool. One random number picks the options,
they are always distinct, and each mutation's real chance of appearing equals its
`p`. The draw is seeded per cell and offer, so a retry or reconnect never rerolls.
The pool always holds well over five eligible mutations, so the 70% cap is always
satisfiable.
### Tunable draw settings
| Setting | Scope | Trial |
| --- | --- | --- |
| `offer_options` | global | 3 |
| `cap`, `floor` | global | 70%, 0.001% |
| `score_min`, `score_max` | global | -1000, +1000 |
| `max_multiplier`, `min_multiplier` | global | 10x, 0x (the floor still applies) |
| `base_weight` | per mutation | 100 |
| `increase_points`, `decrease_points` | per mutation | 100 |
| Trigger thresholds (seconds, counts, angles) | per mutation | listed with each mutation |
| Step sizes: primary, paired, spread | per mutation | 5, 2, 1 points |
## 4. Choosing and cost
The player picks one of the options or declines. Declining is free; the next offer
draws again.
Each mutation has its own tunable **cost**: an amount per channel (energy E in
picojoules; carbon C, nitrogen N, phosphorus P and other matter O in femtograms), plus
one **scale** from 0% to 100% for fine tuning. The charged amount per channel is
`amount x scale`.
```text
mutation.strong_propulsion.cost_e_pj = 0
mutation.strong_propulsion.cost_c_fg = 0
mutation.strong_propulsion.cost_n_fg = 0
mutation.strong_propulsion.cost_p_fg = 0
mutation.strong_propulsion.cost_o_fg = 0
mutation.strong_propulsion.cost_scale_percent = 0
```
Every mutation starts with all amounts and the scale at 0. Playtesting decides whether
a mutation needs a cost at all, and further playtesting tunes it, one mutation at a
time.
The cost is paid from the reserve when the mutation is applied; reserve matter can
stand in for its energy part (feeding and energy plan, section 3). An unaffordable
option is still offered; it shows the shortfall and cannot be selected until the
reserve covers it.
**Where the cost goes:** the environment reclaims it. Each non-empty channel of the
paid cost becomes a new resource bubble of that amount at a random point in the
region, chosen by the region's seeded draw so a replay places it identically. Nothing
is destroyed; the region's totals are unchanged.
If the region is already at its deposit limit, the reclaimed amount merges into the
existing bubble **farthest** from the paying cell, so the cost cannot easily be
collected straight back.
This replaces the earlier draft policy of no separate fee for selecting a mutation.
### Testing the pool
For testing, every mutation can be switched on or off in the tuning file
(`mutation.<name>.enabled = 1`). A disabled mutation is not in the pool at all, even
at the floor. Together with `base_weight`, this lets a playtest narrow the pool to
the mutations under test or bias the draw toward them.
## 5. Movement mutations
Movement edits the genome's movement arrangement, in reference points where the founder
is 100. Steps add or remove fixed points; they never compound (100 -> 105 -> 110).
Global defaults: primary step `mutation.step_points` = 5, paired step
`mutation.paired_points` = 2; each mutation can override them (section 3).
Percentages below are at matched conditions against the arrangement before the edit,
from the current handling model (top speed ~ thrust / drag; thrust energy ~ output /
efficiency).
### Core mutations (available from birth)
#### Strong Propulsion
- **Effect:** output +5, efficiency -2.
- **Pro:** top speed and acceleration +5%.
- **Con:** energy per second at full thrust +7%; energy per distance +2%.
- **Increase:** thrust for 10 s in total.
- **Decrease:** no thrust for 30 min.
#### Economical Propulsion
- **Effect:** coasting +5 (lower drag, forward and sideways).
- **Pro:** drifts about 5% further after letting go; top speed +5%; cheaper travel when
thrust is pulsed.
- **Con:** stops more slowly, so precise stops need braking, which costs energy; slides
more in turns.
- **Increase:** thrust at least every 15 s for a minute, or move steadily for a minute.
- **Decrease:** no movement for 2 min.
#### Efficient Propulsion
- **Effect:** efficiency +5, output -2.
- **Pro:** energy per distance -5%; energy per second at full thrust -7%.
- **Con:** top speed and acceleration -2%.
- **Increase:** movement is over half the energy spent in a minute.
- **Decrease:** no thrust for 5 min.
#### Agile Steering
- **Effect:** steering +5, output -2.
- **Pro:** turns 5% faster.
- **Con:** top speed and acceleration -2%.
- **Increase:** 5 sharp turns (over 90 degrees) within 20 s.
- **Decrease:** hold one heading (within 20 degrees) for 60 s of thrust.
#### Streamlined Body
- **Effect:** streamlining +5, steering -2 (lower forward drag only).
- **Pro:** top speed +5% and longer forward glide.
- **Con:** turns 2% slower.
- **Increase:** thrust in a straight line (within 20 degrees) for 20 s.
- **Decrease:** 5 sharp turns within 20 s.
Distinct from Economical Propulsion: Streamlined lowers forward drag only and pays in
turning; Economical lowers drag in every direction and pays in stopping and sliding.
#### Strong Brakes
- **Effect:** braking +5, output -2.
- **Pro:** stops and reverses 5% faster.
- **Con:** top speed -2%; each brake draws 5% more energy.
- **Increase:** brake 5 times within a minute.
- **Decrease:** no braking for 10 min.
### Mirror mutations (kept for now)
Each core mutation has a mirror that moves the same axes the other way, so lowering a
trait is a real choice with its own benefit. A mirror's triggers are its core
mutation's triggers swapped.
| Mirror | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Light Propulsion | output -5, efficiency +2 | Energy per second -7%, per distance -2% | Top speed -5% | No thrust for 30 min | Thrust for 10 s |
| Damped Body | coasting -5 | Stops sooner, slides less | Top speed -5%; energy per distance +5% | No movement for 2 min | Pulsed or steady movement for a minute |
| Overdriven Propulsion | efficiency -5, output +2 | Top speed +2% | Energy per second +7%, per distance +5% | No thrust for 5 min | Movement over half of energy spent |
| Forward Drive | steering -5, output +2 | Top speed +2% | Turns 5% slower | One heading for 60 s of thrust | 5 sharp turns in 20 s |
| Rounded Body | streamlining -5, steering +2 | Turns 2% faster | Top speed -5% | 5 sharp turns in 20 s | Straight thrust for 20 s |
| Light Brakes | braking -5, output +2 | Top speed +2% | Stops 5% slower | No braking for 10 min | Brake 5 times in a minute |
### Limits
Each axis has tunable bounds (trial: 25 to 1,000 points; the genome already caps at
1,000). A mutation that would cross a bound is not eligible. Efficiency divides thrust
cost, so it can never reach 0.
### Postponed
Burst, Anchor, Shed propulsion and Colony propulsion are postponed. They are not in the
pool, not even at the 0.001% floor, until their mechanics exist.
## 6. Feeding and energy mutations
Systems and terms are defined in the
[feeding and energy plan](Cellular_feeding_energy_plan.md). All indices are points with
the founder at 100. All available from birth unless stated.
**Spread pattern:** a channel mutation raises one matter channel by the primary step
(5) and lowers each of the other three matter channels by the spread step (1). The
steps are tunable per mutation.
### Feeding
| Name | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Carbon Gatherer | C collection +5, N/P/O collection -1 each | Collects carbon 5% faster | Collects N, P, O 1% slower each | Carbon is at least half the matter collected in the last minute | No carbon collected for 5 min |
| Nitrogen Gatherer | N collection +5, C/P/O -1 each | Collects nitrogen 5% faster | Collects C, P, O 1% slower each | Same, for nitrogen | Same, for nitrogen |
| Phosphorus Gatherer | P collection +5, C/N/O -1 each | Collects phosphorus 5% faster | Collects C, N, O 1% slower each | Same, for phosphorus | Same, for phosphorus |
| Other Matter Gatherer | O collection +5, C/N/P -1 each | Collects other matter 5% faster | Collects C, N, P 1% slower each | Same, for other matter | Same, for other matter |
| Big Appetite | Shared intake limit +5, upkeep efficiency -2 | Takes in 5% more per second at rich food | More upkeep | Feeding at the intake limit for 10 s total | No feeding for 5 min |
| Small Appetite (mirror) | Shared intake limit -5, upkeep efficiency +2 | Less upkeep | Takes in 5% less at rich food | No feeding for 5 min | Feeding at the intake limit for 10 s total |
### Energy
| Name | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Thorough Extraction | Energy kept per bubble +5, energy collection -2 | More energy from each energy bubble | Drains energy bubbles 2% slower | Burning matter for energy for 30 s total | No matter burned for 10 min |
| Rapid Extraction | Energy collection +5, energy kept per bubble -2 | Drains energy bubbles 5% faster | Keeps slightly less of each | Energy collection at its limit for 10 s total | No energy collected for 5 min |
| Carbon Metabolism | C burn efficiency +5, N/P/O -1 each | Carbon covers 5% more energy when burned | N, P, O cover 1% less each | Burning carbon for 30 s total | No carbon burned for 10 min |
| Nitrogen Metabolism | N burn efficiency +5, C/P/O -1 each | Nitrogen covers 5% more energy | C, P, O cover 1% less each | Burning nitrogen for 30 s total | No nitrogen burned for 10 min |
| Phosphorus Metabolism | P burn efficiency +5, C/N/O -1 each | Phosphorus covers 5% more energy | C, N, O cover 1% less each | Burning phosphorus for 30 s total | No phosphorus burned for 10 min |
| Other Matter Metabolism | O burn efficiency +5, C/N/P -1 each | Other matter covers 5% more energy | C, N, P cover 1% less each | Burning other matter for 30 s total | No other matter burned for 10 min |
Thorough and Rapid Extraction mirror each other. Energy kept per bubble can never
exceed 100% of the bubble's energy.
### Photosynthesis
Light capture is in points, with acquisition at 100.
| Name | Effect | Pro | Con | Available | Increase | Decrease |
| --- | --- | --- | --- | --- | --- | --- |
| Acquire Photosynthesis | Gain producer tissue at 100, energy collection -2 | Steady energy from light | Tissue adds mass (slower, more upkeep); drains energy bubbles slower | After burning a tunable amount of carbon; not a producer | Burning carbon for 30 s total | Burning other channels for 30 s total |
| Expand Photosynthesis | Light capture +5, energy collection -2 | 5% more energy from light | More tissue mass and upkeep; drains energy bubbles slower | Is a producer | Drifting without thrust for 60 s total | Thrust for 2 min total |
| Reduce Photosynthesis (mirror) | Light capture -5, energy collection +2 | Less tissue, lighter; drains energy bubbles faster | Less energy from light | Is a producer, above the minimum | Thrust for 2 min total | Drifting without thrust for 60 s total |
| Shed Photosynthesis | Remove producer tissue | No producer mass or upkeep | No light energy | Is a producer | Thrust for 5 min total | Drifting without thrust for 60 s total |
Shed Photosynthesis has `base_weight` 25 (others 100), so shedding is rarer than
trimming. A cell that sheds it can be offered Acquire again; the carbon it has already
burned still counts.
## 7. Predation and defense mutations
Systems and terms are defined in the
[predation and defense plan](Cellular_predation_defense_plan.md). All indices are points
with the founder at 100. All available from birth.
| Name | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Reinforced Membrane | Membrane +5 | Predators need 5% more mass to engulf you | More membrane mass and upkeep, slower collection, heavier | In contact with a cell over 1.5x your mass for 5 s total | No contact with a larger cell for 10 min |
| Thin Membrane (mirror) | Membrane -5 | Faster collection, less mass and upkeep | Easier to engulf | No contact with a larger cell for 10 min | In contact with a cell over 1.5x your mass for 5 s total |
| Expanding Chamber | Engulf capacity +5, membrane -2 | Can engulf prey 5% bigger | Stretched wall: slightly easier to engulf yourself | 3 failed engulfs because the prey was too large or its membrane too thick | No engulf attempts for 10 min |
| Small Mouth (mirror) | Engulf capacity -5, membrane +2 | Tougher wall | Only smaller prey | No engulf attempts for 10 min | 3 failed engulfs because the prey was too large |
| Rapid Digestion | Kill absorption +5, shared intake -2 | Takes 5% more from a kill straight away, so less is left behind | Slower everyday feeding | A successful engulf | No successful engulf for 15 min |
| Grazer's Gut (mirror) | Kill absorption -5, shared intake +2 | Faster everyday feeding | Takes less from kills | No successful engulf for 15 min | A successful engulf |
Expanding Chamber links offense and defense: a better hunter is slightly easier prey.
Failed-engulf reasons (prey too large, membrane too thick) are already reported by the
server; contact with a larger cell is a new counter.
## 8. Body and maintenance mutations
Systems and terms are defined in the
[body and maintenance plan](Cellular_body_maintenance_plan.md). Indices are points with
the founder at 100; the body recipe is in per thousand. All available from birth.
**Recipe spread:** a thrifty body lowers one channel's share by the recipe step (20 per
thousand) and spreads the same amount evenly across the other three. Tunable per
mutation.
| Name | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Larger Body | Size +5 | Harder to engulf, can engulf bigger prey, larger footprint touches more food | More upkeep, costlier buds and regrowth, heavier and slower | Reserve holds more matter than the body for 60 s total | Burning matter for energy for 30 s total |
| Smaller Body (mirror) | Size -5 | Less upkeep, cheaper buds and regrowth, quicker | Easier to engulf, smaller prey only | Burning matter for energy for 30 s total | Reserve holds more matter than the body for 60 s total |
| Carbon-Thrifty Body | Carbon share -20, N/P/O share +20 in total | Building, regrowth and buds need less carbon | Need more N, P and O | Growth or a bud blocked by lack of carbon for 10 s total | Carbon is at least half the matter collected in the last minute |
| Nitrogen-Thrifty Body | Nitrogen share -20, C/P/O share +20 in total | Need less nitrogen | Need more C, P and O | Same, for nitrogen | Same, for nitrogen |
| Phosphorus-Thrifty Body | Phosphorus share -20, C/N/O share +20 in total | Need less phosphorus | Need more C, N and O | Same, for phosphorus | Same, for phosphorus |
| Other-Thrifty Body | Other-matter share -20, C/N/P share +20 in total | Need less other matter | Need more C, N and P | Same, for other matter | Same, for other matter |
| Efficient Upkeep | Upkeep efficiency +5, growth speed -2 | Lower upkeep, never below the essential floor | Regrows 2% slower | Upkeep is over half the energy spent in the last 5 min | Regrowing for 60 s total |
| Rapid Growth | Growth speed +5, upkeep efficiency -2 | Regrows 5% faster after splits | More upkeep | Regrowing for 60 s total | Fully grown for 10 min |
| Dense Tissue | Density +5 | Smaller footprint for the same mass, lighter membrane, less upkeep | Less surface: slower collection, touches less food | In contact with a cell over 1.5x your mass for 5 s total | Feeding by contact for 60 s total |
| Light Tissue (mirror) | Density -5 | Larger surface: faster collection, touches more food | More membrane mass and upkeep, bigger target | Feeding by contact for 60 s total | In contact with a cell over 1.5x your mass for 5 s total |
Thrifty bodies have no performance effect; their value is fitting the region's supply,
and they pair with the Gatherer mutations. Efficient Upkeep and Rapid Growth mirror
each other. Dense Tissue and Reinforced Membrane share an increase trigger: both answer
the same threat.
## 9. Reproduction mutations
Systems and terms are defined in the
[reproduction plan](Cellular_reproduction_plan.md). Bud share is in points with the
founder at 100 (half the parent's body). Only on-demand buds count as reproductions;
mutation splits do not.
### Bud size
| Name | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Bigger Buds | Bud share +5 | Buds start 5% larger: harder to engulf, more likely to survive | Each bud costs 5% more from the reserve | One of your buds is engulfed within 2 min of birth | A bud refused for lack of resources |
| Smaller Buds (mirror) | Bud share -5 | Each bud is cheaper | Buds start smaller and more vulnerable | A bud refused for lack of resources | One of your buds is engulfed within 2 min of birth |
### Multiple offspring
**Litter** is a heritable value, founder 0, giving extra offspring per bud:
- Each full 100 litter points is one guaranteed extra offspring; the remainder is the
percentage chance of one more. Litter 150 means one extra, plus a 50% chance of a
second.
- Every offspring of one bud shares the same investment, so more offspring means each
is smaller. The bud costs the same.
- The maximum offspring per bud is tunable (trial 10, so litter up to 900).
- Each extra offspring needs a free spot touching the parent and room under the region
cap. If fewer can be placed, fewer are born and the investment is shared among them.
- This replaces the current 25% twin chance: new founders start at litter 0.
| Name | Effect | Pro | Con | Increase | Decrease |
| --- | --- | --- | --- | --- | --- |
| Twinning | Litter +25 | More offspring per bud | Each offspring starts smaller and more vulnerable | Bud while the reserve covers at least twice the bud's cost | One of your buds is engulfed within 2 min of birth |
| Single Bud (mirror) | Litter -25 | Each offspring starts larger | Fewer offspring per bud | One of your buds is engulfed within 2 min of birth | Bud while the reserve covers at least twice the bud's cost |
Single Bud is not eligible at litter 0. Twinning is not eligible at the maximum.
### Becoming multicellular
| Name | Effect | Pro | Con | Available | Increase | Decrease |
| --- | --- | --- | --- | --- | --- | --- |
| Adhesion | Gain Adhesion | Become a multicellular organism: the path to emerging into the world | Permanent: no more splits, one shared reserve, the whole organism can be engulfed at once, heavier | After a tunable number of on-demand buds (trial 5) | Each on-demand bud | No bud for 15 min |
Adhesion has `base_weight` 50. Accepting it is a split whose offspring expresses
Adhesion and attaches, so the organism forms at once whichever cell the player keeps;
its offer shows Accept and Decline only.
Emerging into the world is a **button**, not a mutation: it appears once the organism
reaches the emergence threshold (reproduction plan, section 7).
## 10. Balance notes
- Economical Propulsion and Streamlined Body raise top speed without raising energy per
second. Their cost and weights must keep them from dominating.
- Big Appetite only matters where a channel's own limit is above the share of the
shared limit it gets; the shared limit and channel limits must be tuned together.
- Thresholds above are first guesses. "Thrust for 10 s" is cumulative and fires each
time 10 s of thrust accrues; "no thrust for 30 min" is continuous.
## 11. Implementation map
| Piece | State today |
| --- | --- |
| Movement arrangement in the genome | Exists (schema 6); not edited by any mutation yet. |
| Handling from the arrangement | Exists: output, efficiency, steering, streamlining, braking, coasting. |
| Step/paired points, interval, option count | Keys exist in `cellular.tuning`; unused by code. |
| Named catalog with pro/con, triggers and cost | New: replaces the 32 generic adjust/acquire/shed operators for new rules. |
| Per-cell affinity scores | New persisted state, inherited at birth (lives format bump). |
| Trigger tracking | New server-side activity counters from per-tick thrust, brake, heading and velocity. |
| Chance allocation and systematic draw | New: replaces the current uniform draw of 3. |
| Per-mutation cost and scale | New tuning keys and funding path; defaults all 0. |
| Reclaimed cost | New: paid channels become seeded random bubbles in the region. |
| Per-mutation `enabled` switch | New tuning key, for narrowing the pool in tests. |
| Per-mutation step sizes | New tuning keys (primary, paired, spread). |
| Feeding and energy genome fields | New: collection index per channel, shared intake, burn efficiency per channel; energy kept per bubble reuses `energy_conversion`. |
| Feeding and energy triggers | New counters: diet share per channel, time at intake limit, matter burned per channel, drifting time. |
| Predation genome fields | New: membrane in points, engulf capacity, kill absorption. |
| Predation triggers | Failed-engulf reasons exist; contact time with larger cells and kill timers are new. |
| Body genome fields | New: size in points, body recipe, upkeep efficiency, density, growth speed. |
| Body triggers | New: growth or bud blocked by a named channel, regrowth time, time fully grown, reserve-to-body ratio. |
| Reproduction genome fields | Bud share exists (reproduction capability, in points is new); litter and Adhesion are new. |
| Multiple offspring per bud | Twin budding exists (shared investment, room check); litter in place of the fixed 25% chance is new. |
| Reproduction triggers | New: on-demand bud count, bud refusals, early deaths of own buds, reserve-to-bud-cost ratio. |
| Offer UI | Shows name, pro, con, cost, shortfall and chance. |
Every new behaviour goes in a new rules version; regions on earlier rules keep their
meaning.
+108
View File
@@ -0,0 +1,108 @@
# Cellular predation and defense plan
Status: planning draft, 2026-10-22. Records the maintainer's decisions on engulfment
and membrane defense. Part of the [Cellular gameplay plan](Cellular_gameplay_plan.md).
Replaces the engulfment sections of [Cellular_feeding_draft.md](Cellular_feeding_draft.md)
and the active parts of [Cellular_defense_draft.md](Cellular_defense_draft.md). No code,
runtime rule or live region is changed by it.
## 1. Who can engulf
Every cell can try to engulf, wildlife included. The player engulfs by targeting a cell
it touches (the existing engulf action); wildlife uses the same action through its
controller. Engulfing is not a capability gained by mutation.
## 2. Eligibility
Engulfment is **instant**: if the attempt is eligible, the prey dies that tick.
```text
predator engulf mass x (predator engulf capacity / 100)
>= prey engulf mass x engulf ratio x (prey membrane points / 100)
```
Engulf capacity is a genome index, founder 100 (section 6).
- **Engulf mass** = body mass + reserve matter x `engulf_reserve_mass_percent`. At 100%
a hoarding cell is both harder to engulf and able to take larger prey; at 0% only
the body counts. Movement always counts all reserve matter; this setting affects
predation only.
- **Engulf ratio:** tunable; trial 1.5 (today's value), so at the founder's membrane a
predator needs 1.5 times the prey's mass.
- **Multicellular organisms** are engulfed whole or not at all, judged on the
organism's total engulf mass.
- Same-tick contests resolve in stable life order, as today.
## 3. What the predator gets
1. The predator absorbs up to its **per-tick collection limit** on each channel,
scaled by its kill absorption index (founder 100), from the prey's body and
reserve. Energy absorbed this way follows the energy-bubble efficiency rule
(feeding and energy plan, section 4a); the rest of it is heat.
2. The **remainder** is split:
- **Half becomes bubbles** at the prey's spot (one per non-empty channel), for the
predator to eat over the next ticks. Other cells and the currents compete for
them.
- **Half goes to the region's spent pool** and seeps back into the region as
random bubbles.
3. The prey's accumulated heat goes to the region's heat owner, as today.
If the region is at its deposit limit, the bubble half goes to the spent pool as well.
Staying to eat the bubbles is a risk: a predator that sits still long enough can
become prey itself.
## 4. Membrane defense
Membrane thickness is stored in **points**, with the founder at 100 (today's 1 µm), so
it can change in 5-point steps like movement.
| Thicker membrane | Thinner membrane |
| --- | --- |
| Harder to engulf (the ratio scales with points) | Easier to engulf |
| More membrane mass, which is upkept twice (exists) | Less mass and upkeep |
| Slower collection on every channel (new) | Faster collection |
| Heavier, so slower to move | Lighter |
The collection penalty is a tunable coefficient. Membrane points have a tunable
minimum (a viable cell wall) and maximum.
## 5. Postponed
Armor, live capture and escape, prey retention, slippery coating, adhesive grip,
defensive expulsion and siphoning wait for a live-capture system. They are not in the
mutation pool.
## 6. Genome indices and mutations
| Index | Founder | Mutations (mutation plan, section 7) |
| --- | --- | --- |
| Membrane points | 100 | Reinforced Membrane, Thin Membrane |
| Engulf capacity: scales the predator's side of the eligibility check | 100 | Expanding Chamber, Small Mouth |
| Kill absorption: scales the per-tick limit during a kill | 100 | Rapid Digestion, Grazer's Gut |
## 7. Tunables
| Setting | Trial |
| --- | --- |
| Engulf ratio | 1.5 |
| `engulf_reserve_mass_percent` | 100% |
| Kill remainder bubble share | 50% (the rest to the spent pool) |
| Membrane collection penalty | To be selected in playtesting |
| Membrane points minimum and maximum | To be selected in playtesting |
## 8. Implementation map
| Piece | State today |
| --- | --- |
| Instant engulfment by contact, in stable order | Exists (rules 3+). |
| Wildlife engulfing | Exists (rules 7+). |
| Engulf mass with tunable reserve share | New; today only body plus reserve as total mass. |
| Membrane in points | New genome representation (whole micrometres today). |
| Kill remainder split between bubbles and spent pool | New; today all of it becomes bubbles. |
| Membrane slowing collection | New. |
| Engulf capacity and kill absorption indices | New genome fields. |
| Whole-organism engulfment | New, with the multicellular organism. |
Every new behaviour goes in a new rules version; regions on earlier rules keep their
meaning.
+206
View File
@@ -0,0 +1,206 @@
# Cellular reproduction plan
Status: planning draft, 2026-10-22. Records the maintainer's decisions on the
reproduction revamp. Companion to [Cellular_mutation_plan.md](Cellular_mutation_plan.md).
Where this document conflicts with the earlier drafts or with the unimplemented
proposals in ADR-0135, this document wins. No code, runtime rule or live region is
changed by it.
## 1. Purpose
Today reproduction has no purpose for the player: it costs resources, and the player
watches the offspring swim off, eat and reproduce until it dies.
The goal is one loop:
**gather energy and matter -> evolve and reproduce -> become a multicellular
organism -> break out of the region into the world.**
Reproduction becomes the way a lineage evolves, and the way a multicellular organism
grows.
## 2. Two genomes per cell
Every cell carries two genome references (they already exist from rules 10):
| Genome | Meaning |
| --- | --- |
| **Expressed** | What its own body is built from: its traits, handling, costs. |
| **Heritable plan** | What its offspring are born expressing. |
A newborn starts with both references naming the same genome: it expresses its plan.
## 3. Bud (on demand)
- **Trigger:** the player presses Bud.
- **Requires:** fully grown (`bud_min_growth`), a free spot touching the parent, and
the region below its organism cap.
- **Cost:** the parent's reserve pays the bud's body, the energy to build it and its
starting energy supply, as today. A tunable fee per channel (default 0, with the same
amount-and-scale model as mutation costs) is added on top and reclaimed by the
environment as random bubbles.
- **Offspring:** expresses the parent's heritable plan, so it carries every mutation
held in that plan.
- **Size:** the reproduction capability's share of the parent's body (founder: half),
built from the parent's reserve (body and maintenance plan, section 6).
- **Litter:** a heritable value (founder 0) can give extra offspring per bud, up to a
tunable maximum (trial 10). They share one investment, so each is smaller. See the
mutation plan, section 9.
- **Control:** the player chooses to stay as the parent or become the bud. The cell the
player leaves becomes wildlife. The choice is one way.
This section describes a single cell. A multicellular organism's bud becomes an
internal cell instead (section 6).
## 4. Mutation split
Accepting a mutation divides a single cell. (A multicellular organism expresses an
accepted mutation directly; section 6.)
1. The mutation's cost is paid and reclaimed by the environment (mutation plan,
section 4).
2. The mutation is written into the heritable plan of **both** cells.
3. The cell divides. Body and reserve are split per channel by `split_share` (trial
50%); a rounding remainder stays with the founder. Each half starts at the size its
half of the body covers and regrows by feeding (body and maintenance plan,
section 5).
4. The **offspring expresses the mutation**. The **founder does not**: its body is
unchanged, but its plan now carries the mutation.
5. The player chooses which cell to continue as. The other becomes wildlife. (When the
mutation is Adhesion, the two stay attached instead; section 6.)
The control choice is made in the offer itself: each option has **Stay as founder**
and **Become offspring**. Nothing waits on a decision window after the birth.
| Choice | The player controls | The other cell |
| --- | --- | --- |
| Stay as founder | The unchanged body, with half the resources. Every later bud expresses the mutation. | The mutated offspring becomes wildlife: the player watches how the mutation does. |
| Become offspring | The mutated body, with half the resources, not starting from nothing. | The founder becomes wildlife with an unchanged body; its own buds are mutated. |
Consequences:
- A player who always stays as the founder accumulates mutations in their plan, but
their own body never changes. To live in a mutated body, the player must at some
point become an offspring.
- If a mutation changes how much matter the body needs, the offspring funds the
difference from its half. If it cannot, the split is refused and nothing is spent.
- Both cells inherit the founder's affinity scores.
### When a split is not possible
A split needs a minimum growth (`split_min_growth`, trial: fully grown), a free spot
touching the founder, and the region below its organism cap. If any is missing, the
option shows why and cannot be chosen; the offer stays pending until the split is
possible or the player declines.
## 5. The cell the player leaves
It becomes autonomous wildlife, as today: it feeds, buds from its own heritable plan
and dies. Wildlife earns no mutation offers.
## 6. Becoming multicellular
### The transition
- **Adhesion** is a mutation, offered after a tunable number of on-demand buds (trial
5; mutation splits do not count). A newborn that expresses Adhesion stays attached to
its parent.
- The moment a newborn attaches, the parent and newborn become **one multicellular
organism**. There is no separate colony stage.
- Accepting Adhesion is a mutation split (section 4) whose offspring expresses
Adhesion, so it attaches at once: the organism forms immediately, whichever cell the
player would have kept. The offer shows Accept and Decline only.
- The organism expresses **one genome**: the founder's heritable plan at the moment of
attachment, which now includes Adhesion. Mutations the founder held in its plan
become expressed for the whole organism. Any tissue that change requires is funded
from the combined reserve; if it cannot be funded, the split is refused and nothing
is spent.
- A member can never be detached.
### Life as a multicellular organism
- **One reserve:** every member's reserve combines into the organism's reserve.
- **Mutations affect the whole organism.** Accepting one does not split anything; it is
expressed by the organism directly, paid from the organism's reserve, and changed
tissue is funded from it. The offer shows only Accept or Decline; there is no
Stay / Become choice.
- **Budding adds an internal cell.** The bud's body is built from the organism's
reserve and becomes part of the organism. It counts toward the emergence threshold.
- **The goal changes:** the organism gathers mass and energy to emerge into the world.
- **Region cap:** a multicellular organism counts once toward the region's organism
cap, however many members it has.
- **Mass drives movement and energy.** Every member adds to the organism's mass.
Heavier organisms accelerate and turn more slowly for the same thrust, and movement
energy rises with total mass, reserve matter included. Upkeep rises with body mass
only (feeding and energy plan, section 4). The coefficients are tuned in
playtesting.
### Wildlife organisms
Because Adhesion always forms the organism at once with the player's cell, and an
organism never releases a cell, wildlife cannot currently become multicellular. As a
safeguard, a wildlife organism **cannot emerge**: it stops budding one member short of
the emergence member threshold. Wildlife earns no mutation offers.
### Death
The organism lives and dies as one body.
- **Starvation:** with one reserve, members cannot starve individually. The organism
starves when its reserve cannot pay its maintenance, and the whole organism dies.
- **Engulfment:** a predator engulfs the whole organism or none of it, judged on the
organism's total mass.
- **On death:** every member becomes a corpse and its matter returns to the region as
food, as deaths do today.
This replaces the earlier rule that a dead member is recycled to the colony: with a
combined reserve, a member cannot die on its own.
## 7. Emergence
When the organism reaches the emergence threshold, an **Emerge** button appears. It is
not a mutation and is not drawn in offers. Pressing it leaves the region and enters the
world as ADR-0177 describes: the matter is a recorded export, and the organism arrives
at a world-scaled value at a location chosen near its preferred temperature and
nutrients. Individual or bulk emergence
follows ADR-0177.
The threshold is tunable: member count, total mass and reserve energy.
## 8. Tunables
| Setting | Trial |
| --- | --- |
| `bud_min_growth` | 1000 per thousand (fully grown) |
| `bud_fee` per channel, `bud_fee_scale_percent` | 0, 0 |
| `split_min_growth` | 1000 per thousand |
| `split_share` | 50% |
| Emergence threshold: members, total mass, reserve energy | To be selected in playtesting |
| Wildlife member limit | Emergence member threshold minus 1 |
| Mass coefficients for acceleration, turning, movement and maintenance energy | To be selected in playtesting |
## 9. Open questions
None. Organism size, drag and feeding contact by member count are tuned with the mass
coefficients above.
## 10. Implementation map
| Piece | State today |
| --- | --- |
| Expressed genome and heritable plan per cell | Exists (lives format 8, rules 10-12). |
| Bud funding with a different offspring genome | Exists (`fund_offspring`, ADR-0164). |
| Funding a mutation at the current growth | Exists (`fund_mutation_at_growth`, ADR-0157). |
| Funded regrowth after a split | Exists (funded maturation, rules 9). |
| Choosing parent or child at birth | Accepted direction (ADR-0163); not built. |
| On-demand bud with a control choice and a fee | New. |
| Mutation split: even division of body and reserve | New transition; not the bud bill. |
| Offer options with Stay / Become | New wire and UI. |
| Adhesion and the multicellular transition | New. |
| Multicellular organism: one genome, one reserve, internal buds | New. |
| Mass-scaled handling and energy for the organism | Partial: movement and maintenance energy already scale with a cell's body mass; reserve mass in movement and organism-level handling are new. |
| Wildlife member limit below the emergence threshold | New safeguard. |
| Emergence | Accepted direction (ADR-0177); not built. |
Every new behaviour goes in a new rules version; regions on earlier rules keep their
meaning.