Difference between revisions of "Homebrew"

From 5etools Community Wiki
Jump to: navigation, search
m (Homebrew)
m (Homebrew)
Line 5: Line 5:
 
<br/>
 
<br/>
 
: '''FIRST''' things first.
 
: '''FIRST''' things first.
:: When we say homebrew in the sense of 5eTools, it's more than what you might be normally be used to, homebrew content effectively means ''any content'' that is not WoTC and is also available for use within 5eTools. This will include licensed 3rd party content such as Green Ronin; Kobold Press; Paizo; etc. You can see the list of Offical content [{{ }} here].
+
:: When we say homebrew in the sense of 5eTools, it's more than what you might be normally be used to, homebrew content effectively means ''any content'' that is not WoTC and is also available for use within 5eTools. This will include licensed 3rd party content such as Green Ronin; Kobold Press; Paizo; etc. You can see the list of Offical content '''[{{SourceRAW}} here]'''.
 
<br/>
 
<br/>
 
::When it's used within 5eTools, Homebrew also includes the ''means'' to take your ideas and use them as part of the site. (ie Homebrew Manager is how you include non SRD/RAW content)
 
::When it's used within 5eTools, Homebrew also includes the ''means'' to take your ideas and use them as part of the site. (ie Homebrew Manager is how you include non SRD/RAW content)

Revision as of 16:58, 3 September 2019

framless
v1.125.1

Homebrew

This is currently being developed so it will be a bit rough as we develop better content and as we get feedback on what helps, and what doesn't.


FIRST things first.
When we say homebrew in the sense of 5eTools, it's more than what you might be normally be used to, homebrew content effectively means any content that is not WoTC and is also available for use within 5eTools. This will include licensed 3rd party content such as Green Ronin; Kobold Press; Paizo; etc. You can see the list of Offical content [LEGEND
For Whom 🧙 DM ⛹️ Player
Type 🗝️ Adventure 📚 Book 🏫 Class 🧝 Race 💰 Item 🧙 Spell
🍣 RAW 🍺 Homebrew 🗝️ Adventure
AL 🏆 AL Legal 🥇 AL Legal+ 🥈 Not AL Legal



Title Abbrev Type AL Whom Buy?
Player's Handbook PhB 🏆 🧙⛹️ 💸
Dungeon Master's DMG 🍣 🧙 💸
Dungeon Master's Screen Screen 🥈 🧙 💸
Monster Manual MM 🥇 🧙⛹️ 💸
Sword Coast Adventure's Guide SCAG 🥇 🧙⛹️ 💸
Volo's Guide to Monsters VGM 🥇 🧙⛹️ 💸
Xanathar's Guide to Everything XGE 🥇 🧙⛹️ 💸
Elemental Evil Player's Companion EEPC 🥇 🧙⛹️ 💸
Elemental Evil: Trinkets EET 🏆 🧙⛹️ 💸
Mordenkainen's Tome of Foes MTF 🍣 🧙 💸
Wayfinder's Guide to Eberron UAWGE 🥈 🧙⛹️ 💸
Mythic Odysseys of Theros MoT 🗝️ 🥈 🧙⛹️ 💸
Adventurers' League AL 🏆 🧙⛹️ 💸
Adventurers' League:
Curse of Strahd
ALCurseOfStrahd 🗝️ 🏆 🧙 💸
Adventurers' League:
Elemental Evil
ALElementalEvil 🗝️ 🏆 🧙⛹️ 💸
Adventurers' League:
Rage of Demons
ALRageOfDemons 🗝️ 🏆 🧙 💸
Aquisitions Incorporated AI 🥈 🧙⛹️ 💸
Lost Mines of Phandelver LMoP 🗝️ 🧙 💸
Hoard of the Dragon Queen HoDQ 🗝️ 🧙 💸
Rise of Tiamat RoT 🗝️ 🧙 💸
Rise of Tiamat Online Supplement RoTOS 🗝️ 🧙 💸
Princes of the Apocalypse PotA 🗝️ 🧙 💸
Out of the Abyss OotA 🗝️ 🧙 💸
Curse of Strahd CoS 🗝️ 🧙 💸
Storm King's Thunder SKT 🗝️ 🧙 💸
Tales from the Yawning Portal:
Against the Giants
TftYP-AtG 🗝️ 🧙 💸
Tales from the Yawning Portal:
Dead in Thay
TftYP-DiT 🗝️ 🧙 💸
Tales from the Yawning Portal:
The Forge of Fury
TftYP-TFoF 🗝️ 🧙 💸
Tales from the Yawning Portal:
The Hidden Shrine of Tamoachan
TftYP-THSoT 🗝️ 🧙 💸
Tales from the Yawning Portal:
The Sunless Citadel
TftYP-TSC 🗝️ 🧙 💸
Tales from the Yawning Portal:
Tomb of Horrors
TftYP-ToH 🗝️ 🧙 💸
Tales from the Yawning Portal:
White Plume Mountain
TftYP-WPM 🗝️ 🧙 💸
Tomb of Annihilation ToA 🗝️ 🧙 💸
Waterdeep: Dragon Heist WDH 🗝️ 🧙 💸
Waterdeep: Dungeon of the Mad Mage WDMM 🗝️ 🧙 💸
Krenko's Way KKW 🗝️ 🧙 💸
Lost Laboratory of Kwalish LLK 🗝️ 🧙 💸
Ghosts of Saltmarsh GoS 🗝️ 🧙 💸
Hunt for the T-hydra HftT 🗝️ 🧙 💸
Dragon of Icespire Peak DIP 🗝️ 🧙 💸
The Orrery of the Wanderer OoW 🗝️ 🧙 💸
Guildmaster's Guide to Ravnica GGR 🥈 🧙⛹️ 💸
Planeshift:Amonket PSA 🥈 🧙⛹️ 💸
Planeshift:Dominaria PSD 🥈 🧙⛹️ 💸
Planeshift:Innistrad PSI 🥈 🧙⛹️ 💸
Planeshift:Ixalan PSX 🥈 🧙⛹️ 💸
Planeshift:Kaladesh PSK 🥈 🧙⛹️ 💸
Planeshift:Zendikar PSZ 🥈 🧙⛹️ 💸
The Tortle Package TTP 🥈 🧙⛹️ 💸
One Grung Above OGA 🥇 🧙⛹️ 💸
Dragon Magazine Mag 🥈 🧙⛹️ 💸
Unearthed Arcana UA 🥈 🧙⛹️ 💸
Unearthed Arcana
Artificer
UA
Artificer
🥈 🧙⛹️ 💸
Unearthed Arcana
Eladrin and Gith
UA
EladrinAndGith
🥈 🧙⛹️ 💸
Unearthed Arcana
Eberron
UA
Eberron
🥈 🧙⛹️ 💸
Unearthed Arcana
Feats for Races
UA
FeatsForRaces
🥈 🧙⛹️ 💸
Unearthed Arcana
Feats for Skills
UA
FeatsForSkills
🥈 🧙⛹️ 💸
Unearthed Arcana
Fiendish Options
UA
FiendishOptions
🥈 🧙⛹️ 💸
Unearthed Arcana
Feats
UA
Feats
🥈 🧙⛹️ 💸
Unearthed Arcana
Gothic Heroes
UA
GothicHeroes
🥈 🧙⛹️ 💸
Unearthed Arcana
Modern Magic
UA
ModernMagic
🥈 🧙⛹️ 💸
Unearthed Arcana
Starter Spells
UA
StarterSpells
🥈 🧙⛹️ 💸
Unearthed Arcana
The Mystic Class
UA
TheMysticClass
🥈 🧙⛹️ 💸
Unearthed Arcana
That Old Black Magic
UA
ThatOldBlackMagic
🥈 🧙⛹️ 💸
Unearthed Arcana
The Ranger, Revised
UA
TheRangerRevised
🥈 🧙⛹️ 💸
Unearthed Arcana
Waterborne Adventures
UA
WaterborneAdventures
🥈 🧙⛹️ 💸
Unearthed Arcana
Variant Rules
UA
VariantRules
🥈 🧙⛹️ 💸
Unearthed Arcana
Light, Dark, Underdark!
UA
LightDarkUnderdark
🥈 🧙⛹️ 💸
Unearthed Arcana
Ranger and Rogue
UA
RangerAndRogue
🥈 🧙⛹️ 💸
Unearthed Arcana
A Trio of Subclasses
UA
ATrioOfSubclasses
🥈 🧙⛹️ 💸
Unearthed Arcana
Barbarian Primal Paths
UA
BarbarianPrimalPaths
🥈 🧙⛹️ 💸
Unearthed Arcana
Revised Subclasses
UA
RevisedSubclasses
🥈 🧙⛹️ 💸
Unearthed Arcana
Kits of Old
UA
KitsOfOld
🥈 🧙⛹️ 💸
Unearthed Arcana
Bard: Bard Colleges
UA
BardBardColleges
🥈 🧙⛹️ 💸
Unearthed Arcana
Cleric: Divine Domains
UA
ClericDivineDomains
🥈 🧙⛹️ 💸
Unearthed Arcana
Druid
UA
Druid
🥈 🧙⛹️ 💸
Unearthed Arcana
Revised Class Options
UA
RevisedClassOptions
🥈 🧙⛹️ 💸
Unearthed Arcana
Fighter
UA
Fighter
🥈 🧙⛹️ 💸
Unearthed Arcana
Monk
UA
Monk
🥈 🧙⛹️ 💸
Unearthed Arcana
Paladin
UA
Paladin
🥈 🧙⛹️ 💸
Unearthed Arcana
Modifying Classes
UA
ModifyingClasses
🥈 🧙⛹️ 💸
Unearthed Arcana
Sorcerer
UA
Sorcerer
🥈 🧙⛹️ 💸
Unearthed Arcana
Warlock and Wizard
UA
WarlockAndWizard
🥈 🧙⛹️ 💸
Unearthed Arcana
The Faithful
UA
TheFaithful
🥈 🧙⛹️ 💸
Unearthed Arcana
Wizard Revisited
UA
WizardRevisited
🥈 🧙⛹️ 💸
Unearthed Arcana
Elf Subraces
UA
ElfSubraces
🥈 🧙⛹️ 💸
Unearthed Arcana
Mass Combat
UA
MassCombat
🥈 🧙⛹️ 💸
Unearthed Arcana
Three-Pillar Experience
UA
ThreePillarExperience
🥈 🧙⛹️ 💸
Unearthed Arcana
Greyhawk Initiative
UA
GreyhawkInitiative
🥈 🧙⛹️ 💸
Unearthed Arcana
Three Subclasses
UA
ThreeSubclasses
🥈 🧙⛹️ 💸
Unearthed Arcana
Order Domain
UA
OrderDomain
🥈 🧙⛹️ 💸
Unearthed Arcana
Centaurs and Minotaurs
UA
CentaursMinotaurs
🥈 🧙⛹️ 💸
Unearthed Arcana
Giant Soul Sorcerer
UA
GiantSoulSorcerer
🥈 🧙⛹️ 💸
Unearthed Arcana
Races of Eberron
UA
RacesOfEberron
🥈 🧙⛹️ 💸
Unearthed Arcana
Races of Ravnica
UA
RacesOfRavnica
🥈 🧙⛹️ 💸
Unearthed Arcana
Of Ships and the Sea
UA
OfShipsAndSea
🥈 🧙⛹️ 💸
Unearthed Arcana
Sidekicks
UA
Sidekicks
🥈 🧙⛹️ 💸
Unearthed Arcana
Artificer Revisited
UA
ArtificerRevisited
🥈 🧙⛹️ 💸
Livestream (Mearl's Happy Hour) Stream 🍺 🧙⛹️ 💸
Twitter Titter 🍺 🧙⛹️ 💸

here].


When it's used within 5eTools, Homebrew also includes the means to take your ideas and use them as part of the site. (ie Homebrew Manager is how you include non SRD/RAW content)


SECOND().
That requires some additional work from what you may be familiar with RE: Homebrewry, GMBinder, or just drafting up a thought in a word processor. It helps to have a minor understanding of a data structure called JSON. If you've used Homebrewry or GMBinder, CritterDB or the like, it's not that different.


We'll do our best to give you the support to build your own homebrew for 5eTools.


This process is outlined below and will link to the associated documents.



To Create Homebrew

To convert homebrew into 5eTools you will:
  • Find content you wish to migrate into 5eTools
  • Decide how to break it down for 5eTools
  • Determine Tools
  • Review Sample(s) & Related works
  • Review Template
  • Register/List your homebrew on the Tracking Worksheet
  • Open Editor / Tool
  • Develop META header
  • Begin Conversion
  • Test code in JSONlint
  • Attempt to upload through Manage Homebrew
  • Test each section that was added

Homebrew: Diety Homebrew: How to Homebrew: JSON Overview Homebrew: Overview Homebrew: Psionic Homebrew: Resources Homebrew: Spell Homebrew Repository

How to create a Homebrew JSON for 5eTools

There are some site-specific Tools to make Homebrew for the 5eTools.




Site Tools

Homebrew Builder
Great for Monsters & Spells
Text Converter
Helpful for converting Tables and statblock from Markdown or simple text
Renderer Demo
A style guide / practical reference of the various tags with side by side comparison of code to render, which means it provides a place to test out snippets of entries. MOST IMPORTANT TOOL FOR COVERTING QUALITY CONTENT.
It will not render a fully developed homebrew from JSON, it works for the embedded content (ie the "meat" or content).
Example Files
Each type has a sample file for reference to see how they are constructed, what is included and how formatting applies for such.
Schema
The specifics and requirements of the various types.
Homebrew Manager
Ultimately, the homebrew is

External Tools

JSONlint.com
This site validates basic JSON structure (syntax) and points out what you're missing.
5eTools' Community Discord
specifically the #Brew-Coversion channel (its where you can ask directly for support and guidance)
Homebrew Repo
this serves as the offical Repository for Homebrew (the location from which the Manage Homebrew tool pulls.)
Code Editor
you may wish to install Pretty JSON.
you may wish to install JSTool.



This wiki will, under the sections or types of homebrew, which tools are best to work with within the 5eTools schema, Which reminds me...

The site utilizes JSON files for its data container(s), and so the homebrew'd additions are also JSON and must be converted from their current format (Markdown, PDF, .Doc etc into JSON formatted content.

If you're not familiar with it here is an overview of JSON -- the type of file/data structure content is stored within for 5eTools. Each main data type will have its own schema, and most will have a sample file associated with it to review and see how the schema is built with a practical example. (see below for that list).


Beyond that, there are some additional tools you will likely want to have in your virtual belt, loaded or bookmarked on your local PC.



entry templates are not linked yet, still testing.
Section Name noframes Example File(s) Template Schema
📑
Tool(s) Description
Adventure noframes

💾

📑

[📑]

A playable adventure. Should include maps, event descriptions, etc.
Book noframes

💾

📑

[📑]

Books are like Compendiums but include more information, 'fluff' and the like.
Background noframes

💾

📑

[📑]

A custom character background which provides rich content.
Bestiary noframes

💾

📑

[📑]

Bestiary - Monsters, NPCs and the like
Boon noframes

💾

📑

[📑]

Special rewards from Extraordinarily powerful creatures for a character's service.
Class noframes

💾

📑

[📑]

Character class information
Class Features noframes

💾

📑

[📑]

Features such as Invocations, Fightstyles, or the like.
Collection A Brew with multiple section types defined within it, which doesn't lean more towards any one type.
Conditions noframes

💾

📑

[📑]

Conditions and their effects
Deity noframes

💾

📑

[📑]

The gods of the worlds of D&D through various campaigns.
Creature noframes

💾

📑

[📑]

Bestiary - Monsters, NPCs and the like
Disease noframes

💾

📑

[📑]

Diseases and illnesses.
Feats noframes

💾

📑

[📑]

Custom Feats
Hazard noframes

💾

📑

[📑]

These are most often enviromental hazards and climate issues, not as simple as traps but still worthwhile.
Item noframes

💾

📑

[📑]

Items are the most complicated. Magical and Mundane, Trade goods, Kits, Mounts etc etc etc.
Meta tag noframes

💾

📑

[📑]

This is required for each JSON
Monster noframes

💾

📑

[📑]

Bestiary - Monsters, NPCs and the like
Object noframes

💾

📑

[📑]

Objects are special items, being seige weaponry, explosives etc - usually mundane items that have specific features that exceed simple items but don't really have traditional combat aspects and need special descriptions.
NPC noframes

💾

📑

[📑]

Bestiary - Monsters, NPCs and the like
Optional Features noframes

💾

📑

[📑]

Optional features are things like Eldritch Innvocations, Powers, etc
Psionics noframes

💾

📑

[📑]

Psionics are currently unique to Mystics and are similar to spells.
Races noframes

💾

📑

[📑]

Playable races.
Reward noframes

💾

📑

[📑]

Rewards and Boons, these are extraordinary results.
Ships noframes

💾

📑

[📑]

Ships are part of a UA expansion to better identify how naval (space) combat would work.
Spells noframes

💾

📑

[📑]

Spells are the magical powers for spellcasters, being divided into 10 tiers of power (cantrips + 1..9 level spells)
Table noframes

💾

📑

[📑]

Tables can be random result tables or just a means to store data in a more helpful way.
Trap noframes

💾

📑

[📑]

Traps and Lair like features that threaten characters - most often without combat resolutions.
Variant Rules noframes

💾

📑

[📑]

These are sets of Rules for 5e that are House Rules, or expansions of existing rules - like crafting, mass combat/warfare, Strongholds and Travelling
Vehicles noframes

💾

📑

[📑]

Ships are part of a UA expansion to better identify how naval (space) combat would work.

Formatting