NoxClaim Lite

Documentación Oficial del Plugin Official Plugin Documentation

⚡ Funciones⚡ Features

🖥️ 100% Basado en Menús (GUI):🖥️ 100% GUI-Based: Gestión completa mediante menús interactivos con iconos HD en Base64.Complete management via interactive menus with HD Base64 icons.
💬 Entrada Inteligente en Chat:💬 Smart Chat Prompt: Escribe nombres directamente en el chat sin salir de los menús—sin usar comandos largos.Type names directly into chat within interactive menus—no long commands.
🔰 Anti-Grief Infalible:🔰 Bulletproof Anti-Grief: Bloquea grifeos avanzados, máquinas de lag, exploits de pistones y trucos de marcos.Blocks advanced griefing, lag machines, piston exploits, and frame tricks.
📊 Reclamo Automático (BossBar):📊 Auto-Claim (BossBar): Elegante barra superior que muestra en tiempo real el estado del territorio actual.Elegant top bar shows real-time claim status of your current territory.
🚩 Sistema Visual de Banderas (Flags):🚩 Visual Flag System: Activa o desactiva interacciones globales (PVP, explosiones, puertas, botones) con un solo clic.Toggle global interactions (PVP, explosions, doors, buttons) with a single click.
⚙️ Extremadamente Optimizado:⚙️ Extremely Optimized: Funciona a nivel de chunk (parcelas) con cero impacto en el rendimiento o los TPS del servidor.Works at the chunk level with zero impact on server performance or TPS.
🌐 100% Traducible:🌐 100% Translatable: Archivos lang.yml y flags.yml totalmente configurables.Fully configurable lang.yml and flags.yml files.
🚀 Ligero y Potente:🚀 Lightweight & Powerful: Uso mínimo de recursos, perfecto para servidores de cualquier tamaño.Minimal resource usage, perfect for any server size.

👤 Comandos (Usuario)👤 Commands (User)

Comando Base:Base Command: /claim (Alias: /reclamarAlias: /reclamar)
💡 Nota: Los permisos de las banderas (flags) son requeridos para interacciones completas.💡 Note: Flag permissions are required for full interactions.

/claim ➡️ Activa/desactiva el modo de reclamar zonas (alterna la BossBar de estado).Enable/disable Claim Mode (toggles the status BossBar).
/claim menu ➡️ Abre el menú principal para administrar tus protecciones.Open the Main Menu (GUI) to manage your claims.
/claim claimchunk ➡️ Reclama la zona (chunk) en la que te encuentras.Claim the chunk you are standing in.
/claim unclaimchunk ➡️ Elimina la protección de la zona (chunk) actual.Remove protection from the current chunk.
/claim unclaimall confirm ➡️ Elimina todas tus protecciones a la vez (requiere confirmación).Remove all your claims at once (requires confirmation).
/claim vision ➡️ Muestra/oculta las partículas de los bordes de tus parcelas.Toggle visible particles showing chunk borders.
/claim adduser <player> ➡️ Añade un amigo a tu zona (le permite construir e interactuar).Add a friend to your claim (allows build/interact).
/claim removeuser <player> ➡️ Elimina a un amigo de tu zona.Remove a friend from your claim.
/claim banuser <player> ➡️ Bloquea a un jugador para que no pueda entrar en tus tierras.Block a player from entering your land.
/claim pardonuser <player> ➡️ Desbloquea a un jugador de tus tierras.Unblock a player from your land.
/claim setowner <player> ➡️ Transfiere la propiedad completa de tus tierras a otro jugador.Transfer full ownership of your land.

🛠️ Comandos (Staff)🛠️ Commands (Staff)

Comando Base:Base Command: /noxclaims
🔑 Requiere permisos de administrador.🔑 Requires admin permission.

/noxclaims reload ➡️ Recarga las configuraciones en tiempo real sin reiniciar el servidor.Reload configurations in real-time without restarting.
/noxclaims addclaim <amount> <player> ➡️ Aumenta permanentemente el límite máximo de protecciones de un jugador.Permanently increase a player's max claim limit.
/noxclaims removeclaim <amount> <player> ➡️ Reduce las protecciones extras de un jugador.Decrease a player's extra claims.

🔒 Permisos🔒 Permissions

noxclaims.admin ➡️ Acceso total de administrador e inmunidad (Modo Dios).Full admin access & bypass (God Mode).
noxclaims.maxclaims.<group> ➡️ Límites personalizados de protecciones para rangos específicos (VIP, Donador, etc).Custom claim limits for specific ranks (VIP, Donor, etc).
noxclaims.flag.<flagname> ➡️ Necesario para usar o alternar las protecciones específicas (flags).Required to use or toggle specific protection flags.
noxclaims.flag.* ➡️ Otorga acceso a todas las banderas de protección (flags).Grants access to all protection flags.

