Hero vs. Villain Points - Foundry VTT Module
A visual Hero/Villain point tracking system for Pathfinder 2E, inspired by the Star Wars Destiny Point mechanic.
📖 Overview
This module replaces traditional Hero/Villain Point tracking with 7 visual circles that represent the current balance of power in the game.
- ⚪ Hero Points → Silver Circles (Used by players for advantages)
- 🔵 Villain Points → Midnight Blue Circles (Used by the GM for complications)
- Only the GM can flip points, ensuring controlled gameplay balance.
- All changes sync instantly for all players.
- Persistent state between sessions (points remain after reloading).
🛠 Features
✔️ Graphical Interface: Points are represented as interactive circles instead of numbers.
✔️ GM-Only Control: Players can see the points but cannot change them.
✔️ One-Click Flipping: The GM can click a point to instantly flip it from Hero → Villain or vice versa.
✔️ Auto-Balanced: The total always stays at 7 (flipping one point moves it to the other pool).
✔️ Persistent Save: Points are stored between sessions.
🎮 How It Works
1️⃣ The GM clicks on a circle to flip between Hero (⚪) and Villain (🔵).
2️⃣ Players can see the changes but cannot interact with the circles.
3️⃣ The GM can manually adjust points via a configuration menu.
⚙️ Installation
1️⃣ Install via Foundry Package Manager:
- In Foundry VTT, go to "Add-on Modules" → Click "Install Module".
- Search for "Hero vs. Villain Points" and install.
2️⃣ Install via Manifest URL:
- Paste this URL into the Foundry Install Module dialog:
https://raw.githubusercontent.com/jkwitchel/foundryvtt-hero-villain-points/main/hero-villain-points/module.json
3️⃣ Activate the module in Game Settings → Manage Modules.
🛠 How to Use
- Flipping a Point: The GM clicks on a circle to switch between Hero/Villain.
- Configuring Points: The GM clicks "Configure" to set a custom balance.
- Tracker Visibility: The GM and players can toggle the tracker with:
toggleHeroVillainTracker();
📷 Screenshots
(Include images of the UI with the hero/villain circles!)
🚀 Future Enhancements
🔄 Custom Colors/Themes: Allow customization of the circle colors.
🎭 Optional Player Control: Add an option to let players flip points.
📝 GM Log: Track who spent a point.
💡 Credits & License
Author: Jeremy Witchel
System: Pathfinder 2E
License: MIT
📜 Support & Feedback
- GitHub Repo: https://github.com/jkwitchel/foundryvtt-hero-villain-points
- Report Issues / Request Features: GitHub Issues