📖 Documentation

Choose Your Own Start

The gacha is a story-writing tool first and a roller second. If you're starting a new adventure and want a template — how your character got the gacha, and what they begin with — pick one option from each list, or just take inspiration. It's all optional.

Method of acquisition

How you stumbled onto the Chaos Gacha and got hold of its power.

• 1 — Patron From Beyond. Found drifting in the wrong afterlife, or noticed by an outer god who gifted you the gacha for its own amusement before sending you to a world of its liking. Entertain it well enough and you may yet meet your patron face to comprehensible face.
• 2 — The Entertainer. Chosen as entertainment by beings beyond understanding, handed the gacha to sow chaos and change the world. No deadlines — with the gacha, entertaining results are guaranteed.
• 3 — Information Storm. Died, slipped off the road to the afterlife, and met a massive chaotic storm in deep space that looked like a game bug. Your existence was rewritten by chaotic information, configuring itself as the gacha.
• 4 — Pure Chance. You hit a one-in-10²⁰⁰ lottery coincidence and connected to the infinite ever-changing chaos at the centre of everything and nothing.
• 5 — Native Link. Your universe already had one link into the gacha — a semblance, a devil fruit, a sacred gear — and you got your hands on it. Only one existed in all of reality, so good job.
• 6 — Mysterious Stranger. Won a small "harmless" bet against a stranger in a formal suit and fedora. God or devil, test or whim — either way, you now hold infinite chaos.

Starting options

How you ended up where you ended up — and what tickets you start holding.

• 1 — Transmigration. Still you, baseline human, fresh body in a new world with maybe some downloaded local knowledge — clothes on your back and the gacha in your soul. Starts with: 3× Random Gold tickets.
  Start with these
• 2 — Native. You live here; this is all normal to you. Prior training and an established backstory — but less starter pity. Starts with: 1× Random Gold Start, or 2× Random Silver Start, or 3× Random Bronze Start.
• 3 — Take Over. You woke in a canon character's body with their memories, training, and powers. No starter pity — go earn your own tickets. Starts with: no tickets.
• 4 — Changed Fate. You were meant to be the fated protagonist with a cheat — instead the multiverse replaced it with the gacha, and there's no canon to lean on. Starts with: 1× Platinum Random + 2× Gold Random Start, or 1× Triple-Advantage Platinum Random (roll all three, keep the best) Start.

Tickets & feats

In stories using the gacha, tickets are earned through feats — anything impressive you accomplish. The more impressive the feat relative to your power, the better the ticket. Killing a city-destroying kaiju guarantees a good ticket; whether it's Platinum or Legendary depends on how outmatched you were.

Feats are judged by the weight of the act, not semantics: one action earns one feat, and repeatable deeds cap out (pickpocketing 10 people may earn bronze, 50 may earn silver, but no amount of pickpocketing regulars earns gold).

Feat tiers

• Trash — barely feats at all, given as an insult or tease: showing up on time, losing gracefully.
• Bronze — notable but unpowered deeds: a fair fight won, wolves hunted, a job landed.
• Silver — peak-human or low supernatural: impressing crowds, taking a gang hideout, killing a bear bare-handed.
• Gold — firmly impressive: guarded-bank heists, escaping death sentences, beating city-wrecking foes.
• Platinum — true accomplishments: unbreakable records escaped, foes that level city blocks beaten.
• Aluminium — joke-tier quest rewards between gold and platinum: twenty rat pelts, an errand for Pepsi Man.
• Diamond — extraordinary and rare: saving cities, slaying Nomu-class threats.
• Legendary — legend-making: stealing Thanos' gauntlet, winning Holy Grail Wars, saving countries.
• Mythical — shoulder-to-shoulder with gods: besting Sword Saints, pacifying Scion, shaking universes.
• Divine — supremacy proofs: defeating Scion or Goetia alone, conquering worlds.
• Wild — off the scale entirely: doing something incomprehensibly random in an extreme situation and coming out on top against all odds anyway.

Ticket anatomy

A ticket has a rarity (which pool it pulls from) and a category (ability, item, skill, trait, familiar — or random, which picks one). Tickets can also carry an optional theme tag (e.g. dragonic undead holy): the roll then only picks entries carrying that tag. Some tickets carry a prefix such as Advantage: roll twice, keep the better. The tree app adds traversal tickets — skip, jump, choice-jump, hop — covered under the Chaos Tree tab.

Which feats earn which categories

• Ability — displays of power, defeating enemies.
• Trait — resilience, survival, changing the status quo.
• Skill — expertise and finesse.
• Item — acquiring things, heists, treasures.
• Familiar — companionship, taming, diplomacy.

Overlaps are settled by author discretion — the story matters more than the rules.

Categories

Story rules for what each category means. The apps hand you the entries; they don't enforce slots, energy, or cooldowns.

Abilities

Supernatural powers held in ability slots (one by default, +1 per five abilities) and fired with energy. Power scales with your stats and with rarity — don't expect a rare dispel to beat a legendary fireball. Foreign abilities accept your own energy instead of their native source.

Abilities classify roughly like this: Enhancer, Emitter, Thinker, Tinker (interface/build tech; blackboxed by default), Alteration, Manipulation/Kinesis, Recovery, Mover, Changer, Stranger, Master, Passive.

Traits

Passive or reactive modifiers that cost no energy, take no slots, and can be toggled — luck, resistances, allure, world-tweaks. Race traits are permanent once toggled on (hybridizing you), but can be rerolled beforehand.

