Table Tools · Fan-made

Roll20 Compendium Script

The character sheet's ? and hammer buttons talk to a mod script. This is the public copy: a crafting system with a thousand everyday items and what each is made of, and a place to put your own table's rules so the ? button can find them.

Download

Version 1.7.0

dcc-compendium-public.js: one file, about 186 KB. It works with the Roll20 character sheet from version 2.11.0.

It holds no text from the books. Look up a skill or a spell and it will tell you it has nothing, until you add your own entry for it. What it does carry is the crafting house rule this site’s table uses, and the catalogue of items that goes with it.

Download the script

Installing it

Open the game's mod scripts
From the game's details page: Settings, then Mod (API) Scripts. This needs a Pro or Elite subscription on the account that owns the game.
Add a new script
Click New Script, name it dcc-compendium.js, and paste the whole downloaded file in.
Pick your materials setting
Near the top of the script is a settings block. Leave materials as "split", or change it to "junk". The next section explains the difference.
Save
The API console should say "DCC Compendium ready". From then on the sheet's ? and hammer buttons work, and anyone in the game can type the commands below.

var CONFIG = {
    materials: "split",   // or "junk"
    handout: "DCC Compendium"
};

Split materials or Misc Junk

The books build everything from one raw material, Misc Junk, and price an item by its size. Some tables want more texture than that: carrying 12 Metal and 3 Glass rather than a pile of unnamed junk, and needing the right stuff to build the right thing. The script supports both, and it is your call.

materials: "split" breaks items into seven kinds. A toaster breaks into Metal, Electronics and Glass, and building one costs those kinds.

materials: "junk" counts all of it as Misc Junk. The toaster is still worth 4; it just doesn’t say what of. Costs, break-downs and anything the GM hands out with !dcc-found all collapse into the one pool, and the other six Materials boxes on the sheet stay at zero.

You can change your mind later. Materials already on a sheet stay where they are.

How the crafting house rule works

Building still follows the book: the skill, the check, the time and any crafting table. This rule only settles what an item is made of, and so what building one costs and what breaking one gives back.

What an item costs

An item is worth exactly what the book says an item of its size costs. With split materials, that total is shared out between the kinds it is made of.

Size	For example	Cost
Tiny	Soda can	1
Small	Toaster	4
Petite	Chair	16
Medium	Desk	32
Large	Statue	64
Huge	Dumpster	128
Colossal	Barn	256
Gargantuan	Grain silo	512

Magic costs Alchemical. An enchanted item costs its base object plus 2 Alchemical (2 Misc Junk, in the junk setting) for every bonus level of every enchantment on it. A toaster with +2 Dexterity and +3 Dodge costs its 4, plus 10.

Breaking an item down

It takes 1 hour (30 minutes from Salvage rank 5) and an Unopposed Salvage check, which the hammer rolls: a d20 + Salvage rank + Int Mod, against 10 + Floor × 2. Without the skill it rolls untrained, with Disadvantage.
The better the check, the more comes back: all of it on a Critical Hit, three-quarters on an Amazing Success, half on a Standard Success, a quarter on a Near Miss, nothing on a Standard Fail (the item is kept), and nothing on a Major or Critical Fail, which ruin the item. At Salvage rank 10 every Success gives all of it and a Near Miss half.
The share is of the whole item, rounded down, then shared out in its own proportions: a toaster gives back 2 points on a Standard Success, not 1.
Several of the same thing broken down together are pooled first, on one check. One soda can gives nothing on a Standard Success; ten give 5. The hammer breaks down one at a time, and asks first when one alone would give nothing back on a Standard Success, offering the whole stack.
Enchanted loot gives back its Alchemical too, which is where most of a party’s Alchemical ends up coming from.

The kinds, in the split setting

Misc Junk is universal. When you build something, any kind you are short of can be paid in Misc Junk instead.

Wood: Lumber, furniture, paper and cardboard, handles, rope fibre
Metal: Steel, aluminium, copper, iron, fasteners, casings, blades
Electronics: Circuit boards, wiring, batteries, chips, motors, sensors
Glass: Bottles, jars, lenses, screens, mirrors, bulbs
Chemical: Fuel, acids, solvents, powders, plastics and synthetics, and the volatile component explosives need
Alchemical: Monster parts, blood, hide and leather, bone, fungi, reagents, and the stuff of magic
Misc Junk: Everything else, and a stand-in for any kind above

Searching a place. When the party strips a room, the GM can answer in materials rather than listing every object: select the crawlers’ tokens and type !dcc-found 6 metal, 2 glass, 4 junk.

Commands

The sheet’s buttons send most of these for you. Answers are whispered to whoever asked.

!dcc-lookup <name>Posts the entry to chat. Forgives plurals and half-typed names; when several things match it offers buttons.
!dcc-breakdownWhat the hammer on an inventory row sends: rolls the crawler's Salvage check, breaks the item down by the result and adds what came back to that crawler's Materials.
!dcc-inventory <character id>Fills in what every inventory row is made of, for rows the catalogue knows.
!dcc-found 6 metal, 2 glassGM only. Adds materials to every selected crawler: the answer to "we search everything".
!dcc-materialsGM only. Shows the selected crawlers' materials.
!dcc-compendiumHow many entries are loaded, from where, and which materials setting is on.
!dcc-compendium reloadGM only. Reads the DCC Compendium handout again after you edit it.

Adding your own entries

Your house rules, your homebrew items, the conditions your GM made up on the spot: put them in the game and the ? button finds them like anything else.

Make a handout called DCC Compendium. The name has to match the handout setting.
Paste your entries into its GM Notes, as JSON, like the example below. GM Notes, so players can’t read the raw list; they see an entry when somebody looks it up.
Type !dcc-compendium reload. The script also reads the handout every time the game starts.

An entry with the same type and name as a built-in one replaces it, so you can give the Toaster your own description, or change what it is made of.

[
  {
    "type": "house-rule",
    "name": "Critical fumbles",
    "summary": "A natural 1 on an attack drops the weapon.",
    "facts": ["Picking it up is a Move Action"]
  },
  {
    "type": "item",
    "name": "Grandma's Cast-Iron Skillet",
    "summary": "Heavy enough to count as a club.",
    "materials": { "metal": 16 },
    "aliases": ["Skillet", "Frying pan"]
  },
  {
    "type": "condition",
    "name": "Soggy",
    "summary": "Disadvantage on Stealth until you dry off.",
    "cite": "Our table, session 3"
  }
]

name: Required. What !dcc-lookup finds it by.
type: One of rule, house-rule, condition, skill, spell, class, race, deity, item, loot, creature. Anything else counts as item.
summary: The text of the card.
facts: A short line, or a list of short lines, shown under the summary. From Compendium script 1.4.0 a "Label: value" line gets its own labelled row on the card.
ruling: How your table plays it, set apart on the card.
cite: Where it comes from: a page, a session, a person.
materials: What it's made of, by kind: wood, metal, electronics, glass, chemical, alchemical, junk. Makes it breakable with the hammer.
aliases: Other names it should answer to.

If the JSON has a mistake in it, reload says so and keeps the entries it had. A missing comma is the usual culprit; pasting the list into any JSON checker will point at the line.

The legal bit

Made and supported by CritsNThings, as an unofficial fan work. It is not endorsed by, affiliated with, or supported by Renegade Game Studios or Matt Dinniman.

The crafting rule is our table’s house rule, and the item catalogue is our own. Neither is official. You need the rulebook to play.

Offered as is, free, with no promise that it will keep working as Roll20 changes.