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! 🎨✨