Hungry Hungry Halfling

"AI" disclosure

Some or all of the code in this repository was generated with the assistance of LLM-based tools.

AI-generated code is not automatically owned by the person who generated it. No claim of ownership is made over third-party code or material included in this repository.

If you believe any code in this repository infringes your copyright, please contact me with the relevant details and I will review the matter and remove the material if appropriate.

This repository is intended for personal use only. The code is provided "as is", without warranties of any kind. I accept no responsibility or liability for any damage, data loss, security issues or other consequences resulting from its use.

Use this code at your own risk. You have been warned.

About

A companion module for the Foundry VTT module Core Clock that adds automated hunger rules to Dragonbane games.

It reacts to time progression announced by Core Clock and applies:

• Hunger tracking for player-owned characters
• The Famished condition when a character goes a full day without eating
• 1 HP starvation damage for each full day spent famished, up to death
• No HP/WP recovery from rest while famished
• Optional hunger pain checks (1d20 > PHY) with growl sounds while famished
• Eating sounds when a character consumes food

Compatibility

• Foundry VTT 14
• Dragonbane/Drakar och Demoner 4.x
• Requires the Core Clock
• Uses the Famished condition from Dragonbane Status Effects when that module is active

Installation

In Foundry VTT, go to Add-on Modules → Install module and enter the manifest url: https://code.chuggybumba.com/thanius/hungry-hungry-halfling/raw/main/module.json

Configuration

1. Open an item sheet and tick the Edible checkbox on anything that counts as food.
2. Players eat by clicking the Eat button on their character sheet and choosing an edible item. One item is consumed and hunger resets.
3. In Module Settings:
   • Enable eat sounds and famished pain checks
   • Set sound files and max volumes
   • Players can mute the module's sounds or lower volumes for their own client
   • Enable debug logs (GM) to trace hunger timing in the browser console

Integration

The module listens to Core Clock hooks:

• coreClock.roundAdvanced
• coreClock.quarterAdvanced (famished pain checks roll here)
• coreClock.shiftAdvanced
• coreClock.diurnalAdvanced (resets daily starvation damage)

Hunger state is stored on each actor in flags.hungry-hungry-halfling.hunger.