Format guide: armor and weapons
The short answerArmor sets your Armor Class, and a weapon gets an attack row with its to-hit and damage worked out. Describe it to the Archivist Inquiry Assistant and approve what it suggests, or copy the closest one and paste your lines over it by hand. Then add it from your Inventory and press Equip.
- For players and DMs
- 15 short steps
- Updated 7 November 2026, for Archivist 1.4.0
This page's examples are Coral Mail and the Harpoon, made up for the Drowned Coast.
Make it with the Archivist Inquiry Assistant
- Press the owl at the right edge of the screen to open the Archivist Inquiry Assistant. On a phone, press the owl beside search.
- Describe your armor or weapon in a sentence.
- Check what it suggests and press Approve. Your armor or weapon is in your Compendium and in your inventory.
For exampleAdd homebrew medium armor called Coral Mail to my inventory: Armor Class 14 plus my Dexterity modifier, up to 2, and Resistance to Cold damage while I wear it.
You can undo it. Can't see the owl? Turn on Archivist Inquiry Assistant in Settings.
Change an existing one with the Archivist Inquiry Assistant
- Open the Compendium, or a sheet that uses the armor or weapon, and press the owl.
- Say which armor or weapon and what to change.
- Check what it suggests and press Approve. Characters who use the armor or weapon change with it.
For exampleMake my Coral Mail give Armor Class 15 instead of 14.
You can undo it.
Do it by hand: copy the armor closest to your idea
Change it into your armor
- In the list, press your copy: the Chain Shirt with Homebrew under Source.
- Above its card, press the ⋯ button.
- Press Edit.
- Press in the Text box, select all of its text (Ctrl+A, or Cmd+A on a Mac), then paste these lines. Change the words to make it yours:Coral Mail
name: Coral Mail edition: '2024' source: Homebrew category: medium ac: base: 14 add_dex: true dex_max: 2 stealth_disadvantage: false weight: 25 cost: '75.00' - Press Save.
The Preview beside the text draws the armor again as you type. On a phone, Text and Preview are two tabs. Keep the spaces at the start of each line.
The same for a weapon
- Copy the closest weapon from Weapons in the same way, press Edit, and paste these lines. Press Save.The Harpoon
name: Harpoon edition: '2024' source: Homebrew category: martial-melee damage: dice: 1d8 type: piercing versatile_dice: 1d10 properties: - thrown - versatile range: normal: 30 long: 90 mastery: - topple weight: 4 cost: '8.00'
The lines in armor and weapons
Every line below is in the ready lines above.
| Line | What it does | What you can write |
|---|---|---|
ac (armor) | Your Armor Class while worn. | base: 14, add_dex: true, dex_max: 2 |
category (armor) | The kind of armor, and who is proficient. | light, medium, heavy, shield |
stealth_disadvantage | Printed on its card. | true or false |
damage (weapon) | Its dice and type, and two-handed dice. | dice: 1d8, type: piercing, versatile_dice: 1d10 |
category (weapon) | Decides proficiency, and melee or ranged. | simple-melee, martial-melee, simple-ranged, martial-ranged |
properties | Thrown, Versatile, Finesse and the rest. | - thrown, on its own line |
range | Thrown or ranged distance. | normal: 30, long: 90 |
mastery | Its mastery property. | - topple |
weight, cost | On its card and in your Inventory. | weight: 4, cost: '8.00' |
Questions
Save does nothing. What now?
Save waits until the text can be read, and a line over the Preview says what to fix, such as "Line 12 can't be read. Check its spacing and colons." Put the spaces back at the start of that line. If a sentence has a colon in it, put the whole sentence in double quotes.
How do I make a +1 weapon?
Make a magic item whose base_item line names a weapon, with its bonus under bonuses. See Make a homebrew magic item.
How do my players get my gear?
Press Manage compendiums, then Export beside your compendium, and send them the zip file. They press Import homebrew, choose Archivist files and drop it in. Share homebrew with your party shows each step.
Will I see it on my phone?
Yes. Your homebrew stays in sync on every device you sign in on, along with your characters and their portraits.
Keep going
- Compendium format guideLet the Archivist Inquiry Assistant write entries, or learn the lines by hand.
- Make a homebrew magic itemDescribe it to the Archivist Inquiry Assistant, or copy an item and change it by hand.
- Track inventory, bags and attunementAdd items, drag them into a bag, attune, and the sheet follows.
- Roll dice and build a custom rollClick a number to roll it; Option+click damage to build the roll.
- Share homebrew with your partyExport your compendium as a zip; they bring it in with Import homebrew.






