Difference between revisions of "Homebrew: Deity"

From 5etools Community Wiki
Jump to: navigation, search
m (Homebrew Support)
(Completed page restructure)
Line 1: Line 1:
__NOTOC__
 
 
{{HomebrewHeader}}
 
{{HomebrewHeader}}
  
==🍺Building a deity ==
 
 
Deities are the gods or "higher forces" that are part of the D&D world setting.
 
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).  
 
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).  
  
====An Example:====
+
==Building a deity==
The [[Homebrew: Meta|'''_Meta''']] is normally included in a full JSON, for this example it has been removed. See [[Homebrew: Meta|the link]] for how to develop the _meta.
 
  
"deity": [
+
===Basic skeleton===
{
+
To start, copy the following code block and fill the empty <code>""</code> values.
"name": "The Hunger",
+
<div class="toccolours mw-collapsible mw-collapsed" overflow:auto;">
"alignment": [
+
<div style="font-weight:bold;line-height:2;">Deity code block</div>
"N"
+
<div class="mw-collapsible-content">
],
+
"deity": [
"title": "It of Atrophy",
+
    {
"pantheon": "Outsider",
+
        "name": "",
"symbol": "Grey points on a black field",
+
        "source": "",
"source": "json_in_meta",
+
        "pantheon": "",
"customProperties": {
+
        "symbol": ""
"Domains": "(This overrides the display text for domains, and can include {@i @tags}. The main \"domain\" property is used for list sorting and filtering, so should contain plain text only.)",
+
    }
"Typical Worshipers": "Creatures who spend {@dice 1d6} days in the presence of the metaphysical influence exuded by the Outsider"
+
]
}
+
</div></div>
}
+
 
]
+
:* <code>"name"</code> — the name of the deity.
 +
:* <code>"source"</code> — make sure it is the same as the <code>"json"</code> key in the '''_meta'''.
 +
:* <code>"pantheon"</code> — the pantheon the deity belongs to. Can be one of the official ones, or a new one.
 +
:* <code>"symbol"</code> — renders as "'''Symbol:''' text"
 +
 
 +
==More options==
 +
===Text Entries===
 +
Add text to the deity, usually lore or explanations. Consists of strings ("") separated by commas.
 +
"entries": [
 +
    ""
 +
]
 +
 
 +
===Page===
 +
The page of the document where the deity appears at.
 +
"page": 1
 +
 
 +
===Alignment===
 +
Choose between <code>"L"</code> lawful, <code>"C"</code> chaotic, <code>"N"</code> neutral, <code>"G"</code> good and <code>"E"</code> evil. Several can be applied, separated by commas.
 +
"alignment": [
 +
    "C",
 +
    "G"
 +
]
 +
 
 +
===Title===
 +
A title that will appear next to the deity's name.
 +
"title": "The Dreamer"
 +
 
 +
===Alternate names===
 +
Will render as "'''Alternate names:''' ..."
 +
"altNames":[
 +
    ""
 +
]
 +
===Category===
 +
Allows to filter deities in different groups. Can be any string you want.
 +
"category": "The Usurpers"
 +
 
 +
===Domains===
 +
The domains to which the deity is usually associated with. Accepts non-official pantheons.
 +
"domains": [
 +
    "Life",
 +
    "Death"
 +
]
 +
 
 +
===Province===
 +
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": ""
 +
}
 +
:*<code>"title"</code> — optional value, will show up below the image.
  
<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
===Custom Extension===
<div style="font-weight:bold;line-height:1.6;">Learn More</div>
+
Useful when expanding an already existing deity. Will write a reference to the original entry.
<div class="mw-collapsible-content">
+
"customExtensionOf": "Aegir|Norse"
: In the example; ; the "deity" is defined. The first entry in the deity array '''name''' is defined as "The Hunger". Its [[HomebrewObject: alignment|'''alignment''']] is defined in the alignment array. The deities '''title''' is then define.  Then the panteon is defined to be "Outsider". The deity's '''symbol''' gets defined within [[Homebrew: Meta|'''_Meta''']].
+
:*The format of the link is the same as the <code>{@deity</code> tags: Name|Pantheon (defaults to Forgotten Realms)|Source (Defaults to PHB).
 +
 
 +
==Reference Tag==
 +
How to link to entries within the strings
 +
::<code>{@deity <name_of_deity>|<pantheon>|<json_source><optional_text_information>} </code>
  
: '''customProperties''' is a bit more complicated. In this used solely in homebrew, the example defines the '''Domains''' and '''Typical Worshipers''';
+
:: Example:
</div></div>
+
:::{@deity Gond}
 +
:::{@deity Gruumsh|nonhuman}
 +
:::{@deity Ioun|dawn war|dmg}
 +
:::{@deity Ioun|dawn war|dmg|and optional link text added with another pipe}
 +
<br/>
  
== Field List ('''Sources''') ==  
+
== Field List Sources==  
 
<small>If you do not include the required fields (denoted with bold text) the JSON may pass JSONLint but will fail upon stitch.</small>
 
<small>If you do not include the required fields (denoted with bold text) the JSON may pass JSONLint but will fail upon stitch.</small>
  
Line 72: Line 141:
 
----
 
----
 
<div style="font-weight:bold;line-height:1.6;font-size:140%">🗄️ Reference Files:</div>
 
<div style="font-weight:bold;line-height:1.6;font-size:140%">🗄️ Reference Files:</div>
:: [https://github.com/DMsGuild201/TheGiddyLimit.github.io/blob/master/test/schema/deities.json 🛢️ Requirements Specs (Schemata) ]
+
:: [https://github.com/TheGiddyLimit/TheGiddyLimit.github.io/blob/master/test/schema/deities.json 🛢️ Requirements Specs (Schemata) ]
 
:: [[  🧾 Blank Template]]
 
:: [[  🧾 Blank Template]]
 
:: [https://github.com/TheGiddyLimit/homebrew/blob/master/deity/Sample%20-%20Giddy%3B%20Atrophy.json 📖 Sample JSON]
 
:: [https://github.com/TheGiddyLimit/homebrew/blob/master/deity/Sample%20-%20Giddy%3B%20Atrophy.json 📖 Sample JSON]
Line 79: Line 148:
 
----
 
----
  
<br/>
+
==Homebrew Support==
: <font color="#2e7bab">Reference Tag:</font> (how to link to entries within the strings)
 
::<code>{@deity <name_of_deity>|<optional_text_information>|<json_source>} </code>
 
<br/>
 
:: Example:
 
{@deity The Hunger|the high almighty|json_in_meta}
 
{@deity Gond|dmg}
 
<br/>
 
=== Homebrew Support===
 
 
----
 
----
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
Line 108: Line 169:
 
----
 
----
  
==='''Related Features'''===
+
==Related Features==
 
----
 
----
 
:*[[Homebrew]]
 
:*[[Homebrew]]

Revision as of 13:01, 27 July 2020

framless
v1.1.0

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

Text Entries

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

"entries": [
    ""
]

Page

The page of the document where the deity appears at.

"page": 1

Alignment

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

"alignment": [
    "C",
    "G"
]

Title

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

"title": "The Dreamer"

Alternate names

Will render as "Alternate names: ..."

"altNames":[
    ""
]

Category

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

"category": "The Usurpers"

Domains

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

"domains": [
    "Life",
    "Death"
]

Province

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>}
Example:
{@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
True
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?)


FAQ
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.