Fix storage sort persistence and add configurable format for sort button

[Copilot]

Problem

The storage sort functionality had several UX issues:

1. Sort lost on reopen: When closing and reopening the spawner storage, the selected sort option was reset to default alphabetical order, even though the preference was saved in SpawnerData
2. Sort reset on actions: Any action in the storage (taking items, adding items, etc.) would cause the sort to revert to default display
3. No default selection: When first opening storage, no sort option was selected, making the lore display less user-friendly
4. Hardcoded formatting: Sort button item formatting was hardcoded instead of being configurable like the filter/sort buttons in the list GUI

Root Cause

The issue was that VirtualInventory.getDisplayInventory() would rebuild the display cache without considering the preferred sort material stored in SpawnerData. When the cache was invalidated (by actions or reopening), it defaulted to alphabetical sorting.

Solution

1. Store sort preference in VirtualInventory

Added a preferredSortMaterial field to VirtualInventory that persists the sort preference at runtime:

private org.bukkit.Material preferredSortMaterial;

When sortItems() is called, this preference is stored and automatically applied whenever the display cache needs to be rebuilt.

2. Initialize default sort on first open

Modified SpawnerStorageAction.openLootPage() to:

• Check if preferredSortItem is null when opening storage
• If null and loot items exist, automatically select the first item (alphabetically sorted) as default
• Save the preference to SpawnerData
• Apply the sort to VirtualInventory on every open

This ensures users always see a consistent sort from the first time they open storage.

3. Make item format fully configurable

Replaced hardcoded formatting in SpawnerStorageUI.createSortButton() with configuration-based format strings:

String selectedItemFormat = languageManager.getGuiItemName("sort_items_button.selected_item");
String unselectedItemFormat = languageManager.getGuiItemName("sort_items_button.unselected_item");
String noneText = languageManager.getGuiItemName("sort_items_button.none_text");

Added these configuration keys to gui.yml (en_US and vi_VN):

sort_items_button:
  selected_item: '&#00F986• %item_name%'      # Format for currently selected sort item
  unselected_item: '&#f8f8ff• %item_name%'    # Format for unselected items
  none_text: '&#bdc3c7• None'                 # Text when no items available

The %item_name% placeholder gets replaced with the actual item name, allowing complete customization of colors, bullet styles, prefixes, suffixes, and overall layout.

Result

• ✅ Sort preference now persists across storage reopens
• ✅ Sort is maintained after any action (take items, add items, etc.)
• ✅ First loot item is automatically selected as default on first open
• ✅ Sort button item format is now fully configurable via gui.yml, consistent with filter/sort buttons in list GUI
• ✅ Better UX with always-visible sort selection
• ✅ Users can customize not just colors but entire format including bullet style, text, and layout

Technical Details

The fix works by storing the sort preference in two places:

• SpawnerData: Persisted to disk for long-term storage
• VirtualInventory: Used at runtime when rebuilding the display cache

When VirtualInventory.getDisplayInventory() rebuilds the cache (which happens after any inventory modification), it now checks preferredSortMaterial and applies the appropriate sorting logic automatically.

Backward Compatibility

All changes are backward compatible:

• Existing spawners without a sort preference will automatically get the first item as default
• No database migration required
• Default format values match the previous hardcoded format

Original prompt

at the function handleSortItemsClick(), when reopen the storage the sort display is gone, this also apply to when user use the action in the SpawnerStorage the short will return to the default display, you need to make it consistent maybe modify the VirtualInventory. And at the start when first open SpawnerStorage no sort option item was selected, can you add default item selected is the first item? so the lore display can be more UX/UI friendly. And also can SpawnerStorageUI createSortButton() can you make it that it can be config able color for these line?
String color = currentSort == lootItem.getMaterial() ? "&#00F986" : "&#f8f8ff";
availableItems.append("&#bdc3c7• None");

so it not hard coded there is example for this in filter and sort button in the list gui command

dont write javadocs

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[ptthanh02]

@copilot
ok but I don't want to change only the color but the entire text itselft for example:

sort_items_button:
selected_item: '• &#00F986%item_name%' # Currently selected sort item
unselected_item: '• &#f8f8ff%item_name%' # Unselected items
none_color: '&#bdc3c7• None # "None" text when no items

[Copilot]

@copilot
ok but I don't want to change only the color but the entire text itselft for example:

...

Done! Changed the configuration from just colors to full format strings with placeholders. You can now customize the entire format:

sort_items_button:
  selected_item: '&#00F986• %item_name%'
  unselected_item: '&#f8f8ff• %item_name%'
  none_text: '&#bdc3c7• None'

The %item_name% placeholder gets replaced with the actual item name. You can change the bullet style, add prefixes/suffixes, or completely customize the format. Commit: ddfaec5