ProtectedArea - Wiki Oficial

Sistema completo de protección de áreas para Minecraft Forge

Inicio

ProtectedArea es un mod de Forge para Minecraft que permite crear y gestionar áreas protegidas con un sistema completo de reglas, excepciones y automatización. Este mod te permite proteger zonas específicas del mundo con diferentes niveles de restricciones y funcionalidades avanzadas.

Características Principales

  • Sistema de Áreas Protegidas: Define zonas específicas con coordenadas personalizables
  • Múltiples Reglas de Protección: 9 tipos diferentes de reglas configurables
  • Sistema de Excepciones: Permite excepciones por jugador y por regla
  • Comandos Automáticos: Ejecuta comandos al entrar/salir de áreas
  • Vínculos entre Áreas: Conecta áreas para teleportación automática
  • Límites de Jugadores: Controla cuántos jugadores pueden estar en un área
  • Sistema de Prioridades: Maneja conflictos entre áreas superpuestas
  • Visualización: Item especial para mostrar áreas protegidas

Preguntas Comunes

¿Puedo usarlo en multijugador?

Sí. El servidor y el cliente deben tener instalado este mod. (Este mod no es un plugin y no puede usarse en Bukkit, Spigot o Paper).

¿Es compatible con otros mods?

ProtectedArea es compatible con la mayoría de mods que no modifiquen profundamente la mecánica del juego. El mod está diseñado para trabajar con el sistema de eventos de Forge.

¿Afecta el rendimiento?

El mod está optimizado para un rendimiento mínimo. Solo las áreas activas con jugadores dentro consumen recursos adicionales.

¿Dónde reportar bugs o problemas de compatibilidad?

Puedes reportar problemas en https://discord.gg/owleafstudio.

Comandos

Todos los comandos requieren permisos de operador (nivel 2 o superior).

Comandos Básicos

/area agregar <id> <x1> <y1> <z1> <x2> <y2> <z2>

Crea una nueva área protegida.

Parámetros:

  • id: Identificador único de la área
  • x1, y1, z1: Coordenadas del primer punto
  • x2, y2, z2: Coordenadas del segundo punto

Ejemplo:

/area agregar spawn 0 64 0 10 70 10

/area listar

Muestra todas las áreas protegidas existentes.

/area eliminar <id>

Elimina una área protegida.

Ejemplo:

/area eliminar spawn

/area color <id> <hex> <alias>

Establece el color y alias de una área.

