Plugin avanzado de gestión de protecciones para servidores Spigot/Paper.
Ofrece una interfaz gráfica intuitiva, múltiples herramientas administrativas, soporte multilenguaje y un sistema eficiente para proteger regiones en tu servidor.

---

Características

- [GUI] Interfaz gráfica intuitiva para jugadores y administradores.
- [Usuarios] Gestión completa de propietarios y miembros de regiones protegidas.
- [TP] Teletransporte rápido y seguro a regiones protegidas.
- [Eliminar] Eliminación fácil de regiones desde el menú.
- [Configuración] Herramientas administrativas para gestión de banderas, información técnica y mucho más.
- [Idiomas] Soporte multilenguaje mediante archivos YAML personalizables.
- [Inactividad] Sistema que detecta regiones sin actividad prolongada para posible limpieza.
- [Actualización] Recarga dinámica de datos sin necesidad de reiniciar el servidor.

---

Instalación

1. Descarga el archivo `.jar` desde la sección de lanzamientos del repositorio.
2. Copia el archivo en la carpeta `plugins/` de tu servidor Spigot/Paper.
3. Asegúrate de tener instalado [Vault]( https://www.spigotmc.org/resources/vault.34315/) y otros plugins requeridos (ver requisitos).
4. Reinicia el servidor para cargar el plugin correctamente.

---

Requisitos

- Servidor compatible con Spigot/Paper 1.21+
- [Vault]( https://www.spigotmc.org/resources/vault.34315/) para gestión económica y permisos.
- [WorldGuard]( https://modrinth.com/plugin/worldguard/versions) (opcional para integración avanzada).
- [ProtectionStones]( https://www.spigotmc.org/resources/protectionstones-updated-for-1-20-6.61797/) para bloques de protección configurables.

---

⌨️ Comandos

---

Capturas de pantalla

Menú principal
Visualiza el acceso inicial del administrador a las funcionalidades de gestión de regiones.


Menú de protecciones
Muestra todas las regiones registradas, con detalles de propietarios, coordenadas y actividad reciente.


Menú de selección
Permite elegir opciones específicas para acceder a más acciones.


Menú de acciones
Herramientas para ver detalles, teletransportarse, modificar banderas, editar miembros y eliminar regiones.


Menú de la tienda
Interfaz amigable para comprar protecciones. Requiere permisos específicos, por ejemplo: `protecciones.proteccion21x21`.
Recuerda configurar los precios en `ProtectionStones/blocks.yml` con `price: 500.0`.


Menú de Creación de Protección

Este menú permite a los administradores crear y personalizar piedras de protección mediante una interfaz gráfica intuitiva y sencilla. Desde él, puedes configurar fácilmente:

- Tipo de bloque que se utilizará como piedra de protección.
- Alias único para la protección.
- Descripción informativa del bloque.
- Radio de protección (por ahora solo eje X).
- Nombre visible con soporte de colores (&a, &c, etc.).
- Lore (texto decorativo, separando líneas con `;`).
- Efecto encantado visual activable/desactivable.
- Precio en la economía del servidor.

Tras personalizar los datos, puedes hacer clic en "Guardar configuración", lo que generará automáticamente un archivo `.toml` con las propiedades del bloque de protección.

⚠️ IMPORTANTE:
Después de guardar una nueva protección, no olvides ejecutar los siguientes comandos para que se cargue correctamente en el servidor:

Code (Text):

/pqs reload    # Recarga las protecciones personalizadas creadas
/ps reload     # Recarga ProtectionStones para aplicar los cambios
 

Esto asegura que la protección esté disponible para compra y uso inmediato en el servidor.




---

Localización

Personaliza todos los mensajes editando los archivos `.yml` en:
/plugins/QsProtecciones/lang/

Idiomas incluidos por defecto:
- Español (`es`)
- Inglés (`en`)

Puedes añadir más idiomas creando nuevos archivos YAML en esa carpeta.

---

❓ Soporte

¿Tienes dudas, sugerencias o encontraste un error?
- Contacto Discord: quesito1m98
- Reporta errores en la pestaña "Issues" del repositorio GitHub.

---

⚙️ Archivos de configuración

El archivo `mensajes.yml` permite personalizar los textos en menús y mensajes al jugador.


---

Créditos

Desarrollado por: @angel00027

Basado en los complementos y APIs de:
- [WorldGuard]( https://github.com/EngineHub/WorldGuard)
- [ProtectionStones]( https://github.com/espidev/ProtectionStones)

---

Licencia

Este proyecto está licenciado bajo una licencia personalizada.
Puedes usar y distribuir este plugin libremente, siempre que se otorgue la debida atribución al autor original.

Si tienes dudas sobre su uso en servidores públicos o redistribución, contáctame directamente.

---