Implement class resource system

[FirebrickRed]

Priority: MEDIUM
Status: TODO

Description

Implement limited-use class resources that track usage and recharge on rest (short/long rest).

Examples of Class Resources

• Barbarian: Rage uses per long rest
• Bard: Bardic Inspiration uses
• Monk: Ki Points
• Fighter: Action Surge, Second Wind
• Warlock: Invocations, Pact slots

Scope

This issue is specifically for class-based resources. Racial/feat abilities (like Astral Elf's Misty Step) will be tracked separately in a future feature system.

Acceptance Criteria

• Define resource tracking in CharacterSheet (current amount, max amount, recharge type)
• Add resource definitions to class YAML files
• Implement resource consumption and recovery logic
• Display resources in character sheet UI
• Handle short rest vs long rest recharge

Technical Notes

DndClass.java already has a placeholder:

private Map<String, Integer> classResources; // Line 36
// ToDo: implement Class Resources like Rage and Sneakattack (Line 349)

Related

• Will need similar system for racial/feat abilities later (separate issue)

[FirebrickRed]

Related Issue: Issue #26 (Spell slot progression system)

Both issues deal with limited-use resources that recharge on rest:

• Issue Implement class resource system #25: Class resources (Rage, Ki, Bardic Inspiration)
• Issue Implement spell slot progression system #26: Spell slots (spellcasting resource)

These systems are very similar and could share implementation patterns.

[FirebrickRed]

Feature Objects in YAML (Additional Scope)

While working on Issue #33 (menu lore), discovered that class YAMLs currently have rich feature objects but the loader only handles simple strings:

Current YAML format:

features_by_level:
  1:
    - name: Rage
      type: resource
      uses: 2
      damage: 2
      description: Enter a rage as a bonus action...
    - name: Unarmored Defense
      type: passive
      description: While not wearing armor...

Current parser expectation:

features_by_level:
  1:
    - "Rage"
    - "Unarmored Defense"

Recommendation:

When implementing this issue, consider:

1. Creating a DndFeature model class with properties: name, type, uses, damage, description, rechargeType
2. Updating LoaderUtils.parseLevelFeatureMap() to parse feature objects instead of strings
3. Changing DndClass.featuresByLevel from Map<Integer, List<String>> to Map<Integer, List<DndFeature>>

This would allow the existing rich YAML data to be utilized for:

• Displaying feature descriptions in tooltips
• Tracking resource uses (Rage: 2/2)
• Showing passive vs active vs resource-based features
• Automatic recharge logic based on feature type

Temporary Workaround:

For now (Issue #33), class YAMLs will be simplified to string format to display feature names in selection menus. The rich object data can be restored when this issue is implemented.

[FirebrickRed]

Completed in commit 480f54d

Core resource tracking system implemented:

• ✅ ClassResource model with consume/restore methods
• ✅ DndClass.createResourcesForCharacter() helper
• ✅ CharacterSheet resource initialization and rest recovery
• ✅ YAML support for both level-based and ability-based resources
• ✅ Updated Bard, Fighter, Monk, Barbarian class definitions

Phase 1 complete! Follow-up issues created for:

• Implement Barbarian Rage active state tracking #39: Rage active state tracking
• Implement transferable buff system for Bardic Inspiration #40: Bardic Inspiration transferable buffs
• Add /shortrest and /longrest commands #41: Rest commands (expanded with DM/party support)
• UI display and consumption mechanics (to be created)

Build successful ✅