- Hit the "Manage Homebrew" button (if available) on a Pf2eTools page.
- Hit the "Get Homebrew" button.
- Click the title of a homebrew to add it to the site. Currently, the list only displays items from this repository.
- Browse for the file you want.
- Click "Raw" (top-right) and save it as
.json. - Load into Pf2eTools via the Brew Manager.
Join the Pf2eTools Discord Server, and ask in the #brew conversion channel.
Note: one large advantage of contributing to this repo, is that your files will be kept up-to-date as changes are made to the main site.
- The easiest way to make your own is to copy one of the existing 'brews as a template and use the main Pf2eTools data as a reference.
- Contributions are welcome. For the GitHub-literate, make a pull request.* For everyone else, create an Issue and post a link to your file (PasteBin is fine), and I (or other maintainers, in future) can add it for you.
* See the article here for a how-to.
A schema is available (json.schema) describing the layout of the and usage of the _meta property found in the various data files.
There are a few conventions used which should be followed when creating homebrew:
- Use tabs over spaces, "LF" as end-of-line, and UTF-8 (without BOM) encoding.
- Format filenames as
Author Name; Homebrew Name.json - Use a unique
"json"source name; they should be uniquely identifiable across all homebrew. For example, for the hypothetical book "A History Of Dragons" by "A. N. Other," a sensible source name would be"HistoryOfDragonsANOther". Note that this text is never displayed, so can be as long and as ugly as required. While this is not enforced, we reserve the right to change data as required to avoid naming conflicts. - Only include content authors in the source
"author"field; conversion credit should be given in a"convertedBy"field (with the same format). - Include a
"dateAdded"property in file metadata, which is a Unix timestamp (in seconds) at which the file was added. You can view and copy the current Unix time here.