ProtectionStones Addon v1.0.0 MC 1.19.4+

xPsMenu Premium

El sistema de interfaz gráfica (GUI) más avanzado, interactivo y totalmente personalizable para ProtectionStones. Transforma la experiencia clásica de proteger terrenos en un sistema visual moderno y premium para tus jugadores.

100% Personalizable

Cada menú, ítem, descripción (lore) y mensaje es completamente editable a través de archivos YML con soporte nativo para colores HEX y MiniMessage.

Dynamic Selector

Una GUI en vivo que se actualiza automáticamente mostrando todas las regiones del jugador con un filtro interactivo (Propias, Miembro, Todas).

0-Lag Particles

Cuando un bloque de protección se oculta, solo el dueño verá partículas mágicas indicando su ubicación (Altamente optimizado, sin lag al servidor).

Gestión de Jugadores

¡Ve a los miembros y dueños usando cabezas de jugadores reales! Expulsa jugadores directamente haciendo Shift + Click Derecho en la GUI.

Galería de Interfaces

Obtén la Configuración Premium (ES/EN)

¿Quieres que tu servidor se vea exactamente como en las imágenes de arriba? Olvídate de configurar archivos YML por horas. Obtén nuestra configuración oficial premium lista para usar.

8.00€ Comprar vía Ticket de Discord

Instalación & Setup

Apaga tu servidor.
Descarga el archivo xPsMenu-v1.0.0.jar y colócalo en tu carpeta /plugins/.
Paso Crucial: Debes usar el archivo messages.yml para ProtectionStones incluido en la carpeta de descarga. Reemplaza tu archivo actual para asegurar que los menús funcionen correctamente.
Asegúrate de tener las dependencias: ProtectionStones (v2.10+), WorldGuard y WorldEdit.
Enciende el servidor. Ingresa a /plugins/xPsMenu/ para personalizar a tu gusto.

Comandos y Permisos

Jugadores

`Shift + Click Derecho`	Golpea un bloque de protección para abrir la GUI principal de esa región específica.
`/psmenu`	Abre el Selector de Regiones Dinámico (Muestra todas tus regiones activas).
`/psmenu help`	Muestra el menú de ayuda del plugin.

Administradores

`/psmenu reload` Permiso: `psmenu.admin`	Recarga todos los archivos de configuración y menús sin lag.
`/psmenu clearall confirm` Permiso: `psmenu.admin`	⚠️ ¡PELIGRO! Borra TODAS las regiones de ProtectionStones de la base de datos del servidor.
Bypass: `psmenu.bypass`	Permite a los VIPs/Staff ignorar el tiempo de espera (3 segundos) al teletransportarse a una región.

Placeholders

Variables Internas del Menú

Usa estas variables exclusivamente dentro de gui.yml y flags.yml:

%region% - Muestra el ID exacto de la región que se está editando en la GUI.
%hidden_status% - Muestra el estado actual del bloque de protección (ej. Oculto ✘ o Visible ✔).
Nota: Puedes usar cualquier variable global de PlaceholderAPI dentro de los menús (como %player_name%).

Variables Globales (PAPI)

Úsalas en Scoreboards, Tablist, Hologramas, etc:

%xpsmenu_version% - Muestra la versión actual del plugin.
%xpsmenu_player% - Muestra el nombre del jugador que interactúa.

Developer API

¿Estás creando un NPC interactivo o un core custom? Engánchate fácilmente a xPsMenu para abrir las interfaces usando nuestra API estática.

build.gradle

dependencies {
    compileOnly fileTree(dir: 'libs', include: 'xPsMenu-v1.0.0.jar')
}

Java

import jn.willfrydev.xPsMenuAPI;
import org.bukkit.entity.Player;

public class MyCustomPlugin {
    
    public void openMenuForPlayer(Player player, String regionId) {
        // Abre la GUI principal de edición para una región específica
        xPsMenuAPI.openMainMenu(player, "ps10x64y5z");
    }

    public void openListForPlayer(Player player) {
        // Abre la GUI del Selector Dinámico de regiones para el jugador
        xPsMenuAPI.openSelector(player);
    }
}