Character Keeper

A single-page app for keeping tabletop RPG characters — OSR / old-school systems (Shadowdark, Worlds Without Number, OSE, …), Unknown Armies 3rd Edition, Basic Roleplaying (BRP), and Silent Legions — and running basic combat. Settings → System switches which ruleset's characters, Compendium, and Bestiary you're looking at. BRP ships with its own bundled Compendium (Powers and Equipment) and Bestiary (creatures and sample NPCs). All bundled BRP data comes only from the Basic Roleplaying: Universal Game Engine core book (Chapters 4, 8, and 11), which is published under the ORC license; nothing comes from Basic Roleplaying: Creatures. Combat shows its characteristics/Armor/Damage Bonus instead of the OSR AC/HD. Silent Legions book content (Compendium, Bestiary, random tables) can be loaded from your own PDF; see Silent Legions below. Unknown Armies Combat counts wounds up to the wound threshold, and its book content can be loaded from your own PDFs; see Unknown Armies. Plain HTML/CSS/JS — no build step, no backend, no account, nothing leaves your browser (unless you turn on the optional Dropbox sync).

• Live: deployed to GitHub Pages from main (see the repo's Pages settings for the URL).
• Local: serve the folder with any static web server, for example python3 -m http.server, then open http://localhost:8000/. Opening index.html as a file (file://) does not work: the app loads its data files over http.
• A reload opens the tab that was open last (stored in this browser only).

---

Your data

Everything is stored in your browser's IndexedDB (database osr_store). It survives reloads and browser restarts, but it is per-browser and per-machine. (Older versions used localStorage; the first start of this version moves that data into a campaign named "Default".)

Campaigns. The selector at the top right, next to the Dropbox and Export buttons, switches between campaigns. Its last option, + New campaign…, creates one. Each campaign has its own characters, Journal, log, trackers, combat, Bestiary, Compendium, and settings (theme and System too). A new campaign starts with the default Bestiary and Compendium of every system, and no example characters. Settings → Campaign renames or deletes the current campaign. Export, Import, and Dropbox sync work on the current campaign.

• Export (top bar) downloads a single osr-manager-YYYYMMDD.json with all your data — characters, notes, consumables, the monster library, the current encounter, map scenes, settings and the log. When the campaign has map images, Export asks first: with Include map images, you get osr-manager-YYYYMMDD.zip with the same data and every map image. Import reads both.
• Import offers Replace all or Merge (adds the file's characters + monsters to what you have). A content pack (a file with a pack header, such as the Unknown Armies catalog below) never replaces the whole campaign. Import opens a window that lists the pack's items:
  • Groups are Compendium (by category), Bestiary, and Tables (by output). Click ▸ to show the entries of a category.
  • Tick or untick a group, a category, or one entry. Select all and Select none change every entry. The summary shows how many items are added and replaced.
  • An entry you already have (same name) shows you have it. It is skipped, unless you tick Replace the items I already have. A replaced item keeps its place (and a table its name, so the tables that roll on it still work).
  • Import adds what is ticked and switches System to the pack's system. Cancel, ×, or Escape adds nothing.
  • To write a tool that makes packs, see docs/content-pack-format.md.

Use Export/Import to back up, move between machines, or share a party.

Dropbox sync (optional)

Settings → Dropbox sync keeps the campaign in your Dropbox, so every browser where you connect has the same data. It is off until you click Connect.

• Your Dropbox app folder (Apps/<app name>/) holds a campaigns folder: the list of campaigns, and one folder for each campaign with one file for the shared data (shared.json) and one for each system (osr.json, ua3e.json, brp.json, sl.json). A change uploads only the file it changed. Map images are in the campaign's maps folder; another browser downloads an image when it first shows its scene. The seeds folder holds the default Bestiary and Compendium of each system, with any content pack you imported. The app can see only its own folder in your Dropbox, nothing else.
• Every browser where you connect sees every campaign. A campaign made in another browser is downloaded when you first open it.
• Older versions kept the whole campaign in one file, Character Keeper campaign.json. The first sync of this version splits it and keeps the old file as Character Keeper campaign (before split).json. That file has the same format as Export, so Import can read it.
• After each change, the app uploads the changed files a few seconds later. The header shows the state: Synced, Saving…, Reconnect, Resolve, or Sync error. Click it to sync now.
• When you open the app, or come back to its tab, it checks Dropbox. If only Dropbox changed, the app loads the Dropbox copy. If Dropbox and this browser both changed, the app asks which copy to keep. The first time you connect a browser to a Dropbox that already has a campaign, it asks too.
• You connect once per browser. The sign-in does not expire. The header shows Reconnect only if you remove the app from your Dropbox account.
• Disconnect stops the sync. The campaigns stay in this browser and the files stay in Dropbox.

Connect.

1. Click Connect. This tab goes to Dropbox.
2. Click Allow. Dropbox sends you back to the app, and the sync starts.

If you cannot register the app's address (step 3 of Setup), use connect with a code under Setup instead. Dropbox opens in a new tab and shows a code. Paste the code into the box under Dropbox sync, and click Finish.

Setup (once). The app needs a Dropbox app key:

1. In the Dropbox App Console, click Create app. Choose Scoped access and App folder, and give the app a name. The name is also the folder name under Apps.
2. On the Permissions tab, tick files.content.write and files.content.read. Click Submit.
3. On the Settings tab, keep Allow public clients (Implicit Grant & PKCE) on Allow. Under Redirect URIs, add the app's address and click Add. Settings → Dropbox sync → Setup shows the address to add. Add one for each place where you open the app, for example the GitHub Pages URL and http://localhost:8000/.
4. In the app, open Settings → Dropbox sync → Setup and paste the App key. It is stored in this browser only. (A deployment can also set DEFAULT_APP_KEY in js/dropbox.js, so its users don't have to.) The app key is not a secret. Never paste the app secret.

A new Dropbox app is in Development status. In that status, up to 500 Dropbox accounts can connect, which is enough for a gaming group.

If Connect fails:

• The Dropbox page shows Invalid redirect_uri: the app's address is not in the app's Redirect URIs. Add it (Setup step 3), or use connect with a code.
• Dropbox did not accept the sign-in or the code: the code is single-use and expires after a few minutes. Click Connect again.
• The Dropbox page shows Invalid client_id: the app key is wrong. Copy it again from the App Console.
• The header shows Sync error with missing_scope: tick the permissions in step 2, click Submit, then click Disconnect and Connect again. A token keeps the permissions the app had when you connected.
• With connect with a code, no tab opens: the browser blocked it. Click Open Dropbox next to the code box.

---

Character tab

• Pick a character from the Character dropdown. Create one with New blank, Paste from clipboard (reads a sheet off your clipboard), or New from text… (paste into a box). The first heading or line becomes the name, without its [WWN] / [BRP] tag: pasting # John [BRP] makes a character named John. The tag (or "Shadowdark" in the text) sets the system badge, and View mode shows the heading without it. Keep the tag in the text: [BRP] is what marks a BRP sheet.
• A campaign can hold several characters. The Character B dropdown puts a second character side by side, one per column. With Character B set to — none —, the single sheet is split into two columns at the first standalone --- line in its Markdown (text before it on the left, text after it on the right); with two characters shown, --- is just a normal rule.
• View / Edit toggle. View renders the sheet as Markdown; Edit is the raw Markdown source (Edit always acts on Character, not Character B).
• In View mode, dice formulas and modifiers are underlined and clickable (blue, dotted):
  • 2d6+3, 1d20+4, 4d6kh3, 1d8 + 2 → rolled as written.
  • A bare +1 / -2 / +0 → rolled as 1d20 ± that.
  • Every click is logged under the character's name.
• Also in View mode, names in [square brackets] are underlined (violet, dashed) and looked up in the Compendium on hover — see that tab. Short all-caps tags like [WWN] are left alone.
• Rename / Delete act on the selected character.

Character-sheet variables

Write Name: value anywhere in a sheet — value a plain, optionally-signed integer — and it's picked up as a variable you can reference in dice formulas. In View mode the name is highlighted in its own colour and the value keeps its usual blue, clickable-roll underline:

CON: -1, STR: 0, DEX: +1

detects CON = -1, STR = 0, DEX = +1. Several fields can share a line, separated by a comma, semicolon, or | (in addition to each just being its own line) — e.g. HP: 10 | AC: 14 | AB: +0 detects AC and AB.

A value can have more after it, as long as a space separates them — parsing simply stops at the first number, so a common "modifier with the score in parentheses" layout works too:

ATTRIBUTES
STR: +1 (14)
DEX: +0 (9)
CON: +1 (14)

detects STR = +1, DEX = +0, CON = +1 (the (14), (9) are never looked at). The same rule applies whichever number comes first — STR: 14 (+1) instead detects STR = 14. A number with no separating space, like the 19 in HP: 19/19, doesn't count — only HP: 19 (or HP: 19, …) would.

Use a variable in a dice formula with $Name — e.g. 1d6+$CON+2 rolls 1d6 plus that character's current CON plus 2. The rendered formula shows just the name (1d6+CON+2); hover it to see each variable's current value in the tooltip (1d6+CON (-1)+2). Typing $ in the sheet editor or the Dice Roller's custom-formula box pops up a list of that character's detected variables to pick from. If a name changes or a sheet is edited, $Name always resolves against whatever the sheet says right now.

Right-click any dice roll (in a sheet, in Combat, in a Compendium popup, or a Dice Roller preset) to open a small popup with a flat modifier field and a dropdown to add one of the character's variables to the roll — picking one adds another dropdown so you can stack several — before rolling.

Journal

A campaign-wide Markdown composer below the sheet (a proper editor — EasyMDE, with the [ Compendium autocomplete). Press Enter to log the current text to the Session Log as a Journal entry (rendered as Markdown there) and clear the box; Shift+Enter inserts a new line. The unsent draft is saved and survives reloads.

Consumables (right side)

Campaign-wide trackers with − / value / + and an optional max, shared across every character. The list is grouped by character (every system): a heading with the character's name, then one line per tracker with its short label, for example HP 24 / 24 and PP 10 / 10 under Edith Jensen. A tracker named Label (Character name) belongs to that character; you can name your own that way (Arrows (Leo Sato)). Other trackers (Rations, Torches) follow under Shared. Editing a short label keeps the tracker in its group. A character's trackers show only while the System matches that character. Each character gets an HP (Name) line (starts 0 / 0; auto-filled from that character's sheet HP: x/y when you add them to combat, and renamed if you rename the character). Sheet resources: every Name: current/max on a sheet gets its own line when you create or save the character, for example HP: 13/13; PP: 17/17; FP: 27/27 makes HP (Ada), PP (Ada), and FP (Ada). Write each resource on its own line, or separate them with ; (also | or ,). HP and Hit Points use the HP line. A new line starts at the sheet's values; after that the line holds the current value and the sheet sets only the max. A rename moves the lines, and deleting the character removes them. Add lines for rations, torches, arrows, rage uses… Delete a line with ✕. Blank or 0 max means "no upper limit". Silent Legions characters also get a Madness (Name) line (0 / 100) — see Silent Legions.

---

Dice roller (right side, always visible)

Preset buttons: d20, Adv (2d20 keep-highest), Dis (2d20 keep-lowest), d4–d12, d100, 2d6, 3d6, 4d6kh3. Plus a custom formula field.

Formula grammar: NdM (e.g. 3d6), +/- chains (2d6+3, 1d8-1), keep/drop (kh/kl/dh/dl + number, e.g. 4d6kh3), and d%. Typing a bare number/modifier rolls a d20.

After a roll, on the Combat tab, an Apply damage button appears — it subtracts the result from the currently selected combatant (HP, or HD/HP under Scarlet Heroes rules — see Settings). The button also shows on the Maps tab: there it applies the damage to the combatant of the one selected token, or to the selected combatant when no token in combat is selected. On the other tabs the button does not show.

---

Session log (bottom, always visible)

Every roll, status change, side change and library roll is logged with a timestamp (and, in combat, the round number). Copy puts the log on your clipboard; Clear empties it. Capped at 500 lines.

---

Combat tab

The tracker

• Add character… (dropdown of your characters) or Add monster… (opens the library, below). A second copy of the same name gets a (1), (2)… suffix.
• Combatants are shown top-to-bottom in initiative order. Drag rows to reorder. Initiative is entered manually — the app never rolls it.
• Basic Roleplaying: the order is a rank, highest first. Settings → BRP combat order picks which one: DEX rank (default; the order of actions, core book p.123) or INT rank (the order of powers, which go before actions, p.124). A new combatant goes in at its rank: a monster's DEX or INT, or the DEX: N / INT: N on a character's sheet. A creature with no DEX acts on DEX rank 1 (core book p.222); one with no INT goes last in INT order. Each row has a box for the active rank and a chip for the other one. Change the box for this combat (for example a spell that delays the caster), then click Sort by DEX / Sort by INT. Clear the box to use the characteristic again. On a tie the book lets the higher relevant skill go first: drag the rows.
• Round counter with − / +. Next › / ‹ Prev move the active-turn marker (◀ turn) through the order; going past the end bumps the round.
• Hotkeys (while the Combat tab is focused and you're not typing in a field): ↑ / ↓ move the selection, N / P advance / rewind the turn.
• Per row: a side dot (click to cycle neutral → ally → enemy), name, and ✕ to remove. Second line: HD stepper (monsters only), HP stepper with / max, AC, saves and attacks (monsters), and status tags.
• HD / HP steppers: − / + adjust by 1; you can also type directly. HD keeps any * / + suffix.
• A combatant at HP 0 is greyed out with its name struck through.
• Sides: allies get a faint green row, enemies a faint red one. Characters default to ally, monsters to enemy.

Right-click a combatant

Opens a menu with:

• Change side → ally / enemy — flips the side (logged).
• A scrollable list of status conditions — click to add/remove. Hover a tag on the row to see its description and an ✕ to clear it. Comes prepopulated with the common OSR set (Blinded, Charmed, Frightened, Grappled, Paralyzed, Poisoned, Prone, Stunned, Unconscious, …).
• More ▸ — the conditions you added yourself that this combatant does not have. A condition you added moves up to the main list while the combatant has it.
• New condition… — name + description; added to the library and applied.

All status add/removes are logged with the round they happened.

Selected combatant detail (below the tracker)

• Monster: AC / THAC0 / HD / HP / MV / AL / XP chips; clickable attacks (a to-hit button rolls 1d20 + bonus; a damage button rolls just the damage dice and enables Apply damage); clickable saves and a Morale roll; special abilities (dice inside them are clickable); and the raw stat block.
• BRP monster: EL / HP / Major Wound / Armor / DB / Move / characteristic chips; Attacks one per line, all at the same indent (the stat block's ; separates them), with clickable NN% and damage dice; skills, powers, and the description.
• Character: the rendered character sheet, with its dice/modifiers clickable.

Monster library

Reached via Add monster…. Seeded on first run with the full Shadowdark core bestiary (Title Case) plus a couple of Old-School Essentials examples.

• Search by name and filter by HD (min / max). The count shows matches / total.
• Roll picks a random monster from the filtered list, highlights it and scrolls it into view (logged).
• Hover a row for a stat-block popup.
• Per row: Add (to combat), Edit (opens the stat block in an editor — saving re-parses it), ✕ (remove from library).
• Paste pane (right): paste one or more stat blocks and send them to the library, optionally also dropping them straight into combat. A Paste text / Fill in fields toggle above it switches to a structured form instead (see the Bestiary tab below) — the same toggle appears when you Edit a monster, so editing isn't raw-text-only either.

Populate by HD (Populate by EL for BRP)

+ Populate by HD… spends a total Hit Dice budget on monsters from the current Bestiary. Type the Total HD and, if you want, the Number of monsters. Keeper always spends the whole budget exactly. It shows the proposal first: the dice icon on a row rerolls that one monster for another with the same HD, Reroll makes a new proposal, and Add to Combat adds them.

For Basic Roleplaying, the button reads + Populate by EL…. BRP has no Hit Dice, so it uses the monster's Encounter Level (EL). EL 1 is a fair fight for one starting Normal-level PC, and ELs add up. A BRP monster without an EL is never picked. A party calculator fills the total for you:

• PCs: starts at the number of BRP characters (4 when there are none).
• Power level: Normal 1, Heroic 1.25, Epic 2, Superhuman 3 per PC. Heroic and Epic come from the core book p.246 (+25% and double the foes); Superhuman is an estimate.
• Difficulty: Easy ×0.5, Standard ×1, Hard ×1.5, Deadly ×2.

The bundled BRP Bestiary has no ELs. The BRP content pack from the brp_character repo (tools/extract_monsters.py) adds rated monsters from your own PDFs, or type an EL in the form.

---

Bestiary tab

A persistent, filterable view of the whole monster library — same idea as the Compendium tab, but for monsters. + New monster and Combat's own + Add monster… open the exact same modal described above; Search and HD min/max filter the list the same way the modal's own do (for BRP the filter reads EL, the Encounter Level). Per row: Add to Combat, Edit, ✕ (remove from library).

Fill in fields

Instead of pasting a stat block, switch the add/edit modal to Fill in fields and pick a Format — Shadowdark (a single AC, and S/D/C/I/W/Ch stat modifiers), Old-School Essentials (a descending AC — the matching ascending AC is derived automatically — THAC0, D/W/P/B/S save targets, and Morale), Basic Roleplaying (BRP), or Silent Legions (a descending AC, Morale, Skill, one Save target — leave it blank for the book's 15 − ½HD — Madness, Slaughter die, and an AC* box for creatures that ordinary harm doesn't work on). The BRP form has an EL field (Encounter Level; leave it blank for an unrated monster). BRP and Silent Legions have no paste parser, so the modal opens straight into the form when one of them is the active System. Add as many Attacks (label, count, to-hit, damage, note) and Abilities (name + description) rows as the monster needs with + Add; ✕ removes a row. Saving builds the monster's stat-block text from whatever you entered, so it displays (and can be switched back to Paste text) just like a pasted one.

Random monster generator

Click Random monster…, to the right of the HD filter, to open the generator. A click outside it, or Escape, closes it. It rolls a monster following the Shadowdark core rulebook's Monster Generator and Monster Mutations tables, for a given Party Level:

• Its AC is Party Level + 10; a Combat roll sets its Level (and attack bonus) somewhere around that Party Level, and picks a flavor Quality (e.g. Draconic, Undead, Ooze) with a matching Strength and Weakness.
• Its HP is rolled from its Level (in d8s); it has a random number of attacks (1-4), each a d8.
• The Mutations stepper (0-3) adds that many extra special abilities, each from the rulebook's own numbered mutation table.

Generate… doesn't add the result straight to the library — it lands in the add modal's Fill in fields form (with an editable placeholder name like "PL 3 Draconic Creature") so you can review, rename, or tweak anything before saving it for real.

---

Compendium tab

A personal reference of Items, Spells, Abilities, Rules and Other entries. Each entry has a name, a category, a source, and a Markdown body edited in a proper Markdown editor (EasyMDE, vendored). It comes seeded with the Shadowdark RPG core gear (weapons, armor, basic gear) as Items sourced Shadowdark Core.

• + New entry opens the editor modal — category defaults to Other, source to Unknown (the source box offers your existing sources as suggestions).
• Filter: tick/untick the Category and Source checkboxes. Right-click a checkbox to show only that one; right-click it again to tick every checkbox in its row. Type in Search to match entry names. Full text also searches the body; Fuzzy switches to approximate matching (Fuse.js, vendored). The count shows matches / total.
• Click a row (or its Edit) to edit; ✕ deletes.

Bracket lookup

Put an entry's name in [square brackets] in a sheet (View mode), the Journal, or another Compendium entry's body. It renders underlined in violet; hover it for a popup:

• Match found — the entry's Markdown rendered as HTML, plus an Edit button. Bare dice formulas in the description (1d6, 2d6+3 — not in backticks) are clickable and logged under the entry's name. Nested [refs] in the body are themselves hoverable. Matching is case-insensitive exact first, then fuzzy; with several matches, the ‹ n / N › arrows in the header (or ↑ / ↓ while hovering) page through them. The body scrolls normally when it's long.
• Fuzzy match (no exact name) — a line at the top says so, with the match confidence (e.g. 88%), and a New button sits next to Edit to create the entry you actually meant.
• No match — a note and a Create entry button (pre-fills the name; category Other).

Make a link from the sheet: in View mode, select some text, right-click → "Add … to Compendium". The editor opens with that text as the name; on Save, the sheet's Markdown source has that text replaced with [Entry Name], so it becomes a live link.

Popups stack — hovering a link inside a popup opens another, and the whole chain stays while the mouse is anywhere in it. Each popup has a 📌 pin (keeps it open after the mouse leaves) and an ×. Esc closes every popup; clicking elsewhere closes the unpinned ones. A pinned popup can be dragged by its header to reposition it. Drag the corner grip (bottom right) to resize a popup; a resized popup stays pinned. A popup shows only on the tab you opened it from, even when pinned: it hides when you change tabs and comes back when you return to that tab. On the Maps tab, a popup also belongs to the scene you opened it on, and it hides on other scenes. This browser keeps the pinned popups of each scene (place and size too), so they come back after a reload. Esc closes only the popups that show.

[ autocomplete

In the sheet editor, the Journal, and the Compendium entry editor, typing [ followed by 2+ characters pops a search of Compendium entry names. ↑ / ↓ to move, Enter / Tab or click to insert [Name], Esc to dismiss. With text selected, pressing [ or ] in any of those editors wraps the selection in [ ] instead of replacing it.

---

Maps tab

Battle maps and world maps, one scene at a time. Each scene belongs to the current System.

• New scene. Choose + New scene… in the scene selector. Give it a name, and choose an image file or enter the address of an image. You can also paste an image (Ctrl/Cmd+V) on the Maps tab, or drop an image file on the map. With no image, the scene is a blank map.

  • The app keeps its own copy of the image (scaled to at most 8192 px), so the map works offline and syncs with Dropbox.
  • Some websites do not allow a download from another site. Then the scene shows the image from its address, with a warning: that image is not saved, and it is gone if the address stops working.

• Scenes. The selector at the right of the toolbar switches scenes. Rename, Duplicate (the copy shares the image), and Delete work on the open scene.

• Hotkeys. Alt plus a key chooses a toolbar button: Alt+1 to Alt+4 the hand, ruler, grid, and pin tools; Alt+5 to Alt+0 and Alt+- the drawing tools; Alt+= the hexcrawl tool; Alt+S sticky mode; Alt+F show the whole map; Alt+O pop out; Alt+G the Grid menu; Alt+K the Tokens menu. Alt is the Alt key on Windows and the Option (⌥) key on Mac. Hover a button to see its key, or click the ? button at the end of the toolbar for the list.

• Sticky mode (the thumbtack button, on by default). On: a tool stays chosen after you use it. Off: after one drawing, text, measure, pin, or grid drag, the hand tool comes back.

• Right-click pan (the mouse button next to sticky mode, off by default). On: drag with the right mouse button on the map to move the view, and the browser's menu does not open. Off: a right-click on the map opens a menu to add a pin there or, in hexcrawl mode, to mark the hex explored. A right-click on a token, a drawing, or a pin always opens its own menu.

• Grid, Tokens, and ? (the hotkeys) are menus at the end of the toolbar. They open over the map, so the map does not move. A click on the map closes them.

• Move and zoom. With the hand tool, drag to move the view. The mouse wheel zooms around the pointer. The middle mouse button, or Space held, moves the view with any tool. The expand button shows the whole map again. This browser keeps the view (center and zoom) of each scene, so a reload or a switch to another scene and back shows the same place.

• Grid. A new scene has hexes. Open Grid to choose squares or hexes (flat-top or pointy-top), the cell size in image pixels, the offset, and what one cell is (for example 5 ft, or 6 miles for a hexcrawl).

---

Tables tab

A library of random tables. The built-in ones are Shadowdark encounter tables (one per terrain/district — Arctic, Cave, Market, Tavern, Tomb, and so on), each rollable with its own dice formula (usually d100). A content pack can add tables (for example the Silent Legions pack). You can also make your own tables, and a table can roll on other tables (a master table).

Every campaign and every System sees the same tables.

• Three filter rows choose which tables are listed. Tick or untick a value, or right-click a value to show only that one in its row; right-click it again to tick every value in its row.
  • Source: where the table comes from (Shadowdark, Silent Legions, Homebrew).
  • Setting: Fantasy, Modern, or Horror. A table can have more than one (Silent Legions tables are Modern and Horror). It shows while one of its settings is ticked.
  • Output: what the table makes: Encounter, Entity, Location, Adventure, Group, or Other.
• Don't show included subtables (on by default) hides each table that another table rolls on, so the list shows the generators and not their parts. A search still finds a hidden table, and a click on a [Name] link shows it.
• Search filters by table name. The count shows matches / total.
• Click a table's name to expand it and see every row. A [Name] in a row is a link: click it to open that table.
• Roll rolls the table's formula, highlights the matching row, and logs the result (table name, formula, total, and the full text) to the Session Log at the bottom. The Dice Roller's last-roll box does not show it. The copy button next to the result copies only the result text; an outline result copies as a block between ``` lines, with its indents. For a master table, every sub-roll in the result is underlined: click one to roll only that part again.
• A master table whose entry is a list of labelled lookups, such as Origin: [Artifact Origin]; Curse: [Artifact Curse], shows its result as an outline: one line per lookup ("Origin: …"), and a sub-table that is itself such a list goes indented under its label. Click the label to roll that whole group again. A ; ends a line. Text like A [Color] [Shape] stays on one line. The Session Log shows the same lines.
• + New table opens the table editor. Set its Source (type a new one or pick one in use), Setting (tick one or more), and Output there. A new table starts as Homebrew, Other, and the settings of the current System (Unknown Armies: Modern; Silent Legions: Modern and Horror; else Fantasy).
• Duplicate copies any table (built-in ones too) into a new one that you can change. Your tables show a mine badge and have Edit and Delete. Delete removes the table from every campaign. Your tables go into Export (an Import adds the ones you do not have) and into Dropbox sync as one file. A table of yours with the same name as a built-in one replaces it.

Table text

d10
1-2: [Ruin]
3-5: [Camp]
6-7: The [Words.Group] of the [Words.Hue] [Words.Thing]
8-0: [2x Ruin]

• Line 1 is the die: d12, 2d6, d100. Add named columns with |: d12 | Group | Hue | Thing.
• Each entry is range: text. A range is 4 or 1-2 (1–2 works too). On a d10, 0 means 10; on a d100, 00 means 100. A line without a range takes the next number, so a plain list of 12 lines under d12 is a full table.
• Columns: split the text with |, one cell per column: 1: Circle | Grey | Lamp.
• Lookups: [Name] rolls on another table. [Name.Column] rolls on a table with columns and takes one column ([Name] alone gives every cell). [2x Name] or [1d4x Name] rolls more than once, joined with commas. [2d6] rolls dice in the text.
• Blank lines and lines that start with # are skipped.

The editor colors the text as you type: ranges, lookups to known tables, dice, and lookups to tables that do not exist (red). Type [ for a list of table names; pick a table with columns and the list shows its columns. Below the text, the editor lists problems: a bad die (Save is blocked), values with no entry, overlapping ranges, and unknown tables. Test roll rolls the draft without logging it. If you rename a table, the lookups to it in your other tables change too.

A content pack can carry tables too (a tables list of { name, source, origin, settings, output }, where source is the table text and settings is a list such as ["Modern", "Horror"]), so you can keep the tables from your books in a private pack. A pack table without origin gets the pack name; without settings, the pack's System gives them. An older single setting string works too. The full format is in docs/content-pack-format.md.

---

Unknown Armies

Set Settings → System to Unknown Armies 3rd Ed.

• Characters: a sheet keeps its statblock in a ```ua block (identities, passions, relationships, Wound Threshold: N, and the five shock meters). View mode shows it as a sheet: abilities follow from the hardened notches, and you click the notch dots to change them. Every NN% is a percentile roll.
• Book content (optional): the app ships no Unknown Armies book text. If you own the books, the separate UA3 data tools (not in this repo) read your PDFs and write a local content pack: Compendium entries (spells, rituals, schools, archetypes, artifacts, identities, features, cabals, phenomena, places) and every GMC and unnatural entity as a Bestiary monster. Load it with Import. The same tools' character generator copies a finished character as sheet text, with [Name] links to those Compendium entries; paste it with Paste from clipboard.
• Bestiary: a GMC is pasted as text — its name on the first line, optional Type:, Book:, Wound Threshold: and Obsession: lines, then the same sections as a ```ua block. An identity can be rated with a range or dice (3d10+40%) and an Abilities section gives an ability directly (Struggle 70%). Put a line of --- between two GMCs. There is no Fill in fields form and no HD filter for Unknown Armies.
• Combat: a UA combatant counts wounds up to its wound threshold instead of HP and HD. The row shows the wound state from Book One (hurt at ½, badly hurt at ¾, unconscious at 90%, dead at the threshold; unconscious and dead grey out the row) and the rating of a Provides Initiative identity (Init), because Unknown Armies has no initiative roll. A GMC's threshold can be typed in the row (some entities have a formula instead of a number); a character's comes from its sheet, through its Wounds (Name) tracker. The detail panel lists a GMC's identities, abilities, passions, shock gauge, and book text, all clickable. After a percentile attack roll, the Dice Roller offers the wounds for each weapon kind — fists or thrown (sum of the dice), weapon +3 / +6 / +9, or a gun (the roll) — for the selected combatant. A plain dice roll still uses Apply damage, as wounds. Populate by HD is hidden.

---

Silent Legions

Set Settings → System to Silent Legions.

• Pregens: a fresh install includes four ready-to-play level-1 characters, one per class, who already know each other: Dee Okafor (Investigator), Miriam Castell (Scholar), Vivian Sato (Socialite), and Ray Kowalczyk (Tough). On an existing campaign, use Settings → Add missing pregens.
• Characters: New blank makes a sheet with a ```sl block (attributes and a starting Madness: N line). That block is what marks a character as Silent Legions, the same way ```ua does for Unknown Armies. A BRP sheet has no block: [BRP] at the end of its first line marks it. Write skill checks as Perception 2d6+1 and the attack bonus as +1 so they stay clickable.
• Madness: each Silent Legions character gets a Madness (Name) tracker, max 100, starting from the block's Madness: line. After that the tracker is what you update.
• Book content (optional): the app ships no Silent Legions book text. If you own the PDF, the separate Silent Legions Foundry VTT system (its "Import from PDF" dialog, or node tools/extract.mjs "Silent Legions.pdf") writes keeper-sl-pack.json. Load it with Import. It adds:
  • Compendium: rules and quick reference, the four classes and their abilities, skills, backgrounds, deliria, the 38 spells, the 8 disciplines, weapons, armor, gear, vehicles, and the 60 location tags.
  • Bestiary: the 11 creature templates at Weak / Average / Strong and the named NPCs and horrors (58 monsters). HP is the d8 average; reroll if you like.
  • Tables tab: the book's random tables, plus generators (master tables such as Cult, Dark Sorcery, or Occult Grimoire) that roll on them.
• Old campaigns had a built-in Silent Legions Compendium and Bestiary. The app removes those entries and monsters once, unless you edited them.
• Combat: AC shows as the book's descending number (6* = ordinary harm doesn't work). A to-hit roll's log line says which ACs it hits (1d20 + bonus + AC ≥ 20). The detail panel adds Skill (2d6 + skill), Slaughter (6+ triples the damage), and Madness buttons.

---

Settings tab

• Style theme (default Default). Recolours and re-fonts the whole app; dark mode only. Fantasy — parchment & gold on mahogany, serif type. Sci-fi — cyan on cold slate, wide caps. Horror — bone & blood on near-black. The choice is saved with your data and included in Export/Import.
• BRP combat order (shown only while System is BRP; default DEX rank). Which rank the Combat tracker sorts by: DEX rank (actions) or INT rank (powers). A change re-sorts the running combat at once.
• Scarlet Heroes damage resolution (default off). When on, Apply damage translates each damage die individually — 1 → 0, 2–5 → 1, 6–9 → 2, 10+ → 4 — sums the results, and applies that to a monster's HD or a character's HP. A flat damage bonus is folded into the single highest die before translating. If a monster is already at 0 HD but still has HP, the hit drops its HP to 0. Off: the raw rolled total comes off HP.
• Monster library → Reload defaults — replaces the library with the bundled set (your pasted-in monsters are lost; combatants already in the tracker are untouched).
• Compendium → Reseed defaults — adds back any bundled entry (the Shadowdark core gear) that isn't already present, matched by name; your own entries and edits are left alone.
• Compendium → Delete all — clears every Compendium entry after a confirmation. They don't come back on reload; use Reseed defaults to restore the bundled gear.
• New defaults — shows when the defaults of the current System changed: a new version of the app, or a content pack imported in another campaign or browser. Apply adds the new items and updates the changed ones. Items you edited stay as they are, unless you click Apply and overwrite my edits. Skip hides the notice until the defaults change again.
• Example characters → Add missing pregens — the example characters (OSR, Unknown Armies, and the four Silent Legions pregens) are only created on a fresh install. This adds any of them your campaign doesn't have, matched by name; your own characters and edits are left alone. Each one shows under its own System. The button is disabled when nothing is missing.
• Dropbox sync — Connect, Sync now, , and the app key under . See .

---

Supported stat-block formats

Pasted monsters (and the character-sheet examples) are parsed automatically. Two monster formats:

Shadowdark

BEAR, POLAR
A mighty, white bear that thrives in arctic environments.
AC 13, HP 34, ATK 2 claw +6 (2d6), MV near (climb), S +4, D +1, C +3, I -2, W +1, Ch -2, AL N, LV 7
Crush. Deals an extra die of damage if it hits the same target with both claws.
Thick Fur. Cold immune.

Old-School Essentials

Bulette
15′ long, hard-shelled reptiles with huge maws...
AC 0 [19] Hd 9* (40hp) Att Bite (4d12) + 2 × claw (3d6) THAC0 12 [+7] Mv 150′ (50′) sv D8 W9 P10 B10 S12 (9) ML 11 AL Neutral XP 1,600 TT None
▶ Ravenous: Will attack anything living.
▶ Leap: If cornered, can leap forward 20′, attacking with all 4 claws.

Paste several at once — a blank line between them is ideal, but back-to-back blocks are handled too.

---

Credits

• Monster data: the Shadowdark RPG core bestiary (© The Arcane Library) — see data/bestiary_data.json.
• Map token icons: game-icons.net by Lorc, Delapouite, Skoll, DarkZaitzev, Cathelineau, Faithtoken, Caro Asercion, and the other artists of icons you download, under CC BY 3.0 (some CC0) — see data/token-icons.json. Settings lists the authors of the icons your campaign uses.
• Bundled libraries (no CDN): marked for Markdown, Font Awesome Free 6.5.2 for icons.

See AGENTS.md if you want to work on the code.