Files
aevolution/Cellular_gameplay_plan.md
dingoandClaude Opus 5.5 0a5cf3e6bd
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 5s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 4m34s
Foundation / postgres-tools (push) Successful in 5s
Foundation / server-image (push) Successful in 5s
Foundation / image (push) Successful in 5s
docs: cellular revamp build plan and ADR-0179
ADR-0179 records the maintainer's cellular gameplay revamp (rules 13) and the
two locked-requirement questions it raises: whole-organism mutations versus
"structural changes are expressed in offspring", and what Emerge does before
the 3D world exists. The build plan stages the work in six phases (genome and
body, feeding and predation, mutation offers, reproduction, multicellular and
emergence, wildlife and the playtest), each pushed with CI green and deployed
once at the end. Refreshes the DEV session window.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 17:59:35 -04:00

107 lines
5.3 KiB
Markdown

# 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](Cellular_Revamp_Build_Plan.md),
[ADR-0179](docs/adr/0179-cellular-gameplay-revamp.md)), 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.