📁 Archivos de Configuración📁 Configuration Files

config.yml

# ========================================== #
#               NOXCLAIMS CORE               #
#         Created by Noxstar Studios         #
# ========================================== #

# Main plugin command(s)
main_command:
  - "claim"
  - "proteccion"
  - "reclame"

limits:
  max_claims_per_player:
    default: 10
    vip: 20
    mvp: 30

# Storage configuration
storage:
  # Can be "YAML" (saved in local file, better for small servers)
  # or "MYSQL" (database, better for large networks)
  type: "YAML"
  mysql:
    host: "localhost"
    port: 3306
    database: "noxclaims"
    username: "root"
    password: ""
    # How many concurrent connections the plugin will open to the DB
    pool_size: 10

flags.yml

# ========================================== #
#               NOXCLAIMS FLAGS              #
# ========================================== #
# Configure default protection flags for chunks here.
# 'default' is the value assigned to a chunk when it is first claimed.
# false = Actions blocked. true = Actions allowed.
# 'permission' is optional. If specified, the player needs 
# that permission to be able to toggle the flag in the GUI.

flags:
  pvp:
    name: '&#ef4444PvP'
    description: '	ca3afAllows combat between players.'
    material: DIAMOND_SWORD
    default: false
    permission: noxclaims.flag.pvp
  explosions:
    name: '&#ef4444Explosions'
    description: '	ca3afAllows Creepers and TNT to break blocks.'
    material: TNT
    default: false
    permission: noxclaims.flag.explosions
  open_chest:
    name: '&#f59e0bChests & Inventories'
    description: '	ca3afAllows visitors to open chests.'
    material: CHEST
    default: false
    permission: noxclaims.flag.open_chest
  interact:
    name: '
b981Interact'
    description: '	ca3afAllows using doors, buttons, etc.'
    material: OAK_DOOR
    default: false
    permission: noxclaims.flag.interact
  block_break:
    name: '&#dc2626Break Blocks'
    description: '	ca3afAllows visitors to break blocks.'
    material: IRON_PICKAXE
    default: false
    permission: noxclaims.flag.block_break
  block_place:
    name: '&#dc2626Place Blocks'
    description: '	ca3afAllows visitors to place blocks.'
    material: GRASS_BLOCK
    default: false
    permission: noxclaims.flag.block_place
  hostile_spawning:
    name: 'b5cf6Hostile Monsters'
    description: '	ca3afSpawning of monsters (Zombies, etc).'
    material: ZOMBIE_HEAD
    default: false
    permission: noxclaims.flag.hostile_spawning
  animal_spawning:
    name: '&#ec4899Peaceful Animals'
    description: '	ca3afSpawning of animals (Cows, Sheep).'
    material: PIG_SPAWN_EGG
    default: true
    permission: noxclaims.flag.animal_spawning
  fire_spread:
    name: '&#f97316Fire Spread'
    description: '	ca3afAllows fire to burn your house.'
    material: CAMPFIRE
    default: false
    permission: noxclaims.flag.fire_spread
  pve:
    name: '&#ef4444Animal Damage (PvE)'
    description: '	ca3afVisitors can hurt your pets.'
    material: LEATHER
    default: false
    permission: noxclaims.flag.pve
  enderman_grief:
    name: 'b5cf6Enderman Grief'
    description: '	ca3afEndermen can steal blocks.'
    material: ENDER_PEARL
    default: false
    permission: noxclaims.flag.enderman_grief
  item_drop:
    name: '&#f3f4f6Drop Items'
    description: '	ca3afVisitors can drop items.'
    material: DROPPER
    default: false
    permission: noxclaims.flag.item_drop
  item_pickup:
    name: '&#f3f4f6Pickup Items'
    description: '	ca3afVisitors can pick up dropped items.'
    material: HOPPER
    default: false
    permission: noxclaims.flag.item_pickup
  entry:
    name: 'b82f6Entry Ban'
    description: '	ca3afVisitors will not be able to enter.'
    material: IRON_BARS
    default: true
    permission: noxclaims.flag.entry
  alerts:
    name: '&#f59e0bIntruder Alerts'
    description: '	ca3afWarning when someone enters your zone.'
    material: BELL
    default: true
    permission: noxclaims.flag.alerts

lang.yml