Parámetros:

  • id: ID de la área
  • hex: Color en formato hexadecimal (ej: #FF0000)
  • alias: Nombre descriptivo de la área

Ejemplo:

/area color spawn "#00FF00" Área de Spawn

Sistema de Reglas

ProtectedArea incluye 9 tipos de reglas diferentes que puedes activar o desactivar por área:

Tipos de Reglas

no_romper

Impide romper bloques

no_colocar

Impide colocar bloques

no_interactuar

Impide interactuar con bloques (chests, puertas, etc.)

no_mobgriefing

Impide que los mobs destruyan bloques

no_pvp

Desactiva el PvP entre jugadores

no_damage

Impide cualquier tipo de daño

no_spawn

Impide el spawn de mobs

no_entrada

Impide entrar al área

no_salida

Impide salir del área

Comandos de Reglas

/area regla <id> <regla> <estado>

Configura una regla específica para un área.

Parámetros:

  • id: ID de la área
  • regla: Tipo de regla (ver lista arriba)
  • estado: true para activar, false para desactivar

Ejemplos:

/area regla spawn no_pvp true
/area regla spawn no_romper false

/area listar_reglas <id>

Muestra todas las reglas configuradas para un área.

Ejemplo:

/area listar_reglas spawn

Excepciones

El sistema de excepciones permite que ciertos jugadores o entidades ignoren reglas específicas.

Comandos de Excepciones

/area exception add <id> <target> <rule>

Agrega una excepción para un jugador o entidad.

Parámetros:

  • id: ID de la área
  • target: Selector de entidad (ej: @p, @a, nombre_jugador)
  • rule: Regla a excepcionar (o "all" para todas)

Ejemplos:

/area exception add spawn @p no_pvp
/area exception add spawn Steve all

/area exception remove <id> <target> <rule>

Elimina una excepción.

Ejemplo:

/area exception remove spawn @p no_pvp

Comandos Automáticos

Puedes configurar comandos que se ejecuten automáticamente cuando los jugadores entren o salgan de un área.

Comandos de Entrada

/area command entrar <id> <delay> <usos> <commandtext>

Agrega un comando que se ejecuta al entrar al área.

Parámetros:

  • id: ID del área
  • delay: Retraso en ticks antes de ejecutar
  • usos: Número máximo de veces que se puede usar
  • commandtext: Comando a ejecutar (usa %player% para el nombre del jugador)

Ejemplo:

/area command entrar spawn 20 5 "tell %player% ¡Bienvenido al spawn!"

/area command entrar <id> <remove>

Elimina todos los comandos de entrada del área.

Ejemplo:

/area command entrar spawn remove

Comandos de Salida

/area command salir <id> <delay> <usos> <commandtext>

Agrega un comando que se ejecuta al salir del área.

Parámetros:

  • id: ID del área
  • delay: Retraso en ticks antes de ejecutar
  • usos: Número máximo de veces que se puede usar
  • commandtext: Comando a ejecutar (usa %player% para el nombre del jugador)

Ejemplo:

/area command salir spawn 10 3 "effect clear %player% minecraft:night_vision"

/area command salir <id> <remove>

Elimina todos los comandos de salida del área.

Ejemplo:

/area command salir spawn remove

Gestión de Usos

/area command usos <entrar> <id> <target> <usos> <comando al cual se le agregara usos>

Agrega usos adicionales a un comando de entrada específico.

Parámetros:

  • entrar: Tipo de comando (entrar)
  • id: ID del área
  • target: Selector de jugador (ej: @p, nombre_jugador)
  • usos: Número de usos adicionales a agregar
  • comando al cual se le agregara usos: Índice del comando (0, 1, 2, etc.)

Ejemplo:

/area command usos entrar spawn @p 5 0

/area command usos <salir> <id> <target> <usos> <comando al cual se le agregara usos (indexorall)>

Agrega usos adicionales a un comando de salida específico.

Parámetros:

  • salir: Tipo de comando (salir)
  • id: ID del área
  • target: Selector de jugador (ej: @p, nombre_jugador)
  • usos: Número de usos adicionales a agregar
  • comando al cual se le agregara usos (indexorall): Índice del comando (0, 1, 2, etc.) o "all" para todos

Ejemplos:

/area command usos salir spawn @p 3 0
/area command usos salir spawn @p 10 all

Vínculos entre Áreas

Puedes vincular áreas para crear teleportación automática entre ellas.

Comandos de Vínculos

/area vincular add <delay> <fromId> <toId>

Crea un vínculo entre dos áreas.

Parámetros:

  • delay: Retraso en ticks antes del teleport
  • fromId: ID del área de origen
  • toId: ID del área de destino

Ejemplo:

/area vincular add 20 spawn lobby

/area vincular remove <fromId>

Elimina el vínculo de un área.

Ejemplo:

/area vincular remove spawn

Límites de Jugadores

Puedes establecer límites en el número de jugadores que pueden estar en un área simultáneamente.

Comandos de Límites

/area limite add <id> <max>

Establece un límite de jugadores para un área.

Ejemplo:

/area limite add spawn 10

/area limite bloquear <id> <value>

Activa o desactiva el bloqueo de salida cuando se alcanza el límite.

Ejemplo:

/area limite bloquear spawn true

/area limite remove <id>

Elimina el límite de jugadores.

Ejemplo:

/area limite remove spawn

Prioridades

Cuando las áreas se superponen, el sistema de prioridades determina qué reglas se aplican.

Comando de Prioridad

/area prioridad <id> <valor>

Establece la prioridad de un área (mayor número = mayor prioridad).

Ejemplo:

/area prioridad spawn 10

Teleportación

Comando de Teleport

/area tp <areaId> <selector> [delay] [groupSize]

Teleporta jugadores a un área específica.

Parámetros:

  • areaId: ID del área de destino
  • selector: Selector de jugadores
  • delay: Retraso opcional en ticks
  • groupSize: Tamaño del grupo para teleportación escalonada

Ejemplos:

/area tp spawn @p
/area tp lobby @a 20 5

Comando de Ejecución

/area execute <id> <comando>

Ejecuta un comando en todos los jugadores dentro de un área.

Parámetros:

  • id: ID del área
  • comando: Comando a ejecutar (usa %player% para el nombre del jugador)

Ejemplo:

/area execute spawn tell %player% ¡Estás en el spawn!

Configuración

El mod incluye un sistema de configuración que se guarda automáticamente. Las áreas se guardan en el archivo de configuración del servidor.

Configuración del Cliente

  • Visualización de Áreas: Usa el item "Show Area" para ver las áreas protegidas
  • Renderizado de Contornos: Las áreas se muestran con contornos de colores

Configuración del Servidor

  • Guardado Automático: Las áreas se guardan automáticamente al cerrar el servidor
  • Carga Automática: Las áreas se cargan automáticamente al iniciar el servidor
  • Sincronización: Los datos se sincronizan con los clientes al conectarse

API para Otros Mods

ProtectedArea proporciona una API para que otros mods puedan interactuar con el sistema de áreas protegidas.

Clases Principales

  • AreaManager: Gestión principal de áreas
  • Area: Representación de una área protegida
  • RuleType: Tipos de reglas disponibles
  • AreaProtectionHandler: Manejador de eventos de protección

Integración

Los mods pueden:

  • Crear y gestionar áreas programáticamente
  • Verificar si una ubicación está protegida
  • Agregar nuevos tipos de reglas
  • Interceptar eventos de protección

Ejemplos de Uso

Área de Spawn Básica

/area agregar spawn 0 64 0 20 70 20
/area color spawn #00FF00 "Área de Spawn"
/area regla spawn no_pvp true
/area regla spawn no_damage true
/area regla spawn no_romper true
/area regla spawn no_colocar true
/area command entrar spawn "say ¡Bienvenido al spawn!"
/area command salir spawn "say ¡Hasta luego!"

Área de Eventos

/area agregar eventos 100 64 100 200 80 200
/area color eventos #FF0000 "Área de Eventos"
/area regla eventos no_pvp false
/area limite add eventos 50
/area command entrar eventos 10 "effect give @p minecraft:strength 60"

Sistema de Lobby

/area agregar lobby 50 64 50 150 70 150
/area color lobby #0000FF "Lobby"
/area regla lobby no_pvp true
/area regla lobby no_romper true
/area command entrar lobby 20 "tp @p 100 65 100"
/area vincular add 40 lobby spawn

Solución de Problemas

El área no se crea

  • Verifica que tienes permisos de operador
  • Asegúrate de que el ID sea único
  • Confirma que las coordenadas son válidas

Las reglas no funcionan

  • Verifica que la regla esté activada: /area listar_reglas <id>
  • Comprueba si hay excepciones aplicadas
  • Revisa la prioridad de las áreas superpuestas

Los comandos no se ejecutan

  • Verifica la sintaxis del comando
  • Asegúrate de que el comando existe
  • Comprueba los permisos del comando

Problemas de rendimiento

  • Reduce el número de áreas activas
  • Limita el uso de comandos automáticos
  • Considera usar límites de jugadores

Créditos

Desarrollador: OwLeafStudio

Versión: 1.0.0

Compatibilidad: Minecraft Forge

Esta wiki se actualiza regularmente. Para la información más reciente, consulta el repositorio oficial del mod.