xPsMenu icon

xPsMenu -----

The best add-on for protectionstones




xPsMenu - Official User Guide

[​IMG]
[​IMG]
[​IMG]

Do you want to acquire the best ES/EN configuration?
¡Enter our Discord! It helps us a lot.
JOIN DISCORD

[HR][/HR]​

Requirements

  • Minecraft Version: 1.19.4 or higher.
  • ProtectionStones: v2.10+ (Highly recommended to use the version provided in our download folder).
  • WorldGuard & WorldEdit: Required for region management.
  • PlaceholderAPI: Optional, but highly recommended.

[HR][/HR]

Installation & Setup

  1. Stop your server.
  2. Download the xPsMenu-v1.0.0.jar and place it in your /plugins/ folder.
  3. ⚠️ CRUCIAL STEP: You must use the messages.yml file for ProtectionStones provided in our download folder. Replace your existing ProtectionStones messages.yml with ours to ensure the menus function properly.
  4. Start the server.
  5. Customize the configuration files inside /plugins/xPsMenu/ and type /psmenu reload.

[HR][/HR]

⌨️ Commands & Permissions

Player Commands
  • Shift + Right Click (on a protection block) - Opens the main management GUI for that specific region.
  • /psmenu - Opens the dynamic Region Selector (Shows all your active regions).
  • /psmenu help - Shows the help menu.

Admin Commands
  • /psmenu reload - Reloads all configuration files seamlessly.
    (Permission: psmenu.admin)
  • /psmenu clearall confirm - ⚠️ DANGER! Wipes every single ProtectionStones region from the server database.
    (Permission: psmenu.admin)

Extra Permissions
  • psmenu.bypass - Bypasses the 3-second teleportation delay. Instant teleport!

[HR][/HR]

Placeholders

Internal Menu Variables (Use in gui.yml/flags.yml):
  • %region% - Displays the ID of the region currently being edited.
  • %hidden_status% - Displays the current state of the block (Hidden ✘ or Visible ✔).

PlaceholderAPI Variables (Global):
  • %xpsmenu_version% - Displays the current plugin version.
  • %xpsmenu_player% - Displays the player's name.

[HR][/HR]

Developer API

Add to your build.gradle:
Code (gradle (Unknown Language)):

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

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

public class MyCustomPlugin {
   
    public void openMenuForPlayer (Player player, String regionId ) {
        // Opens the main Editor GUI for a specific region
        xPsMenuAPI. openMainMenu (player, regionId ) ;
    }

    public void openListForPlayer (Player player ) {
        // Opens the Dynamic Region Selector GUI for the player
        xPsMenuAPI. openSelector (player ) ;
    }
}
 
[HR][/HR]
Developed with ❤️ by xPlugins x WillfryDev
Resource Information
Author:
----------
Total Downloads: 20
First Release: Mar 14, 2026
Last Update: Mar 14, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings