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"

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

zones:
  spawn_zone:
    slot: 0
    name: "Zone Spawn"
    material: PLAYER_HEAD
    world: "world"
    region: "pinata"
    coordinates:
      x: 100.5
      y: 64.0
      z: 200.5
      yaw: 0.0
      pitch: 0.0
    skull: "headdb:1234"
    itemsadder: 'namespace:nameitems'
    lore:
      - "&7Click to teleport."
    discovery_message: "&aNew zone: &eSpawn Zone"
    reward_commands:
      - "give %player% emerald 1"

  hdb_example:
    slot: 1
    name: "Zone HeadDB"
    material: PLAYER_HEAD
    skull: "headdb:1234"
    coordinates:
      x: 0.0
      y: 64.0
      z: 0.0
    lore:
      - "&7Exemple utilisant HeadDatabase"

messages:
  general:
    prefix: "<gradient:#ff9a00:#ff2d95>Codex</gradient> &7"
    no_permission: "&cVous n'avez pas la permission."
    player_only: "&cSeuls les joueurs peuvent utiliser cette commande."
    unknown_subcommand: "&cUsage: /codex reload|list|create <id>."
    menu_title: "<gradient:#ff9a00:#ff2d95>Codex</gradient>"
    menu_unavailable: "&cAucune zone n'est disponible dans le Codex."
    locked_name: "&cZone verrouillée"
  info:
    reload_success: "&aConfiguration rechargée."
    list_header: "&6Zones disponibles:"
    list_format: "&e- &f%id% &7(%name%)"
    list_empty: "&cAucune zone n'est configurée."
    teleport_start: "&7Téléportation vers &e%name% &7dans &c%seconds%s..."
    teleport_cancelled: "&cTéléportation annulée."
    teleport_locked: "&cVous devez découvrir cette zone avant d'y accéder."
    zone_discovered: "&aVous découvrez &e%name%&a."
    locked_lore:
      - "&7Vous devez découvrir cette zone pour l'ouvrir."
  error:
    create_usage: "&cUsage: /codex create <id>."
    create_exists: "&cUne zone avec cet identifiant existe déjà."
  success:
    create_success: "&aZone %id% créée à votre position."
    teleport_success: "&aTéléportation vers &e%name% &aréussie."