DK CommandItems

# DKCommandItems - Update v1.2.1 Changelog ## 🆕 New Features ### Custom Display Names - **Set Custom Display Names**: Added ability to set custom display names for items with full color code support - **Color Code Support**: Use `&` for color codes (e.g., `&c&lRed Bold`, `&6&lGolden`, `&a&oGreen Italic`) - **Optional Feature**: Display names are completely optional - items work with or without them - **Clear Option**: Type `clear` to remove a previously set display name - **Cancel Option**: Type `cancel` to cancel the display name operation ### GUI Improvements - **New Button**: Added "Set Custom Display Name" button (paper icon) in Create Item GUI - **Visual Feedback**: Shows current display name status in button lore - **Persistent Storage**: Display names persist across GUI reopens using static storage - **Better Layout**: Reorganized GUI buttons for improved user experience ## 🔧 Technical Changes ### CreateItemGUI Class - Added `playerDisplayNames` static Map to store custom display names - New PAPER case handler for display name input - Display name is applied to item when creating the custom item - Proper cleanup of display names when player exits GUI ### Color Code Processing - Automatic conversion of `&` to `§` for Minecraft color codes - Support for all standard Minecraft color codes (0-9, a-f) - Support for formatting codes (l=bold, m=strikethrough, n=underline, o=italic, r=reset) ### GUI Layout Updates - Display name button added at slot 30 - Command block button moved to slot 32 - Single use toggle moved to slot 34 - Improved visual spacing and organization ## 📋 How to Use ### Setting a Custom Display Name 1. Open Create Item GUI: `/dkcommanditems` → "Create Custom Item" 2. Click the **"Set Custom Display Name"** button (paper icon) 3. Type your desired name in chat with color codes 4. The GUI will reopen showing your custom display name 5. Continue creating your item normally ### Color Code Examples **Basic Colors:** ``` &cRed Text &aGreen Text &9Blue Text &eYellow Text ``` **With Formatting:** ``` &c&lRed Bold &a&oGreen Italic &9&nBlue Underline &e&mYellow Strikethrough ``` **Complex Names:** ``` &6&lLegendary Sword &c&lF&6&lI&e&lR&a&lE &b&lHealing &f&lPotion ``` ### Available Color Codes | Code | Color | Code | Format | |------|-------|------|--------| | `&0` | Black | `&l` | **Bold** | | `&1` | Dark Blue | `&m` | ~~Strikethrough~~ | | `&2` | Dark Green | `&n` | Underline | | `&3` | Dark Aqua | `&o` | *Italic* | | `&4` | Dark Red | `&r` | Reset | | `&5` | Dark Purple | | | | `&6` | Gold | | | | `&7` | Gray | | | | `&8` | Dark Gray | | | | `&9` | Blue | | | | `&a` | Green | | | | `&b` | Aqua | | | | `&c` | Red | | | | `&d` | Light Purple | | | | `&e` | Yellow | | | | `&f` | White | | | ## 🐛 Bug Fixes ### Display Name Persistence - **Fixed**: Display names now persist when reopening the GUI - **Fixed**: Display names are properly applied to items when saved - **Fixed**: GUI correctly shows "None" when no display name is set ### GUI State Management - **Improved**: Better handling of player data across GUI instances - **Improved**: Static storage ensures display names don't get lost - **Improved**: Proper cleanup when player exits or cancels ## 🔄 Compatibility - **Backward Compatible**: All existing items continue to work normally - **Optional Feature**: Display names are completely optional - **No Breaking Changes**: Existing functionality remains unchanged - **Server Compatibility**: Works with Paper, Spigot, and Bukkit 1.20+ ## 📝 Usage Examples ### Example 1: Legendary Weapon ``` Display Name: &6&lLegendary Sword Item ID: LegendarySword Commands: effect give %player% strength 60 2 ``` ### Example 2: Healing Item ``` Display Name: &a&lHealing Potion Item ID: HealPotion Commands: effect give %player% regeneration 10 2 ``` ### Example 3: Rainbow Item ``` Display Name: &c&lR&6&la&e&li&a&ln&b&lb&9&lo&d&lw Item ID: RainbowStar Commands: give %player% diamond 10 ``` ### Example 4: Simple Name ``` Display Name: &bTeleport Stone Item ID: TPStone Commands: tp %player% 0 64 0 ``` ## 🎯 What's Next This update focuses on giving players more creative freedom with item customization. Future updates may include: - Custom lore lines - Item enchantment configuration - Item attribute modification - More placeholder options ## 📦 Installation 1. **Download** the latest version (v1.2.1) 2. **Stop** your server 3. **Replace** the old plugin jar with the new one 4. **Start** your server 5. **Enjoy** the new custom display name feature! ## ⚠️ Important Notes - Display names are **optional** - you can skip this step if you want - Display names are **separate** from item IDs (internal identifiers) - Color codes use `&` not `§` (the plugin converts automatically) - Type `clear` to remove a display name - Type `cancel` to cancel the operation --- **Version**: 1.2.1 **Release Date**: 2024 **Compatibility**: Minecraft 1.20+ **Required Java**: 17+ **Thank you for using DKCommandItems!** 🎨✨

