chaos-rpg 2.3.1

CHAOS RPG in your terminal: a roguelike where every roll is a chain of real math (Lorenz, Mandelbrot, Collatz, zeta)
chaos-rpg-2.3.1 is not a library.

CHAOS RPG

A roguelike where every hit, heal and loot drop comes from real math (the Lorenz attractor, the Mandelbrot set, Collatz) instead of a random number. Free, one-line install on Windows, macOS and Linux.

Why this over the alternatives: Random-number roguelikes feel the same run to run; here every outcome is a traceable chain of real equations you can learn to read.

Guarantee: if it doesn't do what this page says, open an issue and I'll fix it.

A roguelike for anyone who likes dice games and maths: every hit, heal and loot drop is decided by chaining real math (the Lorenz attractor, the Mandelbrot set, the Collatz sequence) instead of a random number.

Install

You have Run this
Windows (PowerShell) irm https://gitlab.com/mattbusel/chaos-rpg/-/raw/master/install.ps1 | iex
Windows (Scoop) scoop bucket add mattbusel https://gitlab.com/mattbusel/scoop-bucket then scoop install mattbusel/chaos-rpg
macOS / Linux (Homebrew) brew install mattbusel/tap/chaos-rpg
macOS / Linux (script) curl -fsSL https://gitlab.com/mattbusel/chaos-rpg/-/raw/master/install.sh | sh
Rust, prebuilt cargo binstall chaos-rpg-graphical (also chaos-rpg, chaos-rpg-proof)
Rust, from source cargo install chaos-rpg-graphical
Nothing, just a zip Latest release: Windows .zip, macOS and Linux .tar.gz, with SHA256SUMS.txt
A browser account mattbusel.itch.io/chaos-rpg

Every method gives you the same three programs:

Program What it is
chaos-rpg-graphical The game in its own window. Start here.
chaos-rpg-proof The same game on Proof Engine (preview, shown in the GIF above).
chaos-rpg The same game in your terminal. Works over SSH, no GPU.

The binaries are not code signed. If you download the zip by hand, Windows SmartScreen may say "unknown publisher": click More info, then Run anyway. On macOS, right-click the binary and choose Open the first time.

Play in 3 steps

  1. Start it. Run chaos-rpg-graphical (or double-click it). You land on the title screen.
  2. Roll a character. Pick New Game, then a mode (Story is 10 floors and a final boss), a class, a background and a boon. Your stats come from a 10-engine "destiny roll", so the same class can be a god or a corpse.
  3. Descend. On the floor map press Enter to walk into the next room, fight with A (attack), H (heavy), D (defend) or a spell number. Press Z to let auto-pilot play, and V in combat to watch the math behind each roll.

Want the same run twice? The terminal version takes a seed:

CHAOS_SEED=666 chaos-rpg          # macOS / Linux
$env:CHAOS_SEED=666; chaos-rpg    # Windows PowerShell

Each program answers --help and --version. Settings (music, difficulty tweaks, visuals) live in chaos_config.toml; see Configuration and Where your files live.

Results: the math is real

Every combat action prints the chain of engines that produced it. This frame is from the recording above: the hero's attack went Mandelbrot 0.05 -> 1.00, logistic map 1.00 -> 0.15, Euler's totient 0.15 -> -0.42, and landed on -0.417, a miss.

The pipeline is a plain library, so you can run it yourself. This is the real output of cargo run -p chaos-rpg-core --example roll -- 666 from a clone of this repository:

Attack roll, seed 666
  Logistic Map              0.500 ->  0.374
  Euler's Totient           0.374 -> -0.126
  Collatz Chain            -0.126 -> -0.657
  Modular Exp Hash         -0.657 -> -0.409
  Lorenz Attractor         -0.409 -> -0.064
  final -0.064  d20 10  (miss)

Destiny roll (all 10 engines, used for character creation), seed 666
  Lorenz Attractor          0.500 ->  0.191
  Fourier Harmonic          0.191 -> -0.383
  Prime Density Sieve      -0.383 ->  0.433
  Riemann Zeta Partial      0.433 -> -0.698
  Fibonacci Golden Spiral  -0.698 -> -0.691
  Mandelbrot Escape        -0.691 ->  1.000
  Logistic Map              1.000 ->  0.303
  Euler's Totient           0.303 -> -0.176
  Collatz Chain            -0.176 -> -0.613
  Modular Exp Hash         -0.613 ->  0.609
  final 0.609  game value 80

Run it again with the same seed and you get exactly the same numbers. That is why seeded runs are reproducible.

