# SimBee: The Honeybee Colony Simulation
## User Manual & Field Guide to Apis mellifera


### Table of Contents

**Part I: Getting Started**
1. [Introduction](#introduction)
2. [Quick Start Guide](#quick-start)
3. [Basic Controls](#basic-controls)
4. [Understanding Your Colony](#understanding-your-colony)
5. [Saving Your Colony](#saving)

**Part II: Game Systems**
6. [Colony Management](#colony-management)
7. [Foraging & Resources](#foraging-resources)
8. [Communication & Dancing](#communication-dancing)
9. [Seasons & Weather](#seasons-weather)
10. [Threats & Defense](#threats-defense)
11. [Research & Development](#research-development)
12. [Player Interactions](#player-interactions)

**Part III: The Science of Bees**
13. [The Superorganism](#the-superorganism)
14. [Bee Biology & Castes](#bee-biology)
15. [The Waggle Dance Language](#waggle-dance-science)
16. [Hive Architecture](#hive-architecture)
17. [Seasonal Life Cycle](#seasonal-lifecycle)
18. [Diseases & Parasites](#diseases-parasites)
19. [Bee Intelligence & Decision Making](#bee-intelligence)

**Part IV: Advanced Topics**
20. [Emergent Behaviors](#emergent-behaviors)
21. [Optimization Strategies](#optimization-strategies)
22. [Achievements & Challenges](#achievements)

---

## Part I: Getting Started

### Introduction {#introduction}

Welcome to SimBee, where you'll experience the remarkable world of honeybees from both a colony management and individual bee perspective. Unlike traditional strategy games, SimBee simulates a true superorganism where 60,000 individuals coordinate through dance, pheromones, and collective intelligence to survive, thrive, and reproduce.

Your role shifts between that of a benevolent beekeeper providing guidance and resources, and a direct participant in the colony's activities through mini-games and first-person bee control. Success requires understanding both the individual behaviors that emerge from simple rules and the complex colony-level patterns that result.

### Quick Start Guide {#quick-start}

**Your First Day:**
1. You begin with a starter colony of **12,000 bees** in early spring (stores start around 42 honey, 14 pollen, 8 water, 5 wax)
2. Watch foragers leave and return - bees heading out to the flower patches are foragers
3. Click on any bee to open the inspector and see its caste, age-derived role, and what it's carrying
4. When a forager unloads at the hive it may break into a waggle dance - that's your cue to open the decode mini-game (the **Decode a waggle dance** button)
5. Open the **Colony Dashboard** (the colony button, right-side drawer) to read health, population, temperature, and stores at a glance
6. Click **Look inside the hive** to step into the comb and watch a single cell develop from egg to adult
7. Set speed with the **1× / 2× / 5×** buttons (or keys **1 / 2 / 3**), and **pause** with the play/pause button or **Space**

**First Week Goals:**
- Successfully decode at least one waggle dance
- Watch a brood cell develop through to an emerging adult in the hive interior
- Keep your honey stores comfortably toward the dashboard's target (honey's target bar fills at **60**; the colony looks "Thriving" when honey is above ~40 in a growth season)
- Unlock your first research upgrade
- Witness at least one emergent behavior (the heat-ball hornet defense is the one you can actually watch unfold)

### Basic Controls {#basic-controls}

**Camera - God's-eye (orbit) view:**
- Drag (left button): rotate around the hive
- Right-drag or middle-drag: pan
- Mouse wheel: zoom in/out
- When idle, the camera gently auto-rotates
- Camera response is tied to real time, so it stays smooth even when the sim is paused or sped up

**First-Person - "Become a Bee":**
- WASD: fly
- Space / Shift: rise / descend
- Move the mouse: look around
- The camera collides with the terrain, so you can skim the meadow
- Mouse-look works whether or not the browser grants pointer-lock (handy in embedded/iframe contexts)

**Selecting & inspecting:**
- A click that doesn't drag selects the nearest bee and opens the inspector
- Inspector buttons: **Follow** (camera tracks the bee), **Become** (drop into first-person at that bee), **×** (close)

**Simulation & panels (on-screen buttons):**
- **Play / Pause** - also the **Space** bar (in god's-eye view)
- **1× / 2× / 5×** speed - also keys **1 / 2 / 3**
- **Skip to next season** - jumps the clock straight to the next season
- **Open the colony dashboard** (the colony button)
- **Open the research tree** (the research button)
- **Look inside the hive** (enters the comb interior)
- **Decode a waggle dance** (opens the dance mini-game)
- **Become a Bee** (drops into first-person flight)

**The only keyboard shortcuts** are: **Space** (pause/resume in god's-eye view), **1 / 2 / 3**
(speed), **WASD + Space/Shift** (fly in first-person), and **Esc** (exit first-person).
Everything else is a button - 
- *Control a bee* is now the inspector's **Become** button (no `C` key)
- *Look inside the hive* is the hive-interior button (no `H` key) - and it's a viewer now, not a construction planner (see §12)
- *Feed colony* and *Treat for mites* no longer exist as actions - mite pressure is managed through **research** (the Genetics branch) rather than a treatment button (see §10–11)

### Understanding Your Colony {#understanding-your-colony}

Most colony information lives in the **Colony Dashboard**, a slide-in drawer on the right that
updates live (even while paused). Its cards:

- **Health** - an overall banner derived from honey, population, temperature, and mite load
- **Population** - broken into age-based roles plus drones and the queen (weighted by season)
- **Brood-nest temperature** - a gauge around the 35°C set-point
- **Stores** - honey, pollen, water, and wax against their seasonal targets
- **Activity** - foragers out, loads delivered today, dances read
- **Threats & defense** - mite load, defense readiness, and a **Simulate hornet attack** button
- **Saved game** - save-now and new-colony controls

A compact HUD also shows the resource rail, population, and the current season card.

**Individual Bee Information (the Inspector):**
Click a bee to open its panel:
- Caste: Worker, Drone, or Queen
- Age-derived role (temporal polyethism: cleaner → nurse → builder → guard → forager)
- Current activity and what it's carrying
- Energy
- An educational note tied to its role

### Saving Your Colony {#saving}

The web build saves automatically - there's no manual save/load cycle to manage.

- Your colony **autosaves to the browser** (localStorage) every few seconds and again whenever
  you close or hide the tab. Reloading the page resumes your *latest* live state: resources,
  population, the season/day clock, unlocked research, and mite load.
- The world snaps straight to the saved season on load (no spring-to-autumn fade-in).
- **New Colony** (on the dashboard's saved-game card) wipes the save and starts fresh.

> Because saves are stored in the browser, they're tied to *that* browser on *that* device.
> Clearing site data, or opening the game in a different browser, starts a new colony.

---

## Part II: Game Systems

### Colony Management {#colony-management}

Your colony operates through division of labor among three castes:

**The Queen**
- Single reproductive female
- Lays up to 2,000 eggs daily in peak season
- Produces Queen Mandibular Pheromone (QMP) for cohesion
- Lives 2-5 years (vs 6 weeks for summer workers)
- Death = colony failure unless new queen is raised

**Worker Bees (Sterile Females)**
Follow age-based progression (temporal polyethism):
- Days 1-4: Cell Cleaners (prepare cells for eggs)
- Days 4-12: Nurse Bees (feed larvae, check each 1,300 times)
- Days 12-18: Architects (produce wax, build comb)
- Days 18-21: Guards (defend entrance)
- Days 21+: Foragers (collect resources)
- Specialize as: Scouts (elite foragers), Water Collectors

**Drone Bees (Males)**
- Exist solely for mating with virgin queens
- Consume resources without working
- Evicted before winter ("drone massacre")
- Managing their population affects genetic diversity vs efficiency

### Foraging & Resources {#foraging-resources}

**Resource Types:**
- **Nectar**: Converted to honey (30% efficiency), energy source
- **Pollen**: Protein for raising brood, stored in cells
- **Water**: Cooling, food processing, 1 liter/day needed
- **Propolis**: Tree resin for sealing (a research upgrade in the Architecture branch)

> In the web build the colony tracks four stores - **honey, pollen, water, and wax** - in
> abstract units (not kg/lb). Nectar is collected and converted into honey rather than stored
> separately, and propolis appears as a research upgrade rather than a stored resource.

**Foraging Mechanics:**
- Range: Typical 1-2 miles, up to 8 miles when desperate
- Efficiency: Elite foragers (19%) do 50% of work
- Flower Constancy: Bees stick to one flower type per trip (60-95%)
- Memory: Successful locations remembered for days

**Resource Management:**
- Honey: 6-8 pounds consumed to make 1 pound of wax
- Daily consumption: Workers 0.002kg, Drones 0.004kg honey
- Seasonal storage: Need 60+ pounds honey for winter

### Communication & Dancing {#communication-dancing}

**The Waggle Dance encodes:**
- Direction: Angle relative to sun
- Distance: Duration of waggle run (200m = 8-9 circuits in 15 seconds)
- Quality: Vigor of dance
- Includes 10-15° natural error (adaptive feature)

**Dance Mini-Game:**
1. When a forager unloads, it may break into a waggle dance - start the decode mini-game
2. A 2D canvas shows the figure-8: a straight **waggle run** (its angle = direction relative to the sun, its duration ≈ distance at about 1 second per km) plus the return loops
3. Watch the run carefully
4. **Drag the compass dial** to set the direction
5. **Set the slider** for distance
6. **Submit** your interpretation
7. You're scored on angular error (within about ±18°) and distance error (within 25% of the true distance, or 0.4 km - whichever is larger). Land inside both and the read succeeds, sending foragers to the source and earning resources + research points
8. The **Dance Accuracy** research widens those tolerances, making decoding more forgiving

**Pheromone Communication (biology):**
Beyond the dance, real colonies coordinate through scent. The web build doesn't render
pheromone clouds as a visual layer, but the chemistry is worth knowing:
- Queen pheromone (QMP): calming, maintains colony cohesion
- Alarm pheromone: recruits defenders to a threat
- Nasonov pheromone: an orientation/homing "come here" signal
- Brood pheromone: tells nurse bees which larvae need feeding

### Seasons & Weather {#seasons-weather}

> **Time in SimBee (web build).** The in-game clock runs about **3.2 seconds per day at 1× speed**
> and **12 in-game days per season**, cycling spring → summer → fall → winter (~48 days/year).
> The day ranges below describe the *real* honeybee year and are kept as biological reference -
> they are not the in-game day counts. Seasons keep advancing even while you're inside the hive.

**Spring (real-world: ~days 1–90):**
- Critical buildup period
- Aging winter bees must rear replacements
- Risk of "spring dwindle"
- Growth rate: 500-600 bees/day once established

**Summer (real-world: ~days 91–180):**
- Peak population (40,000-60,000)
- Maximum foraging
- Swarming season (reproduction)
- Drone production

**Fall (real-world: ~days 181–270):**
- Winter bee production (physiologically different)
- Drone eviction
- Resource consolidation
- Mite treatment critical

**Winter (real-world: ~days 271–365):**
- Cluster formation for warmth
- No foraging, consume stores
- Population drops to 10,000-20,000
- Survival depends on food stores and cluster integrity

**Weather Effects:**
- Rain: Reduces/stops foraging
- Wind: Affects flight paths, energy consumption
- Temperature: Triggers clustering or fanning
- Day/Night: Foraging only during daylight

### Threats & Defense {#threats-defense}

**Varroa Mites:**
- Reproduce in capped brood
- Population doubles monthly
- Treatment threshold: 3 mites/100 bees
- Weakens bees, transmits viruses
- Research VSH trait for resistance

**Diseases:**
- American Foulbrood: Fatal, requires colony destruction
- European Foulbrood: Treatable, stresses colony
- Nosema: Reduces lifespan, winter mortality
- Chalkbrood: Mummified larvae during stress

**Predators:**
- Hornets: Trigger defensive ball formation
- Birds: Pick off foragers
- Bears: Destroy hives for honey
- Mice: Invade hives in winter

**Defense Mechanisms:**
- Guard bees check all entering bees
- Alarm pheromone recruits defenders
- Suicide stinging (barbed stinger = death)
- Heat ball: Surround hornet, vibrate to 45°C

> **In-game hornet encounter (web build).** A hornet attack plays out as a timed sequence:
> *incoming → engage → outcome → disperse*. If you've researched **Heat-Ball Defense**, defenders
> swarm into a shell around the hornet, the ball's temperature climbs to ~47°C (shown in the top
> banner), the hornet dies, and you earn research points. Without that research, it becomes a
> *raid*: the hornet picks off guards and the colony loses population, with a prompt to go
> research the tactic. Attacks trigger automatically (weighted toward late season, rate-limited)
> or on demand via the dashboard's **Simulate hornet attack** button.

### Research & Development {#research-development}

**Research Points are earned through:**
- Each forager delivery: **+0.05**
- Decoding a waggle dance: **+0.5** for a clean read, **+0.2** for a partial one
- A daily trickle scaled by colony size (roughly **population ÷ 18,000** per in-game day)
- Winning a heat-ball hornet defense: **+2**
- **Spring bonus:** all point gains are multiplied by **1.5×** during spring

> You start with **3 points**, enough to open a first-tier upgrade right away.

**The tree has 16 upgrades across 6 branches.** Each node lists its cost in points and requires
the previous node in its branch.

**Foraging** (yellow)
- Flower Memory (3) → Optimal Foraging (6) → Quantum Navigation (10)
- More honey/pollen per trip (+15% / +25% / +40%); Optimal Foraging also sends more foragers out

**Communication** (orange)
- Dance Accuracy (3) → Pheromone Mastery (6) → Superorganism (10)
- Dance Accuracy widens your decode tolerance; the later two pull more recruits and add forager waves

**Architecture** (tan)
- Wax Efficiency (3) → Propolis Sealing (6) → Festooning Mastery (10)
- Faster wax; far less honey burned in winter; faster comb building

**Genetics** (violet)
- Selective Breeding (4) → Hygienic Behavior (7) → VSH Trait (11)
- Slower population decline in hard seasons; disease resistance; strong varroa-mite suppression

**Defense** (red)
- Guard Training (3) → Heat-Ball Defense (6)
- Sharper guards; unlocks the heat-ball that lets the colony cook an attacking hornet

**Ecology** (green)
- Pollination Science (4) → Climate Adaptation (7)
- Richer nectar yields; steadier brood-nest temperature through any weather

### Player Interactions {#player-interactions}

**"Become a Bee" - first-person flight:**
Drop into a bee's-eye view (via the inspector's **Become** button, or the main **Become a Bee**
control) and fly the meadow:
- WASD: fly
- Mouse: look around
- Space / Shift: rise / descend
- Esc: return to the god's-eye view
- The view collides with the terrain so you can skim the ground and hover among the flowers

First-person is a free-flight **observation** mode - you're riding along with the swarm, not
collecting nectar yourself. 

**Hive Interior - watch the comb up close:**
The hive interior is its own scene (its own camera, pan, and zoom). Inside, you'll see hundreds
of hex cells laid out like a real frame - brood nest in the center, a pollen band around it, and
capped honey arcing over the top - plus a crawling queen with her retinue and wandering nurse/house bees.

Interactive cells:
- Click a **brood cell** → that cell animates through **egg → larva → capped pupa → emerging adult**
  over ~21 "days," with a floating stage label; when it completes, a new worker crawls out and
  the colony population ticks up.
- Click a **honey / pollen / storage cell** → a labelled tooltip explains what's stored there.

**Your levers on the colony:**
The web build keeps the player's hand fairly light - you guide the colony rather than micromanage it:
- **Decode waggle dances** well - a clean read recruits a wave of foragers and bumps honey/pollen
- **Spend research points** to shape the colony's traits (yield, winter survival, disease/mite resistance, defense)
- **Simulate hornet attack** (dashboard) - triggers the hornet encounter on demand to test your defenses
- **Skip to next season** - advance the clock when you want to move things along
- **Inspect** the colony via the Dashboard (§4) and individual bees via the Inspector (§3)

There are **no Feed or Treat-Mites buttons**
Mite pressure is handled indirectly: it climbs faster in late summer/fall and is suppressed by the
Genetics research line - **Hygienic Behavior** slows mite growth and **VSH Trait** actively drives
it down. Honey and population are shaped by the season clock, foraging, and your research choices
rather than by direct feeding.

---

## Part III: The Science of Bees

### The Superorganism {#the-superorganism}

A honeybee colony is not just a collection of individuals but a true superorganism - a single living entity composed of many parts. Like cells in your body, individual bees cannot survive alone. The colony exhibits properties that emerge only from the collective:

**Collective Intelligence:**
The colony makes decisions no individual bee understands. When choosing a new nest site, scout bees investigate options, return to dance their findings, observe other dances, and may switch allegiance to better sites. Through this democratic process, the swarm reaches consensus without any bee comparing all options.

**Thermoregulation:**
The colony maintains the brood nest at exactly 35°C (95°F) year-round. In winter, bees form a cluster, vibrating flight muscles to generate heat while rotating positions so no bee freezes. In summer, they collect water and fan wings in coordinated waves to create evaporative cooling. No individual bee "knows" the target temperature - it emerges from simple behavioral rules.

**Adaptive Immunity:**
While individual bees have immune systems, the colony has social immunity. Hygienic behavior (removing diseased larvae), propolis use (antimicrobial tree resin), and fever response (heating the hive to kill pathogens) protect the superorganism. Some bees even act as "medical specialists," collecting specific antimicrobial plants when disease is detected.

### Bee Biology & Castes {#bee-biology}

**Development (Complete Metamorphosis):**
- Egg: 3 days (queen checks each up to 10 times)
- Larva: 6 days (fed 1,300 times by nurses)
- Pupa: 12 days (21 total for workers, 24 for drones, 16 for queens)
- Adult: Emerges with soft exoskeleton, hardens in hours

**Caste Determination:**
All female eggs are identical - diet determines caste:
- Royal Jelly only = Queen (fertile, lives years)
- Royal Jelly then worker food = Worker (sterile, lives weeks)
- Unfertilized eggs = Drones (haploid males)

**Anatomy Adaptations:**
- Compound eyes: 6,900 facets, see UV, polarized light for navigation
- Proboscis: Tube tongue for nectar, can reach 6.5mm into flowers
- Pollen baskets: Concave areas on hind legs with surrounding hairs
- Wax glands: 8 glands on abdomen, peak production at 12-18 days old
- Barbed stinger: Only in workers, tears out = death (ultimate altruism)
- Antennae: 170 odor receptors, detect pheromones, CO2, humidity

### The Waggle Dance Language {#waggle-dance-science}

Discovered by Karl von Frisch (Nobel Prize 1973), the waggle dance is the only known abstract symbolic language in non-primates.

**Dance Components:**
1. **Return Phase**: Semi-circular path back to start
2. **Waggle Run**: Straight line with abdomen waggling
3. **Second Return**: Completes figure-8 pattern

**Information Encoded:**
- **Direction**: Angle of waggle run relative to vertical = angle from sun
- **Distance**: Duration of waggle run (1 second = ~1 kilometer)
- **Quality**: Number of circuits, vigor, duration of dancing
- **Urgency**: Dance tempo and follower recruitment

**Dialects:**
Different bee subspecies have different "dialects" - Italian bees use different distance calibrations than Austrian bees. When colonies are mixed, communication errors occur until they learn each other's dialect.

**Dance Floor:**
Near the hive entrance, usually vertical comb surface. Dancing in darkness requires followers to use touch and vibration sensors to decode the message.

### Hive Architecture {#hive-architecture}

**Hexagonal Genius:**
Bees are mathematicians. The hexagon uses least material to create maximum storage - proven optimal by human mathematics only in 1999. Cells tilt 13° upward to prevent honey from dripping out.

**Cell Sizes:**
- Worker cells: 5.4mm diameter, ~5 per inch
- Drone cells: 6.9mm diameter, 15% larger
- Transition zones: Irregular cells where sizes meet
- Queen cells: 25mm peanut-shaped, hang vertically

**Comb Organization (inside to outside):**
1. **Brood nest**: Central sphere, maintained at 35°C
2. **Pollen band**: Arc above/around brood (protein near larvae)
3. **Honey dome**: Top and sides (insulation and food)

**Construction Process:**
1. Workers consume honey, convert to wax in glands
2. Wax scales secreted, chewed to make pliable
3. Initial cells are circular
4. Heat and surface tension create hexagons
5. Multiple bees work simultaneously, yet achieve perfect alignment

### Seasonal Life Cycle {#seasonal-lifecycle}

**Spring Buildup:**
- Triggered by lengthening days, not temperature
- Queen gradually increases laying: 100→500→2000 eggs/day
- Critical race: Must rear new bees before winter bees die
- Pollen crucial - without protein, no brood rearing

**Swarming (Reproduction):**
- Triggered by: Congestion, queen pheromone dilution, abundant nectar
- Process takes 2-3 weeks:
  1. Queen cells built (8-20 cells)
  2. Queen stops laying, slims down to fly
  3. Scouts search for new home
  4. Old queen leaves with 50% of workers
  5. First virgin queen emerges, kills rivals
  6. Virgin takes mating flights (mates with 10-20 drones)
  7. Returns to head parent colony

**Summer Peak:**
- 40,000-60,000 bees
- 1,500-2,000 eggs laid daily
- Foragers fly 500,000 miles collectively
- Colony gains 2-5 pounds daily during nectar flow

**Fall Preparation:**
- "Winter bees" raised - different physiology:
  - Extra fat bodies (protein/lipid storage)
  - Enlarged hypopharyngeal glands
  - Live 6 months vs 6 weeks
- Drones evicted - dramatic "massacre"
- Propolis collection increases for sealing

**Winter Cluster:**
- Forms when temperature drops below 14°C (57°F)
- Outer shell: Packed bees at 7°C (45°F)
- Inner core: Loose bees at 35°C (95°F)
- Bees rotate positions to avoid freezing
- Consume 30-100 pounds of honey
- No defecation for months (amazing retention)

### Diseases & Parasites {#diseases-parasites}

**Varroa destructor (Most Serious Threat):**
- External parasite, feeds on fat body (not blood as once thought)
- Reproduces in capped brood cells
- Doubles population monthly
- Vectors for 20+ viruses
- Resistance evolving: VSH, grooming, ankle-biting behaviors

**American Foulbrood (Paenibacillus larvae):**
- Bacterial, spores survive 40+ years
- Larvae die after capping
- Ropy, foul-smelling remains
- Spreads through equipment, robbing
- No cure - burn infected colonies

**European Foulbrood (Melissococcus plutonius):**
- Bacterial, kills larvae before capping
- Twisted, yellow/brown larvae
- Can recover with requeening, feeding
- Stress-related occurrence

**Nosema (Microsporidian):**
- Gut parasite, two species
- Reduces lifespan by 50%
- Dysentery, crawling bees
- Spreads through shared food

**Colony Collapse Disorder (CCD):**
- Mysterious disappearance of adult bees
- Queen and brood remain
- Food stores untouched
- Multiple causes suspected: pesticides, pathogens, nutrition, stress

### Bee Intelligence & Decision Making {#bee-intelligence}

**Individual Intelligence:**
Despite having only 960,000 neurons (vs 86 billion in humans), bees demonstrate:
- **Counting**: Up to 4 objects
- **Abstract concepts**: Same/different, above/below
- **Face recognition**: Can recognize human faces
- **Tool use**: Pull strings to access rewards
- **Metacognition**: Uncertainty awareness, harder choices = longer decisions
- **Emotional states**: Pessimism/optimism affecting decisions

**Collective Decision-Making:**
**House-hunting Process:**
1. Scouts (5% of swarm) search for sites
2. Evaluate ~12 factors: volume, entrance, height, exposure
3. Return to dance quality proportional to site quality
4. Other scouts investigate advertised sites
5. May switch allegiance to better sites
6. Quorum at site (10-20 scouts) triggers decision
7. Scouts return, pipe signal to warm up flight muscles
8. Entire swarm departs together

**Foraging Decisions:**
- Colonies allocate foragers optimally across flower patches
- Uses "unemployment" system - idle foragers watch dances
- Better sources = longer dances = more recruits
- Automatic balancing without central control

---

## Part IV: Advanced Topics

### Emergent Behaviors {#emergent-behaviors}

> **What you can actually watch in-game:** of the behaviors below, the **defensive heat ball**
> is the one rendered as a live event - it's the climax of the hornet defense (see §10). The other
> three (washboarding, festooning, synchronized ventilation) aren't simulated as visible behaviors
> in the web build; they're included here as the real biology that inspired the simulation. The
> bee flight you *do* see - foragers arcing out and back, house bees hovering, drones patrolling,
> and a dancer tracing a figure-8 on the landing board - is itself emergent from simple per-bee rules.

**Behaviors emerging from simple rules:**

**Defensive Heat Ball:** *(playable - the hornet defense)*
- Japanese honeybees surround giant hornets
- Vibrate flight muscles
- Raise temperature to 45°C (113°F)
- Hornet dies at 44°C, bees survive to 48°C
- No bee "knows" the plan - emerges from attraction to hornet + vibration when crowded

**Washboarding:** *(real biology - not simulated in-game)*
- Mysterious behavior - hundreds of bees rock back and forth
- Occurs on hot afternoons
- Purpose unknown - possibly scent dispersal or cleaning
- Demonstrates behaviors we still don't understand

**Festooning:** *(real biology - not simulated in-game)*
- Bees link legs in chains during comb building
- Creates living scaffolding
- May measure distances or generate heat
- Self-organizes without blueprint

**Synchronized Ventilation:** *(real biology - not simulated in-game)*
- Fanners coordinate without communication
- Creates unidirectional airflow through hive
- Emerged pattern more efficient than random fanning

### Optimization Strategies {#optimization-strategies}

> These tips are written for the web build's actual levers: **research, dance decoding, the
> season clock, and reading the dashboard.** There's no cell-building, feeding, mite-treating,
> or drone-culling to manage - the colony handles those itself.

**Early Game (Spring):**
- Spring multiplies research points by 1.5× - decode dances now to bank points fast
- Open **Flower Memory** first (cheap, +15% to every load), then start toward **Wax Efficiency**
- Watch the dashboard's health banner; if honey dips low, lean on dance decoding to refill stores

**Mid Game (Summer):**
- Peak foraging season - keep decoding dances (clean reads add big honey/pollen bumps)
- Push the **Foraging** line (Optimal Foraging adds foragers and yield) and start **Genetics** (Hygienic Behavior) before mite load climbs
- Bank toward **Heat-Ball Defense** so a summer/fall hornet doesn't cost you hundreds of bees

**Late Game (Fall/Winter):**
- Mites grow fastest in fall - have **Hygienic Behavior**, ideally **VSH Trait**, online
- **Propolis Sealing** sharply cuts winter honey burn; **Climate Adaptation** steadies the brood nest
- Foraging stops in deep winter (no blooms), so go in expecting stores to draw down - survival is about what you banked

**General Tips:**
- Research effects stack and persist through saves - plan a path rather than buying scattershot
- A clean dance read (≤18° and within ~25%/0.4 km) is worth far more than a partial one - line up the compass dial carefully before submitting
- Keep an eye on the **mite load** bar; once it passes ~55%, it starts costing population every day
- You can't lose the colony outright - population has a floor (~11,500) - so treat it as a system to optimize, not a survival fail-state


---

## Appendix: Quick Reference

**Bee Lifespans:**
- Summer Worker: 6 weeks
- Winter Worker: 6 months  
- Drone: 90 days (evicted in fall)
- Queen: 2-5 years

**Temperature Thresholds:**
- Brood nest: 35°C (95°F) ±0.5°C
- Cluster forms: <14°C (57°F)
- Foraging stops: <10°C (50°F)
- Wax production optimal: 33-36°C

**Colony Metrics:**
- Eggs per day (peak): 2,000
- Honey to make 1lb wax: 6-8 lbs
- Daily honey consumption: 0.5-1 lb
- Foraging radius: 3 miles typical, 8 miles max
- Wing beats: 230 per second
- Flight speed: 15-20 mph

**Dance Calibration:**
- 1 second waggle = ~1 kilometer
- Figure-8 cycles indicate quality
- 10-15° typical error rate (the *bee's* natural, adaptive scatter)
- Success rate: 10% of observers recruited

> For the decode mini-game, the *player's* tolerance is separate from the bee's natural error:
> a read counts as correct within about **±18° of direction** and within **25% of the true
> distance (or 0.4 km, whichever is larger)**. The **Dance Accuracy** research widens both
> (roughly +7° and +0.3 km). A clean read recruits foragers (+3 pollen, +2 honey, +0.5 research);
> a partial read still helps a little (+1 pollen, +0.2 research).

---

*"The bee is more honored than other animals, not because she labors, but because she labors for others."* - Saint John Chrysostom

Welcome to the hive mind. May your colonies prosper, your dances be true, and your honey flow eternal.

**SimBee** - Where individual intelligence creates collective wisdom.