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:
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user