Use the dice in your own program

cargo add chaos-rpg-core
use chaos_rpg_core::chaos_pipeline::chaos_roll_verbose;

fn main() {
    // Same input and seed, same chain, every time.
    let roll = chaos_roll_verbose(0.5, 666);
    for step in &roll.chain {
        println!("{:<24} {:>6.3} -> {:>6.3}", step.engine_name, step.input, step.output);
    }
    println!("d20 = {}", roll.as_d20());
}

This is core/examples/quickstart.rs; run it with cargo run -p chaos-rpg-core --example quickstart. More examples, none of which open a window or play sound:

Example What it shows
cargo run -p chaos-rpg-core --example roll -- 666 An attack roll and a destiny roll with the full engine chain
cargo run -p chaos-rpg-core --example dice_stats -- 100000 How the chaos d20 is distributed over many seeds, next to a fair d20
cargo run -p chaos-rpg-core --example quickstart The snippet above

Already using rand? ChaosDie is a rand distribution, so any generator can roll chaos dice:

use chaos_rpg_core::dice::ChaosDie;
use rand::Rng;

let face: u8 = rand::thread_rng().sample(ChaosDie::d20());

Chaos dice are deliberately not fair. Over 100,000 seeds (dice_stats above) a 20 comes up 10.2% of the time and a 19 only 1.0%, where a fair d20 gives 5% each. That lopsidedness is the game.

chaos-rpg-core has no optional features. It pulls in ureq (rustls) for the daily leaderboard client, time and directories; no window or audio code.


Build from Source

Requires Rust 1.88+ from rustup.rs. Proof Engine comes from crates.io, so one clone is enough:

git clone https://gitlab.com/mattbusel/chaos-rpg
cd chaos-rpg

cargo run --release -p chaos-rpg-graphical  # bracket-lib frontend (stable)
cargo run --release -p chaos-rpg-proof      # Proof Engine frontend (preview)
cargo run --release -p chaos-rpg            # terminal frontend

Seeded runs:

CHAOS_SEED=666 cargo run --release -p chaos-rpg         # Linux/macOS
$env:CHAOS_SEED=666; cargo run --release -p chaos-rpg   # Windows PowerShell

Same seed = same character stats, same enemies, same loot, every time.


The Chaos Pipeline

This is the math under every number in the game (core/src/chaos_pipeline.rs, core/src/math_engines.rs).

There are 10 engines. Each takes a value in [-1, 1] plus a seed and returns a new value in [-1, 1]:

Engine What it computes
Lorenz Attractor steps the Lorenz system (sigma 10, rho 28, beta 8/3)
Fourier Harmonic a sum of seeded harmonics
Prime Density Sieve prime density around a seeded integer
Riemann Zeta Partial a partial sum of zeta on the critical line
Fibonacci Golden Spiral Fibonacci ratios and the golden angle
Mandelbrot Escape escape time of z -> z^2 + c
Logistic Map iterates r x (1 - x) in the chaotic regime
Euler's Totient phi(n) / n for a seeded n
Collatz Chain stopping time of the Collatz sequence
Modular Exp Hash modular exponentiation as a hash
input (-1..1), seed
  |
  v  chaos_roll_verbose: pick 4 to 8 engines from the seed,
  |  feed each engine's output into the next one
  v
ChaosRollResult
  .final_value     -1.0 .. 1.0
  .chain           every step: engine, input, output (shown in the combat log)
  .game_value      0 .. 100
  .as_d20()        1 .. 20
  .is_success()    final_value > 0.5
  .is_critical()   final_value > 0.8
  .is_catastrophe() final_value < -0.8
  • Destiny roll (character creation) runs all 10 engines in a fixed order, which is why the same class can roll wildly different stats.
  • Biased rolls blend the chain's result toward a bias, so stats and difficulty tilt the odds without removing the chaos.
  • Corruption: every 50 kills is one corruption stage (up to 8). Each stage mutates the Lorenz, logistic and Mandelbrot engines, and every second stage adds one more engine to the chain. From 400 kills on, a roll has a 5% to 20% chance to backfire and flip negative.
  • EngineLock crafting locks an engine into an item's rolls.

Same input and seed always give the same chain, so seeded runs are fully reproducible.

Chaos Engine Visualizer: Press [V] during combat to open a live overlay showing the full engine chain - engine name, raw input, output, delta, and a magnitude bar for each step in the current roll.


Three Frontends, One Game

