NxCodex

Version 1.5.0 - Latest Release

New Features

#### Custom Player Head Support - Base64 Texture Support: Use custom player head textures without any plugin dependency - HeadDatabase Integration: Optional HeadDatabase support with automatic fallback - Priority System: HeadDatabase > Head Texture > Material for maximum flexibility - Native API: Uses Bukkit's PlayerProfile API for better compatibility Configuration:

zone:
  spawn:
    material: "GRASS_BLOCK"  # Fallback material
    # hdb: "12345"  # HeadDatabase ID (priority 1, requires HeadDatabase plugin)
    # head-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmFkYzA0OGE3Y2U3OGY3ZGFkNzJhMDdkYTI3ZDg1YzA5MTY4ODFlNTUyMmVlZWQxZTNkYWYyMTdhMzhjMWEifX19"  # Base64 texture (priority 2, no plugin required)

Priority Order: 1. HeadDatabase (hdb: "id") - If HeadDatabase plugin is installed 2. Head Texture (head-texture: "base64") - Custom texture without plugin 3. Material (material: "STONE") - Standard Minecraft material #### Safe Teleportation System - Smart Position Detection: Automatically finds safe teleport locations - Block Collision Prevention: Ensures players don't spawn inside blocks - Ground Validation: Verifies solid ground beneath player - Danger Avoidance: Prevents spawning in lava, magma blocks, or unsafe areas - Auto-Adjustment: Searches up to 3 blocks up/down for safe position - Block Centering: Centers players on blocks (x.5, z.5) for better positioning Safety Checks: - Feet and head blocks are passable (air or non-solid) - Ground block is solid and safe - Avoids lava, magma, and water - Automatic fallback to nearest safe location #### Player Rotation Support (Yaw/Pitch) - Full Rotation Control: Save and restore player facing direction - Automatic Capture: Editor saves current yaw and pitch when setting location - Precise Orientation: Players face the exact direction configured - Visual Feedback: Editor displays current rotation values Configuration:

cordinates:
  x: 0.5      # X coordinate (centered on block)
  y: 64.0     # Y coordinate
  z: 0.5      # Z coordinate (centered on block)
  world: "world"
  yaw: 0.0    # Horizontal rotation (0-360°)
  pitch: 0.0  # Vertical rotation (-90° to 90°)

Rotation Guide: - Yaw: 0° = South, 90° = West, 180° = North, 270° = East - Pitch: -90° = Looking up, 0° = Horizon, 90° = Looking down #### Simplified Configuration - Hardcoded Modrinth ID: No need to configure update checker ID - Cleaner Config: Removed modrinth-id from config.yml - Automatic Updates: Update checker works out of the box #### Automatic Config Migration - Smart Config Updater: Automatically adds missing configuration options - Zero Downtime: Updates happen on plugin startup - Backward Compatible: Works with old configuration files - Safe Updates: Never overwrites existing values What Gets Updated Automatically: - Missing discovery section in config.yml - Missing yaw and pitch in zone coordinates - Missing chat-prompts and cooldown sections in guis.yml - Missing update-notifier message in lang.yml - Decimal conversion for coordinates (0 → 0.5 for centering) - All new configuration options from version 1.5.0 Example:

[ConfigUpdater] Added missing 'discovery' section to config.yml
[ConfigUpdater] codex.yml updated with missing yaw/pitch values
[ConfigUpdater] Added yaw/pitch to guis.yml teleport lore
[ConfigUpdater] config.yml updated successfully

Bug Fixes

#### Editor Display Updates - Fixed: Yaw and pitch values now update correctly in the zone editor - Fixed: Multiple config reloads when setting teleport location (now single reload) - Improved: Editor refreshes with updated rotation values immediately - Optimized: Batch coordinate updates for better performance #### Update Checker - Fixed: Update notification now only shows when remote version is actually newer - Fixed: Version comparison using semantic versioning (1.5.0 > 1.3.6) - Fixed: No more false update notifications when running dev/newer versions - Improved: Smart version parsing with support for suffixes (-SNAPSHOT, -beta) #### Gradient System - Fixed: Gradient colors now render correctly with formatting tags - Fixed: <bold>, <italic>, <underline>, <strikethrough> tags properly handled - Fixed: Character counting excludes formatting tags for accurate color distribution - Improved: Support for short tags (<b>, <i>, <u>, <st>) - Improved: Better color interpolation across gradient text #### Teleportation Issues - Fixed: Players no longer spawn inside blocks - Fixed: Teleportation to unsafe locations (lava, void, etc.) - Fixed: Incorrect player positioning on blocks - Improved: Teleportation reliability and safety #### Head/Skull Support - Fixed: HeadDatabase dependency is now optional (softdepend) - Fixed: Plugin works without HeadDatabase installed - Fixed: Proper fallback when HeadDatabase is not available - Improved: Better error handling for custom textures #### Configuration - Fixed: Coordinates now support decimal values for precise positioning - Fixed: Rotation values properly saved and loaded - Improved: Default values for new zones (centered on blocks)

Technical Changes

#### New Classes - SkullUtil: Utility class for managing custom player heads - HeadDatabase API integration - Base64 texture support - Automatic plugin detection - TeleportUtil: Safe teleportation utility - Position validation - Safety checks - Automatic position adjustment - ConfigUpdater: Automatic configuration migration - Adds missing config options - Updates old formats to new ones - Runs on plugin startup - Safe and non-destructive #### Enhanced Classes - CodexZone: Added headTexture field for custom textures - CodexManager: - Enhanced coordinate loading with yaw/pitch support - Added editZoneMultiple() for batch field updates - Optimized reload system for better performance - CodexMenu: Improved item building with head priority system - MenuListener: - Safe teleportation and rotation saving - Batch coordinate updates (x, y, z, world, yaw, pitch) - Improved editor refresh logic - ZoneEditorMenu: Display yaw/pitch in editor GUI with live updates - UpdateChecker: - Hardcoded Modrinth ID for simplicity - Semantic version comparison (major.minor.patch) - Smart version parsing with suffix support - ColorUtil: - Fixed gradient rendering with formatting tags - Support for <bold>, <italic>, <underline>, <strikethrough> - Improved color interpolation algorithm #### Dependencies - HeadDatabase: Changed from depend to softdepend - HeadDatabase API: Added as provided dependency - Bukkit PlayerProfile API: Used for custom head textures

Configuration Changes

#### codex.yml Updates Before:

cordinates:
  x: 0
  y: 64
  z: 0
  world: "world"

After:

cordinates:
  x: 0.5      # Centered on block
  y: 64.0
  z: 0.5      # Centered on block
  world: "world"
  yaw: 0.0    # New: Horizontal rotation
  pitch: 0.0  # New: Vertical rotation

New Head Options:

# Option 1: HeadDatabase (requires plugin)
hdb: "12345"

# Option 2: Base64 Texture (no plugin required)
head-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmFkYzA0OGE3Y2U3OGY3ZGFkNzJhMDdkYTI3ZDg1YzA5MTY4ODFlNTUyMmVlZWQxZTNkYWYyMTdhMzhjMWEifX19"

# Option 3: Standard Material (fallback)
material: "GRASS_BLOCK"

#### config.yml Updates Removed:

update-notifier:
  modrinth-id: "RuKNgtS0"  # No longer needed

Current: ```yaml update-notifier: enabled: true on-join