Feature: Admin GUI Overhaul - Player Home Management & Navigation

[derrickmehaffy]

Scope

Overhaul the Admin GUI to enable administrators to view, use, and manage other players' home locations, and add proper back button navigation between admin sub-pages.

Implementation Details

Player Home Management:

• Add a player search/lookup page in the admin GUI
• Search by username (including offline players) to view their homes
• Display a list of all homes for the selected player with:
  • Home name, coordinates, world
  • Creation/last modified date
  • Share status
• Admin actions for each player home:
  • Teleport: Teleport the admin to the player's home location
  • Delete: Remove a specific home (with confirmation dialog)
  • Transfer: Move a home to a different player (optional, lower priority)
• Show player stats: total homes, home limit, last online

Back Button Navigation:

• Add back buttons to all admin sub-pages (currently no way to go back)
• AdminMainPage -> AdminSettingsPage: add back button to settings
• AdminMainPage -> Player Lookup -> Player Homes -> Home Detail: full navigation chain
• Consistent back button placement matching the user-facing GUI overhaul

Dashboard Improvements:

• Show server-wide statistics on the admin main page:
  • Total players with homes
  • Total home count across all players
  • Storage stats (file count, approximate size)

Risks and Alternatives

• Risk: Loading all player data for stats could be slow with many players. Consider caching or lazy loading.
• Risk: Admin teleporting to player homes in unloaded worlds. Need to handle world loading gracefully.
• Alternative: Could use chat commands for admin home management instead of GUI. But GUI is more efficient for browsing/managing multiple homes.
• Alternative: Could paginate player list instead of search. Search is better for servers with many players.

References and Media

• Current admin pages: gui/page/admin/AdminMainPage.java, gui/page/admin/AdminSettingsPage.java
• HyperFactions admin GUI pattern (player lookup, stats dashboard, back navigation)
• Permission required: hyperhomes.admin (existing)

Confirmation

• I have searched existing issues to ensure this is not a duplicate
• I have considered the scope and impact of this feature