AxoStudio

AxoProtectionBlock

AxoProtectionBlock es un plugin moderno de protecciones para servidores Paper que permite crear regiones protegidas usando bloques especiales, sin depender de sistemas externos.

Plataforma

Paper 1.21.11+ / 26.1.2+

Compatibilidad

Paper y Folia

Java Requerido

Java 25+

Autor

AxoStudio

Funcionamiento

El jugador coloca un bloque, el plugin crea una proteccion alrededor de ese punto, guarda la region en su propio archivo y aplica reglas de proteccion mediante eventos nativos de Bukkit/Paper.

Usa sistema propio de regiones, bloques configurables desde YAML, menus GUI nativos y almacenamiento separado por proteccion.

Plugins opcionales

Plugin	Uso
PlaceholderAPI	Dependencia opcional incluida en el proyecto. Los placeholders propios funcionan sin plugins externos.
WorldGuard	Hook opcional para integraciones y classpath. No convierte las protecciones en regiones de WorldGuard.

Proteccion por bloques

Bloques configurables desde la carpeta blocks/.
Cada tipo puede tener material, radio, nombre, lore, flags, mensajes y comportamiento propios.
Soporte para cabezas con PLAYER_HEAD, owner o textura Base64.
Items marcados con PersistentDataContainer para evitar falsificaciones simples.
Al colocar el bloque se crea una region automaticamente.
Al romper el bloque protector se elimina la region.
El bloque vuelve directamente al inventario del jugador, incluso en creativo.
Explosiones y pistones pueden impedirse sobre bloques protectores.

Sistema de regiones propio

No usa WorldGuard ni dependencias obligatorias.
Soporta multiples mundos.
El radio afecta X/Z; en Y cubre toda la altura del mundo.
Evita regiones superpuestas, mundos bloqueados y duplicados.
Busca regiones mediante cache por mundo y chunks.
Guarda cada proteccion en un YAML dentro de protecciones/.

Datos guardados por region

ID unico, nombre de proteccion, UUID y nombre del dueno.
Mundo, ubicacion del bloque protector y material.
Coordenadas minimas y maximas, radio y fecha de creacion.
Miembros, nombres de miembros, flags y home.
Mensajes personalizados de entrada y salida.

Menus GUI

Los menus usan inventarios nativos de Bukkit/Paper y se editan desde menu/. Por defecto usan tamano 27, equivalente a 3 filas.

Menu principal.
Menu de protecciones del jugador.
Menu de administracion.
Menu de miembros.
Menu de flags.
Menu de homes.
Menus de confirmacion.

Homes por proteccion

Cada proteccion puede tener un home guardado dentro del archivo de region.
El dueno puede cambiar el home dentro de su proteccion.
Los miembros pueden usar homes si la configuracion lo permite.
El teletransporte valida mundo existente y ubicacion segura.
Compatible con teleportAsync.

Visualizacion y rendimiento

/apb view muestra bordes con particulas y antispam por jugador.
Indice de regiones por mundo.
Busqueda por chunk para evitar recorridos globales innecesarios.
Guardado asincrono cuando corresponde.
Flujo de liquidos optimizado para reducir busquedas repetidas.
Sin BukkitScheduler tradicional en tareas internas.

Flags actuales

true significa permitido. false significa protegido o bloqueado. Duenos, miembros y usuarios con bypass pueden saltarse restricciones segun el caso.

Flag	Controla
`BLOCK_BREAK`	Romper bloques.
`BLOCK_PLACE`	Colocar bloques.
`INTERACT`	Interacciones generales.
`CONTAINER_ACCESS`	Cofres, barriles, hornos y contenedores.
`PVP`	Dano entre jugadores.
`ENTITY_DAMAGE`	Dano a entidades, item frames, armor stands y similares.
`EXPLOSIONS`	Explosiones generales.
`LIQUID_FLOW`	Flujo de agua y lava.
`PISTONS`	Movimiento con pistones.
`ENTRY`	Entrada de jugadores a la region.
`MOB_DAMAGE`	Dano causado por mobs.
`FIRE_SPREAD`	Propagacion de fuego, lava y quemado.
`LIGHTER`	Uso de mechero o fireball por jugador.
`ENDERMAN_GRIEF`	Enderman moviendo bloques.
`TRAMPLE_BLOCKS`	Pisoteo de cultivos/farmland.
`CREEPER_EXPLOSION`	Explosiones de creeper.
`WITHER_DAMAGE`	Dano y explosiones del Wither.
`GHAST_FIREBALL`	Fireballs de Ghast.

