Pathfinder Community Sheet for Roll20.net

Editing

Unlike most character sheets found on Roll20's repo, the Pathfinder Community Sheet must be edited/developed within a specific local environment. Sheetworkers have been separated into various es modules based on their specific sheet sections or function(s). It is necessary to minimally install Git and Node/NPM. The html and js must be bundle using npm commands and webpack. More details below.

In order to edit the sheet locally, complete the following sections;

Install Git or Desktop GUI

You will need to fork and clone the Pathfinder Community Sheet using Git and/or Github Desktop Gui.

• Git for Windows
• Git for Linux
• Github Desktop GUI

If you are going to setup with VScode See specific instructions below you can skip the Limited Install steps.

Limited Install using Node.js using NVM

This is a good option if you are not going to use VScode as your editor.

Windows

1. Download and install latest version of Node Version Manager(NVM): https://github.com/coreybutler/nvm-windows/releases
2. Open a NEW shell (Right click -> Open Git Bash Here/Git GUI Here) You can not use one which was opened before NVM is installed.
3. Run nvm install latest to install the latest version of node.js
4. Run nvm list available and note the version you want to use. The latest version should be fine.
5. Run nvm use node <version#> include the proper version number as noted above.

Linux/Mac (adjust node version as needed)

1. Run curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
2. Close and reopen your terminal
3. Run nvm install 6.9.5
4. Run nvm alias default 6.9.5
5. Run nvm use 6.9.5

Dependencies

NPM is distributed with Node.js - which means that when you download Node, you automatically get NPM installed on your computer as well.

Install Curl executable (If you don't have it already)

Curl allows us to download TheArronSheet.js, instead of maintaining our own copy.

1. Go to https://curl.se/download.html and download the correct version for your OS.
2. Unzip and save to a directory on your computer ie on windows; c:\curl and copy curl.exe to c:\windows\system32\
3. You may need to add the .\Curl install directory or curl.exe to your windows environment PATH variable More Info

VScode Installation

Here are some instructions for using VScode for editing the sheet.

Install git

1. Download the Github Desktop GUI and/or install Git as noted above. You may also have both installed side-by-side.
2. Add the Github for Windows install directory to your windows environment PATH variable. More specific instructions; there is only a 'cmd' directory, not a bin directory, contrary to the directions. More info.

VScode and Node.js integration

1. Download and install VScode
2. Install Node using vscode's integrated terminal. ie npm install
3. You may want to create a unique Workspace specifically for editing the pathfinder sheet.

Reccomended Vscode Extensions

• NPM Intellisense
• Eslint extension (works with included ./eslint.config.mjs)
• Prettier Eslint (works with included ./.prettierrc.json)
• GetLens

Install Curl

Curl is required. See above.

Editing and Submitting updates

1. Fork the Pathfinder Community Sheet code if you haven't already done so.
2. Clone the project from within VScode or Github Desktop
3. It's highly reccomended that you create new "working" branches based on the Development branch.
4. Submit commits to your working branch until you are done editing and then submit a pull request to Origin/Develop for approval.
5. Once the latest changes on the Develop branch are approved, they will be merged into the Origin/Master.
6. A pull request for any new changes on the Pathfinder Sheet's repo Origin/Master will need to be submitted to Roll20's repository for approval. You may need to fork and clone the Roll20's repo.

Build/Compile Commands

• Run npm run build - Builds the project's index.html Use Case: development/testing. Output to "dist" folder.
• Run npm run prod - Turns debug off automatically. Builds the project's index.html Use Case: roll20 production. Output to "prod" folder.
• Run npm run postinstall - downloads TheArronSheet.js and saves it to the ./src folder as TheAaronSheet.cjs "TAS" is used to handle custom logging/debugging as well as some common utility functions. To simplify bundling, the ./src/TheAaronSheet.js included in the repo is a slightly edited (ie adds module.exports) version of TAS to make it an es6 module as well.

Viewing in Roll20

• Option 1: Use the bundled index.html from the ./dist or ./prod folder accordingly and the pathfinder.css, translation.json, and sheet.json as included in the ./src folder. These files can be copied as raw text directly into a Custom game's, "Game Settings" editor (HTML|CSS|TRANSLATION). Do not rely on the Preview tab. Always view the sheet in-game for an accurate load.
• Option 2: Sync a Sandbox game to your local files using Scott C's Chrome browser extension Roll20 API and Sheet Autouploader You may need to create a Symbolic link for the ./src/pathfinder.css and/or the ./src/translation.json to the ./dist and ./prod folders so the extension can easily detect local changes.

Errors/Issues

• Webpack dependencies: update webpack and dev dependencies with caution.

Module Breakdown

Each "page" or section of the Pathfinder sheet has one or more modules associated with it. For instance, the core page has PFAbilityScores, PFInitiative, PFClassRaceGrid etc. The Defense page has PFDefense, PFSaves. The Attacks page has PFAttacks, spells page PFSpells, etc.

Repeating sections

Pages with repeating sections will have a module for the repeating list, another module for the page-level variables (usually above it on the page), and a 3rd module for "roll options" the user has selected. For the attacks page it is :

• PFAttacks: the repeating_weapon list
• PFAttackGrid: the melee,ranged,cmb grid at the top
• **PFAttackOptions: ** the options checkboxes and how they affect macros

spells:

• PFSpells: the repeating_spells list
• PFSpellCasterClasses: The spell caster section, spells per day, spell points, etc
• PFSpellOptions: the spell options and updating of macros