> 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/guides/players.md).

# What players can do

A tour of the menus as a player sees them.

## Opening the menus

* `/psmenu` (also `/psm` and `/ps menu`): the main menu.
* `/psmenu here`: the region you stand in.
* **Right-click a protection block** with an empty hand: the menu of that region. Owners get every tool; members get a short view. Admins can change this in `config.yml` (`open`).

<figure><img src="https://i.imgur.com/zeShgYX.png" alt="My regions: every region in every world, with search, filter and sort order"><figcaption><p>My regions: every region in every world, with search, filter and sort order</p></figcaption></figure>

ProtectionStones' own commands typed **alone** also open the menus instead of a list in chat:

| Typed       | Opens                                                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------------------------------------ |
| `/ps`       | The main menu                                                                                                            |
| `/ps home`  | The Homes list                                                                                                           |
| `/ps flag`  | The flags menu of the region you stand in (only where you can change flags; elsewhere ProtectionStones answers as usual) |
| `/ps flags` | The same; outside your regions it says why instead                                                                       |

With anything after them (`/ps home base`, `/ps flag pvp deny`) the command goes to ProtectionStones as always. Each one can be turned off in `config.yml` (`open.replace-ps-commands`).

## Main menu

* **Profile**: your regions out of your limit, regions shared with you and your balance.
* **My regions**, **Shared with me**, **Homes**: lists of regions with search, filters, order and pages. Left click opens a region, right click teleports to it (in Homes it is the other way round). Homes in every world are listed and can be reached. When teleports cost money, the price is shown. The Homes button needs `protectionstones.home` or `protectionstones.tp`.
* **This region**: the region you stand in.
* **Protection shop** and **Market** (when the server has an economy).
* **Placing blocks**: turns placing protection blocks on and off, like `/ps toggle` (needs `protectionstones.toggle`).
* **Admin** (players with `rnpsmenu.admin`): any player's regions, every region on the server, the editor and reload.

<figure><img src="https://i.imgur.com/eWPYwCf.png" alt="The main menu"><figcaption><p>The main menu</p></figcaption></figure>

## Region menu

| Button              | What it does                                                                                                                                                            | ProtectionStones permission                                                   |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Info                | Name, id, world, block, size, owners, members, home, priority, market, taxes                                                                                            |                                                                               |
| Teleport            | Goes to the region's home after a short wait with a countdown (cancelled when moving). Members only when ProtectionStones allows it (`allow_home_teleport_for_members`) | `protectionstones.home` or `protectionstones.tp`                              |
| Set home here       | Moves the home to where you stand (inside the region)                                                                                                                   | `protectionstones.sethome`                                                    |
| Name                | Left click: rename. Right click: remove the name                                                                                                                        | `protectionstones.name`                                                       |
| Flags               | The flags menu                                                                                                                                                          | `protectionstones.flags`                                                      |
| Members / Owners    | Add, remove, make owner / member, operator rights. Owners only (operators with the Members right see Members)                                                           | `protectionstones.members` / `protectionstones.owners`                        |
| Bans                | Ban players, expel visitors                                                                                                                                             | `rnpsmenu.ban`                                                                |
| Protection block    | Hide / show the block                                                                                                                                                   | `protectionstones.hide` / `protectionstones.unhide`                           |
| Show border         | Particles on the border, only for you                                                                                                                                   | `rnpsmenu.border`                                                             |
| Flag templates      | Apply templates, copy flags from another region                                                                                                                         | `rnpsmenu.presets`                                                            |
| Sell / rent / taxes | The economy menu                                                                                                                                                        | `protectionstones.buysell`, `protectionstones.rent`, `protectionstones.tax`   |
| Merge regions       | Merge a neighbor region into this one (when ProtectionStones allows merging for the block type)                                                                         | `protectionstones.merge`                                                      |
| Priority            | Which region wins where two overlap                                                                                                                                     | `protectionstones.priority`                                                   |
| History             | Who changed what and when                                                                                                                                               | `rnpsmenu.activity`                                                           |
| Remove region       | Deletes it and gives the block back (asks first)                                                                                                                        | `protectionstones.unclaim` (+ `protectionstones.unclaim.remote` from outside) |
| Hologram            | Show or hide the floating text over the protection block                                                                                                                | `rnpsmenu.hologram`                                                           |
| Leave this region   | For members: stop being a member                                                                                                                                        |                                                                               |

<figure><img src="https://i.imgur.com/zVVBDqC.png" alt="The menu of a region: its data on top and a button for each tool"><figcaption><p>The menu of a region: its data on top and a button for each tool</p></figcaption></figure>

