Improve Character Sheet Display

[FirebrickRed]

Priority: MEDIUM
Status: TODO
Depends on: #31 (Character Persistence - need data to display)

Description

Expand the character sheet UI to show all relevant character information. Currently only displays HP, AC, and Initiative - needs to show resources, abilities, spells, equipment, and more.

Current State

ViewCharacterSheetMenu shows:

• ✅ HP (current/max)
• ✅ AC
• ✅ Initiative
• ✅ Class resources (we just added this!)

Missing:

• ❌ Ability scores (STR, DEX, CON, WIS, INT, CHA with modifiers)
• ❌ Proficiency bonus
• ❌ Skills and proficiencies
• ❌ Known spells/cantrips
• ❌ Spell slots (current/max per level)
• ❌ Equipment/inventory
• ❌ Save & Close functionality

Proposed Layout

Row 1 (Stats):

• HP | AC | Initiative | Proficiency Bonus

Row 2 (Class Resources):

• Rage (2/2) | Ki Points (3/3) | etc.
• Use item stack count to show current uses ✅ (already implemented)

Row 3-4 (Spell Slots):

• 1st: ○○● (2/3) | 2nd: ○● (1/2) | 3rd: ●●● (3/3) | etc.
• Show filled/empty indicators

Row 5-6 (Ability Scores):

• STR 16 (+3) | DEX 14 (+2) | CON 15 (+2)
• WIS 10 (+0) | INT 8 (-1) | CHA 12 (+1)

Row 7+ (Equipment, Spells, Skills):

• Paginated or scrollable sections
• Click to expand details

Bottom Right Corner (Save & Close):

• Barrier or Bed icon
• Click to close menu and save character state
• Useful for switching between multiple characters

Acceptance Criteria

Display Additions

• Show all 6 ability scores with modifiers
• Show proficiency bonus
• Show spell slots with current/max (per level)
• Show known spells and cantrips (paginated if many)
• Show equipment/inventory (paginated if many)
• Show skills and proficiencies
• Visual indicators for resource states (full/partial/depleted)

Save & Close Functionality

• Add save & close button/icon (bottom right corner)
• Click icon to close menu
• Auto-save character on close
• Alternative: /closesheet or /savecharacter command
• TODO: Decide if icon, command, or both during implementation

Layout & UX

• Clean, organized layout (not cluttered)
• Consistent with existing menu style
• Use LoreBuilder for all item lore
• Color coding (green=full, yellow=partial, red=depleted)
• Navigation if content doesn't fit (pagination/sections)

Visual Design Ideas

Resource Display (already implemented):

Item: Red Dye (stack of 2)
Name: "Rage (2/2)"
Lore: "Recovery: Long Rest"
      "Full" (green)

Spell Slot Display:

Item: Lapis Lazuli (stack of 2)
Name: "1st Level Slots (2/3)"
Lore: "3 slots available"
      "2 remaining" (yellow)

Ability Score Display:

Item: Iron Ingot
Name: "STR 16 (+3)"
Lore: "Strength modifier: +3"
      "Saving throw: +5" (proficiency)

Save & Close Button:

Item: Barrier or Red Bed
Name: "Save & Close"
Lore: "Click to save character"
      "and close this menu"

Save & Close - Command vs Icon

TODO during implementation: Decide which approach (or both):

Option A: Icon Only

• Click barrier/bed icon in bottom right
• Simple, visual, consistent with Minecraft UX

Option B: Command Only

• /closesheet or /savecharacter
• Good for players who prefer commands
• Can close without clicking menu

Option C: Both (Recommended)

• Icon for visual users
• Command for keyboard users
• Best of both worlds

Get user feedback during implementation!

Technical Notes

• Use LoreBuilder for all lore (consistency with Issue Refactor lore display methods to use LoreBuilder utility #37)
• Use item stack count for visual feedback (resources, spell slots)
• Color coding via NamedTextColor
• Pagination pattern if needed (next/prev buttons)
• Ensure display works with Issue Save character inventory and auto-save on server shutdown #31 persistence data

Related Issues

• Issue Save character inventory and auto-save on server shutdown #31: Character persistence (provides data to display)
• Issue Implement class resource system #25: Class resources (already displaying!)
• Issue Implement spell slot progression system #26: Spell slots (needs display)
• Issue Refactor lore display methods to use LoreBuilder utility #37: LoreBuilder (use for consistency)
• Issue Character Sheet Commands (View and Give) #47: View character sheet commands

Future Enhancements

• Click resources to consume them (like spell focus pattern)
• Click spells to cast them (if in spell focus slot)
• Character sheet "pages" (stats page, spells page, equipment page)
• Export character sheet as image/PDF
• Customizable layout per player preference

[FirebrickRed]

All phases of character sheet improvements complete:

✅ Phase 1: Ability Scores Display - Shows all 6 ability scores with modifiers, proficiency bonus
✅ Phase 2: Skills Menu - Drilldown menu showing all skills with proficiency markers
✅ Phase 3: Spellbook Enhancements - Shows cantrips, spells, and concentration status
✅ Phase 4: AC Breakdown - Shows detailed armor class calculation (simplified from full equipment menu)
✅ Phase 5: Spell Slots Display - Shows current/max spell slots per level in spellbook tooltip
✅ Phase 6: Save & Close - Implemented BOTH button (slot 53) AND /closesheet command

Equipment inventory display was intentionally scoped out as items already exist in Minecraft inventory. A more detailed equipment menu can be tracked in a future issue if needed.

Character sheet is now alpha-ready! Commits: a05257a, 2b82f62, b606a48