Homebrew

v1.92.0

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 availible here.
• Homebrew content is either on the Homebrew Repo, stored locally, or could even be in a separate server / filestore that only you and your friends have access to for your personal usage.

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)

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 links will be provided to greater detail around each step.

---

How to add Existing Homebrew to the site

The community has created a number of files that work with the system, adding custom (homebrew) content to the site's data.

• Go to the website and choose Utilities,
• choose Manage Homebrew,
• select Get Homebrew and choose what sources you'd like to add.

(for more information check the feature information for Manage Homebrew)

---

The Process To Create Homebrew

To convert homebrew into 5eTools you will:

• Find content you wish to migrate into 5eTools
• Decide how to organize/break down the content for 5eTools
• Determine Tools
• Review related example(s) & Related work.

Reminder: please register/List your homebrew on the Tracking Worksheet

• Open what you're going to be using for the Editor / Construction Tool
• Develop META header
• Begin Conversion
• Test code in JSONlint

fix any errors that occur until it passes successfully

• Attempt a upload through Manage Homebrew
• Test each section that was added

fix any errors that occur until it passes successfully

• Have your conversion peer-reviewed
• Submit to the Repo.

Through a Pull Request (preferred)

Or posting the file in the Discord Community's #Brew Conversion Channel and tagging an admin/Arch-Magos

Homebrew: How to

Homebrew: Overview

Homebrew Repository

How to create a Homebrew JSON for 5eTools

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

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.

Master Schemata

Section Name		Example File(s)	Template	Schema 📑	Tool(s)	Description
Adventure		💾	📑	[📑]		A playable adventure. Should include maps, event descriptions, etc.
Book		💾	📑	[📑]		Books are like Compendiums but include more information, 'fluff' and the like.
Background		💾	📑	[📑]		A custom character background which provides rich content.
Bestiary		💾	📑	[📑]		Bestiary - Monsters, NPCs and the like
Boon		💾	📑	[📑]		Special rewards from Extraordinarily powerful creatures for a character's service.
Class		💾	📑	[📑]		Character class information
Class Features		💾	📑	[📑]		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		💾	📑	[📑]		Conditions and their effects
Deity		💾	📑	[📑]		The gods of the worlds of D&D through various campaigns.
Creature		💾	📑	[📑]		Bestiary - Monsters, NPCs and the like
Disease		💾	📑	[📑]		Diseases and illnesses.
Feats		💾	📑	[📑]		Custom Feats
Hazard		💾	📑	[📑]		These are most often enviromental hazards and climate issues, not as simple as traps but still worthwhile.
Item		💾	📑	[📑]		Items are the most complicated. Magical and Mundane, Trade goods, Kits, Mounts etc etc etc.
Meta tag		💾	📑	[📑]		This is required for each JSON
Monster		💾	📑	[📑]		Bestiary - Monsters, NPCs and the like
Object		💾	📑	[📑]		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		💾	📑	[📑]		Bestiary - Monsters, NPCs and the like
Optional Features		💾	📑	[📑]		Optional features are things like Eldritch Innvocations, Powers, etc
Psionics		💾	📑	[📑]		Psionics are currently unique to Mystics and are similar to spells.
Races		💾	📑	[📑]		Playable races.
Reward		💾	📑	[📑]		Rewards and Boons, these are extraordinary results.
Ships		💾	📑	[📑]		Ships are part of a UA expansion to better identify how naval (space) combat would work.
Spells		💾	📑	[📑]		Spells are the magical powers for spellcasters, being divided into 10 tiers of power (cantrips + 1..9 level spells)
Table		💾	📑	[📑]		Tables can be random result tables or just a means to store data in a more helpful way.
Trap		💾	📑	[📑]		Traps and Lair like features that threaten characters - most often without combat resolutions.
Variant Rules		💾	📑	[📑]		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		💾	📑	[📑]		Ships are part of a UA expansion to better identify how naval (space) combat would work.

entry templates are not linked yet, still testing.