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.

Grendal the Wary's character sheet with the Archivist Inquiry Assistant open over its right side. The box at the bottom holds the request for homebrew medium armor called Coral Mail: Armor Class 14 plus Dexterity, up to 2.

It may ask you something first. Pick an answer and press Send.

The Archivist Inquiry Assistant at work on the request. Its lines say it searched the Compendium for Coral Mail and found none, and it has a question: whether Grendal should wear it now. Yes, wear it is picked and sent, and the next line says it is drafting the change.

It shows what it adds. Nothing changes until you press Approve.

The Archivist Inquiry Assistant's suggestion: Change Grendal the Wary's sheet, adding Coral Mail to the inventory as worn, with an Approve button.

Your new armor or weapon is in the Compendium.

The Compendium's Armor list showing Coral Mail from Homebrew, and its block: medium armor, Armor Class 14 plus Dexterity, up to 2.

Grendal the Wary's inventory: Coral Mail, worn.

Grendal the Wary's inventory: Coral Mail, worn.

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.

The Archivist Inquiry Assistant's suggestion to change it, ready to approve.
Its suggestion, ready to approve.

Do it by hand: copy the armor closest to your idea

  1. In the top bar, press Compendium.
  2. In the list on the left, press Armor.
  3. In the search box, type a armor closest to your idea. Here it is Chain Shirt.
  4. Press it in the list. When two rows match, pick the one with the rules you play by.
  5. Press Copy to my compendium.
The Compendium's Armor list searched for Chain Shirt. Rings mark Compendium, Armor, the search box, the Chain Shirt row and the Copy to my compendium button.
Rings 1 to 5 match steps 1 to 5.
  1. Under To, press Homebrew. Every account starts with this compendium.
  2. Press Copy.
The Move or copy Chain Shirt window on Copy. Under To, the Homebrew compendium is picked and ringed, and a second ring marks the Copy button.
The built-in rules stay as they are. You work on your own copy.

Change it into your armor

  1. In the list, press your copy: the Chain Shirt with Homebrew under Source.
  2. Above its card, press the ⋯ button.
  3. Press Edit.
The Armor list with the Chain Shirt from the Homebrew compendium ringed. The three dots button above its card is ringed and its menu is open, with Edit ringed.
Your own entries get this menu.
  1. 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'
  2. 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 Edit window with Coral Mail's lines in the Text box, ringed, and the Preview showing Armor Class 14 plus Dexterity modifier, max 2. A second ring marks Save.
The Preview shows Armor Class 14 plus Dexterity, up to 2.

The same for a weapon

  1. 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 Edit window with the Harpoon's lines in the Text box and the Preview showing a Martial Melee weapon with 1d8 or 1d10 piercing, range 30 by 90 feet.
Copied from the Trident.
  1. On your character's Inventory tab, add it with Add Item. Press its name, then Equip.
  2. On the Actions tab, your weapon has its attack row.
The Weapons section of the Actions tab with the Harpoon's row ringed, with its range, +8 to hit and 1d8+4 piercing, between a Longsword and a Javelin.
The to-hit and damage come from your character.

The lines in armor and weapons

Every line below is in the ready lines above.

LineWhat it doesWhat 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_disadvantagePrinted 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
propertiesThrown, Versatile, Finesse and the rest.- thrown, on its own line
rangeThrown or ranged distance.normal: 30, long: 90
masteryIts mastery property.- topple
weight, costOn 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