Files
aevolution/Cellular_predation_defense_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

109 lines
4.6 KiB
Markdown

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