EXPLOSIONS es la flag general. Para permitir explosiones normales pero bloquear creepers, usa EXPLOSIONS: true y CREEPER_EXPLOSION: false. MOB_DAMAGE es la flag general de dano de mobs; WITHER_DAMAGE y GHAST_FIREBALL controlan casos concretos.

Almacenamiento ordenado

blocks/ define tipos de bloques, protecciones/ guarda regiones creadas por jugadores y menu/ guarda la configuracion editable de menus.

plugins/AxoProtectionBlock/
|- blocks/
|  |- beacon_64.yml
|  |- otros_bloques.yml
|- menu/
|  |- main.yml
|  |- homes.yml
|  |- otros_menus.yml
|- protecciones/
|  |- region-uuid.yml
|  |- region-otro-uuid.yml
|- config.yml
|- messages.yml

Bloque configurable basico

El nombre del archivo es importante para comandos como /apb give Steve beacon_64. En ese caso beacon_64 sale de beacon_64.yml.

type: BEACON
alias: "64"
description: "Proteccion de radio 64 bloques."

restrict-obtaining: true

worlds:
  list-type: blacklist
  list:
    - world_nether
    - world_the_end

prevent-block-place-in-restricted-world: true
allow-placing-in-wild: true

region:
  radius: 64

  home-offset:
    x: 0.5
    y: 1.0
    z: 0.5
    yaw: 0.0
    pitch: 0.0

  flags:
    BLOCK_BREAK: false
    BLOCK_PLACE: false
    INTERACT: false
    CONTAINER_ACCESS: false
    PVP: false
    ENTITY_DAMAGE: false
    EXPLOSIONS: false
    LIQUID_FLOW: false
    PISTONS: false
    ENTRY: true
    MOB_DAMAGE: false
    FIRE_SPREAD: false
    LIGHTER: false
    ENDERMAN_GRIEF: false
    TRAMPLE_BLOCKS: false
    CREEPER_EXPLOSION: false
    WITHER_DAMAGE: false
    GHAST_FIREBALL: false

  messages:
    enter: "%prefix%&aEntrando a la proteccion de &f%owner%&a."
    leave: "%prefix%&eSaliendo de la proteccion de &f%owner%&e."

block-data:
  display-name: "&b&lProteccion &d&l64x64"
  lore:
    - "&7Coloca este bloque para crear una proteccion."
    - "&bRadio: &f64 bloques"
    - "&7Dueno: &f%player%"
  enchanted-effect: true
  custom-model-data: -1
  price: 0.0

Bloques con cabezas

El plugin genera un ejemplo llamado blocks/player_head_10.yml. Si texture esta vacio, usa owner; si quieres textura fija, coloca el Base64 en texture.

type: PLAYER_HEAD
alias: "head_10"
description: "Proteccion de radio 10 usando una cabeza personalizada."

region:
  radius: 10

block-data:
  display-name: "&c&lProteccion de Cabeza &7(Radio 10)"
  lore:
    - "&7Coloca esta cabeza para proteger una zona."
    - "&cRadio: &f10 bloques"
    - "&7Dueno: &f%player%"

  head:
    enabled: true
    owner: "%player%"
    texture: ""

Region guardada

id: fb54c1fa-5556-4cf7-be83-d3ad864f667c
name: Proteccion de Steve
owner-uuid: 00000000-0000-0000-0000-000000000000
owner-name: Steve
world: world
radius: 64
created-at: 1778348437989

protection-block:
  x: 68
  y: 117
  z: -17
  material: BEACON

min:
  x: 4
  y: -64
  z: -81

max:
  x: 132
  y: 319
  z: 47

members: []
member-names: {}

home:
  world: world
  x: 68.5
  y: 118.0
  z: -16.5
  yaw: 0.0
  pitch: 0.0

messages:
  enter: "%prefix%&aEntrando a la proteccion de &f%owner%&a."
  leave: "%prefix%&eSaliendo de la proteccion de &f%owner%&e."

Configuracion principal

settings:
  default-radius: 16
  max-regions-per-player: 3
  region-shape: CUBE
  disabled-worlds:
    - world_nether
    - world_the_end

menus:
  size: 27
  rows: 3

homes:
  enabled: true
  default-home-at-protection-block: true
  allow-members-teleport: true
  safe-teleport: true
  teleport-delay: 3

Mensajes

Se editan desde plugins/AxoProtectionBlock/messages.yml.
Soporta colores con &.
Placeholders propios: %player%, %owner%, %region%, %radius%, %flag% y %value%.
Prefix configurable con %prefix%.
Cada region tambien puede tener mensajes propios de entrada y salida.