All frontends share the same core library (chaos-rpg-core), so the game plays the same everywhere.

Proof Engine frontend (preview)

Built on Proof Engine, a mathematical rendering engine written from scratch in Rust. What the game runs today:

  • Chaos field: the animated background of mathematical glyphs behind every screen
  • Combat lighting: per-room lighting presets and element-tinted light on enemies
  • 12 boss overlays: one visual overlay per unique boss (Mirror symmetry line, Fibonacci Hydra spiral, Null blackout and so on)
  • Particles and effects: hit, spell and status particles, debris, screen transitions
  • Music: the procedural soundtrack follows the screen and the fight
  • Auto-pilot (Z) and a debug overlay (profiler, inspector, console)

The source tree also holds modules that are written and unit tested but not wired into the game yet: cinematics, weather, steering/behaviour-tree/GOAP AI, isometric terrain, economy, dialogue trees, mod loading, replays, extra save slots, shader presets and an audio-reactive layer. They compile with the frontend but nothing calls them.

Graphical (bracket-lib OpenGL)

  • Fullscreen OpenGL window at 160×80 tiles
  • Animated HP/MP bars, 5 color themes, chaos field background
  • The stable, recommended way to play

Terminal (ratatui)

  • Runs in any terminal emulator (80×24 minimum)
  • Full color, keyboard driven, works over SSH
Theme Vibe
VOID PROTOCOL Deep space violet/indigo, electric blue
BLOOD PACT Gothic crimson on near-black, ember accents
EMERALD ENGINE Matrix green circuit geometry
SOLAR FORGE Amber/gold alchemical heat
GLACIAL ABYSS Crystalline ice blue, zero-precision cold

Game Systems

Game Modes

Mode Description
Story 10 floors, structured narrative, final boss. Recommended for new players.
Infinite Floors never end. Score goes on the leaderboard. Enemies scale exponentially.
Daily Seed Same dungeon for everyone today. Resets at UTC midnight. Score submits to the global leaderboard.

Title Screen Keys

Key Opens
[N] New game
[C] Continue saved run
[T] Cycle color theme
[?] Tutorial (5 slides)
[J] Achievements (175 total)
[A] Achievements browser (terminal)
[H] Run history
[D] Daily leaderboard
[E] Bestiary (graphical)
[X] Codex (graphical)

Character Creation

Pick a name, class, background, and difficulty. Stats are rolled by chaining a Destiny Roll → Lorenz attractor → full chaos pipeline. Same class, different character every time.

In the graphical version: press [N] on the character creation screen to type your character's name (up to 20 characters). Leave blank to default to "Hero".

12 Classes:

Class Passive Ability
Mage Critical spells deal ENTROPY/10 bonus damage
Berserker Below 30% HP: +40% damage, attack twice on crit
Ranger PRECISION/20 bonus accuracy every attack
Thief CUNNING/200 + 10% dodge on incoming hits
Necromancer On kill: absorb 8% of enemy max HP
Alchemist Items and potions grant 50% more effect
Paladin Regenerate (3 + VIT/20) HP at turn start
VoidWalker ENTROPY% chance to phase through any attack
Warlord Commands soldiers; morale affects damage
Trickster Illusion attacks; confusion skills
Runesmith Inscribes weapons mid-combat for effects
Chronomancer Manipulates action order; time-dilation spells

8 Backgrounds:

Background Starting Bonus
Scholar +15 MANA, +10 ENTROPY
Wanderer +15 LUCK, +10 PRECISION
Gladiator +15 FORCE, +10 VITALITY
Outcast +15 CUNNING, +10 ENTROPY
Merchant +15 CUNNING, +10 LUCK
Cultist +20 MANA, +20 ENTROPY, -10 VITALITY
Exile +20 CUNNING, +10 ENTROPY, -10 MANA
Oracle +20 LUCK, +10 MANA, -15 FORCE

4 Difficulties: Easy (0.7× enemy damage, score ×1) → Normal (score ×2) → Brutal (1.4×, score ×4) → CHAOS (2×, all random effects maximized, score ×10)

Stats can be negative. A character with -40 force genuinely fights at a disadvantage - but the Misery System compensates.

The Boon System

After character creation, choose one of three randomly offered permanent bonuses. These range from stat boosts to starting items to passive abilities. Only one per run. The graphical selection screen shows full boon details in a right-side panel.

Combat

Round structure:

  1. Player chooses action
  2. Player action resolves (damage = force × chaos_roll / 50)
  3. Enemy counterattacks (if alive)
  4. Status effects tick (burn, freeze, stun, bleed, poison)
  5. Class passive fires