# ========================================== #
#               NOXCLAIMS LANG               #
#           Translation and Texts            #
# ========================================== #
# Note: You can use HEX colors in &#RRGGBB format
# or traditional color codes like &a, &b, &c...

prefix: "&#d1d5db[&#ff4d4dN&#ff6060o&#ff7373x&#ff8686C&#ff9999l&#ff8686a&#ff7373i&#ff6060m &#f59e0bLite&#d1d5db] &r"

messages:
  # ========================================
  # SYSTEM MODES AND BOSSBARS
  # ========================================
  mode_activated: "
b981Claim mode activated!"
  mode_claim_instructions: "	ca3af💡 Click (Left/Right) to claim | Shift + Click to unclaim"
  mode_deactivated: "&#ef4444Claim mode deactivated."
  vision_activated: "b82f6Vision mode activated! You can now see the borders."
  vision_deactivated: "&#ef4444Vision mode deactivated."
  bossbar_claim: "
b981&lClaim Mode Active &f- Type &e/claim &fto exit"
  bossbar_vision: "b82f6&lVision Mode Active &f- Type &e/claim vision &fto exit"

  # ========================================
  # CHUNK CLAIMING AND UNCLAIMING
  # ========================================
  chunk_claimed_success: "
b981You have successfully claimed this chunk!"
  chunk_unclaimed_success: "
b981[✔] You have unclaimed this chunk."
  unclaimall_confirm_warning: "&#ef4444&lWARNING! 	ca3afYou are about to delete &#ef4444ALL 	ca3afyour chunks. This action is &#ef4444&lirreversible	ca3af. To confirm, type: &#f59e0b/claim unclaimall confirm"
  unclaimall_success: "
b981[✔] You have successfully unclaimed your &#f59e0b{amount} 
b981claims."
  no_claims_to_unclaim: "&#ef4444You do not have any claims to abandon."
  not_your_chunk_to_unclaim: "&#ef4444You cannot unclaim a chunk that is not yours."
  chunk_not_claimed: "&#ef4444This chunk is not claimed."
  chunk_already_claimed: "&#ef4444This chunk is already claimed."
  limit_reached: "&#ef4444You have reached the maximum claim limit (&#f59e0b{max}&#ef4444 chunks)."
  need_empty_hand: "&#ef4444You must have an empty hand to claim a chunk."
  need_empty_slot_bar: "&#ef4444Warning: To claim, you must select an empty slot in your hotbar."
  
  # ========================================
  # USER MANAGEMENT (FRIENDS AND BANNED)
  # ========================================
  player_trusted: "
b981You have given permissions to &#f59e0b{player} 
b981in this chunk."
  player_untrusted: "&#ef4444You have removed permissions from &#f59e0b{player} &#ef4444in this chunk."
  already_trusted: "&#f59e0b{player} 	ca3afalready had permissions in this chunk."
  not_trusted: "&#f59e0b{player} 	ca3afdid not have permissions in this chunk."
  
  player_banned: "&#ef4444You have banned &#f59e0b{player} &#ef4444from this chunk."
  player_unbanned: "
b981You have unbanned &#f59e0b{player} 
b981from this chunk."
  already_banned: "&#f59e0b{player} 	ca3afwas already banned from this chunk."
  not_banned: "&#f59e0b{player} 	ca3afwas not banned from this chunk."
  
  setowner_success: "
b981[✔] You have transferred this chunk to &#f59e0b{player}
b981!"
  target_limit_reached: "&#ef4444You cannot give the chunk to &#f59e0b{player} &#ef4444because they have reached their claim limit."
  
  # ========================================
  # ZONE ALERTS (ENTER/EXIT)
  # ========================================
  zone_enter: "
b981You have entered the territory of &#f59e0b{owner}"
  zone_exit: "	ca3afYou have entered the wilderness."
  intruder_alert: "&#ef4444[!] ALERT: 	ca3afPlayer &#f59e0b{player} 	ca3afhas entered your territory."
  banned_enter_attempt: "&#ef4444You are banned from this zone. You cannot enter!"
  entry_denied: "&#ef4444[!] The owner has denied entry to their territory."

  # ========================================
  # GENERAL ERRORS AND WARNINGS
  # ========================================
  no_permission: "&#ef4444You do not have permission to do this."
  flag_no_permission: "&#ef4444You do not have the required permission to modify this flag."
  not_your_chunk: "&#ef4444You cannot open the settings of a chunk that is not yours."
  player_not_found: "	ca3afPlayer &#f59e0b{player} 	ca3afwas not found."
  cannot_target_self: "&#ef4444You cannot perform this action on yourself."
  
  usage_adduser: "&#ef4444Usage: /claim adduser <player>"
  usage_removeuser: "&#ef4444Usage: /claim removeuser <player>"
  usage_banuser: "&#ef4444Usage: /claim banuser <player>"
  usage_pardonuser: "&#ef4444Usage: /claim pardonuser <player>"
  usage_setowner: "&#ef4444Usage: /claim setowner <player>"
  pvp_disabled: "&#ef4444PvP is disabled in this zone."
  
  # ========================================
  # ADMIN COMMANDS
  # ========================================
  reload_success: "
