Difference between revisions of "Homebrew: Deity"

From 5etools Community Wiki
Jump to: navigation, search
m (Code not collapsed)
Line 9: Line 9:
===Basic skeleton===
===Basic skeleton===
To start, copy the following code block and fill the empty <code>""</code> values.
To start, copy the following code block and fill the empty <code>""</code> values.
<div class="toccolours mw-collapsible mw-collapsed" overflow:auto;">
<div class="toccolours mw-collapsible" overflow:auto;">
<div style="font-weight:bold;line-height:2;">Deity code block</div>
<div style="font-weight:bold;line-height:2;">Deity code block</div>
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">

Latest revision as of 12:05, 14 September 2020


Deities are the gods or "higher forces" that are part of the D&D world setting.

Most settings have specific Deities they include within the setting's mythos/lore, that can be as varied as the Earth has supporting multiple ethnicities each possesses deities or a monotheistic religion (though this is VERY uncommon in fantasy literature).

Building a deity

Basic skeleton

To start, copy the following code block and fill the empty "" values.

Deity code block
"deity": [
        "name": "",
        "source": "",
        "pantheon": "",
        "symbol": ""
  • "name" — the name of the deity.
  • "source" — make sure it is the same as the "json" key in the _meta.
  • "pantheon" — the pantheon the deity belongs to. Can be one of the official ones, or a new one.
  • "symbol" — renders as "Symbol: text"

More options

Make sure you are adding these blocks in the same level as the "name", "source", etc.

Text Entries

Add text to the deity, usually lore or explanations. Consists of strings ("") separated by commas.

"entries": [


The page of the document where the deity appears at.

"page": 1


Choose between "L" lawful, "C" chaotic, "N" neutral, "G" good and "E" evil. Several can be applied, separated by commas.

"alignment": [


A title that will appear next to the deity's name.

"title": "The Dreamer"

Alternate names

Will render as "Alternate names: ..."



Allows to filter deities in different groups. Can be any string you want.

"category": "The Usurpers"


The domains to which the deity is usually associated with. Accepts non-official pantheons.

"domains": [


The nouveau form of 'title', first seen in Mordekainen's Tome of Foes

"province": "Greed"

Custom Properties

Allows to add extra properties in a key:value format. If the key is the same as some of the defined ones, it will override it with the new text while keeping the data intact.

"customProperties": {
    "Domains": "Life in the north, Death in the south."

Symbol Image

A link to an image of the symbol.

"symbolImg": {
    "type": "image",
    "href": {
        "type": "external",
        "url": "example.com/image.jpg"
    "style": "deity-symbol",
    "title": ""
  • "title" — optional value, will show up below the image.

Custom Extension

Useful when expanding an already existing deity. Will write a reference to the original entry.

"customExtensionOf": "Aegir|Norse"
  • The format of the link is the same as the {@deity tags: Name|Pantheon (defaults to Forgotten Realms)|Source (Defaults to PHB).

Reference Tag

How to link to entries within the strings

{@deity <name_of_deity>|<pantheon>|<json_source><optional_text_information>}
{@deity Gond}
{@deity Gruumsh|nonhuman}
{@deity Ioun|dawn war|dmg}
{@deity Ioun|dawn war|dmg|and optional link text added with another pipe}

Field List Sources

If you do not include the required fields (denoted with bold text) the JSON may pass JSONLint but will fail upon stitch.

Field Name Data Type Description Required
name String The Proper Name for the Deity True
reprintAlias String Other Names it has appeared as False
alignment Array of Strings Alignment True
title String title False
pantheon String The culture it is associated with True
symbol String The Icon associated with the diety
their holy symbol
customProperties Object Complicated see Learn More boolean
page Integer The Page number it apepars upon False
additionalsources Array of Objects other locations it appears within False
source String json (_meta's json value) True
entries Array of Strings Other Names False
altNames Array of Strings Other Names False
symbolImg String (URL) URL for its Image/Symbol False

🗄️ Reference Files:
🛢️ Requirements Specs (Schemata)
🧾 Blank Template
📖 Sample JSON
💾 Functional Example
📚 Repository of Other Examples

Homebrew Support

Known Issues
Looks like its perfect... (Did we miss anything?)

Nothing's here (Do you have any suggestions?)
Best Practices
(NON SCHEMATA) For the sake of balance, dieties typically don't have more than two domains of influence.

Related Features

Did that answer your question(s)?

If not please check the under Support; Troubleshooting or the Known Issues page for further guidance, or go to the Discord community and leave a comment in the issues channel.

If you enjoy the project, please follow this link to see how you can contribute and help make it even better.

Do you have time to take a Survey?