Items

Anything that isn't an ability, trait, familiar, or skill: weapons, armour, consumables, potions — even placed structures. Actives may carry a cooldown; consumables may carry a restock timer that starts when you take the item out and ends when you may take another.

Familiars

Independent, distinctly inhuman beings — absolutely loyal and obedient even when grumpy, summonable to and from familiar space where they rest and heal, able to draw on your energy with consent. Standard gear included. Tame a non-human creature and it joins the list with the same benefits. (Digimon here are living creatures that don't evolve; Pokémon can't evolve and use level-up/egg moves unless stated.)

Skills

Pure downloaded knowledge and experience — comfortable after a small headache. Roughly: Basic ≈ 1 year of training, Intermediate ≈ 5, Adept ≈ 10, Expert ≈ 25, Master ≈ 100, Grandmaster ≈ one-in-a-billion talent plus work, Divine ≈ surpass-the-gods.

Rolling

Set a minimum, average, and maximum (or pick a preset ticket), choose a category, and roll. Average is the distribution's centre of gravity: at average 2.0 over many rolls, results cluster in 1.9–2.1.

Rarity ladder

0.1–0.9 Trash · 1.0–1.9 Common · 2.0–2.9 Uncommon · 3.0–3.9 Rare · 4.0–4.9 Elite · 5.0–5.9 Epic · 6.0–6.9 Legendary · 7.0–7.9 Mythical · 8.0–8.9 Divine · 9.0+ Transcendent

Ticket presets

Bronze ⌀1.3 · Silver ⌀2.3 · Gold ⌀3.3 · Platinum ⌀4.3 · Diamond ⌀5.3 · Legendary ⌀6.3 · Mythical ⌀7.3 · Divine ⌀8.3 · Transcendent ⌀9.3 (each with a matching min/max window).

What you get

Vehicles, locations, and other big entries arrive self-contained and at your disposal: you get the thing itself, functional, without its home setting, apocalypse, or cast unless its description explicitly includes them.

Filters & tickets (this version)

Narrow the pool by text, source checkboxes, rarity band, theme tag (entries tagged dragonic undead holy etc. — shown as pills on every card), NSFW/Tech toggles (NSFW hides by default), or skip already-rolled results. The ticket wallet holds tickets you spend one at a time (each ticket can also carry its own theme tag, combined with the filter); ×10 does ten quick rolls at once. History, stats, and exports live under their tabs.

Theme tags (for authors)

Tags live in the gacha definition files as leading tokens: #(Tag:holy) Create and control holy water… or several at once as #(Tag:dragonic)(Tag:undead) … / #(Tags: dragonic, undead) …. Names are lowercase letters/numbers/hyphens (draconic aliases to dragonic). Tagged entries show pills across the gacha, entries, tree, and casino views, and can be rolled/filtered by tag. See tools/tag_entries.py for the curated starter set and its keyword heuristics.

Curse Roulette

Curses are rolled from the Curse Roulette, most often taken at the start of a gambler's journey when their tickets don't feel like enough for the challenge ahead, or whenever the Roulette is offered to them. A curse can add a status condition, warp the world they're in, or both — but a curse will never directly put you in a certain-death position.

Most curses — at least the ones that don't alter the world — come with a Resolve Condition. Meet it and the curse's effects end and it disappears from you for good. The rest are one-and-done deals with no way out but living with them.

Spin & severity

One spin rolls a d20, which sets the curse's severity, then draws a random curse of that severity:

Rewards

By default, spinning pays out a gacha ticket for the trouble. Rewards follow the source table:

This app's ticket wallet has no Advantage flag, so Medium's Advantage Gold Random is granted as two Gold Random tickets; Major and Ultimate let you choose the category before sending the reward.

In this app

• Rewards go to the same ticket wallet as the gacha roller — open the Gacha to spend them. Nothing is added until you press Send reward to ticket wallet.
• Award tickets for spins can be switched off if you want curses without the payout.
• Hide NSFW curses keeps mature entries out of the pool (on by default), and Spin slowdown controls the wheel — the result is decided before the spin, so the wheel is pure theatre.
• Copy grabs the curse, its resolve condition and its reward as text for your story. History keeps your recent curses with a ✓ button to track which ones you've resolved.

Open the Curse Roulette →

Chaos Tree

A generated web of every entry, arranged in a sphere by rarity. The free Origin root starts unlocked; every other node costs 1 core + 10^rarity points. Tickets grant 1 core each and pool their points into a shared wallet.

Seeing & unlocking

By default you see and can unlock only nodes adjacent to yours (⬡ marks the ones you can afford right now). Skip N reaches up to N extra hops out; [Type] Jump takes the closest node of a category not touching a chosen node; Choice N Jump lets you pick among the N closest; Hop unlocks a distant node plus one free node on the way.

Tree-meta nodes

Special ability/item/trait entries that grant powers while unlocked: extended sight, name/description/source tracing, full-tree reveals, +% ticket points, Echo double payouts, lock-and-refund, lifelines, recalls, added links, topology shuffles, random unlocks, and core-free (10x points) unlocks within two connections of the root. Full list with rarities is in the trees README.

Saves & versions

Each named tree keeps its own progress automatically. Export a tree + progress as one file; imports accept those or Python-generator tree JSONs. Copy duplicates progress, Fresh restarts the same parameters. Every tree records the data version it was generated with — a mismatch warning means regenerating now could reshape it, so back up first.