Records the maintainer's region decisions: regions linked to a world area rather than a voxel, currents and a world-derived thermal map as conditions rather than stock, capped regions, fresh-life region choice, scaled emergence and a protected logout anchor. ADR-0098, 0172 and 0173 note the amendments. Adds the movement draft decisions (fixed-point motion state, player-dropped 007 anchor) and the phased implementation plan with a Git tuning file and bubble merging. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
719 lines
47 KiB
Markdown
719 lines
47 KiB
Markdown
# Cellular movement draft
|
|
|
|
Status: discussion draft, 2026-10-21. This is the focused movement review for
|
|
draft mutations 001-010. It documents verified source behavior separately from
|
|
planned changes and proposed replacement adaptations. No code, runtime rule,
|
|
public contract, live region, or deployment changes are made here. No commit or
|
|
push is authorized during the maintainer's draft review.
|
|
|
|
Companions:
|
|
|
|
- [Cellular mutation draft](Cellular_mutation_draft.md): overall selection,
|
|
expression, reproduction, and the 150-entry catalog index.
|
|
- [Cellular region changes](Cellular_Region_Changes.md): procedural currents,
|
|
thermal conditions, food disturbance, presentation, and region ownership.
|
|
|
|
### Maintainer decisions, 2026-10-21
|
|
|
|
| Topic | Decision |
|
|
| --- | --- |
|
|
| Scope | 001-010 are the cellular movement mutation options. All ten stay in the first implementation; options that do not fit in play are removed afterwards. |
|
|
| Drag and top speed | Accepted: lowering passive drag (008) also raises top speed, because top speed is thrust divided by drag. |
|
|
| Precision | Fixed-point motion state, as specified in [Numeric representation](#numeric-representation). |
|
|
| Scale | Currents start at 0.3x-1.5x founder swimming speed, so the strongest cannot be swum against. Region size is chosen with founder speed and current speed together. |
|
|
| Client prediction | The client runs the same motion step and flow field as the server. |
|
|
| Energy exhaustion | Unchanged: a cell that cannot pay maintenance dies and its corpse becomes food bubbles at its death location. Thrust that cannot be funded in a tick is not applied; the cell coasts and drifts. |
|
|
| 007 anchor | Player-triggered, like a boat anchor: the anchor drops and the point it hits becomes where the cell stays. It needs no prepared surface. |
|
|
| Logout anchor | A lifecycle state ([ADR-0177](docs/adr/0177-cellular-regions-world-linkage.md)), not the 007 mechanic. |
|
|
| Offer volume | Edits are percentage-based +/- steps off the fixed base, offered three at a time from a large catalog. No per-axis cap is needed now: extreme movement investment is limited by its own energy cost. |
|
|
|
|
## 1. How movement currently works
|
|
|
|
This section describes the inspected repository implementation, not a claim
|
|
about which version is currently deployed or how the proposed liquid controls
|
|
already feel in play. Test descriptions below refer to inspected test source;
|
|
the tests were not executed for this documentation change.
|
|
|
|
### Authoritative motion and input
|
|
|
|
The motion API is in
|
|
[cellular_motion.hpp](include/evo/biology/cellular_motion.hpp), implemented in
|
|
[cellular_motion.cpp](src/biology/cellular_motion.cpp). Its historical design is
|
|
[ADR-0102](docs/adr/0102-cellular-spatial-trial.md).
|
|
|
|
- A tick is 50 ms. The cellular motion resolver accepts per-second budgets and
|
|
converts them to that tick duration.
|
|
- A movement intention is an X/Y direction-and-magnitude vector. Each component
|
|
is between -1000 and 1000, and its squared length cannot exceed 1,000,000.
|
|
It does not authorize a client-supplied position or speed.
|
|
- Maximum per-tick travel is the current phenotype's movement speed multiplied
|
|
by the tick duration, rounded down to integer micrometres.
|
|
- Each axis displacement is the intention component times that maximum step,
|
|
divided by 1000 with integer truncation. The resulting position is clamped
|
|
to keep the square body footprint inside the declared rectangular area.
|
|
- The position identifies the lower-left footprint corner. This helper permits
|
|
areas up to 1,000,000 micrometres per axis; that bound is not a selected new
|
|
region size or a planetary layout.
|
|
- There is no stored velocity, acceleration, facing/turn-rate limit, passive
|
|
deceleration, coasting, active braking, or local-flow input in this resolver.
|
|
Releasing input immediately requests zero displacement. Reversing requests the
|
|
other direction on the next tick without an acceleration/braking transition.
|
|
- Bounds clamp position; there is no wraparound. The square-footprint contact
|
|
helper counts an exact edge touch. It is not a liquid obstacle/pushing solver.
|
|
|
|
### Current movement energy
|
|
|
|
The resolver derives a full-speed tick cost from the metabolic budget, rounded
|
|
up, then scales it by actual bounded travel. Conceptually:
|
|
|
|
`movement E = ceil(full-speed tick E * conservative travelled distance / maximum tick distance)`
|
|
|
|
Travel distance is the integer ceiling of the Euclidean distance between the
|
|
old and final clamped position. A zero-distance move costs zero movement E.
|
|
This means pressing against the region boundary with no resulting displacement
|
|
does not pay an active station-keeping cost under the current model.
|
|
|
|
The funded helper either transfers the entire movement cost from reserve E to
|
|
heat in its detached candidate or refuses the move. It does not apply a reduced
|
|
affordable fraction of a requested move. Reserve matter channels are not consumed
|
|
by that movement transfer. Basal maintenance remains a separate charge.
|
|
|
|
The composed step in [cellular_step.cpp](src/biology/cellular_step.cpp) charges
|
|
maintenance before movement, then handles applicable intake. Underfunded movement
|
|
leaves the cell in place while the step can continue; later food cannot retroactively
|
|
fund earlier movement. See
|
|
[ADR-0104](docs/adr/0104-cellular-single-life-tick-order.md). Later region/deposit
|
|
rules extend feeding and lifecycle behavior; this motion helper is not by itself
|
|
the complete ecology, collision, or publication contract.
|
|
|
|
### Current founder, size, and other traits
|
|
|
|
The inspected [founder parameters](include/evo/biology/founder.hpp) specify
|
|
**200 micrometres/second** movement for an ordinary primitive founder. With no
|
|
speed-reducing producer trait, that permits a maximum 10-micrometre step per
|
|
50 ms tick. This is an existing tunable, not acceptance of the future founder
|
|
speed or proof that the three-minute first-birth target is met.
|
|
|
|
[Development](src/biology/development.cpp) reads the movement capability as a
|
|
speed, not as thrust or a set of acceleration/steering properties. An absent
|
|
capability yields zero speed. Ordinary growth-size changes do not independently
|
|
scale speed in the inspected derivation. The
|
|
[metabolic budget](src/biology/metabolism.cpp) makes full-speed movement demand
|
|
depend on total mass and phenotype speed, with versioned integer coefficients
|
|
and rounding. Mass and membrane changes can therefore change movement cost
|
|
without changing the basic movement-speed parameter.
|
|
|
|
Under that approximately linear mass-and-speed budget, increasing the speed
|
|
parameter raises full-speed E/time but does not independently create a less
|
|
efficient E/distance motor, apart from integer rounding. The simple derivation
|
|
also does not build extra propulsion tissue merely because movement is acquired
|
|
or raised. Real machinery investment and independent efficiency/output properties
|
|
are planned extensions, not existing costs to describe as already implemented.
|
|
|
|
Development version 5 adds photosynthetic organelle mass/upkeep and reduces
|
|
movement speed according to the existing producer rule: at efficiency p per
|
|
thousand, retained speed is `(1000 - p/2) / 1000`, with integer arithmetic.
|
|
See [ADR-0175](docs/adr/0175-photosynthesis-producers.md). This is a versioned
|
|
existing coupling, not the new general body-drag model.
|
|
|
|
[Mutation implementation](src/biology/mutation.cpp) currently offers generic
|
|
adjust-up/down/acquire/shed operations over capability records. Schemas 4 and 5
|
|
use a step of one tenth of the current parameter, at least one. These are not
|
|
the proposed compound movement adaptations below, and their runtime operator IDs
|
|
must not be confused with this document's draft IDs.
|
|
|
|
### Source checks inspected
|
|
|
|
| Test source | Behavior specified by the existing checks |
|
|
| --- | --- |
|
|
| [cellular_motion_tests.cpp](tests/cellular_motion_tests.cpp) | Full/partial/diagonal movement, zero input, boundary clamping, invalid vectors, low-speed quantization, funded refusal, heat transfer, and footprint contact. |
|
|
| [cellular_step_tests.cpp](tests/cellular_step_tests.cpp) | Maintenance before movement/intake and conservation of the composed candidate. |
|
|
| [development_tests.cpp](tests/development_tests.cpp) | Zero speed without capability and unchanged speed under ordinary size changes in the tested derivation. |
|
|
| [metabolism_tests.cpp](tests/metabolism_tests.cpp) | Derived movement budgets, founder values, and membrane/mass relationships. |
|
|
| [photosynthesis_tests.cpp](tests/photosynthesis_tests.cpp) | Producer tissue costs and the version-5 speed reduction. |
|
|
| [mutation_tests.cpp](tests/mutation_tests.cpp) | Versioned capability operations, prerequisites, and mutation adjustment behavior. |
|
|
|
|
These existing checks are useful baselines; they do not validate liquid flows,
|
|
propulsion controls, thermal changes, or the proposed ten movement adaptations.
|
|
|
|
## 2. Planned movement model
|
|
|
|
### Liquid-relative propulsion and world travel
|
|
|
|
Cells propel themselves through liquid while procedural currents carry both
|
|
cells and loose food. The region design specifies 2-n currents with individual
|
|
directions/speeds, possible intersections, quiet areas, and circulating routes.
|
|
The bounded maximum n, flow combinations, and speed ranges remain trial values.
|
|
|
|
`world velocity = local liquid velocity + swimming velocity relative to liquid`
|
|
|
|
This is a conceptual decomposition, not a finalized integrator or repeated
|
|
unbounded acceleration. At comparable propulsion output, travelling with flow
|
|
increases world progress, travelling against it decreases progress, and zero
|
|
ambient flow gives ordinary swimming for the current body/conditions. Cross-flow
|
|
deflects travel; a strong current can prevent upstream progress.
|
|
|
|
Do not apply an additional same-direction speed bonus after adding current.
|
|
Passive drift does not consume propulsion E, but ordinary maintenance and any
|
|
thermal survival cost continue. A cell drifting beside a bubble at the same speed
|
|
still needs relative motion or useful contact to collect it.
|
|
|
|
### Acceleration, slowing, and controls
|
|
|
|
| Behavior | Planned response | Resource consequence |
|
|
| --- | --- | --- |
|
|
| Propel | Accelerate relative to liquid toward the requested direction within available output/steering limits. | Fund actual output; extra machinery can have construction/upkeep costs. |
|
|
| Release propulsion | Passive resistance reduces relative swimming velocity; world drift can continue. | No active propulsion expenditure; dissipation does not refill usable E. |
|
|
| Brake/reverse | Opposing propulsion changes swimming velocity faster than passive slowing alone. | Fund actual braking/reverse output. |
|
|
| Hold world position | Counter local flow rather than treating no input as a free stop. | Sustained funded output while resisting current. |
|
|
| Anchor (007) | Player drops the anchor; the cell holds at the point it hits until released. | Anchor construction, drop/release, and any supported maintenance costs. |
|
|
| Move an attached group | Useful member propulsion moves the whole arrangement against its combined resistance/load. | No free member-count speed multiplier or duplicate charging of shared work. |
|
|
|
|
Start founders with responsive handling. Exact controls for automatic/manual
|
|
braking, reverse thrust, turning at speed, and steering assistance remain open.
|
|
Do not impose long uncontrollable coasting just to demonstrate acceleration.
|
|
|
|
Passive deceleration has a two-sided consequence: stronger slowing improves
|
|
precise stops but sacrifices coasting; weaker slowing preserves motion but makes
|
|
overshooting more likely. Active braking can address that weakness, at its actual
|
|
machinery/output cost. Stopping relative to liquid is not stopping relative to
|
|
the region.
|
|
|
|
### Numeric representation
|
|
|
|
Biology stays integer-only and deterministic; server and client run the same code.
|
|
|
|
| State | Representation | Notes |
|
|
| --- | --- | --- |
|
|
| Position | Existing integer micrometres plus a per-cell sub-micrometre accumulator. | Public position and contact keep whole micrometres. |
|
|
| Velocity relative to liquid | Signed 32-bit, 1/1024 micrometre per second (Q10). | About 1 nm/s resolution; far beyond any trial speed range. |
|
|
| Heading | Unsigned 16-bit angle, 65,536 steps per turn. | Turn rate limits heading change per tick. |
|
|
| Direction vectors | Checked-in integer sine/cosine table (Q14). | Golden-tested; no floating point or platform math. |
|
|
| Flow sample | Q10 velocity grid at a fixed pitch, bilinear integer interpolation. | Rounds toward zero; seeded and versioned. |
|
|
|
|
Per tick:
|
|
|
|
1. Turn: move heading toward the intent direction by at most the turn rate.
|
|
2. Thrust: add funded acceleration along heading (reverse thrust for braking).
|
|
3. Drag: `v -= trunc(v * drag_ppm_per_tick / 1,000,000)`, rounding toward zero so
|
|
speed decays to exactly zero; a speed below a small threshold snaps to zero.
|
|
4. World velocity: add the flow sample at the cell's position.
|
|
5. Displacement: `acc += v_world * tick_us`; whole micrometres are
|
|
`floor(acc / (1024 * 1,000,000))`, carried into position, with the remainder kept
|
|
in `acc`. There is no rounding drift across ticks.
|
|
6. Contact: sweep the path against food and cells, subdividing so no step exceeds
|
|
half the smallest contact radius, with a fixed per-tick work bound.
|
|
|
|
All arithmetic is 64-bit with overflow checks. The motion state (velocity,
|
|
heading, accumulator) is persisted with the cell so restore and replay continue
|
|
exactly.
|
|
|
|
### Derive one profile from the current organism
|
|
|
|
Use propulsion capacity, efficiency, steering arrangement, body shape, mass,
|
|
and resistance as contributors. Derive a consistent resulting movement profile.
|
|
Do not independently assign unrelated percentage changes to every output merely
|
|
to manufacture a pro/con pair.
|
|
|
|
| Displayed comparison | Definition | Founder reference |
|
|
| --- | --- | --- |
|
|
| Maximum swimming speed | Supported speed relative to liquid under reference conditions. | 100%. |
|
|
| Propulsion energy cost | E/distance at a stated reference speed; also show E/time at actual output when useful. | 100%; lower is cheaper. |
|
|
| Acceleration | Rate of increasing relative swimming velocity. | 100%. |
|
|
| Passive deceleration | Rate of losing swimming velocity without propulsion. | 100%; faster stopping also reduces coasting. |
|
|
| Active braking | Available opposing propulsion response. | 100% for ordinary supported founder braking, not possession of specialized 006 machinery. |
|
|
| Turning control | Ability/rate to redirect movement at a stated reference speed. | 100%. |
|
|
|
|
Percentages compare against a fixed founder at stated body/growth/environment
|
|
conditions; they do not reset after every mutation. Store actual quantities and
|
|
derive the display. An absent burst or anchor is absent, not 100%. Every fresh
|
|
primitive life has the same baseline biology regardless of account age.
|
|
|
|
The future founder's absolute values and mutation magnitudes require playtesting.
|
|
The numeric trial map below supplies starting steps for review, not qualified
|
|
balance. Do not automatically carry forward the existing 200-micrometre/second
|
|
speed or generic ten-percent mutation step as a selected propulsion rule.
|
|
Keep previews at matched conditions, then explain actual newborn size, reserves,
|
|
flow, and temperature separately. Thermal cost uses current cell, preferred cell,
|
|
and environment temperatures as recorded in the region draft; it is not an
|
|
automatic multiplier on every movement cost.
|
|
|
|
### Combining one to many adaptations
|
|
|
|
Mutation changes the current body/offspring plan. The history remains an archive,
|
|
not a stack of named buff cards applied indefinitely.
|
|
|
|
| Combination | Useful resulting strategy | Cost or limit that remains |
|
|
| --- | --- | --- |
|
|
| 001 strong propulsion + 004 agile steering | Fast, responsive interception. | Actual machinery, operating demand, and capacity allocation. |
|
|
| 002 economical propulsion + 005 straight swimmer | Efficient sustained directional travel. | Reduced pursuit output and close turning. |
|
|
| 006 active braking + 008 coasting-biased body | Coast between targets, then brake deliberately. | Dedicated brake structure/output; overshooting if braking is delayed or unfunded. |
|
|
| 001 strong + 002 economical propulsion | Potentially a balanced power/economy design. | Valid only if output and efficiency are genuinely separate properties; opposite edits to one property are not two permanent bonuses. |
|
|
| 004 agile steering + 005 straight swimmer | Intermediate or mixed arrangement. | Recalculate one body geometry; do not keep mutually contradictory shape bonuses. |
|
|
| 009 shed propulsion + a supported propelling group | Nonpropelling specialist carried by others. | Donors supply force; group still carries its mass and needs viable material/E supply. |
|
|
|
|
Resistance is counted once. In particular, 005 changes directional streamlining
|
|
and 008 changes passive/coasting response; if the chosen body model cannot express
|
|
them as distinct changes, merge/revise them rather than applying the same drag
|
|
reduction twice. Bound changes, reject no-op candidates, and preview the complete
|
|
combined outcome and construction requirements.
|
|
|
|
### Frequent offers and percentage-step convention
|
|
|
|
The maintainer wants frequent opportunities to tweak the organism while playing.
|
|
Propose a small-tuning offer approximately every **20-30 seconds of productive
|
|
active play**, including an early first offer in that range, rather than the
|
|
earlier 60-90-second interval. These timing values are trial targets, not a
|
|
wall-clock entitlement or a selected activity-credit formula. Do not gate basic
|
|
reproduction on getting any particular offer.
|
|
|
|
Keep one pending offer rather than an accumulating queue of forced menus. Existing
|
|
earned opportunities remain available; no immediate free reroll follows a decline.
|
|
The first three minutes could therefore contain several small plan decisions
|
|
without demanding a separate division for every decision. Structural changes still
|
|
develop through funded offspring. Evolve now requires a viable division/succession;
|
|
Prepare offspring can accumulate edits to the next plan. Frequent offers do not
|
|
authorize free live reconstruction or automatic mutation of an offline cell.
|
|
|
|
For the initial movement experiment, use **percentage points of a fixed reference**
|
|
for parameter edits, not a percentage of the current value:
|
|
|
|
- An ordinary tuning step adds or removes 5 reference points on its primary axis.
|
|
- A paired specialization tradeoff initially moves 2 reference points on the
|
|
specified competing axis, where the proposed tissue arrangement supports it.
|
|
- 100 -> 105 -> 110 is two +5-point edits. It is not 100 -> 105 -> 110.25.
|
|
- These are changes to underlying normalized parameters, not promises that every
|
|
derived final speed/acceleration value changes by those same points.
|
|
- No amount or step may bypass a parameter's physical/recipe bounds. Reject or
|
|
clearly preview a bounded partial step; never advertise a full change then silently
|
|
truncate it. Bounds and rounding remain to be specified before implementation.
|
|
- Acquisition and complete shedding are structural cases, not a +5/-5 edit to
|
|
an absent trait. They need a real developed module/removal and explicit funding.
|
|
|
|
The same reference remains valid across successive mutations and one-way succession.
|
|
Compare equal body/environment conditions; temporary low reserves, small newborn
|
|
size, flow, thermal stress, and damage do not redefine inherited parameter values.
|
|
|
|
### Initial numeric map for movement adaptations
|
|
|
|
This is a **proposed first trial matrix**. Each row names an underlying arrangement,
|
|
its primary improvement, and its competing change. Values do not create independent
|
|
RPG buffs: development must realize the arrangement with actual tissue, supported
|
|
geometry, costs, and a consistent movement model. If the proposed pair cannot be
|
|
realized meaningfully, revise it instead of inventing a flat penalty.
|
|
|
|
| ID | Primary parameter and proposed change per tuning selection | Competing change or numeric consequence | Meaning of a positive direction |
|
|
| --- | --- | --- | --- |
|
|
| 001 | Propulsion-output capacity +5 points. | Propulsion-efficiency index -2 points for the proposed high-output arrangement; additional tissue funded where needed. | More available useful output. |
|
|
| 002 | Propulsion-efficiency index +5 points. | Propulsion-output capacity -2 points in the economical arrangement. | More useful propulsion work per E, not a higher displayed E cost. |
|
|
| 003 | Burst-output capacity +5 points after acquisition. | Sustained-output allocation -2 points at comparable investment; actual burst E is spent and replenished. | More supported short-term output. |
|
|
| 004 | Steering-authority allocation +5 points. | Forward-output allocation -2 points at comparable investment. | More useful redirection authority. |
|
|
| 005 | Axial streamlining index +5 points. | Steering-authority allocation -2 points for that directional arrangement. | Less resistance along the chosen body axis. |
|
|
| 006 | Opposing/braking-output allocation +5 points beyond ordinary supported braking. | Forward-output allocation -2 points at comparable investment; active braking still spends E. | More supported opposing output. |
|
|
| 007 | Anchor holding capacity +5 points after acquisition. | Holding-tissue investment +5% of its reference module recipe; no arbitrary whole-body speed penalty. | More supported attachment load. |
|
|
| 008 | Coasting-response time index +5 points. | Passive slowing rate changes reciprocally in the candidate response model: 100/105 of baseline at index 105, about 95.24%. No second drag debit. | Longer preservation of swimming velocity, with slower passive stops. |
|
|
| 009 | Remove independent propulsion: its available output becomes 0. | Avoid that module's future construction/upkeep, not 100% of total maintenance; lose independent swimming/braking. | Reacquisition is a separate funded positive change, not +5 to an absent motor. |
|
|
| 010 | Dedicated colony-drive capacity +5 points after acquisition. | Dedicated propulsion-tissue investment +5% of its reference module recipe; extra mass and donor operating costs are derived. | More useful group-driving capacity. |
|
|
|
|
The paired 5/2 values are deliberately modest starting proposals for frequent
|
|
offers. Construction, upkeep, drag, total mass, final speed, and E/time are derived
|
|
from the resulting recipe; they are not also assigned all the table's percentages.
|
|
Efficiency is normalized useful work per E, with a physically valid actual range;
|
|
an index above 100 does not mean conversion efficiency above 100%.
|
|
|
|
For a module absent in the founder, a provisional acquisition reference of 100
|
|
means the performance of its explicit first module recipe, not that the founder
|
|
already owns it. Its initial construction and any displacement of other tissue
|
|
must be previewed; acquisition does not provide free mass. Repeated 007/010 scaling
|
|
uses that same module reference, without increasing all whole-body costs by 5%.
|
|
The initial burst recipe/capacity, anchor recipe, and colony-drive recipe still need
|
|
definition before those acquisition options can be offered.
|
|
|
|
For 008, reciprocal slowing is one candidate lumped response: increasing a decay
|
|
time by 5% reduces the corresponding decay rate to approximately 95.24%, not 95%.
|
|
This illustrates why coasting and passive deceleration cannot be assigned unrelated
|
|
percentages. It does not select the full velocity integrator or add usable E.
|
|
|
|
Example of composable edits: starting at output 100 and efficiency 100, one 001
|
|
selection proposes output 105 / efficiency 98. A subsequent 002 selection would
|
|
produce output 103 / efficiency 103 before bounds and physical derivation. This
|
|
does not erase the funded machinery or any construction/upkeep its final recipe
|
|
requires. Show the complete combined result, not only the primary green number.
|
|
|
|
### Decreasing a movement trait
|
|
|
|
A supported lower-investment variant should also have a reason to choose it.
|
|
Use the following inverse steps as trial proposals, without creating another ten
|
|
catalog IDs. They are directional variants of the reviewed adaptations, not a
|
|
requirement to offer every inverse in every context.
|
|
|
|
| ID | Proposed lower-primary variant | Benefit in return | Lost capacity |
|
|
| --- | --- | --- | --- |
|
|
| 001 | Output capacity -5 points. | Efficiency index +2 points in the inverse arrangement. | Maximum useful output. |
|
|
| 002 | Efficiency index -5 points. | Output capacity +2 points in the higher-throughput arrangement. | Work obtained per E. |
|
|
| 003 | Burst capacity -5 points. | Sustained-output allocation +2 points. | Short escape/interception output. |
|
|
| 004 | Steering authority -5 points. | Forward-output allocation +2 points. | Close maneuvering. |
|
|
| 005 | Axial streamlining -5 points. | Steering authority +2 points in the less directional arrangement. | Long-axis swimming economy. |
|
|
| 006 | Braking allocation -5 points. | Forward-output allocation +2 points. | Rapid stopping/reversal. |
|
|
| 007 | Anchor holding capacity -5 points, within a viable module. | Holding-tissue recipe investment -5% of reference. | Maximum supported attachment load. |
|
|
| 008 | Coasting-response time -5 points. | Faster passive stopping; at index 95 the candidate slowing rate is 100/95 of baseline, about 105.26%. | Preserved motion between propulsion intervals. |
|
|
| 009 | Full shedding is already the loss direction. | Avoid future propulsion-module investment. | All independent propulsion; restoration needs an explicit viable reacquisition recipe. |
|
|
| 010 | Dedicated group-drive capacity -5 points, within a viable module. | Dedicated propulsion-tissue investment -5% of reference. | Supported group-driving output. |
|
|
|
|
Inverse edits affect the next developed recipe; they do not refund the unchanged
|
|
parent's existing tissue. Partial reduction cannot cross a capability's minimum
|
|
supported recipe or accidentally become complete removal. A lower-primary variant
|
|
must have the stated benefit in the physical model; otherwise exclude it rather
|
|
than offering a plain detrimental decrease.
|
|
|
|
### Below-baseline traits and positive-offer weighting
|
|
|
|
The maintainer's direction is that **the further into the negative a trait goes,
|
|
the less likely a positive mutation for that trait should be offered**. Interpret
|
|
this draft's negative position as a net reduction of the relevant inherited
|
|
capacity/investment index below its fixed 100 reference. "Positive" here means
|
|
increasing that option's named primary axis, not a mutation with no drawbacks.
|
|
For example, output 70 is -30 reference points; output 90 is -10. Merely falling
|
|
from output 150 to 120 is not yet below the founder baseline.
|
|
|
|
Use the primary underlying axis rather than the color/sign of every displayed
|
|
result. Lower E/distance can be an improvement: an economical motor must not be
|
|
classified as genetically negative merely because its displayed energy cost is
|
|
80%. Coasting likewise has a useful positive axis and a stopping disadvantage.
|
|
|
|
Propose a persistent **recovery weight factor** for a positive movement candidate:
|
|
|
|
`recovery = max(0.10, (index / 100)^2)` when `0 <= index < 100`; otherwise `1`.
|
|
|
|
| Inherited primary index | Offset from reference | Relative weight for its positive-direction candidate |
|
|
| --- | --- | --- |
|
|
| 100 or higher | At/above reference. | 100% of otherwise applicable weight. |
|
|
| 95 | -5 points. | 90.25%. |
|
|
| 90 | -10 points. | 81%. |
|
|
| 80 | -20 points. | 64%. |
|
|
| 70 | -30 points. | 49%. |
|
|
| 60 | -40 points. | 36%. |
|
|
| 50 | -50 points. | 25%. |
|
|
| 40 | -60 points. | 16%. |
|
|
| 30 or lower | -70 points or more. | 10% floor. |
|
|
|
|
These are **relative sampling weights, not the probability of seeing an option
|
|
in a whole offer**. Actual appearance depends on all eligible candidates, their
|
|
weights, the number of slots, and sampling without replacement. If there are only
|
|
three eligible candidates and three slots, all three appear regardless of weights;
|
|
do not present the table as an appearance guarantee in that situation.
|
|
|
|
Apply the factor to that candidate's primary beneficial axis after checking hard
|
|
eligibility and alongside the master draft's behavior/context/preference weights.
|
|
Do not suppress every positive movement candidate because one trait is low.
|
|
Its paired drawback is not a second multiplicative suppression. Net inherited
|
|
reductions count regardless of which adaptation produced them, not the number
|
|
of historical "negative clicks". Do not impose an extra probability reduction
|
|
merely for being above 100; any upper-bound or advanced-body rule needs separate review.
|
|
|
|
The factor follows the inherited plan through succession and changes when the
|
|
underlying index changes; it does not expire after several offers. This differs
|
|
from transient decline preferences, which still decay. It applies to mutation
|
|
opportunities for the offspring plan, not temporary performance lost to current,
|
|
temperature, energy starvation, growth, or damage.
|
|
|
|
Complete loss requires a distinct acquisition option. First acquisition of a
|
|
capability the founder never had is not automatically penalized as a below-baseline
|
|
defect. Reacquiring a deliberately shed propulsion module can use the proposed
|
|
10% floor, subject to a viable supported recipe; no requirement to swim first may
|
|
make a nonpropelling lineage permanently ineligible. Ordinary and alternate viable
|
|
strategies must remain available. This does not guarantee a recovery option on
|
|
the next offer, reset a body, refund its costs, or grant a free reroll.
|
|
|
|
Both the quadratic shape and 10% floor are initial tuning proposals, not accepted
|
|
probabilities. The intended consequence is commitment that becomes harder to
|
|
reverse, without a permanent hidden class lock. Preview that consequence alongside
|
|
large reductions and removal. Frequent offers are important here: a low recovery
|
|
weight must not produce an unusable session-length wait or invalidate the overall
|
|
30-60-minute cellular pacing target. Measure the long tail, not only average draws.
|
|
|
|
## 3. Revised movement mutations 001-010
|
|
|
|
These ten draft entries are **proposals for review**, not ten approved mechanics
|
|
or mandatory movement unlocks. Changes to 006 and 008 below are proposed replacements
|
|
for options that lacked a distinct movement purpose. The numeric matrix above
|
|
provides trial percentage steps; no price, final derived movement equation, or
|
|
qualified balance is selected. IDs are discussion references, not runtime operator IDs.
|
|
|
|
| ID | Movement candidate | Review disposition |
|
|
| --- | --- | --- |
|
|
| 001 | Strong propulsion | Core candidate; increases available output with real costs. |
|
|
| 002 | Economical propulsion | Core candidate; economy versus peak output. |
|
|
| 003 | Burst propulsion | Conditional on a funded, bounded burst mechanism. |
|
|
| 004 | Agile steering | Core candidate; steering allocation versus forward output. |
|
|
| 005 | Straight swimmer | Core candidate; directional streamlining versus maneuverability. |
|
|
| 006 | Active braking propulsion | Proposed replacement for Current sail. |
|
|
| 007 | Anchor | Core candidate; player-triggered, holds the cell where the anchor hits. |
|
|
| 008 | Coasting-biased body | Proposed movement replacement for Food-gradient sensing. |
|
|
| 009 | Shed independent propulsion | Only for an actually supported stationary/carried role. |
|
|
| 010 | Specialized colony propulsion | Only if it adds machinery beyond ordinary member propulsion. |
|
|
|
|
### Tentative visual indicators
|
|
|
|
The maintainer proposed the following starting ideas for recognizing movement
|
|
adaptations on the cell. They are **visual concepts for review, not strong shape
|
|
definitions, accepted anatomy, or proof of a particular movement equation**.
|
|
"Limbs" here means visible cellular appendages; it does not require macroscopic
|
|
limbs or introduce a fixed species/body class.
|
|
|
|
| ID | Initial visual idea | Intended readability |
|
|
| --- | --- | --- |
|
|
| 001 | More limbs, thicker limbs, or a combination. | A visibly stronger propulsion arrangement. |
|
|
| 002 | Longer limbs. | A distinct economical-propulsion form. |
|
|
| 003 | Shorter limbs. | A distinct burst-propulsion form. |
|
|
| 004 | Additional limbs along the cell's sides. | More lateral steering structures. |
|
|
| 005 | Small limbs at the cell's front. | A recognizable forward-oriented arrangement. |
|
|
| 006 | A hook-shaped limb at the back. | A recognizable braking/reversing structure. |
|
|
|
|
Front, back, and sides refer to the cell's body orientation, not compass direction
|
|
or the current's flow direction. Visuals for 007-010 remain open; do not fill them
|
|
with arbitrary anatomy just to complete the table.
|
|
|
|
Frequent percentage steps should produce readable gradual changes where practical;
|
|
each +5-point selection does not have to add a whole limb. Continuous thickness,
|
|
length, or arrangement changes and later count thresholds are possible approaches,
|
|
not selected rules. Preview the difference at useful viewing scale without promising
|
|
an exact one-to-one mapping from a numeric point to an appendage.
|
|
|
|
When adaptations combine, render one coherent resulting body. In particular, 002's
|
|
longer-limb idea and 003's shorter-limb idea need a combined design: perhaps different
|
|
appendage roles or a resulting intermediate arrangement. Neither approach is selected
|
|
here. Opposing edits must not leave contradictory cosmetic layers or continually
|
|
accumulate disconnected limbs.
|
|
|
|
Tie any eventual physical appendage choice to the developed body's actual capacity,
|
|
mass, and construction recipe. These concept sketches do not add a new fee or assert
|
|
that the proposed shapes already provide their intended mechanical advantages.
|
|
Structural changes appear on the offspring that develops them, including immediate
|
|
succession's new organism; an unchanged parent keeps its existing appearance.
|
|
Apply the same biological visual rules to NPCs and players, with a before/after
|
|
preview for the player considering a mutation.
|
|
|
|
### 001: Strong propulsion
|
|
|
|
- **Mechanism:** enlarge/support propulsion machinery to increase usable output.
|
|
Speed, acceleration, braking, body load, and E demand follow from that body.
|
|
- **Reason to choose:** cross currents, intercept food/prey, or escape faster.
|
|
- **Drawback:** additional construction/upkeep and greater E demand when high
|
|
output is used. Slow travel does not always pay maximum operating cost.
|
|
- **Available when:** enlargement changes actual capacity and its physical costs
|
|
are modeled; no fixed number of prior movement mutations is required.
|
|
- **Increases chance:** productive long routes, relevant pursuits, useful current
|
|
crossings where output is limiting.
|
|
- **Decreases chance:** reliable local feeding, little propulsion use, or construction
|
|
already being the dominant shortage.
|
|
|
|
### 002: Economical propulsion
|
|
|
|
- **Mechanism:** configure machinery for efficient sustained swimming at lower
|
|
maximum output; explicitly define efficiency rather than granting a flat discount.
|
|
- **Reason to choose:** reach more food per unit of propulsion E and sustain routes.
|
|
- **Drawback:** weaker pursuit, rapid escape, and upstream performance.
|
|
- **Available when:** output/efficiency tradeoff actually works. It does not require
|
|
first becoming inefficient or approaching starvation.
|
|
- **Increases chance:** propulsion consumes a large share of acquired E during useful
|
|
travel; repeated ordinary routes do not need maximum output.
|
|
- **Decreases chance:** repeated peak-output pursuits or necessary strong-current
|
|
crossings; abundant E makes economy less useful.
|
|
|
|
### 003: Burst propulsion
|
|
|
|
- **Mechanism:** support a short high-output interval using a defined reserve and
|
|
machinery capacity. Recovery means funded replenishment, not free timed refilling.
|
|
- **Reason to choose:** briefly escape a current/predator or intercept a moving cluster.
|
|
- **Drawback:** burst machinery occupies tissue/resources and high output drains the
|
|
available reserve rapidly; lower sustained performance than a sustained-output
|
|
arrangement at comparable construction investment.
|
|
- **Available when:** the burst capacity, cost, exhaustion, and replenishment work.
|
|
- **Increases chance:** short useful escapes/interceptions where ordinary output
|
|
falls short; observed opportunities, not deliberate repeated failed input.
|
|
- **Decreases chance:** long uninterrupted swimming or lack of E to replenish bursts.
|
|
|
|
### 004: Agile steering
|
|
|
|
- **Mechanism:** allocate more machinery/geometry to redirecting useful propulsion.
|
|
- **Reason to choose:** navigate current intersections, track drifting food, and
|
|
change course around supported obstacles or organisms.
|
|
- **Drawback:** at comparable investment, less machinery is available for sustained
|
|
forward propulsion. Turning is not an independent free speed multiplier.
|
|
- **Available when:** heading/force redirection has real movement consequences.
|
|
- **Increases chance:** frequent productive turns and close interceptions.
|
|
- **Decreases chance:** mainly straight travel with little need to redirect.
|
|
|
|
### 005: Straight swimmer
|
|
|
|
- **Mechanism:** streamline geometry/propulsion along the main travel axis.
|
|
- **Reason to choose:** reduce directional resistance on long routes.
|
|
- **Drawback:** poorer tight turning or lateral maneuvering; route commitment matters.
|
|
- **Available when:** direction-dependent geometry/resistance and turning work.
|
|
- **Increases chance:** sustained directional foraging, pursuit, or useful current routes.
|
|
- **Decreases chance:** dense turning/interception demands and frequent route reversal.
|
|
- **Combination note:** ordinary drift is already free of propulsion expenditure;
|
|
this must improve relative swimming, not duplicate a with-flow bonus.
|
|
|
|
### 006: Active braking propulsion
|
|
|
|
- **Mechanism:** allocate machinery to useful opposing/reverse output beyond the
|
|
founder's ordinary braking capacity. It changes relative velocity, not ambient flow.
|
|
- **Reason to choose:** stop near food, recover from overshooting, and reverse swimming
|
|
quickly without waiting for passive slowing.
|
|
- **Drawback:** additional or reallocated machinery reduces another capacity at matched
|
|
investment, and using stronger braking consumes E. The exact forward-output versus
|
|
construction tradeoff must be selected and measured before offering it.
|
|
- **Available when:** active braking works and improved capacity changes outcomes.
|
|
- **Increases chance:** productive routes with repeated stopping/reversal demands or
|
|
overshooting despite useful collection opportunities.
|
|
- **Decreases chance:** long uninterrupted travel, sufficient ordinary braking, or a
|
|
viable anchored strategy that seldom moves.
|
|
- **Restriction:** braking to zero relative speed leaves world drift; it is not free
|
|
station keeping. Current sail is archived below, not quietly treated as approved.
|
|
|
|
### 007: Anchor
|
|
|
|
- **Mechanism:** the player triggers the anchor, like dropping a boat anchor. The
|
|
point it hits becomes the location the cell holds until the player releases it.
|
|
No prepared surface is required.
|
|
- **Reason to choose:** stay at a productive fixed site without continuously swimming
|
|
against the current.
|
|
- **Drawback:** anchor construction investment, and the cell cannot travel while
|
|
anchored; release is needed before independent movement. Excessive loads can
|
|
exceed supported holding capacity.
|
|
- **Available when:** currents exist so that holding position has value.
|
|
- **Increases chance:** costly station keeping or repeated drifting away from useful sites.
|
|
- **Decreases chance:** frequent relocation or still liquid.
|
|
- **Distinct from logout:** the logout anchor is a lifecycle state (ADR-0177), not 007.
|
|
|
|
### 008: Coasting-biased body
|
|
|
|
- **Mechanism:** reduce passive slowing through a supported body-resistance arrangement.
|
|
Recalculate the whole profile; do not grant free extra momentum or a second drag bonus.
|
|
- **Reason to choose:** preserve relative travel between propulsion intervals.
|
|
- **Drawback:** slower passive stopping and more overshooting; precise stops may require
|
|
paid braking. It must differ meaningfully from 005 or the two candidates should merge.
|
|
Lower drag also raises top speed (accepted); 005 lowers forward drag only.
|
|
- **Available when:** relative velocity/passive resistance are modeled and changing
|
|
them has a demonstrable control/energy tradeoff.
|
|
- **Increases chance:** productive long, open travel with useful propulsion-release intervals.
|
|
- **Decreases chance:** frequent precise stops, short crowded routes, or repeated uncontrolled
|
|
overshooting without enough braking capacity.
|
|
- **Classification:** this is a proposed replacement movement entry; the former food
|
|
sensor remains a sensing review item, not a forgotten adaptation.
|
|
|
|
### 009: Shed independent propulsion
|
|
|
|
- **Mechanism:** future offspring omit independent propulsion machinery and its actual
|
|
construction/upkeep. Their bodies/reserves still exist and require maintenance.
|
|
- **Reason to choose:** devote resources to feeding, production, or another supported
|
|
role while stationary or carried by propelling colony members.
|
|
- **Drawback:** no independent swimming, propulsion braking, or escape. Passive drift
|
|
remains; being carried is not the ability to choose a new position independently.
|
|
- **Available when:** propulsion exists and a demonstrated stationary E/material supply
|
|
or supported carried role makes the resulting offspring viable. Exclude unsupported
|
|
solitary founders; photosynthesis alone does not supply C/N/P/O.
|
|
- **Increases chance:** reliable support, useful specialization, and little independent
|
|
propulsion use.
|
|
- **Decreases chance:** independent foraging, uncertain transport, depleting local food,
|
|
or temperature changes requiring relocation.
|
|
- **Restriction:** 010 is not a required partner unlock. Ordinary propelled neighbors
|
|
can provide transport where attachment mechanics support it.
|
|
|
|
### 010: Specialized colony propulsion
|
|
|
|
- **Mechanism:** add dedicated group-propelling machinery beyond ordinary attached
|
|
member contributions; specify what new capacity the tissue actually provides.
|
|
- **Reason to choose:** move useful attached mass that ordinary member output struggles
|
|
to carry, including supported nonpropelling specialists.
|
|
- **Drawback:** propulsion roles spend E moving other members, occupy material, and
|
|
sacrifice feeding/other functional capacity. More tissue still adds load.
|
|
- **Available when:** attached motion/load and differentiated machinery work, with a
|
|
distinct benefit. Neither shedding movement nor an arbitrary large colony is a
|
|
prerequisite; required group/body geometry must follow the actual mechanism.
|
|
- **Increases chance:** useful growing groups with a measured propulsion shortfall.
|
|
- **Decreases chance:** solitary life, adequate ordinary member output, or insufficient
|
|
feeding/transport support for a dedicated role.
|
|
- **Restriction:** ordinary colony movement is baseline attachment behavior, not gated
|
|
by 010. Coordination/polarity belongs to catalog 078 unless a clearly distinct
|
|
mechanism justifies both; do not charge twice for the same improvement.
|
|
|
|
### Reclassified and archived concepts
|
|
|
|
| Previous draft entry | Disposition in this review |
|
|
| --- | --- |
|
|
| 006 Current sail | On hold: ordinary cells/bubbles already drift. Reconsider only if it adds a distinct supported benefit and drawback. It is not accepted merely because currents now exist. |
|
|
| 008 Food-gradient sensing | Reclassified as sensing, retained here as an archived concept pending that category's review. No new catalog ID is assigned, and it is not a propulsion modifier. |
|
|
|
|
Basic cellular visual cues, including the current/thermal environment, are already
|
|
promised to every player in the region draft. A future food sensor must add useful
|
|
information beyond those cues within a defined perception model. Do not reintroduce
|
|
it just to refill a movement slot. The master catalog retains 150 indexed entries;
|
|
archived concepts are not additional approved mutations or runtime IDs.
|
|
|
|
## 4. Food, temperature, reproduction, and colony integration
|
|
|
|
- Loose food follows flow. Passing cells also induce short-lived food drift with
|
|
spatial falloff and temporal decay, as recorded in the region draft. The driving
|
|
velocity, influence radius, multiple-cell combination, and work budget remain open.
|
|
- Food collection does not automatically slow the cell. High-speed crossing needs
|
|
conservative contact detection so neither food nor organisms are skipped.
|
|
- Existing food identities and E/C/N/P/O remain finite while moving; circulating,
|
|
disturbed, or visually clustered food does not duplicate stock.
|
|
- Temperature contributes to survival E use through the region draft's three-temperature
|
|
model. Cold/heat adaptations can affect handling/support, but do not automatically
|
|
change movement stats without a defined coupling.
|
|
- Evolve now versus Prepare offspring follows the master mutation draft. Structural
|
|
propulsion/body changes develop in offspring; current-cell experience uses funded
|
|
division and immediate one-way succession, not free parent reconstruction.
|
|
- Offspring size/reserves influence actual load, capacity, and survival. A fixed-founder
|
|
percentage preview must not promise that a newly divided small body performs exactly
|
|
like a reference adult.
|
|
- The first birth must not require a movement mutation, a colony unlock, or a specific
|
|
random draw. Useful movement and flow routes must support the three-minute target.
|
|
- NPCs and players obey the same movement/resource rules. Offline controlled organisms
|
|
do not acquire passive drift, feeding, mutations, or thermal catch-up. After the logout
|
|
delay the cell is anchored, protected, and frozen (ADR-0177); it resumes with its
|
|
frozen velocity and heading.
|
|
|
|
## 5. Implementation boundaries and future verification
|
|
|
|
This is documentation, not authorization to implement these systems during review.
|
|
The new profile changes the current public motion/state model. Before code changes,
|
|
define versions, units, ranges, rounding, tick order, source/work accounting, contact,
|
|
perception, replay, persistence, migration, and lifecycle semantics. Do not silently
|
|
reinterpret earlier speed-only genomes, motion traces, or founder baselines.
|
|
|
|
Keep headless biology/world logic independent of graphics, transport, databases,
|
|
and Kubernetes. Client interpolation is presentation, not authority over motion.
|
|
No fluid dependency, placeholder service, or World0 operation is introduced here.
|
|
|
|
Later checks must cover:
|
|
|
|
- No-flow, with-flow, against-flow, cross-flow, intersections, and entry/exit behavior.
|
|
- Propulsion output costs, passive slowing, active braking, and funded station keeping.
|
|
- Combined body arrangements, directional drag, limits, no-op rejection, and fair previews.
|
|
- Exhausted E, zero propulsion, anchored roles, attachment release, and ordinary group load.
|
|
- Food contact at speed, passing-cell disturbance, finite stock, and stable contention.
|
|
- Deterministic continuation through restore, retry, and differently partitioned batches.
|
|
- Valid references/IDs and shared NPC/player biological presentation.
|
|
- Playtested founder handling, active feeding, first-birth time, and useful mutation tradeoffs.
|
|
- Frequent small-step offers, fixed-reference arithmetic, paired body allocation,
|
|
below-baseline recovery weights, and viable reacquisition after loss.
|
|
- Recovery-offer tail times across extreme specialization without making reversal
|
|
guaranteed or trapping ordinary active players beyond the intended stage length.
|
|
|
|
Unselected balancing choices include the founder's future absolute quantities,
|
|
output-cost curve, braking controls, limits on mutation effects, exact recipes,
|
|
005/008 distinctness, 006's machinery tradeoff, and 010's extra group machinery.
|
|
All must be concrete before candidates become implemented offers. The trial 5/2-point
|
|
matrix, module scaling, 20-30-second cadence, and quadratic recovery factor also
|
|
require review and measured balancing; documenting them does not qualify them.
|
|
|
|
Document checks for this segment verify source/reference targets, ten unique
|
|
movement draft IDs, consistent master-index links, unchanged 011-150 entries,
|
|
and Markdown/whitespace structure. They do not claim executed C++ tests or
|
|
qualified movement/flow behavior.
|