Arrivals
New elves arrive through three channels: reputation, cultural events, and wandering. Each channel has different triggers, personalities, and first-impression filters. Your settlement's artistic output sets how often elves arrive, and its social health affects whether they stay.
Overview
After the founding elves, every new elf arrives through one of three channels:
| Channel | Trigger | Frequency | Personality |
|---|---|---|---|
| Reputation | Colony reputation score | Periodic (interval scales with reputation) | Aesthetically aligned |
| Cultural Event | Great revel (avg score >= 75) | Burst of 1-2 elves | Drawn by the art |
| Wanderer | Random interval | ~500 ticks | Unpredictable aesthetics |
All arrivals use bimodal personality generation: each axis is set to 0.2 or 0.8 (coin flip) with +/-0.1 jitter. This produces elves with strong personality leanings, unlike founders who cluster near the 8 personality corners.
The arrival system runs two tick systems:
- Scheduling (every tick): checks whether a new arrival should be queued
- Spawning (every tick): processes queued arrivals after their spawn delay
Source: src/sim/arrival.rs -- arrival_scheduling_system, arrival_spawn_system.
How It Works
Reputation Channel
Elves who have heard of your colony's artistic reputation arrive to join it.
Reputation formula:
reputation = prestige_sum + (portfolio_count x 0.5) + (recent_revel_avg x 0.8)
prestige_sum: sum of all elves' prestige scoresportfolio_count: total number of compositions in the settlementrecent_revel_avg: average audience score from the most recent revel
Scheduling interval:
interval = baseline_interval / clamp(reputation / reputation_pivot, 0.2, 5.0)
baseline_interval: 300 ticksreputation_pivot: 50.0- At reputation 50: interval = 300 ticks (baseline)
- At reputation 250: interval = 60 ticks (5x faster, max rate)
- At reputation 10: interval = 1,500 ticks (5x slower, min rate)
Jitter of +/-(interval/4) is applied to each interval.
Spawn delay: 0-30 ticks after scheduling.
Reputation arrivals start with 60.0 satisfaction and always pass the first-impression filter (threshold 2.0 is unreachable by aesthetic distance, which caps at 2.0).
Source: src/sim/arrival.rs -- reputation_score(), schedule_reputation_arrival().
Cultural Event Channel
When a revel ends with an average audience score >= 75.0, word spreads and 1-2 elves arrive as a burst.
- Spawn delay: 20-80 ticks (they travel from afar)
- Initial satisfaction: 60.0
- First-impression filter: threshold 2.0 (always pass)
- Burst size: 1-2 elves per qualifying revel
The better your compositions match your audience's tastes, the more great revels you run and the more elves arrive.
Source: src/sim/arrival.rs -- great revel detection in scheduling system.
Wanderer Channel
Wanderers arrive on a regular interval regardless of your settlement's reputation. They are elves who come across the settlement while traveling.
- Interval: 500 ticks, with jitter of +/-(interval/3)
- Spawn delay: 0-50 ticks
- Initial satisfaction: 45.0 (lower than reputation or cultural event arrivals)
- First-impression filter: strict threshold of 1.2 (or 1.5 if the settlement recently held a welcoming revel)
Wanderers are the most likely to leave during the evaluation period, because of their lower starting satisfaction and stricter aesthetic filter.
Source: src/sim/arrival.rs -- schedule_wanderer_arrival().
First Impressions
Every arriving elf gets a 50-tick evaluation window to assess the settlement. During this window, their aesthetic position is compared against the colony average:
- If aesthetic distance > threshold: the elf rejects the settlement and leaves, generating a
WandererRejectedevent - If aesthetic distance <= threshold: the elf settles, generating a
WandererSettledorElfArrivedevent
| Channel | Threshold | Practical Effect |
|---|---|---|
| Reputation | 2.0 | Always passes (max possible distance is 2.0) |
| Cultural Event | 2.0 | Always passes |
| Wanderer | 1.2 (or 1.5 if recent revel) | ~60-70% of wanderers pass |
The recent-revel bonus (threshold 1.5 instead of 1.2) means wanderers are more likely to stay if you hold regular revels.
Source: src/sim/arrival.rs -- first_impression_system, evaluation window of 50 ticks.
Aesthetic Bias
Arriving elves do not have uniformly random aesthetics. Their aesthetic position is generated using a Gaussian distribution centered on the colony average with sigma = 0.3.
Most arrivals have tastes somewhat similar to the existing population, with occasional outliers. Over many arrivals, new elves tend to agree with the existing majority, which pushes the colony average further in that direction.
A sigma of 0.3 leaves enough variance for outliers. An elf with very different tastes can still arrive and stay, especially via the reputation channel, which always passes the first-impression filter. These outliers add aesthetic diversity and potential rivalry.
Source: src/sim/arrival.rs -- Box-Muller transform with sigma 0.3, centered on colony aesthetic mean.
Name Family Weighting
Arrival names are drawn from name families with weights that reflect the elf's aesthetic position:
| Family | Weight Formula | Aesthetic Lean |
|---|---|---|
| Silvani | 1.0 + (1.0 - tradition) x 0.5 | Low tradition (experimental) |
| Valdari | 1.0 + tradition x structure x 1.5 | High tradition + structure |
| Nelvari | 1.0 + emotion x (1.0 - social) x 1.5 | Emotional + personal |
| Aetheri | 1.0 + (1.0 - tradition) x social x 1.5 | Social + experimental |
A highly traditional, structured elf is more likely to receive a Valdari name. An emotional, personal elf is more likely to be Nelvari. The weighting is probabilistic: any elf can get any family name, at different rates.
Source: src/sim/arrival.rs -- name family weight calculation.
Founder Marker
The starting elves carry a Founder marker component. It is a permanent tag that distinguishes the original settlers from later arrivals. Founders use corner-cluster personality generation (base 0.85/0.15 with +/-0.1 jitter) rather than the bimodal generation (0.2/0.8 coin flip) used for arrivals.
The Founder marker has no mechanical effect beyond personality generation.
Source: src/sim/components.rs, Founder struct.
Values & Formulas
Arrival Rate Examples
| Reputation Score | Interval | ~Arrivals per 1,000 ticks |
|---|---|---|
| 10 | 1,500 ticks | 0.67 |
| 25 | 600 ticks | 1.67 |
| 50 | 300 ticks | 3.33 |
| 100 | 150 ticks | 6.67 |
| 250+ | 60 ticks | 16.67 |
Plus wanderers every ~500 ticks and burst arrivals from great revels.
Satisfaction Starting Points
| Channel | Starting Satisfaction | Departure Risk |
|---|---|---|
| Reputation | 60.0 | Low |
| Cultural Event | 60.0 | Low |
| Wanderer | 45.0 | Moderate |
For context, the departure warning threshold is crossed at 300 ticks of low satisfaction. Wanderers, starting 15 points lower, reach danger faster.
Interactions
Reputation Feedback Loop
Arrivals form a positive feedback loop:
- More elves produce more compositions
- More compositions raise
portfolio_countin the reputation formula - Higher reputation shortens the arrival interval
- More elves arrive
This loop is bounded by satisfaction: if new elves are unhappy, they depart, which lowers the population. Overcrowding and aesthetic clashes also limit growth.
Aesthetic Drift
Because arrivals are biased toward the colony aesthetic mean (sigma 0.3), a large settlement with strong aesthetic consensus attracts more like-minded elves. This can produce an aesthetic monoculture where everyone agrees, which reduces rivalry and revel drama and makes compositions more predictable.
Wanderers (with their stricter first-impression filter but random timing) are the main source of aesthetic diversity. A wanderer who passes the 1.2 threshold but sits at the edge of the aesthetic space can start a new artistic movement.
Revel Quality
Great revels (avg score >= 75) trigger the cultural event channel. This makes revel optimization a population growth strategy: revels that match your audience's tastes raise mood and satisfaction and also bring in new elves.
Tips
-
Prestige drives reputation. The prestige_sum term of the reputation formula is usually the largest contributor. Elves with high prestige (from Love reactions at revels) raise reputation the most.
-
Portfolio padding works. Even mediocre compositions contribute +0.5 to reputation each. A settlement with 20 compositions (even Crude ones) gets +10 reputation from portfolio alone.
-
Wanderer rejection is information. When a
WandererRejectedevent fires, it means the settlement's aesthetic consensus is narrow enough to filter out travelers. That is not necessarily bad, since it reflects a strong aesthetic identity. -
Early revels attract early arrivals. The cultural event channel (great revel >= 75 avg) is the fastest way to grow in the early game. Schedule revels as soon as you have a FeastHall, 5+ elves, food, and compositions.
-
Watch for satisfaction collapse. Rapid growth from high reputation can overwhelm your food supply, crowd housing, and dilute social bonds. New arrivals start with 60 satisfaction but need friend formation and aesthetic alignment to stay above the departure threshold.