To start, copy the following code block and fill the empty "" values.
"item": [
{
"name": "",
"source": "",
"page": "",
"type": "",
"rarity": "none",
"entries": [
""
]
}
]
"name" — the name of the item."source" — make sure it is the same as the "json" key in the _meta."page" — the page of the document where this item appears. If this does not apply, leave at 0."type" — the type of the item. See the table below for all the different options."rarity" — “None” is for mundane items. “Unknown (Magic)” is for miscellaneous magical items. “Unknown” is for miscellaneous mundane items. “Varies” is for item groups.
"rare","none","uncommon","very rare","legendary","artifact","unknown","common","unknown (magic)","varies"
"entries" — the text of the item. You can write several strings (“”) separated with a comma. If the item doesn’t have any associated text, it is safe to remove.To add an image to an item, you need to use a direct link.
"fluff": {
"entries": [
""
],
"images": [
{
"type": "image",
"href": {
"type": "external",
"url": "example.com/image.jpg"
}
}
]
}
Some items will modify the ability scores of a player. They can increase the score a certain amount:
"ability": {
"str": 2
}
It is possible to change the score into a static amount:
"ability": {
"static": {
"con": 19
}
}
The only current official ones are "modern"and “renaissance”, but any string can be used. it will show up as a “Type” filter.
"age": "modern"
Useful for filtering purposes, write the name of any spell that the item allows to cast separated by commas.
"attachedSpells": [
"cone of cold",
"ice storm"
]
Some items offer certain bonuses, either defensive or offensive ones.
"bonusSpellAttack": "+1"
"bonusAC" — extra Armor Class."bonusWeapon" — weapon attack AND damage rolls."bonusWeaponAttack" — only weapon attack rolls."bonusWeaponDamage" — only weapon damage rolls."bonusSpellAttack" — spell attack rolls."bonusSavingThrow" — saving throws.How many pounds a Mount (or similar) can carry.
"carryingCapacity": 120
Some items have charges that power their special abilities
"charges": 3
These charges can be regained after a certain amount of time. Choose between "round", "restShort", "restLong", "dawn", "dusk" or "midnight".
"recharge": "dawn"
This defines the capacity of a container such as a backpack or bag. Both weight and item capacity can be specified.
"containerCapacity": {
"weight": [ 6
],
"item": [ {
"sling bullet|phb": 20,
"blowgun needle|phb": 50
}
],
"weightless": true
}
"weight" is an array, if the container has more than one pocket defined (e.g. Handy Haversack) you can write more weights.|. The number is the max amount of items it can store."weightless: true is an optional line for objects that render their contents weightless, no matter how heavy they are (e.g. Bag of Holding). The container will always weight the same amount.Some magic items bear curses that bedevil their users, sometimes long after a user has stopped using an item.
"curse": true
Enter the type of damage the item gives you resist to.
"resist": [
"cold",
"fire"
]
A distinction mainly used in the DMG that separates "major" and "minor" Magic Items.
"tier": "major"
This will add a handy link to the loot table in which the item appears on. The source is assumed to be DMG, but if using other sources such as homebrew files, add it with a pipe “|”.
You can add more that one table as different entries separated with commas.
"lootTables": [
"Draconic Items|Dragoons"
]
When building an item that contains other items, such a bundle of ammunition or a gear pack, you can define the items that it contains. Very useful for importing into VTTs.
"packContents": [
"backpack|phb",
{
"item": "torch|phb",
"quantity": 3
},
{
"special": "wooden stake",
"quantity": 3
}
]
|."quantity" that you can define."quantity" is optional.If the item is a poison, add the following.
"poison": true
The type of poison can be specified. Choose between injested, injury, inhaled or contact (accepts custom types).
"poisonTypes": [
"injested",
"pill"
]
If anyone can attune with the item, use "true".
"reqAttune": true
The item may only be attunable by a certain class/people. Can handle any string.
"reqAttune": "by a bard"
It is possible that the attunement is optional.
"reqAttune": "optional"
Choose between "arcane" (Sorcerers, Warlocks and Wizards), "holy" (Clerics and Paladins) or "druid" (Druids)
"sfcType": "arcane"
For other items that work as spellcasting focus for any class, you can add the following:
"focus": true
If it only works for certain classes:
"focus": [
"Sorcerer",
"Warlock"
]
The top speed of mounts and vehicles
"speed": 50
Monetary value of the item. Use copper pieces.
"value": 1000
An item can also have a multiplier as value, like Barding. Will render as “x4”.
"valueMult": 4
Specify the weight in pounds.
"weight": 10
An item can also have a multiplier as weight, like Barding. Will render as “x2”.
"weightMult": 2
Text can be added as a note next to the weight of an item, useful for containers. Will render between parenthesis.
"weightNote": "full"
A tag for all items considered Wondrous.
"wondrous": true
For items that use ammunition, not the ammunition items themselves.
"ammunition": true
Differentiate between Simple, Martial or other categories of weapons.
"weaponCategory": "simple"
The damage dice of a weapon is declared as follows.
"dmg1": "1d8"
For Versatile weapons or those that offer an alternative damage dice, a second one can be defined.
"dmg2": "2d6"
Finally, declare the type of damage the weapon deals. For all the different damage types, see the table at the bottom of the page.
"dmgType": "S"
Define the range of a ranged weapon.
"range": "80/320"
The amount of shots before the weapon needs to be reloaded.
"reload": 5
The base Armor Class the item provides.
"ac": 12
There is also a free text version of this:
"acSpecial": "12 AC, 15 AC during the night"
Mainly used for Heavy Armors, displays a text explaining this drawback.
"stealth": true
The minimum Strength value a character needs to not be slowed when wearing the item.
This will result in a line saying “If the wearer has a Strength score lower than x, their speed is reduced by 10 feet.”
"strength": 15
The following will help you create an item-type vehicle, like those present in the DMG. For the type seen in GoS and BGDIA, with Ability Scores and Features, see Vehicles.
The crew can be defined as a static number.
"crew": 10
It can also be specified as a X-Y min-max.
"crewMin": 5,
"crewMax": 15
Specify the amount of passengers the vehicle can carry
"capPassenger": 30
It also works for cargo, specified in tons.
"capCargo": 500
The speed is measured in miles per hour. A damage threshold can also be defined.
"vehSpeed": 1,
"vehAc": 15,
"vehHp": 100,
"vehDmgThresh": 10
Personal travel cost is measured per mile and per passenger. The shipping cost is measured per 100 pounds per mile. Both costs are specified in copper pieces.
"travelCost": 200,
"shippingCost": 100
| Code | Meaning |
|---|---|
"A" |
Ammunition |
"AF" |
Ammunition (futuristic) |
"AT" |
Artisan Tool |
"EM" |
Eldritch Machine |
"EXP" |
Explosive |
"G" |
Adventuring Gear |
"GS" |
Gaming Set |
"HA" |
Heavy Armor |
"INS" |
Instrument |
"LA" |
Light Armor |
"M" |
Melee Weapon |
"MA" |
Medium Armor |
"MNT" |
Mount |
"GV" |
Generic Variant |
"P" |
Potion |
"R" |
Ranged Weapon |
"RD" |
Rod |
"RG" |
Ring |
"S" |
Shield |
"SC" |
Scroll |
"SCF" |
Spellcasting Focus |
"OTH" |
Other |
"T" |
Tool |
"TAH" |
Tack and Harness |
"TG" |
Trade Good |
"$" |
Treasure |
"VEH" |
Vehicle (land) |
"SHP" |
Vehicle (water) |
"AIR" |
Vehicle (air) |
"WD" |
Wand |
| Code | Meaning |
|---|---|
"A" |
Acid |
"B" |
Bludgeoning |
"C" |
Cold |
"F" |
Fire |
"O" |
Force |
"L" |
Lightning |
"N" |
Necrotic |
"P" |
Piercing |
"I" |
Poison |
"Y" |
Psychic |
"R" |
Radiant |
"S" |
Slashing |
"T" |
Thunder |
| Code | Meaning |
|---|---|
"T" |
Thrown |
"V" |
Versatile |
"H" |
Heavy |
"2H" |
Two-Handed |
"F" |
Finesse |
"L" |
Light |
"R" |
Reach |
"A" |
Ammunition |
"LD" |
Loading |
"S" |
Special |
"AF" |
Ammunition (futuristic) |
"RLD" |
Reload |
"BF" |
Burst Fire |
How to link to Items within entries:
{@item <name_of_item>|<json_source>|<optional_text>}Example:
{@item alchemy jug}{@item longsword|PHB}{@item Arrows (20)|PHB|a bundle of 20 arrows}