DnD HP Tracker

A simple and intuitive hit point tracker for your D&D characters, right in your Obsidian vault!

✨ Features

• Visual HP Tracking - See your character's health at a glance with a color-coded HP bar

  • 🟢 Green when healthy (>50% HP)
  • 🟡 Yellow when wounded (25-50% HP)
  • 🔴 Red when critical (<25% HP)

• Temporary Hit Points - Track temporary HP separately, automatically applied before regular HP

• Damage Modifiers - Apply resistance or vulnerability to damage calculations

  • Normal - Full damage
  • Resist (÷2) - Half damage (rounded down)
  • Vuln (×2) - Double damage

• Quick Actions

  • Take damage with modifier support
  • Heal your character
  • Add temporary HP (automatically takes the higher value)
  • Long rest - instantly restore to max HP and clear temp HP

• Concentration Checks - After taking damage while concentrating, resolve the Constitution save in the tracker panel

• Combat Log and Undo - Review your five most recent actions and undo the latest one

• Mobile Friendly - Works on desktop and mobile Obsidian

🚀 Installation

From Obsidian Community Plugins

1. Open Settings → Community plugins
2. Select Browse and search for "DnD HP Tracker"
3. Select Install
4. Enable the plugin in your Community plugins list

🎮 Usage

Opening the HP Tracker

There are three ways to open the HP Tracker:

1. Click the heart icon (❤️) in the ribbon (left sidebar)
2. Use the command palette (Ctrl/Cmd + P) and search for "Open HP Tracker"
3. The tracker opens in the right sidebar by default

Tracking HP

1. Set your max HP in the plugin settings (Settings → DnD HP Tracker)
2. Enter a damage or healing amount in the input field
3. Select a modifier if needed (Normal, Resist, or Vuln)
4. Click the appropriate action button:
   • Take Damage - Apply damage (temp HP absorbed first)
   • Heal - Restore HP (up to max)
   • Add Temp HP - Add temporary hit points
   • Long rest - Full HP restoration

Concentration Checks

When you take damage while the Concentrating toggle is active, the tracker shows the required Constitution saving throw in the panel. Select whether you succeeded to keep concentration or failed to end it.

Example Combat Scenario

1. Your character has 50 max HP and 20 current HP
2. A feature or spell grants you 5 temporary HP
3. An enemy hits you for 12 damage, but you have resistance
   • Select "Resist (÷2)", enter 12, click "Take Damage"
   • The plugin calculates 6 damage (12 ÷ 2)
   • Your 5 temp HP absorbs the first 5, leaving 1 damage to regular HP
   • Result: 19 HP, 0 temp HP
4. After combat, you click "Long rest"
   • HP restored to 50/50

⚙️ Settings

Configure your character in Settings → DnD HP Tracker:

• Max HP - Your character's maximum hit points
• Current HP - Your current hit point total (also changes with tracker actions)
• Temp HP - Current temporary hit points (also changes with tracker actions)

🛠️ Development

Want to contribute or customize the plugin?

# Clone the repository
git clone https://github.com/Butterski/obsidian-dnd-hp-tracker.git

# Install dependencies
npm install

# Start development with auto-rebuild
npm run dev

# Build for production
npm run build

Project Structure

src/
  main.ts              # Plugin entry point
  settings.ts          # Settings interface and defaults
  constants.ts         # View type constants
  HPTrackerView.ts     # Main HP tracker UI
  HPTrackerSettingTab.ts # Settings UI

🤝 Contributing

Contributions are welcome! Here are some ways you can help:

• 🐛 Report bugs
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit pull requests

Please feel free to open an issue or pull request on GitHub!

📜 License

This plugin is released under the MIT License. See LICENSE for details.

🙏 Acknowledgments

Built with ❤️ for the D&D and Obsidian communities.

Special thanks to:

• The Obsidian team for their excellent plugin API
• The D&D community for inspiration and feedback

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Roll for initiative! 🎲