> 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/getting-started/installation.md).

# Installation

Requirements, the right ProtectionStones version for your server, and the first start.

## Requirements

* A **Spigot** or **Paper** server from **1.21.1 to 26.3**, or a fork of Paper such as Purpur or Folia.
* **Java 21** or newer.
* **ProtectionStones** and **WorldGuard** (with WorldEdit), in the versions of the table below.
* Optional: **Vault** with an economy plugin (for the shop, the market, selling, renting, taxes and teleport costs), **PlaceholderAPI** (for [placeholders](/rnsetups/rnpsmenu/reference/placeholders.md)), and **BlueMap** or **dynmap** (for [web maps](/rnsetups/rnpsmenu/guides/maps.md)).

| Your server     | ProtectionStones                                                                                                  | WorldGuard                             |
| --------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| 1.21.1 – 1.21.9 | 2.10.5                                                                                                            | the version for your Minecraft version |
| 1.21.10 – 26.3  | 2.10.6 or 2.10.7                                                                                                  | the version for your Minecraft version |
| Folia           | the Folia build of ProtectionStones ([ProtectionStones-folia](https://github.com/Galajus/ProtectionStones-folia)) | 7.0.16 or newer                        |

{% hint style="warning" %}
ProtectionStones 2.10.6 and newer only start on 1.21.10 and newer. On older 1.21 servers use **2.10.5**.

The official ProtectionStones does not run on Folia. rnPsMenu itself supports Folia, but it needs a Folia build of ProtectionStones and WorldGuard 7.0.16 or newer.
{% endhint %}

## Steps

1. Install ProtectionStones and WorldGuard first and check that they start.
2. Download `rnPsMenu.jar` and put it in the `plugins/` folder.
3. Restart the server (do not use `/reload`).
4. The plugin creates `plugins/rnPsMenu/` with its files (see [Files overview](/rnsetups/rnpsmenu/getting-started/files.md)).
5. Open `config.yml` and set `language` to `en` or `es`. Changes are applied a few seconds after saving.

The console shows a line like this:

```
[rnPsMenu] Running on Paper with ProtectionStones 2.10.7, economy found.
```

## Permissions of ProtectionStones

rnPsMenu uses the permissions of ProtectionStones for every action: a player needs `protectionstones.flags` to change flags, `protectionstones.members` to add members, and so on. ProtectionStones gives most of them **only to operators** by default, so give your players the ones they should have (for example with LuckPerms). See [Commands and permissions](/rnsetups/rnpsmenu/reference/commands.md).

## First test

1. Get a protection block (`/ps get <block>` or `/ps give <block> <player>`) and place it.
2. Type `/psmenu`. The main menu shows your region.
3. Right-click the protection block with an empty hand: its menu opens.

To install a new version later, see [Updating](/rnsetups/rnpsmenu/getting-started/updating.md).