# DKCommandItems - Changelog v1.3 ## 🆕 New Features ### Customizable Lore System - **Toggle Default Lore**: Added `show-default-lore` option in config.yml to enable/disable the default plugin lore - **Hidden Identifier**: When disabled, only an invisible identifier is added to items - **Custom Lore Freedom**: Allows players to create items with fully customized lore without plugin information - **Configuration**: New setting in config.yml with comments in English, Portuguese, and Spanish ### Case-Insensitive Placeholders - **Flexible Placeholders**: All placeholders now work regardless of capitalization - **Supported Formats**: `%player%`, `%Player%`, `%PLAYER%`, `%PlAyEr%` all work correctly - **All Placeholders**: Applies to all placeholders including `%world%`, `%x%`, `%y%`, `%z%`, `%health%`, `%food%`, `%level%` ## 🔧 Bug Fixes ### GUI Listener Management - **Fixed Duplicate Messages**: Implemented GUIManager to prevent multiple listeners from being active simultaneously - **Automatic Cleanup**: Old GUI listeners are automatically unregistered when opening new GUIs - **No More Duplicates**: Resolved issues with duplicate messages when saving items, getting items, toggling settings, and listing commands - **Centralized Control**: All GUIs now use GUIManager.registerGUIListener() for proper listener management ### Single-Use Item Consumption - **Fixed Consumption Order**: Single-use items are now consumed BEFORE executing commands - **Prevents Loss**: Solves the issue where items weren't consumed when using commands like `kill %player%` - **Proper Verification**: Added checks to ensure the item is still in hand before consumption - **Debug Logging**: Added logging to track item consumption for troubleshooting ### Delete Items GUI - **Fixed Item Detection**: Improved item name extraction from display names and lore - **Multi-Language Support**: Detects items with "Name:", "Nome:", or "Nombre:" in lore - **Display Name Parsing**: Extracts item names from "[DELETAR]" or "[DELETE]" prefixes - **Confirmation Dialog**: Fixed confirmation GUI to use correct localized titles - **Proper Deletion**: Confirmation buttons now work correctly instead of giving items ### NullPointerException Fixes - **CreateItemGUI**: Fixed null baseItem error by saving item reference before chat input - **CommandsGUI**: Added validation to prevent null item references - **Error Messages**: Added user-friendly error messages when item base is not found ### Localization - **English Lore**: Changed hardcoded Portuguese lore to English in CustomItem class - **Consistent Language**: "Commands:" instead of "Comandos:", "Single use" instead of "Uso único" - **Cleanup Detection**: Removes both Portuguese and English lore lines when updating items ## 🛠️ Technical Improvements ### GUIManager Utility Class - **Centralized Management**: New utility class to manage all GUI listeners - **Active Listener Tracking**: Maintains a set of active GUI listeners - **Automatic Unregistration**: Unregisters all previous listeners when registering a new one - **Memory Efficient**: Prevents listener accumulation and memory leaks ### Listener Lifecycle - **isActive Flag**: Added to all GUI classes to track listener state - **HandlerList Cleanup**: Proper use of HandlerList.unregisterAll() before opening new GUIs - **Event Priority**: Maintained EventPriority.HIGHEST for critical GUI events - **Thread Safety**: Proper use of SchedulerUtil for async operations ### Code Quality - **Better Error Handling**: Added try-catch blocks with informative error messages - **Logging**: Added debug logging for troubleshooting item consumption and GUI operations - **Validation**: Added null checks and validation before operations - **Comments**: Added explanatory comments in English for better code maintainability ## 📋 Configuration Changes ### config.yml ```yaml # Show default lore on custom items show-default-lore: true ``` - **Default**: true (shows plugin information in lore) - **When false**: Only adds hidden identifier, preserves original item lore ## 🔄 Compatibility - **Backward Compatible**: Items created with previous versions continue to work - **Lore Detection**: Recognizes both old (Portuguese) and new (English) lore formats - **Automatic Migration**: Old items work seamlessly with new system - **No Data Loss**: All existing items and configurations are preserved ## 🐛 Known Issues Resolved 1. ✅ Duplicate messages when saving items 2. ✅ Duplicate messages when getting items from GUI 3. ✅ Duplicate messages when toggling single-use 4. ✅ Duplicate messages when listing commands 5. ✅ Single-use items not being consumed 6. ✅ Items not consumed when using kill command 7. ✅ Delete confirmation not working 8. ✅ NullPointerException in CommandsGUI 9. ✅ Portuguese lore showing in English mode 10. ✅ Case-sensitive placeholder issues ## 📝 Notes - All GUI classes now use GUIManager for listener registration - Single-use items are consumed immediately before command execution - Placeholders are now case-insensitive for better user experience - Default lore is now in English for international compatibility - Delete confirmation GUI properly detects item names in all languages

After defining the item name, the GUI would freeze on papermc.

Added compatibility with Folia, added English league, and added get items only through dkci give in dkci.