Actions:

Key Action
A Attack - basic melee, scales with force
H Heavy Attack - more damage, lower accuracy
D Defend - reduce incoming damage this round
T Taunt - force enemy to attack you
F Flee - luck+cunning roll to escape
1-8 Cast spell - costs mana, chaos-powered
Q-O Use item from inventory
V Toggle Chaos Engine Visualizer overlay

Auto-Pilot

Press [Z] on the floor map to activate Auto-Pilot. The AI handles all navigation and combat decisions automatically, pausing at:

  • Item pickup prompts
  • Shop / Crafting screens
  • Game Over / Victory

When active, the floor map shows "◆ AUTO-PILOT [Z] to stop" - press [Z] again to resume manual control. The terminal version shows [AUTO PILOT ON - Z to stop] in the status line.

Power Tiers

The sum of all 7 stats determines your Power Tier, displayed next to your name. 40 tiers from THE VOID to OMEGA. OMEGA-tier characters render with animated rainbow text. Negative-tier characters have glitch, static, and inversion effects on their display.

The Misery System

Suffering accumulates into the Misery Index. The worse things go, the more powerful the compensations become.

Misery milestones:

  • 5,000: Spite resource unlocks. Enemies randomly miss you (up to 25%).
  • 10,000: Defiance activates. Near-death amplifies power.
  • 25,000: Cosmic Joke. The game acknowledges what's happening.
  • 50,000: Transcendent Misery. Suffering becomes direct power.
  • 100,000: Published Failure. Immortalized in the Hall of Misery.

Underdog Multiplier: Negative total stats give a logarithmic XP and score bonus. A character at -200 total stats earns roughly ×2.3 XP per kill.

Spite Actions: Spend Spite points on revenge abilities - Spite Strike (+50% damage), Bitter Endurance (absorb one hit), Chaos Spite (invert an enemy roll).

The Passive Skill Tree

~820 nodes organized as 8 class-specific rings × 5 levels, connected by bridge clusters. Earn passive points from leveling up and defeating bosses. Start adjacent to your class entry node and traverse outward. Keystones at the tree's deep nodes provide game-changing abilities.

Press [P] on the character sheet to view the full tree. Press [N] anywhere to auto-allocate all pending points.

The Nemesis System

If you flee from an enemy or barely survive a fight, that enemy may be promoted to Nemesis:

  • Gains 50–200% HP bonus
  • Gains +25% damage
  • Gains a unique ability based on the encounter (fire kills → Immolation, spell kills → Spell Reflection)
  • Returns on a later floor titled "Slayer of [your name]"
  • Killing a Nemesis gives 3× XP, 3× gold, and a Legacy achievement

The 12 Unique Bosses

Each boss targets a specific build archetype:

Boss Floor Counter
The Mirror 5+ Copies your exact stats - exploit your class passive
The Accountant 10+ Sends you a bill based on lifetime damage dealt - defend repeatedly
The Fibonacci Hydra 15+ Splits on death following Fibonacci sequence - burst damage or survive 10 splits
The Eigenstate 15+ Superposition of 1 HP (instant kill) or 10,000 HP (no attack) - Taunt to reveal
The Taxman 20+ Taxes your gold every round at escalating rates - kill it fast
The Null 25+ Nullifies the chaos pipeline - base stats only, status effects still work
The Ouroboros 30+ Heals from damage, remembers attack patterns - vary your attacks
The Collatz Titan 35+ HP follows Collatz sequence - force it into powers of 2
The Committee 40+ 5 members vote on whether your attack resolves - majority rules
The Recursion 50+ Deals damage equal to all damage dealt this fight - burst or die
The Paradox 75+ Inverts defense stats - high Vitality becomes a liability
The Algorithm Reborn 100 The dungeon itself, fully aware - adapts to your playstyle across 3 phases

Full boss strategies: docs/BOSSES.md

Crafting

At Crafting Bench rooms, nine operations are available. The graphical version shows the selected item's current modifiers in a right-side detail panel.

Key Operation Effect
1 Reforge Chaos-reroll all stat modifiers from scratch
2 Augment Add one new chaos-rolled modifier
3 Annul Remove one random modifier
4 Corrupt Choose risk tier (Safe/Risky/Reckless) - unpredictable chaos effect
5 Fuse Double all values and upgrade rarity tier
6 EngineLock Lock a chaos engine into the item permanently
7 Shatter Destroy the item and scatter its modifiers to other items
8 Imbue Grant the item 3 charges (bonus effect on use)
9 Repair Restore item durability to maximum (costs gold)

