NxCodex

🌍 Zone System

• Custom name and description
• Exact teleport location (world, coordinates, yaw, pitch)
• Custom icon (supports HeadDatabase)
• Dedicated slot in the menu
• Zones can be locked until discovered

🔓 Area Discovery

• Players must discover zones before teleporting
• Upon discovery:
  • Personalized message
  • Optional reward commands (items, permissions, economy, etc.)
• Locked zones remain hidden in the GUI

⏱️ Teleportation

• Configurable teleport delay by rank:

Rank	Delay
Admin	1s
Moderator	2s
VIP	3s
Default	5s

• Teleportation canceled if the player moves or is interrupted
• Clear messages for: start, success, cancellation, locked zones

🧭 GUI Menu

• Fully customizable:
  • Title, number of rows (up to 6)
  • Slot position per zone
  • Custom icons for locked zones
• Automatic display of discovered/unlocked and locked zones

🧠 HeadDatabase Integration

• Use headdb:<id> for custom skulls
• Supports advanced and professional GUIs

---

Command	Description
/codex	Opens the Codex GUI
/codex admin list	Lists all configured zones
/codex admin create <id>	Creates a new zone at your current location
/codex admin delete <id>	Deletes an existing zone
/codex admin reload	Reloads the plugin configuration

Permission	Default	Description
codex.admin	op	Access to admin commands
codex.reset	op	Permission to reset discoveries

teleport_delays:
  admin: 1
  moderator: 2
  vip: 3
  default: 5

headdb:
  enabled: true
  plugin: "HeadDatabase"

messages:
  prefix: "<gradient:#27A6F5:#098FE3>&lCodex</gradient> &7»   "
  no_permission: "&cYou do not have permission."
  player_only: "&cOnly players can use this command."
  unknown_subcommand: "&cUsage: /codex reload|list|create <id>."
  reload_success: "&aConfiguration reloaded."
  list_header: "&6Available zones:"
  list_format: "&e- &f%id% &7(%name%)"
  list_empty: "&cNo zones configured."
  create_usage: "&cUsage: /codex create <id>."
  create_exists: "&cA zone with this ID already exists."
  create_success: "&aZone %id% created at your position."
  menu_unavailable: "&cNo zones are available in Codex."
  menu_title: "<gradient:#ff9a00:#ff2d95>Codex</gradient>"
  teleport_start: "&7Teleporting to &e%name% &7in &c%seconds%s..."
  teleport_success: "&aTeleported to &e%name% &asuccessfully."
  teleport_cancelled: "&cTeleportation cancelled."
  teleport_locked: "&cYou must discover this zone before accessing it."
  zone_discovered: "&aYou discovered &e%name%&a."
  locked_name: "&cLocked Zone"
  locked_lore:
    - "&7You must discover this zone to unlock it."

menu:
  title: "Codex"
  rows: 6
  locked_material: BARRIER

Codex:
  spawn_zone:
    slot: 11
    name: "&fPinata Zone"
    material: PLAYER_HEAD
    world: "world"
    region: "pinata"
    x: 100.5
    y: 64.0
    z: 200.5
    yaw: 0.0
    pitch: 0.0
    skull:
      value: "headdb:49643"
    lore:
      - "&7Click to teleport."
    discovery_message: "&aNew area: &ePinata Zone"
    reward_commands:
      - "give %player% emerald 1"

  spawn:
    slot: 40  
    name: "&fSpawn"
    material: PLAYER_HEAD
    skull:
      value: "headdb:66312" 
    world: "world"
    x: 0.0
    y: 64.0
    z: 0.0
    lore:
      - "&7Click to teleport."