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

# Menus

### General Settings

Here you can find general information on how to configure the menus to your liking.

#### Inventory Configuration

**`inventories`**

**`items`**

* **Description**: Defines the items present in the specified inventory.

  **`BACK`**

  * **Description**: Represents the "Back" item within the inventory.
  * **Properties**:
    * **`material`**: Specifies the type of material for the item (e.g., `ARROW`).
    * **`amount`**: Indicates the quantity of the item (e.g., `1`).
    * **`slot`**: Represents the slot position of the item within the inventory (e.g., `48`).
    * **`display_name`**: The name displayed for the item in the game. It utilizes color formatting with codes like `&c`.
    * **`lore`**: An empty list indicating no additional information in the lore.
    * **`actions`**: A list of actions that will be executed when the player interacts with the item. In this case, it consists of a single command: `[command] dm open parkourmenu <player>`, indicating that the "parkourmenu" will be opened for the player.

```yaml
inventories:
  currentmenu:
    items:
      BACK:
        material: ARROW
        amount: 1
        slot: 48
        display_name: '&cBack'
        lore: []
        actions:
        - '[command] dm open parkourmenu <player>'
```

***

### Actions <a href="#basic-commands" id="basic-commands"></a>

<table data-header-hidden><thead><tr><th width="178">Prefix</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Prefix</td><td>Description</td><td></td></tr><tr><td><code>[message]</code></td><td>If the prefix is [message] and the player is not in parkour (or is a new player), a message is sent to the player.</td><td></td></tr><tr><td><code>[command]</code></td><td>If the prefix is [command] and the player is not in parkour, a server command is executed. You can use placeholder like %player_name% to get the player's name</td><td></td></tr><tr><td><code>[player]</code></td><td>If the prefix is [player] and the player is not in parkour, a chat action is performed for the player</td><td></td></tr><tr><td><code>[sound]</code></td><td>Send a sound to the player, add volume, pitch using ;</td><td></td></tr><tr><td><code>[broadcast]</code></td><td>Send a global message, to all connected players</td><td></td></tr></tbody></table>

***

### Disable settings in a world.

You can disable any setting by simply adding it to the list below. You must use:\
\&#xNAN;**`(world name);(settings)`**

```yaml
    settings_disable:
    - Parkours;Fly
    - Parkours;Jump
    - (world);(Setting)
```

***

### Permission to use the settings are:

<table data-header-hidden><thead><tr><th width="307">Settings</th><th>Permission</th><th data-hidden></th></tr></thead><tbody><tr><td>Action</td><td>Permission</td><td></td></tr><tr><td><p></p><p><code>/settings</code> Command</p></td><td><code>options.settings</code></td><td></td></tr><tr><td>Setting: TimeSet </td><td><code>options.timeset</code></td><td></td></tr><tr><td>Setting: Chat</td><td><code>options.chat</code></td><td></td></tr><tr><td>etc</td><td>etc</td><td></td></tr></tbody></table>

