Configurable durations for light sources #129
Description
What I'd like to see:
- A duration field on light source definitions (in minutes of world time) - so a Torch could be set to 60 minutes, a Lamp to 360, etc.
- Automatic extinguishing when the duration runs out, consuming inventory just like a manual toggle-off
- A warning whispered to the player before their light goes out, with a configurable threshold (e.g. warn at 90% elapsed)
- Built-in durations for the common sources in D&D 5e, PF1, and PF2e based on their rulebook values
- Users should be able to set duration on their own sources via the JSON/YAML config, or override the built-ins
- Sources without a duration should behave exactly as they do now
Nice to have:
- A hook when a source expires, so macro authors can react to it
- An API method to query remaining duration
- The warning threshold should be a game setting so GMs can tune it or disable it entirely
This would depend on the GM advancing world time (via Simple Calendar or manually), which seems like a reasonable requirement. The GM client could be responsible for processing expiry checks to avoid duplicate work in multiplayer.