Item Filter: Press / in the item selection screen to type-ahead filter by name or rarity. Clear the filter with Escape.

Achievements

175 achievements across 7 rarity tiers, tracked persistently across all runs.

  • Graphical: Press [J] on the title screen
  • Terminal: Press [A] on the title screen - shows unlocked/locked tabs, rarity colors, progress bars, filter by All/Unlocked/Locked
Tier Examples
Common Reach floor 5, deal first kill
Uncommon Win on Hard, reach floor 15
Rare Beat a Nemesis, win with negative stats
Epic Win on Chaos difficulty, floor 100
Legendary Complete all class masteries
Mythic Floor 500, 10,000 total kills
Omega Transcendent feats across the entire run history

Unlocked achievements display full name, description, and unlock date. Locked achievements show ??? until earned.

Bestiary

Press [E] on the graphical title screen to open the Bestiary. Every enemy you have encountered is recorded with:

  • Times seen, times killed, times it killed you
  • Maximum damage dealt
  • Lore snippet

The bestiary shows 66 entries at once on the full 160×80 canvas and scrolls with ↑↓.

Codex

Press [X] on the graphical title screen to open the Codex - a lore encyclopedia covering world lore, item descriptions, spell origins, and narrative fragments discovered during runs. Entries unlock as you encounter the corresponding content.

Run Narrative

After each run, a procedurally generated narrative is recorded in the run history - a short story summarizing the key moments of your run (first kill, near-death moments, nemesis encounters, final fate). Press [H] on the title screen and select a run to read its full narrative.

Run History

Press [H] on the title screen to view a scrollable table of all past runs. The graphical version shows 62 runs at once with extended columns: class, floor, score, kills, mode, difficulty, gold, power tier, and cause of death.

Daily Leaderboard

Press [D] on the title screen to view the daily leaderboard. Daily Seed mode uses the same dungeon for all players on a given UTC day. Your best score per day is always kept locally.

Sharing scores needs a leaderboard server, and none is configured by default (the old default server no longer exists). server/worker.js is a complete one for Cloudflare Workers' free tier: deploy it with wrangler deploy (instructions at the top of the file) and put its URL in [leaderboard] url in chaos_config.toml. Daily Seed runs are then submitted automatically.

  • Today's seed is shown at the top of the screen
  • Your personal best for today is shown below the seed
  • The global rankings are listed by rank, name, class, floor, score, and kills
  • Press [R] to refresh the remote scores

Audio

All sound is synthesized procedurally at startup - no audio files. Every SFX (attacks, spells, level-ups, death) and music loop (menu, exploration, combat, boss, cursed floor) is built from oscillators, ADSR envelopes, and filters seeded from the current floor.

Music vibes (set in chaos_config.toml):

  • chill (default) - ambient, low-tempo
  • classic - heavier, more intense
  • minimal - sparse, almost silent
  • off - no music, SFX only

Audio degrades gracefully - if no audio device is found, the game runs silently.

Saving, Scoring, and Legacy

Per-run save: Auto-saves between floors (see Where your files live)

Scoreboard: Top scores saved locally

score = kills × floor × difficulty_multiplier × chaos_bonus × underdog_multiplier

Hall of Misery: Separate leaderboard for misery_index × floor × underdog_mult

Legacy system:

  • 175 persistent achievements across all runs across 7 rarity tiers
  • Full run history with per-run statistics and procedural narratives
  • Character graveyard with procedurally generated epitaphs
  • Hall of Misery historical records

Configuration

chaos_config.toml is read on startup (see Where your files live). All fields are optional - defaults are used for anything not specified.

[audio]
# Music vibe: chill (default) | classic | minimal | off
music_vibe = "chill"
# Master music volume (0.0 = silent, 1.0 = default, 2.0 = double)
music_volume = 1.0
# Master SFX volume
sfx_volume = 1.0

[display]
# Multiply particle drift speed (1.0 = default)
particle_speed_mult = 1.0
# Override kill-linger frame count (0 = engine default ~45)
kill_linger_frames = 0
# Halve all visual timings (same as FAST_MODE=1 env var)
fast_mode = false

