/pdf-sheet

A system agnostic tool to export your Foundry character sheet to a PDF!

Primary LanguageJavaScriptMIT LicenseMIT

PDF Sheet

Version Latest Release Download Count Supported Foundry Versions Discord Server Patreon

A system agnostic tool to export your Foundry character sheet to a PDF!

Installation

In the setup screen, use the URL https://github.com/arcanistzed/pdf-sheet/releases/latest/download/module.json to install the module.

Usage

Just click on the button in the header of a character sheet and then it will open the configuration window. Once you upload a PDF, you'll see a list of each of the PDF's fields alongside an input. If you have a mapping configured correctly, those fields will automatically be filled out with the values from your character sheet.

Get a PDF

This module requires you to upload a form-fillable PDF which it will fill out for you. If you need a copy of the PDF, there is a button which will download the correct one for some systems.

You can theoretically use this module with the PDF for any system, but some fields used on other PDFs may not be supported. File a bug if you encounter a PDF that doesn't work.

Mapping

A mapping is required for the module to function as expected. You can edit the current mapping in module settings and there is also a dropdown menu with some community contributed mappings which you can load in.

A mapping is a JavaScript object (not JSON) which is saved with a .mapping file extension. The mapping provides the information needed to know which PDF fields to associate with which values from your actor. It is also responsible for formatting, calculating, concatenating, etc. those values for display on the PDF character sheet.

TIP: Install Ace Library if you want to use a proper editor to work on creating your mapping.

The mapping is formatted like this:

[
    {
        "pdf": "CharacterName",
        "foundry": @name
    },
    {
        "pdf": "Check Box 11",
        "foundry": @data.abilities.str.proficient
    },
    {
        "pdf": "Race",
        "foundry": @data.details.race
    },
    {
        pdf: "Speed",
        foundry: Object.entries(actor.data.data.attributes.movement).filter(val => val[1]).map(val => val[0] === "hover" ? Object.entries(actor.data.data.attributes.movement)[6][0] : "" + val[0] !== "units" && val[0] !== "hover" ? val.join(": ") + Object.entries(actor.data.data.attributes.movement)[5][1] : "").filter(String).join(", ")
    },
    {
        pdf: "Backstory",
        foundry: @data.details.biography.value?.replaceAll(/<[^>]*>/g, "").trim()
    },
    { "pdf": "PlayerName", foundry: Object.entries(@permission).filter(entry => entry[1] === 3).map(entry => entry[0]).map(id => !game.users.get(id)?.isGM ? game.users.get(id)?.name : null).filter(x => x).join(", ") }
]

This will take care of filling out the character name, strength save proficiency, race, speed, and backstory on a D&D 5e character sheet.

As you can see, the @ is used to access properties of the Actor data, rather than a fixed value. You may use any valid JavaScript functions or formulas in the mapping, but it should return a String or coerce into one.

⚠️WARNING: Do not use line comments (you can use block comments) since the mapping is saved on one line.

While creating a mapping, it's very helpful to work in the browser console (F12):

using-the-console-pdf-sheet.mp4

Please share any mappings you create with me and I will include them in the module for the benefit of the community. See the mappings here.

Support

Please consider supporting me on my Patreon if you like my work. You can see a list of all my projects on my website. From september 2023 the module is mantained with the collaboration of Gioppo Luca, you can find me in the arcanistzed discord server

Bugs

You can submit bugs via Github Issues or on my Discord server.

Contact me

Come hang out on my my Discord server or click here to send me an email.

New extended character sheet for 5e

If you use homebrew content or your player does not have access to all the playing data it is useful for the master to print the whole description of spells and equipment in the extended description. The classic character sheet does not allow to export that content, from now on the master can use the dnd5ev11extended.mapping file together with the pdf in the /pdf folder and give the players a complete character book with all the needed information.

TODO

  • Use PDFlib library instead of pdfform.js (since it's not maintained and can't support images)
  • Change the mapping to JSON, evaluating each value instead of the whole file
  • Store the JSON as an Object rather than serialized text
  • Add a field to the JSON mapping for a link to the PDF which can be put in the App instead of only the D&D link

License

Copyright © 2021 arcanist

This package is under an MIT license and the Foundry Virtual Tabletop Limited License Agreement for module development.

This uses some code from pdfform.js which is under the Apache 2.0 License and heavily modified by me. You may obtain a copy of the license on the Apache website.