diff --git a/Cellular_body_maintenance_plan.md b/Cellular_body_maintenance_plan.md new file mode 100644 index 0000000..4594bcc --- /dev/null +++ b/Cellular_body_maintenance_plan.md @@ -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. diff --git a/Cellular_feeding_energy_plan.md b/Cellular_feeding_energy_plan.md new file mode 100644 index 0000000..c0474ff --- /dev/null +++ b/Cellular_feeding_energy_plan.md @@ -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. diff --git a/Cellular_gameplay_plan.md b/Cellular_gameplay_plan.md new file mode 100644 index 0000000..d160e1b --- /dev/null +++ b/Cellular_gameplay_plan.md @@ -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. diff --git a/Cellular_mutation_plan.md b/Cellular_mutation_plan.md new file mode 100644 index 0000000..d4929d6 --- /dev/null +++ b/Cellular_mutation_plan.md @@ -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..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. diff --git a/Cellular_predation_defense_plan.md b/Cellular_predation_defense_plan.md new file mode 100644 index 0000000..be91960 --- /dev/null +++ b/Cellular_predation_defense_plan.md @@ -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. diff --git a/Cellular_reproduction_plan.md b/Cellular_reproduction_plan.md new file mode 100644 index 0000000..fa415c0 --- /dev/null +++ b/Cellular_reproduction_plan.md @@ -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.