> For the complete documentation index, see [llms.txt](https://realisticnode.gitbook.io/rnsetups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://realisticnode.gitbook.io/rnsetups/rnpsmenu.md).

# rnPsMenu

Menus for ProtectionStones on Spigot, Paper, Purpur and Folia, with 124 flags in one menu (39 of them new), bans, operators, sale and rent, a shop, web maps and an in-game editor.

rnPsMenu adds **menus to ProtectionStones**. Players manage their protected regions from chest menus instead of typing `/ps` commands: flags, members, owners, homes, names, bans, selling and renting, taxes and merging.

<figure><img src="https://i.imgur.com/uMQEC9R.png" alt="Entering a region: the greeting title its owner wrote in the flags menu"><figcaption><p>Entering a region: the greeting title its owner wrote in the flags menu</p></figcaption></figure>

ProtectionStones still protects the land. rnPsMenu only adds the menus and a few extras on top of it, and it follows the same permissions and rules.

{% hint style="info" %}
**Need help?** Join our [Discord](https://discord.gg/GzxW2FANPB) and open a ticket. See [Support](/rnsetups/support.md).
{% endhint %}

## Features

**Manage any region from anywhere**

* Every action works on the region picked in the menu, wherever the player stands, even in another world. Most `/ps` commands only work while standing inside the region.
* A list of your own regions, regions shared with you and your homes in every world, with search, filters, sort order and pages.
* Right-click a protection block to open its menu.
* `/ps`, `/ps home`, `/ps flag` and `/ps flags` typed alone open the menus instead of ProtectionStones' chat lists.

**Flags**

* **One menu with every flag**: up to **124 flags**, each with an icon, a name and a description: the flags the block type allows (`allowed_flags` in ProtectionStones) plus the ones you allow everywhere.
* **39 new flags** among them, for things WorldGuard has no flag for: crafting tables, furnaces, villager trades, elytra, leads, armor stands, phantoms, raids...
* **Flags kept for better blocks or ranks**: locked flags send players to the shop to get a better protection block.
* Allow / deny / not set with one click; change who a flag applies to (members, non-members...) with a right click; type greetings and farewells in chat; choose game modes and weathers from a list.
* The same safety rules as `/ps flag`: only allowed flags and groups, the edit permission of each flag, and pvp can't be removed when the block type sets it.
* **Templates**: apply a set of flags at once (Private, Public, Shop, Farm, Peaceful, or your own), or copy the flags of another region of yours.
* **Anti-trap**: dangerous flags (pvp, entry...) can't change while visitors are inside the region, and each flag has a cooldown.

**Members, owners and bans**

* Add players from the online list or by name; optionally to all your regions at once.
* Make members owners and owners members. A region can never be left without owners.
* **Operators**: trust a member with some owner tools (members, flags, bans, home, name) without making them an owner.
* **Region bans** with a time and a reason. Banned players can't walk, fly, teleport or throw ender pearls into the region, and are sent out if they are inside.
* **Expel** a visitor at once; they can't come back for a while (one minute by default).

**Economy**

* Put a region on sale, rent it out by period, pay taxes and turn tax autopay on, all from a menu.
* A **market** with every region for sale or for rent on the server: buy, rent or visit with one click. Owners decide whether their region can be visited.
* **Protection block shop** with Vault: asks before buying, and each block can go in the slot you choose. Optional **teleport cost**.
* Safer than the commands: money is taken first and checked, prices must be valid, buyers see the price they pay, and a failed payment changes nothing.

**More tools**

* Teleport to region homes after a countdown in the action bar, cancelled when moving or taking damage, with a cooldown and a safe spot check.
* Hide and show the protection block, change the priority, merge regions, see the border with particles.
* **History** of every region: who changed what and when.
* **Holograms** over the protection blocks with the name, owner, members and size: built in, or drawn by DecentHolograms or FancyHolograms. Owners can hide theirs.
* **Web maps**: every protection on BlueMap and dynmap; owners can hide theirs.

**For admins**

* **In-game editor** (`/psmenu editor`) for the settings, the flags, the shop and the templates.
* Admin view of any player's regions and of every region on the server.
* Every menu's layout (slots, items, rows) in `menus.yml`, plus **your own buttons** that run commands; every text in English and Spanish, easy to translate.
* PlaceholderAPI placeholders, a developer event, and `/psmenu open` for NPCs and other menu plugins.
* Works on **Spigot, Paper, Purpur and Folia** from **1.21.1 to 26.3** with one jar.

## Where to start

* [Installation](/rnsetups/rnpsmenu/getting-started/installation.md)
* [What players can do](/rnsetups/rnpsmenu/guides/players.md)
* [Economy and market](/rnsetups/rnpsmenu/guides/market.md)
* [Commands and permissions](/rnsetups/rnpsmenu/reference/commands.md)