PF2 Encounterbrew (BETA)

PF2 Encounterbrew is a self-hosted, mobile-browser friendly encounter tracker for the Pathfinder 2 TTRPG system by Paizo Inc.

Features

Combat Tracking

Encounter View

• Initiative Tracking - Automatic sorting of combatants by initiative order
• Turn Management - Navigate between turns with simple previous/next controls
• Active Turn Highlighting - Visual indicator shows whose turn it is
• Bulk Initiative Setting - Set all initiatives at once or individually
• Encounter difficulty - Calculated automatically based on party level
• XP Budget Display - See total XP and budget for balanced encounters
• Quick Damage/Healing - Apply damage or healing with mobile friendly controls

Monster Management

Monster Statblock

• Full Statblocks - View complete monster statistics including abilities and attacks
• Multi Attack Penalty - See attack bonuses for 3 consecutive attacks pre-calculated. e.g. Jaws +7/+3/-1
• Extensive Bestiary - Access to thousands of official Pathfinder 2e creatures
• Search - Search monsters by name with instant results
• Monster Filtering - Filter by name to find the perfect encounter creatures
• Multiple Instances - Add multiple copies of the same monster with automatic numbering

Spellcards

Spellcard

• Spellcard - Click spell in statblock to see card with complete spell info

Condition Tracking

Condition info

• Comprehensive Conditions - All official PF2e conditions available
• Visual Condition Display - See active conditions at a glance
• Easy Application - Click to add/remove conditions from combatants
• Condition Descriptions - Full condition effects available on click
• Multiple Conditions - Track multiple conditions per combatant

Encounter Management

• Create & Edit Encounters - Build encounters with custom names and descriptions
• Party Assignment - Assign specific parties to encounters for quick player management
• Quick Combat Setup - Add monsters and players to encounters with a few clicks
• Encounter List View - Manage all your encounters from a centralized dashboard
• Delete & Modify - Full CRUD operations for encounter management

Party Management

• Create Parties - Organize your players into reusable party groups
• Player Management - Add players with name, level, HP, AC, and perception
• Quick Player Addition - Add new players directly from party edit screen
• Import/Export Parties - Share parties between campaigns or backup your data
• Multi-Party Support - Manage multiple parties for different campaigns

How can I run this?

• Install Docker
• Download the docker-compose.yml file from this repository
• Open a terminal window
• Find the docker-compose.yml you just downloaded inside the terminal window (e.g. cd ~/Downloads)
• Run the following command:

docker compose up

You should now be able to access the application on http://localhost:8081

If you have not changed the default username and password in the docker-compose.yml file, your can login with username gamemaster and password changeme123.

If you are done using the application, you can shut it down with typing CTRL+C in the terminal window.

All your encounters, parties and players will be stored inside a database and will still be there once your restart the application.

Creating your first encounter

Before creating your first encounter, you need to create your first party. Navigate to the parties screen by choosing "Parties" from the menu (top-right corner). Create your first party there.

Once you have a party, head back to "Encounters" and create your first encounter. Choose the party you created earlier as the encounter's party.

Once you created the encounter, select it from the list of available encounters. You should see your party members already added as "green" combatants.

Click the "+" icon on the bottom of the screen to add a monster. Enter the name of the monster you want to add in the search input and click the green "+" icon appearing next to it. Once you added all your desired monsters, click the blue "save" button. You can now see the monsters added to the encounter, with initiative already rolled, as "red" combatants.

Legal & copyright

"PF2 Encounterbrew" uses trademarks and/or copyrights owned by Paizo Inc., used under Paizo's Community Use Policy (paizo.com/communityuse). I am expressly prohibited from charging you to use or access this content. "PF2 Encounterbrew" is not published, endorsed, or specifically approved by Paizo. For more information about Paizo Inc. and Paizo products, visit paizo.com.

Creature data used in this encounter tracker, see data folder, is provided by the Pathfinder 2e FoundryVTT team under the Apache 2.0 license.

FAQ

You got questions? I try to answer the most common ones here: FAQ.md

Patch Notes

See CHANGELOG.md

Contributing

See CONTRIBUTING.md