NxCodex

Version 1.2.5 - Latest Release

🎉 New Features

🔄 Modrinth Update Checker

• Modrinth API Integration: Now uses the official Modrinth API instead of Spigot
• Configurable Project ID: Set your Modrinth project ID in config.yml
• Customizable Messages: Update notification message is now fully customizable in lang.yml
• Smart Caching: Update messages are cached and shown to admins when they join
• Color Support: Full hex color and gradient support in update messages

Configuration:

update-notifier:
  enabled: true
  on-join: true
  modrinth-id: "RuKNgtS0"

Customizable Message (lang.yml):

update-notifier: "&#ffc84dA new version of NxCodex is available! &#DDDDDD(&#FFFFFFcurrent: &#FF0D0D%current% &#DDDDDD| &#FFFFFFlatest: &#00FF00%latest%&#DDDDDD)"

🎛️ Configurable Discovery System

• Toggle Discovery Mode: Enable or disable the zone discovery system
• Flexible Gameplay: Choose between exploration-based or instant access gameplay
• Per-Server Configuration: Perfect for different server types (survival vs creative)

Configuration:

discovery:
  # If true, zones must be discovered by entering the region
  # If false, all zones are unlocked by default
  enabled: true

Discovery Enabled (true) - Default:

• Players must enter WorldGuard regions to discover zones
• Discovery messages and rewards are given on first entry
• Zones appear locked in the menu until discovered
• Perfect for survival/adventure servers

Discovery Disabled (false):

• All zones are unlocked by default for all players
• No discovery messages or rewards
• Players can teleport to any zone immediately
• Perfect for creative/hub servers

🐛 Bug Fixes

Region Detection Improvements

• Fixed: Region detection now properly checks if player is inside the specific region
• Fixed: Empty or _global_ regions are now properly ignored
• Fixed: Discovery system respects the discovery.enabled configuration
• Optimized: Region checks only occur when player changes block position

Player Data Loading

• Fixed: Players now properly receive all unlocked zones when discovery.enabled = false
• Fixed: Zone unlocking works correctly for both new and existing players
• Improved: Player data caching for better performance

🔧 Technical Changes

Dependencies

• Added: Gson 2.10.1 for JSON parsing (Modrinth API)
• Relocated: Gson to fr.noxuwt.nxcodex.libs.gson to avoid conflicts

Code Improvements

• Refactored: UpdateChecker to use Modrinth API v2
• Improved: PlayerListener with cached update messages
• Enhanced: CodexManager with discovery mode support
• Optimized: Region detection logic for better performance