Apocalypse Frame Roll20

This is a toolkit for producing Roll20 character sheets using modern(ish) web development technologies.

• HTML is built from the Pug templating language
• CSS is built from the Sass CSS superset
• Sheet workers can be compiled from Typescript via include:typescript file.ts in Pug templates
• Final CSS is stripped via PurgeCSS, meaning you can use modern CSS frameworks without bloating your final file size

Getting started

You can use this framework to create your own sheets. Just fork the repository and make your own changes.

Run npm install to install dependencies.

Edit package.json and set the following fields:

• name should be the short name of your game, e.g. apocalypse-frame
• author should be in the form Your Name <[email protected]>
• description should be your Roll20 numeric ID

To build sheets, you'll want to run npm start. Your files will be placed in a directory called dist.

Building Roll20 character sheets

Roll20's documentation for sheets starts here: https://wiki.roll20.net/Building_Character_Sheets

There are four files that will be used to build your sheet. All of them are found in the src directory:

• sheet.pug is the master Pug file for the HTML of your sheet. It can include other files via Pug include syntax.
• sheet.sass is the master SASS file.
• sheet.md is a Markdown file containing instructions for using your sheet.
• variables.json is a JSON file where you can store variables that are used by Pug.

You can use npm to install third party SASS/SCSS packages and include them in sheet.sass.

Using sheets

If you push a tag starting with "v", e.g. "v1.0.0" to Github, a Github Action will create a release. It will publish the sheet.json, the HTML file, and the CSS file, as part of that release.

You can copy the HTML and CSS into a game if you have a Pro account:

1. Create a new game at https://app.roll20.net/campaigns/new
2. For "pick a character sheet", choose "Custom" at the top, and click "Create game" at the bottom
3. Download apocalypse-frame.css and apocalypse-frame.html from the releases page, https://github.com/astralfrontier/apocalypse-frame-roll20/releases
4. On your new game's front page, click Settings > Game Settings
5. Paste the contents of apocalypse-frame.html into the "HTML Layout" tab at the bottom, ditto apocalypse-frame.css into "CSS Styling"
6. Click "Save Changes"

You can publish your sheets to Roll20's official library via Git: https://cybersphere.me/publishing-sheets-to-github/