AxoProtectionBlock

Protección por bloques

• Bloques configurables desde la carpeta blocks/ con tamaño por eje, material y lore.
• Soporte para cabezas con PLAYER_HEAD, o textura Base64.
• Soporte opcional para items de CraftEngine.
• Items marcados con PersistentDataContainer para evitar falsificaciones.
• Al colocar el bloque se crea una región automáticamente.
• Al romper el bloque se elimina la región y vuelve al inventario.
• Las explosiones y pistones pueden bloquearse sobre bloques protectores.

Sistema de regiones propio

• No usa WorldGuard ni dependencias obligatorias.
• El tamaño se define por eje: x_radius, y_radius y z_radius.
• y_radius: -1 cubre toda la altura del mundo.
• Evita regiones superpuestas y mundos bloqueados.
• Soporta múltiples mundos con índice por chunks.
• Guarda protecciones en YAML por región o SQL (SQLite/MySQL).

Almacenamiento de regiones

Cada región contiene: ID, nombre, propietario, coordenadas, radio, miembros, co-dueños, bloqueados, flags, home, fecha de creación y mensajes personalizados.

id: fb54c1fa-5556-4cf7-be83-d3ad864f667c
name: Protección de Steve
owner-uuid: 00000000-0000-0000-0000-000000000000
world: world
radius: 64
x_radius: 64
y_radius: -1
z_radius: 64
created-at: 1778348437989

members: []
co-owners: []
blocked-players: []

flags:
  BLOCK_BREAK: false
  PVP: false
  EXPLOSIONS: false

Menús GUI y Sistemas Visuales

Menús configurables con inventarios nativos desde menu/.

• Menú Principal: Acceso a protecciones, tienda, homes e impuestos.
• Menú de Protecciones: Lista y gestión de tus regiones.
• Menú de Miembros: Añade, elimina y gestiona permisos.
• Menú de Flags: Activa o desactiva protecciones por región.
• Creator Visual: Crea y edita tipos de protección desde el juego.
• Editor de Recetas: Diseña crafteos personalizados.
• Menús Configurables: Desde menu/systems.yml para tienda, rentas e impuestos.

Sistema de Recetas

• Editor visual integrado para crear recetas shaped y shapeless.
• Las recetas se guardan en recipes/ y se registran automáticamente con recipes.auto-register.
• El resultado del crafteo conserva los datos internos del bloque de protección.
• Los jugadores pueden ver recetas sin editarlas con /apb recipes <bloque>.

Tienda de protecciones

• Se abre con /apb shop (configurable desde shop.command).
• Muestra automáticamente bloques definidos en blocks/.
• Soporta precios, ícono, brillo, prioridad y slots configurables.
• Integración opcional con Vault para cobrar dinero real.
• Paginación, decoración, sonidos y actualización automática.
• Items personalizados pueden enviar mensajes, ejecutar comandos, reproducir sonidos.

Homes por protección

• Cada protección puede tener un home único.
• El dueño puede cambiar el home dentro de su protección.
• Los miembros pueden usar homes si está habilitado.
• Teletransporte seguro con delay configurable.
• Compatible con teleportAsync de Paper.

Sistema de Rentas

• Los dueños publican protecciones en renta por precio y duración.
• Duraciones aceptan horas o días: 1h, 6h, 12h, 1d, 7d, 30d.
• El renter se añade automáticamente como miembro durante la renta.
• Renovación automática opcional, cancelación y límites por jugador.
• Avisos configurables antes del vencimiento.
• Registros en rent-data.yml.

Sistema de Impuestos

• Cobros periódicos automáticos por tipo de protección.
• Cálculo basado en: base por bloque, multiplicador por tamaño, multiplicador por prioridad.
• Período configurable (horas) y período de gracia (días) antes del cobro.
• Acciones por impago: NONE (nada), DISABLE (deshabilita), REMOVE (elimina).
• Registros en tax-data.yml.
• Requiere Vault para cobrar dinero real.

Idiomas y Localización

• Soporta es_ES, en_US y ru_RU.
• language.default define idioma global por defecto.
• language.auto-detect-client usa el idioma del cliente de Minecraft.
• /apb language <lang> cambia idioma personal.
• /apb language auto vuelve a detección automática.
• Los idiomas elegidos se guardan en player-languages.yml.
• En menús y tienda puedes usar claves como lang:menu.main.title.

Administración Avanzada

• SQL y Migradores: SQLite/MySQL con HikariCP. Importa desde ProtectionStones y RoyaleProtectionBlocks.
• Limpieza de inactivos: Detecta y elimina regiones de jugadores que no juegan (con vista previa y reportes).
• Discord Webhooks: Integración nativa sin dependencias externas.
• Visualización de bordes: /apb view muestra límites con partículas.
• Bloque inicial: Opción de dar un bloque al entrar por primera vez al servidor.
• Actualizaciones: Notificación automática desde Modrinth.

Combate y Zonas Seguras

• El plugin marca jugadores en combate durante combat.tag-seconds.
• Los jugadores marcados no pueden escapar a una región protegida donde PvP esté bloqueado.

Flags de protección

true significa permitido. false significa bloqueado. Dueños y miembros pueden saltarse restricciones según permisos.

Migradores de otros plugins

• YAML a SQL: /apb migrate yaml-to-sql - Migra YAML a SQL sin borrar archivos.
• ProtectionStones: Lee desde WorldGuard e importa regiones, miembros y flags.
• RoyaleProtectionBlocks: Importa desde DB.sqlite directamente.
• Todos los migradores crean respaldos automáticos en migration-backups/.