b981[✔] Configuration files reloaded successfully!"
  reload_usage: "&#ef4444Usage: /noxclaims reload"
  invalid_amount: "&#ef4444You must enter a valid number greater than 0."
  admin_addclaim_success: "
b981[✔] You have granted &#f59e0b{amount} 
b981extra claims to &#f59e0b{player}."
  admin_removeclaim_success: "
b981[✔] You have removed &#f59e0b{amount} 
b981extra claims from &#f59e0b{player}."

gui:
  # ========================================
  # MENU TITLES
  # ========================================
  main_title: "b5563Chunk Information"
  flags_title: "b5563Flag Settings"
  users_title: "b5563User Management"
  trusted_list_title: "b5563Trusted Friends"
  banned_list_title: "b5563Banned Players"
  claims_list_title: "b5563Your Claims 	ca3af(&#f59e0b{page}	ca3af/&#f59e0b{max}	ca3af)"

  # ========================================
  # CHAT PROMPTS (INTERACTION WITHOUT COMMANDS)
  # ========================================
  prompt_add_user: "&a&l[!] &7Type the name to &aADD&7 in chat:"
  prompt_ban_user: "&c&l[!] &7Type the name to &cBAN&7 in chat:"
  prompt_setowner: "&e&l[!] &7Type the name of the new &eOWNER&7:"
  prompt_cancel_hint: "&8(Or type &c'cancel' &8to exit)"
  prompt_cancelled: "&cAction cancelled."
  
  # ========================================
  # BUTTONS: MAIN MENU
  # ========================================
  btn_info_name: "&#f59e0b&l✦ My Chunks ✦"
  btn_info_lore:
    - ""
    - "&#e2e8f0► Claim Progress:"
    - "  	ca3afProtected Chunks: 
b981{current} b5563/ &#ef4444{max}"
    - ""
    - "&#e2e8f0► Current Location:"
    - "  	ca3afCoordinates: &#f3f4f6X: {x} &8| &#f3f4f6Z: {z}"
    - ""
    - "&#f59e0b★ &oYour protected empire &f★"
    
  btn_flags_name: "b82f6&lManage Flags"
  btn_flags_lore:
    - ""
    - "	ca3afClick to configure who"
    - "	ca3afcan interact in this chunk."

  btn_users_name: "&#a855f7&lUser Management"
  btn_users_lore:
    - ""
    - "	ca3afClick to add or remove"
    - "	ca3affriends and banned players."

  # ========================================
  # BUTTONS: USER MENU
  # ========================================
  btn_add_friend_name: "
b981&lAdd Friend"
  btn_add_friend_lore:
    - "	ca3afGive full access to a player."
    
  btn_remove_friend_name: "&#ef4444&lRemove Friend"
  btn_remove_friend_lore:
    - "	ca3afView friends list and remove them."
    
  btn_add_ban_name: "&#ef4444&lBan Player"
  btn_add_ban_lore:
    - "	ca3afPhysically block a player."
    
  btn_remove_ban_name: "
b981&lUnban Player"
  btn_remove_ban_lore:
    - "	ca3afView banned list and pardon them."

  btn_setowner_name: "&#f59e0b&lTransfer Ownership"
  btn_setowner_lore:
    - "	ca3afTransfer the rights of this chunk"
    - "	ca3afto another player."

  # ========================================
  # BUTTONS: GENERAL GUI
  # ========================================
  btn_back_name: "&#ef4444&lGo Back"
  btn_close_name: "&#ef4444&lClose Menu"
  btn_next_page_name: "&#f59e0b&lNext Page 
b981➡"
  btn_prev_page_name: "
b981⬅ &#f59e0b&lPrevious Page"
  
  claim_item_name: "
b981Chunk X: &#f59e0b{x} 
b981Z: &#f59e0b{z}"
  claim_item_lore:
    - "	ca3afLeft click to"
    - "&#ef4444unclaim 	ca3afthis chunk."
  
  flag_allowed: "
b981&l[✔] ALLOWED"
  flag_denied: "&#ef4444&l[✖] DENIED"
  click_to_toggle: "&#f59e0bClick to toggle!"