<figure><img src="https://i.imgur.com/B8bnFyN.png" alt="Show border: particles along the edge of the region"><figcaption><p>Show border: particles along the edge of the region</p></figcaption></figure>

<figure><img src="https://i.imgur.com/WecEeYX.png" alt="The history of a region: who changed what and when"><figcaption><p>The history of a region: who changed what and when</p></figcaption></figure>

Buttons a player can't use are not shown. Every click checks again that the player still owns the region (or still has the operator right) and still has the permission.

## Hologram

A floating text over each protection block near players shows the region's name, owner, members, size and, when it is on the market, its price. The owner hides or shows it with **Hologram** in the region menu (`rnpsmenu.hologram`, everyone has it).

```yaml
holograms:
  enabled: true          # false = no holograms anywhere
  plugin: rnPsMenu       # rnPsMenu (built in), DecentHolograms or FancyHolograms
  distance: 32           # only blocks closer than this to a player get one
  height: 0.3            # over the top of the block
  refresh-seconds: 5
```

* rnPsMenu draws them by itself: nothing else is needed. If you prefer, `plugin: DecentHolograms` or `plugin: FancyHolograms` hands them to that plugin (when it is installed; if not, rnPsMenu draws them and says so in the console).
* They are never saved: not in the world, not in the other plugin's files. A region whose block is hidden (`/ps hide`) has no hologram.
* The lines are in the language files (`hologram.lines`), with {region}, {owner}, {members}, {width}, {length}, {type}, {price}... Lines whose placeholder is empty are left out.

## Flags menu

* **Left click**: next value (allow → deny → not set), or type a text / choose from a list.
* **Right click**: who the value applies to: everyone, members, owners, non-members, non-owners (only the groups the block type allows).
* **Shift + left click**: back to the value new regions of this type get.
* **Shift + right click**: remove the value.

<figure><img src="https://i.imgur.com/ym260IN.png" alt="The flags menu: value, group and default of each flag"><figcaption><p>The flags menu: value, group and default of each flag</p></figcaption></figure>

<figure><img src="https://i.imgur.com/y2YekBD.png" alt="Text flags show their current text and are written in chat"><figcaption><p>Text flags show their current text and are written in chat</p></figcaption></figure>

<figure><img src="https://i.imgur.com/fOkRLnn.png" alt="Writing a text flag in chat"><figcaption><p>Writing a text flag in chat</p></figcaption></figure>

Typed texts (greetings...) are limited to `flags.max-text-length` characters. Locked flags (kept for better blocks or ranks) say so in their lore; see [Flags and templates](/rnsetups/rnpsmenu/guides/flags.md).

## Members and owners

* **Add a player** lists the players online; **Add by name** works for players who are offline.
* **All my regions: ON** adds the player to every region you own at once.
* Left click a member: make owner. Left click an owner: make member. Right click: remove.
* **Shift + click a member** (owners only): their [operator rights](#operators).
* A region always keeps at least one owner, and ProtectionStones' region limits apply when adding owners.

<figure><img src="https://i.imgur.com/GbYypgk.png" alt="Members: left click makes an owner, right click removes, Shift + click gives operator rights"><figcaption><p>Members: left click makes an owner, right click removes, Shift + click gives operator rights</p></figcaption></figure>

<figure><img src="https://i.imgur.com/9iGsOcG.png" alt="Adding a player from the online list"><figcaption><p>Adding a player from the online list</p></figcaption></figure>

## Operators

Owners can trust a member with some owner tools without making them an owner. Shift + click the member in the Members menu and switch on what they may do:

<figure><img src="https://i.imgur.com/FeJ7B2G.png" alt="The rights of an operator, each one turned on or off with a click"><figcaption><p>The rights of an operator, each one turned on or off with a click</p></figcaption></figure>

| Right   | What the operator can do                                     |
| ------- | ------------------------------------------------------------ |
| Members | Add and remove plain members (not owners or other operators) |
| Flags   | Change flags and apply templates                             |
| Bans    | Ban, unban and expel visitors                                |
| Home    | Move the region's home                                       |
| Name    | Rename the region                                            |

* Operators see only the buttons they were given, and still need the ProtectionStones permission of each action (`protectionstones.members`, `protectionstones.flags`...).
* Rights only count while the player is a member. They are cleared when the player stops being a member in any way (from the menus, or a moment after a ProtectionStones or WorldGuard command), and when the region is sold, removed or merged into another one. A new membership always starts without rights.
* They only work in rnPsMenu's menus: ProtectionStones' own `/ps` commands only know owners and members.
* Saved in `plugins/rnPsMenu/data/operators.yml`. Turn the feature off with `operators.enabled: false`.