GroupeZ Docs
ConfigurationsButtonsButton Types

PREVIOUS Button

Button that navigates to the previous page

The PREVIOUS button type navigates to the previous page in a paginated inventory.

PREVIOUS buttons are permanent by default. They will automatically be shown on all pages of a paginated inventory, even if is-permanent: true is not explicitly set in the configuration.

Usage

items:
  previous:
    type: PREVIOUS
    slot: 45
    item:
      material: ARROW
      name: "&c&l← Previous Page"
      lore:
        - "&7Go to page %zmenu_player_previous_page%"

Properties

PropertyDescription
slot / slotsPosition in inventory
itemVisual appearance
soundSound on click
is-permanentShow on all pages (recommended)

Examples

Basic Previous Button

items:
  previous:
    type: PREVIOUS
    slot: 45
    is-permanent: true
    item:
      material: ARROW
      name: "&c&l← Previous"
    sound: UI_BUTTON_CLICK

Styled Previous Button

items:
  previous:
    type: PREVIOUS
    slot: 45
    is-permanent: true
    item:
      material: PLAYER_HEAD
      url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmQ2OWUwNmU1ZGFkZmQ4NGU1ZjNkMWMyMTA2M2YyNTUzYjJmYTk0NWVlMWQ0ZDcxNTJmZGM1NDI1YmMxMmE5In19"
      name: "&c&l← Previous Page"
      lore:
        - "&7Current: &f%page%"
        - "&7Go to: &f%zmenu_player_previous_page%"
    sound: ITEM_BOOK_PAGE_TURN

Hide When On First Page

items:
  previous:
    type: PREVIOUS
    slot: 45
    is-permanent: true
    view-requirement:
      requirements:
        - type: placeholder
          placeholder: "%zmenu_player_page%"
          action: SUPERIOR
          value: 1
    item:
      material: ARROW
      name: "&c&l← Previous"
    else:
      item:
        material: GRAY_STAINED_GLASS_PANE
        name: "&8"

Complete Navigation Bar

items:
  nav-left-border:
    slots:
      - 45
      - 46
    is-permanent: true
    item:
      material: BLACK_STAINED_GLASS_PANE
      name: "&8"

  previous:
    type: PREVIOUS
    slot: 47
    is-permanent: true
    item:
      material: ARROW
      name: "&c&l← Previous"
    sound: UI_BUTTON_CLICK

  back:
    type: BACK
    slot: 48
    is-permanent: true
    item:
      material: DARK_OAK_DOOR
      name: "&7&lBack"
    sound: UI_BUTTON_CLICK

  page-info:
    slot: 49
    is-permanent: true
    item:
      material: BOOK
      name: "&6&lPage %page% of %maxPage%"
      lore:
        - ""
        - "&7Use arrows to navigate"

  home:
    type: HOME
    slot: 50
    is-permanent: true
    item:
      material: NETHER_STAR
      name: "&e&lHome"
    sound: UI_BUTTON_CLICK

  next:
    type: NEXT
    slot: 51
    is-permanent: true
    item:
      material: ARROW
      name: "&a&lNext →"
    sound: UI_BUTTON_CLICK

  nav-right-border:
    slots:
      - 52
      - 53
    is-permanent: true
    item:
      material: BLACK_STAINED_GLASS_PANE
      name: "&8"

Best Practices

  1. Always use is-permanent: true for navigation buttons
  2. Pair with NEXT button for complete navigation
  3. Add page counter between navigation buttons
  4. Use consistent positioning across all paginated menus
  5. Provide audio feedback with sounds
  • NEXT - Navigate to next page
  • JUMP - Jump to specific page
  • BACK - Return to previous inventory

Next Steps

NEXT Button

Button that navigates to the next page

HOME Button

Button that returns to the first inventory in history

On this page

UsagePropertiesExamplesBasic Previous ButtonStyled Previous ButtonHide When On First PageComplete Navigation BarBest PracticesRelated Button TypesNext Steps
GroupeZ MCP

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.