Lifecycle & Aging
Elves age. Skill comes easier when they are young, compositions are best in an elf's prime, and an elder's prestige carries more weight. An elder who has been satisfied long enough attends one last revel, says goodbye, and leaves a legacy record behind.
Overview
Every elf carries an Age component set at spawn. Age measures ticks lived since birth. Four stages divide that lifespan, and each stage changes how the elf behaves in several other systems:
| Stage | Ticks Lived | Game Days |
|---|---|---|
| Young | 0 -- 499 | 0 -- 4 |
| Prime | 500 -- 1,999 | 5 -- 19 |
| Mature | 2,000 -- 3,999 | 20 -- 39 |
| Elder | 4,000+ | 40+ |
(DAY_LENGTH = 100 ticks.)
Stage is derived from tick - birth_tick on demand and is not stored. A cached last_known_stage field lets transition detection fire exactly once per boundary crossing.
Three systems drive the lifecycle:
age_stage_system(once per day) -- emitsStageTransitionevents when the cached stage differs from the current one.elder_fulfillment_system(every 50 ticks) -- tracks how long each elder has been satisfied; marks themFulfilledafter 500 ticks above satisfaction 70.farewell_departure_system(every tick) -- processes elders markedAwaitingFarewell, spawning aLegacyFigurerecord and despawning the elder.
Source: crates/er-sim/src/sim/systems/lifecycle.rs; crates/er-sim/src/sim/components.rs, Stage, Age, Fulfilled, FulfillmentProgress, AwaitingFarewell, LegacyFigure.
How It Works
Stage Multipliers
Each stage scales four numeric bands of the elf's behavior. The multipliers are read at call-sites across the sim; no single system applies them all.
| Multiplier | Young | Prime | Mature | Elder | Reads Applied In |
|---|---|---|---|---|---|
| Skill XP | 1.3x | 1.0x | 0.7x | 0.5x | compose, build, gather XP awards |
| Composition quality (mastery + originality) | 0.8x | 1.2x | 1.0x | 1.1x | compose system |
| Physical (work progress) | 1.0x | 1.0x | 0.8x | 0.5x | build, gather task progress |
| Influence (prestige weight in satisfaction) | 0.7x | 1.0x | 1.3x | 1.5x | satisfaction prestige term |
By stage:
- Young elves learn fast (1.3x XP) but make lower-quality work (0.8x quality).
- Prime elves produce their best compositions (1.2x quality) with normal XP and physical ability.
- Mature elves lose some XP gain (0.7x) and physical rate (0.8x) but their prestige weighs more heavily in satisfaction (1.3x).
- Elder elves move slowly (0.5x physical, 0.5x XP) but their compositions get +10 to the emotional score, on top of 1.1x base quality. Their prestige also weighs more in satisfaction than any other stage (1.5x).
Source: crates/er-sim/src/sim/components.rs, Stage::skill_xp_multiplier, comp_quality_multiplier, physical_multiplier, influence_multiplier, elder_emotional_bonus.
Personality Maturation Rate
The personality maturation system (which nudges expressed personality values toward their roots) also scales by age stage. Young elves change most quickly; elders change least:
| Stage | Maturation Rate (per 50-tick cycle) |
|---|---|
| Young | 0.04 (4%) |
| Prime | 0.02 (2%) |
| Mature | 0.01 (1%) |
| Elder | 0.005 (0.5%) |
A scar applied in youth reshapes the elf quickly; a scar applied to an elder barely shifts their behavior before they depart.
Source: crates/er-sim/src/sim/components.rs, Stage::maturation_rate; applied in crates/er-sim/src/sim/systems/mood.rs, personality_maturation_system.
Stage Transitions
Once per day (tick multiple of DAY_LENGTH = 100, skipping tick 0), every elf's current stage is compared to their cached last_known_stage. If the stage advanced, the cache updates and a StageTransition { elf, from, to } cultural event fires.
There is no age limit. Once an elf reaches stage Elder at tick 4,000, they remain Elder for the rest of their life. Departure happens through satisfaction mechanics.
Source: crates/er-sim/src/sim/systems/lifecycle.rs, age_stage_system.
Elder Fulfillment
When an elf reaches Elder stage and has satisfaction > 70, a hidden counter starts. Every 50 ticks:
- If their satisfaction is still above 70, add +50 to
FulfillmentProgress.ticks_above. - If their satisfaction drops to 70 or below, reset
FulfillmentProgressto zero. Partial progress does not persist.
When the counter reaches 500 ticks (10 game days of continuous satisfaction as an elder), the elf is marked Fulfilled. The FulfillmentProgress component is removed and an ElderFulfilled event fires.
An elf who alternates between content and discontent never completes the fulfillment path. The counter needs sustained satisfaction; average satisfaction does not count.
Source: crates/er-sim/src/sim/systems/lifecycle.rs, elder_fulfillment_system -- threshold 70.0, accumulator step 50, completion at 500.
The Farewell Revel
Being marked Fulfilled does not trigger an immediate departure. Instead, the elf waits for the next revel they attend. When that revel concludes, the finalization pass scans attendees for the Fulfilled marker and tags each one with AwaitingFarewell.
The revel is the farewell: the fulfilled elder performs or witnesses one last performance, and only then leaves. A fulfilled departure follows a revel the elder attended.
On the next tick after being tagged, farewell_departure_system runs the full departure sequence:
- Build a
LegacyFigurerecord from the elder's portfolio, prestige, love reactions, and revels performed. - Emit a
FulfilledDeparture { elf, legacy_score }event (notable priority). - Apply the fulfilled-departure mood cascade to every elf in the elder's relationship list.
- Apply any apprenticeship cleanup (see apprenticeship).
- Despawn the elder.
Source: crates/er-sim/src/sim/systems/revel.rs (Fulfilled detection + AwaitingFarewell tag at line 523); crates/er-sim/src/sim/systems/lifecycle.rs, farewell_departure_system.
Fulfilled Departure Mood Cascade
Mood effects on surviving elves are milder after a fulfilled departure than after a dissatisfied one, and the mourning period is shorter:
| Relationship to Departed Elder | Mood Modifier | Duration |
|---|---|---|
| Partner | -8 "Partner departed in fulfillment" | 300 ticks |
| Friend | -5 "Friend departed in fulfillment" | 200 ticks |
| Rival | +2 "Rival departed" | 50 ticks |
| Acquaintance | -1 "Elder departed" | 50 ticks |
Friends with strength >= 60 and all Partners also enter a Mourning state. The Mourning component is created with ticks_remaining: 150, shorter than the 200-tick mourning that follows dissatisfied departures.
Source: crates/er-sim/src/sim/systems/lifecycle.rs, farewell_departure_system -- mood matches at lines 137-141, mourning at line 159.
Legacy Figures
When a fulfilled elder departs, a LegacyFigure record is pushed onto the colony's permanent legacy list. Legacy figures persist after the elf is gone and are never removed.
A LegacyFigure captures:
| Field | Source |
|---|---|
name | Elder's display name |
gestalt | Personality gestalt at departure (e.g., DeepRoot, WildFlame) |
composition_count | Portfolio size at departure |
legacy_score | composition_count * 2 + love_reactions * 3 + revels_performed + prestige_tier * 5 |
departure_day | Game day of departure (tick / 100) |
departure_reason | DepartureReason::Fulfilled |
The legacy_score is a rough numeric summary of cultural impact. A prolific Legendary-tier composer who performed at many revels will leave a higher-scored legacy than a quiet Mature-stage soloist. The score is also announced in the FulfilledDeparture event.
Legacy figures persist in the colony state, and a future UI panel could render them as a "Hall of Elders." Dissatisfied departures do not currently push LegacyFigure records; only fulfilled ones do.
Source: crates/er-sim/src/sim/components.rs, LegacyFigure; crates/er-sim/src/sim/systems/lifecycle.rs, score at line 106.
Interactions
Satisfaction & Departure
Fulfilled departure is a separate departure path from the satisfaction-triggered one. The discontented timeline (300 ticks warning, 500 more ticks to depart) does not apply to fulfilled elders. They leave through the farewell revel, and the mood cascade on survivors differs.
The satisfaction formula itself also weights elder elves differently: the prestige bonus term is scaled by the elder's 1.5x influence multiplier. A renowned elder's prestige contributes more to their own satisfaction than a young elf's would, which makes it easier to accumulate the 500 ticks that fulfillment requires.
Personality
The personality maturation system reads the elf's age stage to set the convergence rate. Scarred elves adjust quickly when young and slowly when old. An Elder who loses a partner carries that scar for the rest of their life with very little behavioral adjustment.
Compositions & Revels
Every composition reads the composer's stage through Age to scale mastery and originality by comp_quality_multiplier. Elder compositions receive a flat +10 to their emotional score on top of that multiplier, so late-career works often have the highest emotional scores in a colony's portfolio.
At revel time, the finalization pass checks for attending elders marked Fulfilled. An elder who is fulfilled and attends any revel will depart after that revel, so when you hold revels also decides when they leave.
Apprenticeship
When an elder with AwaitingFarewell departs, the farewell system calls cleanup_apprenticeship_on_departure. If the elder was mentoring an apprentice, the student loses their Apprenticeship component and receives a -8 "Mentor departed" mood modifier for 200 ticks.
Students graduated under the elder retain their permanent TrainedBy lineage marker, and the master's name stays in the student's detail panel after the elder is gone.
Skills & Work
Build and gather task progress is scaled by physical_multiplier: Mature elves work at 80% speed and Elder elves at 50%. Skill XP gains are scaled by skill_xp_multiplier, so aging elves climb skill levels slowly even when they work often. A Young elf learning their craft gains XP 2.6x faster than an Elder performing the same task (1.3 / 0.5).
Tips
-
Schedule revels for your elders. An elder who reaches
Fulfilledstatus is waiting for the next revel to say goodbye. If you want to delay a beloved elder's departure, holding off on revels buys time. But the sustained satisfaction that produces fulfillment works against extending their life indefinitely. -
Prime is the composition sweet spot. Stage Prime gives 1.2x quality with full physical and XP multipliers, and no elder emotional bonus. If you are trying to push a specific elf toward a Magnum Opus (skill 10, inspiration > 90, mood > 50), their Prime window (ticks 500--1,999, days 5--19) is when the composition quality multiplier is highest.
-
Elder prestige contributes more satisfaction. The 1.5x influence multiplier on prestige means an elder with a high prestige tier gets more satisfaction from their reputation than any other stage.
-
Young elves are emotionally volatile. The 4% maturation rate means a scar applied in youth shifts their behavior visibly within a few days. Young elves who suffer heartbreak or unrequited love can change noticeably before you can stabilize them. Pair them with friends early.
-
Mourning for a fulfilled elder is shorter. 150 ticks vs 200 for dissatisfied departures. Your surviving elves will compose fewer Elegies after a fulfilled departure than after a dissatisfied one. If you want Elegy-tagged compositions, dissatisfaction cascades produce them more reliably, at the cost of lower colony mood.
-
LegacyFigures are cumulative, not displayed (yet). The game records them permanently, but no in-game panel lists them yet. A future Hall of Elders could show every fulfilled departure's name, gestalt, compositions, and score; the data is already collected.
-
Fulfilled departures are easier on colony mood. A dissatisfied departure gives friends -10 mood for 300 ticks; a fulfilled departure gives -5 for 200. Over a long-running colony, a string of fulfilled departures leaves survivors in better shape than a string of dissatisfied ones.