GroupeZ Docs

Installation

How to install and configure zShop

This guide walks you through installing zShop on your Minecraft server.

Requirements

RequirementVersion
Minecraft1.13+
JavaJava 21 (required)
Server SoftwarePaper, Purpur, or Folia
zMenuRequired dependency

zMenu Required

zShop requires zMenu to be installed. Install zMenu first before installing zShop.

Download

You can download zShop from:

Installation Steps

Step 1: Install zMenu

  1. Download zMenu
  2. Place zMenu.jar in your plugins/ folder
  3. Start your server to generate zMenu configuration

Step 2: Install zShop

  1. Stop your Minecraft server if it's running
  2. Place the zShop.jar file in your server's plugins/ folder
  3. Start your server

Step 3: Verify Installation

After starting your server, verify that zShop loaded correctly:

  1. Check the server console for:

    [zShop] zShop has been enabled!

  2. Run /zshop in-game to open the shop

Step 4: Initial Configuration

After the first startup, zShop creates the following folder structure:

plugins/zShop/
├── config.yml           # Main configuration
├── economies.yml        # Economy definitions
├── commands.yml         # Command definitions
├── inventories/         # Shop GUI configurations
│   ├── main_shop.yml    # Main shop menu
│   ├── shop_buy.yml     # Buy confirmation menu
│   ├── shop_sell.yml    # Sell confirmation menu
│   ├── confirm.yml      # Purchase confirmation
│   ├── buy_more.yml     # Bulk purchase menu
│   └── categories/      # Shop categories
│       ├── blocks.yml
│       ├── ores.yml
│       ├── farms.yml
│       └── ...
├── patterns/            # Reusable zMenu patterns
├── players/             # Player limit data
├── logs/                # Transaction logs
└── limits.json          # Server limit data

Configuration Overview

config.yml

Main plugin configuration including:

  • Default economy
  • Default item lore
  • Price modifiers
  • Logging settings
  • Price formatting

See Configuration for details.

economies.yml

Define available economies:

  • Vault integration
  • Item-based currencies
  • Experience/Level economies
  • Third-party economy plugins

See Economies for details.

inventories/

Shop menus using zMenu format:

  • Create custom shop categories
  • Configure items with prices
  • Set up confirmation dialogs

See Shop Items for details.

Optional Dependencies

zShop works with these economy plugins:

PluginIntegration
VaultStandard economy support
PlayerPointsPoints-based economy
VotingPluginVote points economy
TokenManagerToken economy
CoinsEngineMulti-currency support
BeastTokenToken economy
PlaceholderAPIPlaceholder support

Migrating from ShopGUI+

zShop includes a converter for ShopGUI+ configurations:

/zshop convert

About 90% of your ShopGUI+ configuration will be converted automatically. Some elements may need manual adjustment.

Updating

To update zShop:

  1. Download the latest version
  2. Stop your server
  3. Backup your plugins/zShop/ folder
  4. Replace the old zShop.jar with the new one
  5. Start your server
  6. Run /zshop reload if needed

Backup First

Always backup your plugins/zShop/ folder before updating. Configuration formats may change between versions.

Troubleshooting

Plugin Not Loading

If zShop doesn't appear in /plugins:

  1. Check console for errors during startup
  2. Verify zMenu is installed and working
  3. Verify you're using Java 21: java -version
  4. Verify you're using Minecraft 1.13+
  5. Ensure you're using Paper (not Spigot)

Economy Not Working

If purchases/sales fail:

  1. Check economies.yml configuration
  2. Verify the economy plugin is installed
  3. Check defaultEconomy in config.yml
  4. Look for economy errors in console

Items Not Appearing

If shop items don't show:

  1. Check YAML syntax in inventory files
  2. Verify material names are correct
  3. Run /zshop reload after changes
  4. Check console for loading errors

Getting Help

Need help?

  • Discord: discord.groupez.dev - Fastest support
  • GitHub Issues: Report bugs and request features
  • Documentation: You're here!

Next Steps

Introduction

Previous Page

Commands & Permissions

Next Page

On this page

RequirementsDownloadInstallation StepsStep 1: Install zMenuStep 2: Install zShopStep 3: Verify InstallationStep 4: Initial ConfigurationConfiguration Overviewconfig.ymleconomies.ymlinventories/Optional DependenciesMigrating from ShopGUI+UpdatingTroubleshootingPlugin Not LoadingEconomy Not WorkingItems Not AppearingGetting HelpNext 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.