GroupeZ Docs

Installation

How to install and configure zShop

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

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

Précédent

Commands & Permissions

Suivant

Sur cette 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

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

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

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.