Files
aevolution/Cellular_predation_defense_plan.md
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

4.6 KiB

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. Replaces the engulfment sections of Cellular_feeding_draft.md and the active parts of 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.

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.