Plugin de Minecraft WorldGuardExtraFlagsPlus

🔌 Acerca de WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus es una extensión del plugin WorldGuard que proporciona flags y comportamientos adicionales para regiones. Amplía el sistema de regiones de WorldGuard con más de 40 flags confirmadas para controlar el uso de objetos, la teletransportación, los límites de entrada, el crafting, la colisión entre jugadores, el comercio con aldeanos y otras reglas específicas de región.

🎯 Propósito

El plugin cubre las carencias de las flags integradas de WorldGuard al ofrecer un control detallado sobre las acciones de los jugadores y las políticas de región. Está pensado para administradores de servidores que necesitan una personalización a nivel de región más allá de WorldGuard base, por ejemplo para crear arenas PvP protegidas, lobbies, comportamiento de hub o zonas de juego restringidas.

⚙️ Características

• Añade más de 40 flags extra (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Nuevas flags específicas de Plus: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• Mensajes personalizables almacenados en messages-wgefp.yml (cooldown de mensajes para evitar spam).
• Hooks de integración opcionales: compatibilidad con PlaceholderAPI para placeholders numéricos, hooks opcionales de paquetes con PacketEvents o ProtocolLib para mejorar el bloqueo de ciertos objetos/ataques.
• Interacción con EssentialsX: las mejoras de las flags godmode y fly desactivan el godmode/fly de EssentialsX cuando esas flags están denegadas.
• Compatibilidad con Folia y handlers seguros para async cuando corresponde.
• Comprobador de actualizaciones y una flag experimental hide-players y el comportamiento experimental chambered-enderpearl.
• Flag console-command-repeat para ejecutar un comando de consola repetidamente mientras un jugador permanezca en una región (desactivada por defecto).

🧩 Para quién es

• Propietarios y administradores de servidores que usan WorldGuard y necesitan controles de región más precisos.
• Servidores Survival, SMP, hub/lobby y PvP que requieren comportamiento personalizado por región.
• Servidores que usan Paper o Folia y necesitan soporte async o específico de la fork.

🏗️ Casos de uso de ejemplo

• Limitar el número de jugadores en una región de arena con player-count-limit.
• Bloquear el uso y el lanzamiento de objetos concretos (mace, trident, ender pearls) dentro de zonas de eventos usando disable-completely y disable-throw.
• Evitar el crafting (2x2) en el inventario dentro de zonas seguras con inventory-craft o bloquear el uso de la mesa de trabajo con permit-workbenches.
• Restringir la entrada a una región por nivel de XP del jugador o por un valor numérico de PlaceholderAPI usando entry-min-level / entry-max-level.
• Ejecutar un comando de consola repetidamente mientras los jugadores permanezcan dentro de una región usando console-command-repeat.

⌨️ Comandos

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial y colócalo en el directorio plugins/ de tu servidor junto con WorldGuard.
• Si actualizas desde el antiguo WorldGuardExtraFlags: elimina el WorldGuardExtraFlags.jar antiguo antes de iniciar — ambos no pueden coexistir.
• Reinicia el servidor y comprueba la consola para confirmar que el plugin y sus flags se cargaron correctamente.

📦 Dependencias

• Requerido: WorldGuard (este proyecto es una extensión de WorldGuard).
• Opcional / Integraciones: PlaceholderAPI (compatibilidad con placeholders numéricos), PacketEvents o ProtocolLib (bloqueo basado en paquetes mejorado), EssentialsX (integración para el comportamiento de godmode/fly).

🧾 Configuración

• Los mensajes del plugin se almacenan en plugins/WorldGuard/messages-wgefp.yml y son totalmente personalizables; hay un sistema de cooldown de mensajes configurable mediante la config del plugin.

🧠 Notas técnicas

• El proyecto declara api-version: 1.21 y apunta a artefactos modernos de la API de Paper; la compatibilidad con Folia está implementada y confirmada.
• El bytecode de Java y el objetivo de la API se alinean con entornos de servidor recientes de la era 1.21.
• El plugin reemplaza el comportamiento antiguo de permit-completely por disable-completely para una semántica de bloqueo de objetos más amplia.
• Algunas funciones (por ejemplo, el bloqueo completo de ciertas mecánicas de embestida de la lanza) son más fiables cuando PacketEvents o ProtocolLib están presentes.
• El plugin expone muchas flags mediante los comandos estándar de flags de WorldGuard (las flags se establecen usando la interfaz de flags de región de WorldGuard).

🤝 Cuándo es útil este plugin

Si usas WorldGuard y necesitas flags de región adicionales y confirmadas para controlar el uso de objetos, las reglas de entrada de jugadores, el crafting y otros comportamientos por región — especialmente en servidores Paper o Folia — WorldGuard ExtraFlags Plus centraliza esas capacidades dentro del sistema de flags de WorldGuard sin necesitar plugins separados de gestión de regiones.