Phase 2 of the cellular revamp build plan (ADR-0179), server half. - Matter as energy: when an energy cost exceeds the reserve's energy, reserve matter stands in for the rest at each channel's burn rate (pJ per 1,000 fg, scaled by the genome's burn efficiency), largest channel first. Upkeep may burn any channel; thrust only channels the player has not excluded. Burned matter adds no heat; it goes to the region's spent pool. A cell dies only when nothing can pay its upkeep. - Collection: per-channel limits scaled by the genome's collection indices, a shared limit on all matter, a tunable cost per membrane point, and only the genome's kept share (energy conversion) of bubble energy reaching the reserve. - Predation: engulf mass carries a tunable share of reserve matter, the predator's engulf capacity scales its side and the prey's membrane (now in nanometres) its own; kill absorption scales the predator's intake; the kill's remainder is split between bubbles at the prey and the spent pool, and a full habitat sends overflow to the pool. - The spent pool is owner format 11 state, counted in conservation, and drips back as seeded random bubbles every interval tick. - Reserve matter is carried as load: slower thrust and turning, costlier thrust. - Channel exclusions are a 4-bit step intent field, trace byte 14; only owned lives under rules 13 may send them. All values come from the revamp tuning file. Rules up to 12 are unchanged. Tests cover payments and their conservation over 400 seeds, the rules-13 region step (collection, membrane, kept energy, burning, engulfment and kill splits with closure), the drip, load, exclusions, a 700-tick run with closure and exact restore, and trace replay with exclusions. Session v14 and the client follow the server phases (build plan). Refreshes the DEV session window. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.5 KiB
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. Replaces the collection and fuel sections of Cellular_feeding_draft.md and the energy sections of 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:
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, the picojoules 1,000 fg of it stands in for, scaled by the cell's burn efficiency for that channel (founder 100). Matter pays at a worse rate than the energy bubbles carry, so burning matter is always the expensive way to stay alive (trial: 2,000 pJ per 1,000 fg).
- 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 (pJ per 1,000 fg) | 2,000 |
| 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.