<pre class="language-yaml"><code class="lang-yaml">inventories:
  
  settings:
    title: '&#x26;8☀ Settings'
    size: 54
    
    settings_disable:
    - Parkours;Fly
    - Parkours;Jump
    
    sound:
      enable: true
      activate: ENTITY_VILLAGER_YES
      disable: ENTITY_VILLAGER_NO
      noperms: ENTITY_VILLAGER_NO
    
    icons:
      TimeSet:
        enable: true
        <a data-footnote-ref href="#user-content-fn-1">material</a>: CLOCK
        amount: 1
        display_name: '&#x26;a&#x26;lTIME &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fYou can use it to set in'
        - '&#x26;f   day or night in your worlds.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_TimeSet}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLED &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 10
      Chat:
        enable: true
        material: PAPER
        amount: 1
        display_name: '&#x26;c&#x26;lPLAYERS CHAT &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fDisable chat on all sides '
        - '&#x26;f   while playing!'
        - ''
        - '&#x26;8 ● &#x26;cThis only blocks chat from other players'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_Chat}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLED &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 11
      WelcomeMessage:
        enable: true
        material: BEACON
        amount: 1
        display_name: '&#x26;9&#x26;lWELCOME MESSAGE &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fThis option allows you to disable the'
        - '&#x26;f   welcome message that is displayed'
        - '&#x26;f   upon entering the mode.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_WelcomeMessage}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 12
      ScoreBoard:
        enable: true
        material: ITEM_FRAME
        amount: 1
        display_name: '&#x26;a&#x26;lSCOREBOARD &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fActivate this option to see the'
        - '&#x26;f   scoreboard to the right side of you.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_ScoreBoard}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 14
      Jump:
        enable: true
        material: SLIME_BLOCK
        amount: 1
        display_name: '&#x26;2&#x26;lJUMP &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fActivate the jump on login.'
        - '&#x26;f   a Game spawn.'
        - ''
        - '&#x26;8 ● &#x26;fThis option does not work in Parkours!'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_Jump}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 15
      Fly:
        enable: true
        material: FEATHER
        amount: 1
        display_name: '&#x26;9&#x26;lFLY &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fActivate the flight mode to enjoy'
        - '&#x26;f   of the constructions around you.'
        - ''
        - '&#x26;8 ● &#x26;fThis option does not work in Parkours!'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_Fly}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 16
      MSGToggle:
        enable: true
        material: FILLED_MAP
        amount: 1
        display_name: '&#x26;b&#x26;lMSG TOGGLE &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fThis option will allow you to receive'
        - '&#x26;f   direct messages.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_MSGToggle}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 29
      SoundToggle:
        enable: true
        material: NOTE_BLOCK
        amount: 1
        display_name: '&#x26;d&#x26;lSOUND TOGGLE &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fThis option will allow you to receive'
        - '&#x26;f   un sound in direct messages.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_SoundToggle}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 30
      ParticleEffect:
        enable: true
        material: LIGHT_WEIGHTED_PRESSURE_PLATE
        amount: 1
        display_name: '&#x26;6&#x26;lPARTICLE EFFECTS &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fThis option will allow you to toggle'
        - '&#x26;f   particles that will come out when'
        - '&#x26;f   you step on a control point.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: &#x26;d%parkouraddon_player_particle_ParticleEffect%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 32
      NightVision:
        enable: true
        material: POTION
        amount: 1
        display_name: '&#x26;5&#x26;lNIGHT VISION &#x26;8| &#x26;fʀɪɢʜᴛ ᴄʟɪᴄᴋ'
        lore:
        - '&#x26;8sᴇᴛᴛɪɴɢs'
        - ''
        - '&#x26;8 ● &#x26;fActivate this option to get'
        - '&#x26;f   night vision when starting a parkour.'
        - ''
        - '&#x26;8 ☀ &#x26;fStatus: %changeoutput_ignorecolor_true_{parkouraddon_player_options_NightVision}_&#x26;a&#x26;lENABLED
          &#x26;a✔_&#x26;c&#x26;lDISABLE &#x26;c✘%'
        - ''
        - '&#x26;e► Click here to Toggle!'
        slot: 33
    
    items:
      BACK:
        material: ARROW
        amount: 1
        slot: 48
        display_name: '&#x26;cBack'
        lore: []
        actions:
        - '[command] dm open parkourmenu &#x3C;player>'
    
    clickable-items:
      enable:
        Minecraft-URL: 4b599c618e914c25a37d69f541a22bebbf751615263756f2561fab4cfa39e
        display_name: '&#x26;aActivado'
      disable:
        Minecraft-URL: 6ba0c4a0fdce923a9048328d664147c5b924491f4ee5fea71f3e9ec314
        display_name: '&#x26;cDesactivado'
      noPerms:
        Minecraft-URL: 61856c7b378d350262143843d1f9fbb21911a71983ba7b39a4d4ba5b66bedc6
        display_name: '&#x26;4No tienes permisos'
      close:
        enable: true
        Minecraft-URL: 86d35a963d5987894b6bc214e328b39cd2382426ff9c8e082b0b6a6e044d3a3
        display_name: '&#x26;cClose'
        slot: 49
  
  stats:
    title: '&#x26;8☀ Stats Parkour'
    
    blacklisted-slots: #
      - 0
      - 1
      - 2
      - 3
      - 4
      - 5
      - 6
      - 7
      - 8
      - 9
      - 17
      - 18
      - 26
      - 27
      - 35
      - 36
      - 44
      - 46
      - 47
      - 48
      - 50
      - 51
      - 52
    icon:
      blacklisted-parkours:
      - e1
      - e2
      - e3
      - e4
      - e5
      - e6
      - e7
      - e8
      - e9
      - e10
      - e11
      - e12
      - e13
      - e14
      - e15
      - m1
      - m2
      - m3
      - m4
      - m5
      - m6
      - m7
      - m8
      - m9
      - m10
      - h1
      - h2
      - h3
      - h4
      - h5
      - h6
      - h7
      - h8
      - h9
      - h10
      display_name: '&#x26;f&#x26;lPARKOUR: &#x26;e&#x3C;parkourName>'
      lore:
      - '&#x26;8Statistics'
      - ''
      - ' &#x26;7Get to know the information and the'
      - ' &#x26;7best scores of this map very easily.'
      - ''
      - ' &#x26;8● &#x26;fYour Record&#x26;8: &#x26;a%parkour_player_personal_best_&#x3C;parkourName>_time%'
      - ' &#x26;8● &#x26;fDeaths&#x26;8: &#x26;a%parkour_player_personal_best_&#x3C;parkourName>_deaths%'
      - ''
      - ' &#x26;8● &#x26;fTimes Completed&#x26;8: &#x26;a%parkour_course_completions_&#x3C;parkourName>%'
      - ''
      - ' &#x26;8● &#x26;fTotal Checkpoints&#x26;8: &#x26;6%parkour_course_checkpoints_&#x3C;parkourName>%'
      - ' &#x26;8● &#x26;fViews&#x26;8: &#x26;6%parkour_course_views_&#x3C;parkourName>%'
      - ' &#x26;8● &#x26;fCreator&#x26;8: &#x26;6%parkour_course_creator_&#x3C;parkourName>%'
      - ' &#x26;8● &#x26;fPlaying&#x26;8: &#x26;6%parkour_course_players_&#x3C;parkourName>%'
      - ''
      - '&#x26;e► Click to see &#x26;lTOP 10&#x26;e!'
      glowing: false
      actions:
      - '[player] /pa leaderboard &#x3C;parkourName> 10'
    
    clickable-items:
      next:
        material: ARROW
        amount: 1
        slot: 53
        display_name: '&#x26;cNext page'
        glowing: false
        hide_attributes: true
        lore: []
      close:
        material: BOOK
        amount: 1
        slot: 49
        display_name: '&#x26;cClose'
        glowing: false
        hide_attributes: true
        lore: []
      previous:
        material: ARROW
        amount: 1
        slot: 45
        display_name: '&#x26;cPrevious page'
        glowing: false
        hide_attributes: true
        lore: []
    
    items:
      BACK:
        material: ARROW
        amount: 1
        slot: 48
        display_name: '&#x26;cBack'
        lore: []
        actions:
        - '[command] dm open parkourmenu &#x3C;player>'
  
  vote:
    title: '&#x26;8☀ Vote Parkour        Pag [1/1]'
    size: 45
    
    icon-map:
      blacklisted-parkours:
      - e1
      material: MAP
      amount: 1
      slot: 13
      display_name: '&#x26;8► &#x26;fParkour &#x26;a&#x3C;parkour>'
      lore:
      - '&#x26;8ʀᴀᴛɪɴɢ'
      - ''
      - '&#x26;f ◤ &#x26;7Rate the map and you will be able '
      - '&#x26;7   to appreciate the rating in the'
      - '&#x26;7   main menus of the map. &#x26;f◢'
      - ''
      - ' &#x26;8● &#x26;fRating: &#x26;e%parkouraddon_map_rating_&#x3C;parkour>%'
    
    votes:
      Basic:
        enable: true
        material: RED_CONCRETE
        amount: 1
        slot: 29
        display_name: '&#x26;4&#x26;lVOTAR &#x26;e⭐✰✰✰✰ &#x26;7(1)'
        lore:
        - '&#x26;8ʀᴀᴛɪɴɢ'
        - ''
        - ' &#x26;8| &#x26;fVota &#x26;e⭐✰✰✰✰ &#x26;7(1) &#x26;fpor el mapa'
        - ''
        - '&#x26;e► ¡Haga click aquí para Votar!'
      Acceptable:
        enable: true
        material: ORANGE_CONCRETE
        amount: 1
        slot: 30
        display_name: '&#x26;4&#x26;lVOTAR &#x26;e⭐⭐✰✰✰ &#x26;7(2)'
        lore:
        - '&#x26;8ʀᴀᴛɪɴɢ'
        - ''
        - ' &#x26;8| &#x26;fVota &#x26;e⭐⭐✰✰✰ &#x26;7(2) &#x26;fpor el mapa'
        - ''
        - '&#x26;e► ¡Haga click aquí para Votar!'
      Good:
        enable: true
        material: YELLOW_CONCRETE
        amount: 1
        slot: 31
        display_name: '&#x26;4&#x26;lVOTAR &#x26;e⭐⭐⭐✰✰ &#x26;7(3)'
        lore:
        - '&#x26;8ʀᴀᴛɪɴɢ'
        - ''
        - ' &#x26;8| &#x26;fVota &#x26;e⭐⭐⭐✰✰ &#x26;7(3) &#x26;fpor el mapa'
        - ''
        - '&#x26;e► ¡Haga click aquí para Votar!'
      Excellent:
        enable: true
        material: LIME_CONCRETE
        amount: 1
        slot: 32
        display_name: '&#x26;4&#x26;lVOTAR &#x26;e⭐⭐⭐⭐✰ &#x26;7(4)'
        lore:
        - '&#x26;8ʀᴀᴛɪɴɢ'
        - ''
        - ' &#x26;8| &#x26;fVota &#x26;e⭐⭐⭐⭐✰ &#x26;7(4) &#x26;fpor el mapa'
        - ''
        - '&#x26;e► ¡Haga click aquí para Votar!'
      Exceptional:
        enable: true
        material: LIME_CONCRETE
        amount: 1
        slot: 33
        display_name: '&#x26;4&#x26;lVOTAR &#x26;e⭐⭐⭐⭐⭐ &#x26;7(5)'
        lore:
        - '&#x26;8ʀᴀᴛɪɴɢ'
        - ''
        - ' &#x26;8| &#x26;fVota &#x26;e⭐⭐⭐⭐⭐ &#x26;7(5) &#x26;fpor el mapa'
        - ''
        - '&#x26;e► ¡Haga click aquí para Votar!'
    
    items:
      PANEL1:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 3
        display_name: ' '
        lore: []
      PANEL2:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 4
        display_name: ' '
        lore: []
      PANEL3:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 5
        display_name: ' '
        lore: []
      PANEL4:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 12
        display_name: ' '
        lore: []
      PANEL5:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 14
        display_name: ' '
        lore: []
      PANEL6:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 21
        display_name: ' '
        lore: []
      PANEL7:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 22
        display_name: ' '
        lore: []
      PANEL8:
        material: GRAY_STAINED_GLASS_PANE
        amount: 1
        slot: 23
        display_name: ' '
        lore: []
      '1':
        material: ARROW
        amount: 1
        slot: 36
        display_name: '&#x26;cBack'
        lore: []
        actions:
        - '[command] dm open parkourmenu &#x3C;player>'



</code></pre>

[^1]:


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://xshyotsus.gitbook.io/parkouraddon/configuration/menus.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