messages:
  enter: "%prefix%&aEntrando a la proteccion de &f%owner%&a."
  leave: "%prefix%&eSaliendo de la proteccion de &f%owner%&e."

Comandos principales

Comando	Descripcion
`/apb`	Comando principal.
`/apb help`	Muestra la ayuda del plugin.
`/apb give <jugador> <bloque> [cantidad]`	Entrega un bloque definido en `blocks/`.
`/apb blocks`	Lista los bloques de proteccion cargados.
`/apb create <bloque\|radio> [material] [nombre]`	Crea una proteccion manual bajo tus pies.
`/apb info`	Muestra informacion de la proteccion actual.
`/apb remove`	Elimina la proteccion donde estas parado.
`/apb edit size <radio>`	Cambia el radio de la proteccion actual.
`/apb edit message <enter\|leave> <mensaje>`	Cambia el mensaje de entrada o salida.
`/apb edit block <material>`	Cambia el material del bloque protector.
`/apb addmember <jugador>`	Anade un miembro a la proteccion actual.
`/apb removemember <jugador>`	Elimina un miembro.
`/apb members`	Abre el menu de miembros.
`/apb flag <flag> <true\|false>`	Cambia una flag.
`/apb list`	Lista tus protecciones.
`/apb view`	Muestra los bordes de la proteccion actual.
`/apb menu`	Abre el menu principal.
`/apb admin`	Abre el menu administrativo.
`/apb homes`	Abre el menu de homes.
`/apb sethome`	Establece el home de la proteccion actual.
`/apb home`	Teletransporta al home de la proteccion actual.
`/apb home <region>`	Teletransporta al home de una proteccion concreta.
`/apb version`	Muestra la version del plugin.
`/apb ver`	Alias corto para ver la version del plugin.
`/apb reload`	Recarga configuracion, mensajes, bloques, menus y regiones.

Permisos

Permiso	Descripcion	Default
`axoprotectionblock.admin`	Permiso administrativo general.	OP
`axoprotectionblock.player`	Permiso global de jugador. Incluye permisos normales, no admin ni `axoprotectionblock.limit.*`.	Todos
`axoprotectionblock.bypass`	Ignora protecciones.	OP
`axoprotectionblock.create`	Permite crear protecciones.	Todos
`axoprotectionblock.remove`	Permite eliminar protecciones propias.	Todos
`axoprotectionblock.member.add`	Permite anadir miembros.	Todos
`axoprotectionblock.member.remove`	Permite eliminar miembros.	Todos
`axoprotectionblock.flag`	Permite cambiar flags.	Todos
`axoprotectionblock.reload`	Permite recargar el plugin.	OP
`axoprotectionblock.give`	Permite entregar bloques de proteccion.	OP
`axoprotectionblock.info`	Permite consultar informacion y listas.	Todos
`axoprotectionblock.view`	Permite visualizar bordes.	Todos
`axoprotectionblock.menu`	Permite abrir el menu principal y homes.	Todos
`axoprotectionblock.menu.members`	Permite abrir el menu de miembros.	Todos
`axoprotectionblock.menu.admin`	Permite abrir el menu administrativo.	OP
`axoprotectionblock.home`	Permite usar homes.	Todos
`axoprotectionblock.sethome`	Permite establecer homes.	Todos
`axoprotectionblock.home.others`	Permite usar homes de regiones ajenas.	OP
`axoprotectionblock.rename`	Permite renombrar protecciones desde menu.	Todos
`axoprotectionblock.edit`	Permite editar tamano, mensajes y bloque.	Todos
`axoprotectionblock.block.<bloque>`	Permite usar un tipo de bloque de `blocks/`.	Segun configuracion
`axoprotectionblock.limit.<numero>`	Define limite de protecciones por jugador.	Falso
`axoprotectionblock.limit.unlimited`	Quita el limite de protecciones.	Falso

Limites por permisos

El plugin detecta automaticamente el permiso numerico mas alto. Los permisos se leen dinamicamente desde Bukkit/Paper, por lo que funcionan con LuckPerms u otros plugins de permisos sin reiniciar.

axoprotectionblock.limit.1
axoprotectionblock.limit.3
axoprotectionblock.limit.5
axoprotectionblock.limit.10
axoprotectionblock.limit.50
axoprotectionblock.limit.unlimited

Si un jugador tiene axoprotectionblock.limit.5 y axoprotectionblock.limit.10, el limite usado sera 10.
Si tiene axoprotectionblock.limit.unlimited, no tendra limite.
Si no tiene ningun permiso limit.X, se usa settings.max-regions-per-player.

settings:
  max-regions-per-player: 3