> 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/configuration/config.md).

# config.yml

Every option of config.yml.

Most options can also be changed in game with `/psmenu editor > Settings`.

| Option                                              | Default                                         | What it does                                                                                                                   |
| --------------------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `language`                                          | `en`                                            | Language file of `languages/`                                                                                                  |
| `per-player-language`                               | `false`                                         | Each player gets the language of their Minecraft client when that file exists                                                  |
| `update-checker`                                    | `true`                                          | Tell admins when a new version is out. See [Updating](/rnsetups/rnpsmenu/getting-started/updating.md)                          |
| `auto-reload`                                       | `true`                                          | Apply saved files without `/psmenu reload`                                                                                     |
| `display.world-names`                               |                                                 | Names shown for worlds (`world: Overworld`)                                                                                    |
| `open.ps-subcommand`                                | `true`                                          | Adds `/ps menu` and `/ps gui` (restart to apply)                                                                               |
| `open.click-block`                                  | `RIGHT`                                         | Opening the menu by clicking a protection block: `RIGHT`, `SHIFT_RIGHT`, `BOTH` (with or without shift) or `OFF`               |
| `open.click-needs-empty-hand`                       | `true`                                          | Only with an empty hand, so building next to the block still works                                                             |
| `open.click-who`                                    | `MEMBERS`                                       | `OWNERS` or `MEMBERS` (members get a read-only view)                                                                           |
| `open.replace-ps-commands.ps`                       | `true`                                          | `/ps` typed alone opens the main menu                                                                                          |
| `open.replace-ps-commands.home`                     | `true`                                          | `/ps home` typed alone opens the Homes list                                                                                    |
| `open.replace-ps-commands.flag`                     | `true`                                          | `/ps flag` (or `/ps flags`) typed alone opens the flags menu of the region you stand in                                        |
| `open.click-delay-ms`                               | `150`                                           | Minimum time between two clicks in a menu                                                                                      |
| `open.sounds`                                       | `true`                                          | Menu sounds (set in `menus.yml`)                                                                                               |
| `teleport.use-ps-wait`                              | `true`                                          | Wait the `tp_waiting_seconds` of the block type when it is longer than `wait-seconds`                                          |
| `teleport.wait-seconds`                             | `3`                                             | Wait before every teleport (`0` = instant). `protectionstones.tp.bypasswait` skips it                                          |
| `teleport.countdown`                                | `true`                                          | Count the seconds down in the action bar, with a tick sound                                                                    |
| `teleport.cancel-on-move` / `cancel-on-damage`      | `true`                                          | Cancel the teleport when moving / taking damage                                                                                |
| `teleport.cooldown-seconds`                         | `5`                                             | Time between two teleports                                                                                                     |
| `teleport.safe-location`                            | `true`                                          | Never teleport into lava, the void or blocks                                                                                   |
| `teleport.cost`                                     | `0`                                             | Money a teleport to a region costs (needs Vault, `0` = free). See [Economy](/rnsetups/rnpsmenu/guides/market.md#teleport-cost) |
| `teleport.cost-other-world`                         | `0`                                             | Extra cost when the region is in another world                                                                                 |
| `names.pattern`                                     | `^[A-Za-z0-9_-]{2,24}$`                         | Allowed region names                                                                                                           |
| `flags.extra-allowed`                               | rnPsMenu's flags and the usual WorldGuard flags | Flags players can change in every region, besides `allowed_flags`. `[]` = only ProtectionStones' list                          |
| `flags.*`                                           |                                                 | See [Flags and templates](/rnsetups/rnpsmenu/guides/flags.md)                                                                  |
| `bans.expel-seconds`                                | `60`                                            | Seconds an expelled visitor can't come back (`0` = at once)                                                                    |
| `bans.*`                                            |                                                 | See [Region bans](/rnsetups/rnpsmenu/guides/bans.md)                                                                           |
| `operators.enabled`                                 | `true`                                          | Owners can give members some owner tools. See [Operators](/rnsetups/rnpsmenu/guides/players.md#operators)                      |
| `border.seconds`                                    | `15`                                            | Time the border is shown                                                                                                       |
| `border.particle`                                   | `DUST`                                          | Particle of the border                                                                                                         |
| `border.color` / `size`                             | `#3FD0FF` / `1.3`                               | Color and size of `DUST`                                                                                                       |
| `border.max-distance`                               | `40`                                            | Only the part of the border closer than this is drawn                                                                          |
| `border.max-points`                                 | `400`                                           | Most particles per player each time the border is drawn (twice a second)                                                       |
| `border.beam`                                       | `true`                                          | A column of particles over the protection block                                                                                |
| `activity.enabled` / `keep`                         | `true` / `100`                                  | Region history and entries kept per region                                                                                     |
| `shop.enabled`                                      | `true`                                          | Protection block shop                                                                                                          |
| `shop.confirm`                                      | `true`                                          | Ask "Buy?" before paying, so a click by mistake buys nothing                                                                   |
| `market.enabled` / `cache-seconds`                  | `true` / `30`                                   | The market, and how long its list is reused                                                                                    |
| `market.visits`                                     | `true`                                          | Right click on an offer teleports there. `false` = no visits on the whole server                                               |
| `holograms.enabled`                                 | `true`                                          | Floating text over the protection blocks. See [Hologram](/rnsetups/rnpsmenu/guides/players.md#hologram)                        |
| `holograms.plugin`                                  | `rnPsMenu`                                      | Who draws them: `rnPsMenu` (built in), `DecentHolograms` or `FancyHolograms`                                                   |
| `holograms.distance` / `height` / `refresh-seconds` | `32` / `0.3` / `5`                              | How close a player must be, height over the block, seconds between updates                                                     |
| `economy.format` / `decimals`                       | `${amount}` / `2`                               | How money is shown                                                                                                             |
| `map-markers.enabled`                               | `true`                                          | Draw the protections on BlueMap and dynmap                                                                                     |
| `map-markers.refresh-seconds`                       | `300`                                           | Seconds between two full redraws (at least 30)                                                                                 |
| `map-markers.layer`                                 | `Protections`                                   | Name of the layer on the map                                                                                                   |
| `map-markers.label` / `detail`                      | `{region}` / owners, members and block          | Name and popup of each area. See [Web maps](/rnsetups/rnpsmenu/guides/maps.md)                                                 |
| `map-markers.fill-color` / `fill-opacity`           | `#3FD0FF` / `0.2`                               | Color and opacity of the inside                                                                                                |
| `map-markers.line-color` / `line-opacity`           | `#3FD0FF` / `0.9`                               | Color and opacity of the border                                                                                                |
| `admin.log-to-console`                              | `false`                                         | Write every change made from the menus to the console                                                                          |