[gameplay]
# Bonus gold at run start (0 = none)
starting_gold_bonus = 0
# Scale all enemy HP and damage (1.0 = normal, 2.0 = double)
difficulty_modifier = 1.0
# Force a specific seed for Infinite mode (0 = random)
infinite_seed_override = 0
# Disable mechanics
disable_hunger = false
disable_nemesis = false
disable_corruption = false
# Extra inventory slots (0-20)
extra_inventory_slots = 0
# XP multiplier bonus (0.0 = none, 1.0 = double XP)
xp_multiplier = 0.0

[leaderboard]
url = ""  # empty: local only; see "Daily Leaderboard" for running a server
submit_daily = true
fetch_on_open = true

[meta]
# Override player name shown in leaderboard submissions
player_name = ""

Where your files live

Saves, scores, achievements, the bestiary, run history and chaos_config.toml are looked up in this order:

  1. The folder in the CHAOS_RPG_DATA_DIR environment variable, if set.
  2. Next to the program, if the file is already there (older versions saved there, and the zip downloads ship chaos_config.toml there).
  3. Your user data folder, created on first use: %APPDATA%\chaos-rpg\data on Windows, ~/Library/Application Support/chaos-rpg on macOS, ~/.local/share/chaos-rpg on Linux.

Before 2.3.0 everything was written next to the program, which failed silently when that folder was read-only and filled ~/.cargo/bin after cargo install.

Room Types

Icon Room What Happens
[x] Combat Enemy encounter. No free escape.
[*] Treasure Free item - sometimes cursed.
[$] Shop Buy items, spells, healing with gold. Graphical version shows your inventory in a right-side panel.
[~] Shrine Stat bonuses or healing.
[!] Trap Unavoidable damage or debuff.
[B] Boss Unique boss encounter.
[^] Portal Skip to a later floor. Risk vs reward.
[8] Chaos Rift Pure chaos event. Anything can happen.
[c] Crafting Modify items at the bench.

Project Structure

A Cargo workspace of six crates (core, audio, terminal, graphical, graphical-proof, web). The Proof Engine frontend uses Proof Engine from crates.io.

chaos-rpg/
├── core/                         # chaos-rpg-core: all game logic
│   └── src/
│       ├── character.rs              12 classes, 8 backgrounds, stat rolling, passives
│       ├── combat.rs                 round resolution, chaos-powered damage
│       ├── chaos_pipeline.rs         10-engine mathematical chain
│       ├── bosses.rs                 12 unique bosses with custom mechanics
│       ├── passive_tree.rs           ~820-node skill tree
│       ├── misery_system.rs          Misery Index, Spite, Defiance
│       ├── achievement_system.rs     175 achievements, 7 rarity tiers
│       └── ... (77 source files)
│
├── graphical-proof/              # chaos-rpg-proof: PROOF ENGINE FRONTEND
│   └── src/
│       ├── main.rs                   ProofGame impl, game loop, screen dispatch
│       ├── state.rs                  150+ field game state
│       ├── theme.rs                  5 themes with engine shader properties
│       ├── lighting.rs               PBR room/combat/boss/floor lighting
│       ├── shader_presets.rs         theme/floor/corruption/boss/status compositing
│       ├── cinematics.rs             boss entrances, death/victory, milestones
│       ├── enemy_ai.rs               steering, behavior trees, GOAP, utility AI
│       ├── weather_system.rs         10 weather types, floor-reactive
│       ├── terrain_map.rs            isometric noise terrain, room elevation
│       ├── game_economy.rs           supply/demand, faction treasuries
│       ├── dialogue_system.rs        Archivist, boss, NPC, codex dialogues
│       ├── mod_system.rs             mod loader, 11 hooks, hot-reload
│       ├── replay_system.rs          recording, playback, ghost runs
│       ├── save_upgrade.rs           5 slots, visual snapshots, cloud sync
│       ├── effects/boss_visuals.rs   12 unique boss visual overlays
│       ├── scenes/chaos_field.rs     2000+ glyph mathematical background
│       ├── screens/                  19 fully implemented screens
│       └── ... (54 source files)
│
├── graphical/                    # chaos-rpg-graphical: bracket-lib frontend
├── terminal/                     # chaos-rpg: terminal frontend
├── audio/                        # chaos-rpg-audio: procedural synthesis
├── web/                          # web frontend: macroquad
│
│
├── server/                       # Cloudflare Worker leaderboard
└── docs/                         # Guides, mechanics, boss docs

Contributing

Issues and pull requests welcome. For large changes, open an issue first.

The chaos pipeline parameters (Lorenz σ/ρ/β, Mandelbrot max_iter, bifurcation r range) are intentionally tuned - changes there have cascading effects on all game balance. Test thoroughly.


Further Reading