Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jkh2/Primordial-Sim/llms.txt
Use this file to discover all available pages before exploring further.
Open the simulation
Navigate to https://jkh2.github.io/Primordial-Sim/ in any modern browser — Chrome, Firefox, Safari, or Edge. No install, no plugins, no build step required.The simulation starts immediately. A splash screen (hint card) displays the core controls. It dismisses automatically on your first interaction.
Choose a scenario preset
Open the World tab in the left panel and find the Scenario Presets dropdown. Six presets are available:
Selecting a preset immediately resets the world with its tuned parameters. See Scenario Presets for a full breakdown of each.
| Preset | Organisms | Food | Species | Character |
|---|---|---|---|---|
| Stable Eden | 4,000 | 3,000 | 5 | Peaceful aquarium, high food, territories form gradually |
| Arms Race | 5,000 | 1,800 | 4 | High mutation, rapid evolution under moderate scarcity |
| Battle Royale | 12,000 | 600 | 6 | Massive population, almost no food, fast carnage |
| Superorganism | 6,000 | 2,500 | 4 | Max flocking — species move as tight swarms |
| Food Chain Cycle | 4,500 | 2,200 | 3 | Rock-paper-scissors predation, oscillating populations |
| Extinction Event | 8,000 | 4,000 | 8 | Abundant start, food dries up, reveals which traits survive |
Interact with the canvas
Click and right-click directly on the simulation canvas to shape the ecosystem in real time:
- Left-click — Drop a cluster of 8 food pellets within a ~30px radius at the cursor position. Use this to rescue a starving population or attract organisms to a region.
- Right-click — Spawn a group of 5 organisms of a random species at the cursor. Useful for reintroducing a species or seeding a new area.
- Hover — Move the cursor over any organism to open an inspection tooltip showing its species, size, energy, age, kill count, and all four gene values.
Control time with keyboard shortcuts
Use your keyboard to manage simulation speed without touching the UI:
| Key | Action |
|---|---|
Space | Pause / Resume |
1 | Speed 0.5x (slow motion) |
2 | Speed 1.0x (default) |
3 | Speed 2.0x |
4 | Speed 5.0x (turbo) |
S | Toggle ambient sound |
L | Toggle AI Lab Partner panel |
Read the UI panels
Two panels frame the canvas:Left panel — Simulation ControlsFive tabs let you tune every aspect of the world:
- World — organism count, food settings, speed slider, real-time population graph, and species census
- Species — species count, starting size, max size, organism speed, lifespan, reproduction thresholds, offspring count, and food oases
- Rules — predation toggles (same-species protection, food chain mode), size advantage ratio, energy from eating, and the five behavioral drive sliders (Hunt, Flee, Flock, Food Attraction, Separation)
- Evolve — enable/disable mutation, mutation rate and strength, and per-trait evolution toggles for Speed, Aggression, Efficiency, and Perception
- Visual — additive glow, death particles, oasis indicators, food glow intensity, and trail length
L or click the star icon (⚛) in the top-right corner to open the AI Lab. Configure your AI provider, then ask the assistant to analyze the ecosystem, design experiments, compare species, or write a full research report. See Controls & UI for full details.Next steps
Controls & UI
Full reference for all mouse controls, keyboard shortcuts, panel tabs, stats bar, and the organism tooltip
Scenario Presets
Detailed breakdown of all six presets and when to use each one