Files
aevolution/Cellular_feeding_energy_plan.md
T
dingoandClaude Opus 5.5 628721dff4 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>
2026-10-22 17:49:38 -04:00

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 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.