Pathfinder & Starfinder Society Chronicle Generator
Generate chronicles for your entire party with one click
A Foundry VTT module that streamlines chronicle generation for Pathfinder & Starfinder Society GMs
✨ Features
|
🎯 Party Chronicle Generation Fill out one form for the entire party easily from the party sheet |
🧮 Automatic Calculations Treasure bundles, earned income, and reputation calculated automatically |
|
🎲 Smart Defaults Detects Bounties, Quests, and Scenarios and sets appropriate defaults |
📋 Pre-configured Layouts Includes layouts for many PFS and SFS scenarios - just select and go |
|
🧑💼 GM Credit Character Drag and drop your GM character to generate a chronicle and include it in session reporting |
📥 Player Downloads Players download chronicles directly from their character sheets |
| 🚀 Starfinder Society Support
The module automatically detects whether you're running Pathfinder or Starfinder and adapts accordingly |
🌐 Session Reporting
Copy session data to your clipboard and use the PFS Session Reporter browser extension to auto-fill the Paizo reporting form |
🚀 Quick Start for GMs
Step-by-step guide to generating chronicles for your party
1️⃣ Make sure the players fill in their PFS ids on their character sheet
The Chronicle Generation process uses that information when filling out the chronicle.
2️⃣ Open the Party Sheet
Open your party sheet and click on the Society tab.
3️⃣ Select Your Chronicle Layout
The module includes pre-configured layouts for many scenarios. When you select a scenario from the dropdown, the appropriate chronicle PDF is automatically selected.
If your scenario isn't in the list, you can:
- Browse for a chronicle PDF manually using the file picker
4️⃣ Fill Out the Form
The form has several sections:
|
📝 Event Information
|
|
|
💰 Rewards (automatically calculated based on scenario type)
|
|
|
⭐ Reputation (automatically calculated)
|
|
|
👤 Character-Specific Information
|
|
|
✅ Adventure Summary
|
|
|
❌ Items to Strike Out
|
5️⃣ Generate Chronicles
Click the Generate Chronicles button. The module will:
- ✅ Validate all required fields
- 📄 Generate a PDF chronicle for each party member
- 📎 Attach the chronicles to each character sheet
6️⃣ Players Download Their Chronicles
Players can now open their character sheets, go to the PFS tab, and click Download Chronicle to get their PDF.
🧮 Automatic Calculations
Save time with built-in calculators
💎 Treasure Bundles → Gold (Pathfinder) / Credits Awarded (Starfinder)
In Pathfinder, treasure bundles are automatically converted to gold based on each character's level, following the official PFS guidelines.
In Starfinder, each character receives a flat Credits Awarded amount based on their level — no treasure bundle input needed.
💰 Earned Income
When players use downtime days to Earn Income:
- Select the task level (usually character level - 2)
- Select the success level (Critical Success, Success, Failure, Critical Failure)
- Select proficiency rank (Trained, Expert, Master, Legendary)
The module automatically calculates the gold (Pathfinder) or Credits (Starfinder) earned based on these selections and the number of downtime days. Starfinder values are 10× the Pathfinder table, rounded up to whole Credits.
⭐ Reputation (Pathfinder only)
Enter the reputation values for each faction, and the module will format them correctly on the chronicle. You can also select which faction gets the bonus reputation from the scenario. The reputation section is hidden when running Starfinder.
🎲 Scenario Types
Smart defaults based on scenario type
Pathfinder Society
| Type | XP | Treasure Bundles | Downtime Days | Reputation |
|---|---|---|---|---|
| Bounty | 1 | 2 | 0 | 1 |
| Quest | 2 | 4 | 4 | 2 |
| Scenario | 4 | 8 | 8 | 4 |
The module detects the type from the scenario name: names starting with "B" followed by a number are Bounties, "Q" followed by a number are Quests, and everything else defaults to Scenario.
Starfinder Society
| Type | XP | Credits Awarded | Downtime Days |
|---|---|---|---|
| Scenario | 4 | By character level | 8 |
Starfinder Society has only scenarios — no bounties or quests. Credits Awarded is a flat amount determined by each character's level (see the Starfinder Society Guide for the full table).
🧑💼 GM Credit Character
Generate a chronicle for your own character as GM
If you're running a session for GM credit, you can include your own character in the chronicle generation and session reporting workflow.
How to assign a GM character
- Open the party sheet's Society tab
- At the top of the character list, you'll see a GM Character Drop Zone
- Drag and drop your character actor from the sidebar onto the drop zone
- Your character appears with a "GM Credit" label, visually distinct from the party members
What the GM character gets
- All the same data entry fields as party members (task level, success level, proficiency rank, earned income, gold spent, notes)
- Shared reward settings (XP, treasure bundles, downtime, reputation) applied automatically
- A filled chronicle PDF included in the generated zip alongside party member chronicles
- The chronicle saved to the actor's flags so you can download it from the character sheet
Session reporting
When you click Copy Session Report, the GM character is included in the signUps array with isGM: true. The PFS Session Reporter browser extension uses this flag to populate the GM credit fields on the Paizo reporting form automatically.
PFS ID validation
The module validates that your GM character's PFS ID (from the actor sheet) matches the GM PFS Number entered in the session info section. If they don't match, you'll see a validation error before generating chronicles or copying the session report.
Managing the GM character
- To clear the assignment, click the clear button on the GM character section
- To replace it, drag a different character onto the section
- The assignment persists across form reloads — no need to re-assign each time
- The Clear Data button removes the GM character along with all other form data
Restrictions
- Only character actors are accepted (not familiars, NPCs, or vehicles)
- The GM character cannot be an actor that is already in the party member list
💡 Tips and Tricks
📂 Collapsible Sections
Click on section headers to collapse/expand them. This makes it easier to focus on one section at a time.
💾 Auto-Save
The form automatically saves as you type, so you won't lose your work if you accidentally close the tab.
🔄 Clear Button
The Clear button resets the form but preserves:
- GM PFS Number
- Scenario Name
- Event Code
- Chronicle Path
- Season and Layout selections
It also sets smart defaults based on the scenario type (Bounty, Quest, or Scenario).
🖼️ Portrait Clicks
Click on a character's portrait to open their character sheet.
👥 For Players
📥 Viewing Your Chronicle
- Open your character sheet
- Go to the PFS tab
- Click Download Chronicle to save the PDF
🗑️ Deleting a Chronicle
If the GM needs to regenerate your chronicle (for example, if there was an error), they can click the Delete Chronicle button on your character sheet's PFS tab. This will remove the old chronicle so a new one can be generated.
🔧 Troubleshooting
⚠️ "Blank chronicle PDF path is not set"
Make sure you've selected a layout with official module support, or browsed for a chronicle PDF using the file picker.
❌ "Validation failed"
Check that all required fields are filled out:
- GM PFS Number
- Scenario Name
- Event Code
- Event Date
- Character Name (for each character)
- Society ID (for each character)
- Level (for each character)
🚫 Chronicles not generating
- Check the browser console (F12) for error messages
- Make sure the chronicle PDF file exists and is accessible
- Try using a different layout to see if it's a layout-specific issue
🤝 Contributing
We welcome contributions! If you want to add a new layout or fix a bug, please see the CONTRIBUTING.md file for development setup, testing, and code quality standards.
🦾 Regarding the use of AI:
I used AI as a coding assistant while building this. I'm a software engineer with over 35 years of professional experience. I could have written every line myself, but AI let me move faster. I drove the architecture and design decisions, followed industry best practices for code quality, and made sure everything is human-readable and maintainable. I have SonarCloud.io quality gates which must be met prior to releasing a new version.
If you don't want to use tools written by AI, then I respect that decsion. That's why I'm transparent about it. You can make up your own mind.
🙏 Acknowledgments
Thank you to GreyWolf and TMK - for your beta testing and excellent input on features and functionality. Without you two, this module would never have seen the light of day!
Thank you to SonarCloud for helping the open source community by making their product free for open source projects like mine.
Special thanks to razanur37's PFS Chronicle Filler for inspiration and the foundation this module was built upon. The layout file format, the concept of automated chronicle generation, and many of the layout files for earlier seasons and adventure paths came from that project.
📄 License
This module is licensed under the MIT License.
⚖️ Community Use Policy
This FoundryVTT Module (PFS Chronicle Generator) uses trademarks and/or copyrights owned by Paizo Inc., used under Paizo's Community Use Policy (paizo.com/licenses/communityuse). We are expressly prohibited from charging you to use or access this content. PFS Chronicle Generator is not published, endorsed, or specifically approved by Paizo. For more information about Paizo Inc. and Paizo products, visit paizo.com.








