NxCodex

Version 1.3.5 - Latest Release

🎉 New Features

🎨 Fully Configurable GUI System (guis.yml)

• New Configuration File: guis.yml for complete GUI customization
• Zone Editor GUI: Fully configurable editor menu with custom items, slots, and messages
• No Hardcoded Values: All GUI elements are now configurable
• Dynamic Item Building: Items are built dynamically from configuration
• Custom Placeholders: Support for zone-specific placeholders in GUI items

New File Structure:

guis.yml
├── zone-editor          # Zone editor GUI configuration
│   ├── title           # Menu title with placeholders
│   ├── size            # Inventory size
│   └── items           # All GUI items
│       ├── filler      # Background items
│       ├── material    # Material editor
│       ├── display-name # Name editor
│       ├── lore        # Lore display
│       ├── teleport    # Location setter
│       ├── region      # Region editor
│       ├── rewards     # Rewards display
│       ├── slot        # Slot editor
│       └── close       # Close button
├── chat-prompts        # Chat input messages
└── cooldown            # Cooldown messages

🔧 GuiManager System

• Centralized GUI Management: New GuiManager class for all GUI operations
• Dynamic Loading: GUIs are loaded from configuration at runtime
• Easy Customization: Server owners can customize without code changes
• Placeholder Support: Rich placeholder system for dynamic content
• Color Support: Full hex color and gradient support in all GUI elements

Available Placeholders:

• %zone_name% - Zone identifier
• %material% - Zone material name
• %display_name% - Zone display name
• %zone_lore% - Zone lore lines
• %world%, %x%, %y%, %z% - Teleport coordinates
• %region% - WorldGuard region name
• %rewards% - Reward commands list
• %slot% - GUI slot number
• %time% - Cooldown time

📝 Configurable Chat Messages

• Chat Prompts: All chat input prompts moved to guis.yml
• Success Messages: Configurable success messages for editor actions
• Error Messages: Customizable error messages with placeholders
• Cooldown Messages: Fully configurable cooldown notification

Chat Prompts Configuration:

chat-prompts:
  material: "&eTapez le nom du matériau (ex: DIAMOND_BLOCK) dans le chat :"
  name: "&eTapez le nouveau nom de la zone dans le chat :"
  region: "&eTapez le nom de la région WorldGuard dans le chat :"
  slot: "&eTapez le numéro de slot (0-53) dans le chat :"
  location-updated: "&aPosition de téléportation mise à jour."
  invalid-material: "&cMatériau invalide : &f%input%"
  invalid-slot: "&cSlot invalide. Entrez un nombre entre 0 et 53."

🎯 Enhanced Zone Editor

• Configurable Layout: Customize item positions, materials, and messages
• Dynamic Item Display: Items show current zone values with placeholders
• Flexible Design: Easy to add or remove editor features
• Multi-language Support: All text is configurable for any language
• Custom Styling: Full control over colors, formatting, and layout

🐛 Bug Fixes

GUI System

• Fixed: Hardcoded GUI titles and messages removed
• Fixed: Editor menu now properly detects zone from title
• Fixed: Item slots are now configurable instead of hardcoded
• Improved: GUI item building with better error handling

Message System

• Fixed: All hardcoded messages moved to configuration files
• Fixed: Cooldown messages now use configured format
• Fixed: Chat prompts properly support color codes
• Improved: Message consistency across the plugin

🔧 Technical Changes

New Classes

• GuiManager: Manages all GUI configurations and operations
• Enhanced ZoneEditorMenu: Rebuilt to use configuration-based system
• Improved MenuListener: Uses GuiManager for all GUI interactions

Code Improvements

• Removed Hardcoded Values: All GUI elements now configurable
• Better Separation: GUI logic separated from configuration
• Improved Maintainability: Easier to add new GUI features
• Enhanced Flexibility: Server owners have full control

Configuration System

• New File: guis.yml for GUI configurations
• Automatic Generation: File is created on first run
• Hot Reload: Changes apply with /codex reload
• Validation: Proper fallbacks for missing values

📝 Configuration Changes

New Configuration File

guis.yml (complete new file):

# Zone Editor GUI
zone-editor:
  title: "§6§lEditor: %zone_name%"
  size: 27
  items:
    filler:
      material: "BLACK_STAINED_GLASS_PANE"
      name: " "
      slots: [0,1,2,3,4,5,6,7,8,18,19,20,21,23,24,25,26]
    material:
      slot: 10
      material: "STONE"
      name: "&eMaterial: &f%material%"
      lore:
        - "&7Click to change the material."
    # ... (see full config in guis.yml)

# Chat Prompts
chat-prompts:
  material: "&eType the material name (ex: DIAMOND_BLOCK) in chat:"
  name: "&eType the new zone name in chat:"
  # ... (see full config in guis.yml)

# Cooldown Messages
cooldown:
  message: "&cPlease wait &f%time%s &cbefore teleporting again."