GroupeZ Docs

Installing zAuctionHouse

How to download, install and configure zAuctionHouse on your Minecraft server

This guide covers downloading and installing zAuctionHouse on your server.

Download

zAuctionHouse is available on multiple platforms:

PlatformLinkNotes
Spigotspigotmc.org/resources/63010Premium version
GroupeZgroupez.dev/resources/1Premium version
BuiltByBitbuiltbybit.com/resources/8987Premium version
Modrinthmodrinth.com/plugin/zauctionhouseFree trial version
GitHubgithub.com/GroupeZ-dev/zAuctionHouseSource code

Support

Support is included with the premium version. Free trial users can access community support on our Discord server.

Requirements

Before installing, ensure your server meets these requirements:

Server Requirements

RequirementVersion
Java21 or higher
Minecraft1.20 to 1.21+

Supported Server Software

SoftwareStatus
PaperRecommended
FoliaFully supported
PufferfishSupported
PurpurSupported
UniverSpigotSupported
SpigotSupported (not recommended)

Paper and its forks are recommended for the best performance and compatibility.

Required Plugins

PluginLink
zMenumodrinth.com/plugin/zmenu
PlaceholderAPIspigotmc.org/resources/6245

Folia Users

For Folia servers, use these forked versions:

PluginLinkDescription
Vaultspigotmc.org/resources/34315Economy integration

Installation Steps

1. Download the Plugins

Download zAuctionHouse and all required plugins from the links above.

2. Install the Plugins

Place all .jar files in your server's plugins/ folder:

  • zAuctionHouse.jar
  • zMenu.jar
  • PlaceholderAPI.jar
  • Vault.jar (recommended)

3. Start Your Server

Start your server to generate the default configuration files.

4. Configure the Plugin

Edit the configuration files in plugins/zAuctionHouse/ to customize the plugin for your server. See the Configuration section for details.

5. Restart Your Server

Restart your server to apply the configuration changes. You're ready to use zAuctionHouse!

Verify Installation

Run /ah to open the auction house interface. If everything is working correctly, you should see the main auction interface.

File Structure

After first startup, zAuctionHouse creates the following structure:

plugins/zAuctionHouse/
├── config.yml              # Main configuration
├── messages.yml            # All plugin messages
├── categories.yml          # Category definitions
├── economies/
│   └── vault.yml           # Economy configurations
├── inventories/
│   ├── auction.yml         # Main auction interface
│   ├── categories.yml      # Category selection
│   ├── confirm_buy.yml     # Purchase confirmation
│   ├── confirm_remove.yml  # Remove confirmation
│   ├── expired.yml         # Expired items
│   ├── player.yml          # Player's listings
│   ├── purchased.yml       # Purchased items
│   └── sell.yml            # Sell interface
├── rules.yml               # Item rules
└── database.db             # SQLite database (if using SQLite)

Next Steps

Getting Started

Discover zAuctionHouse - A powerful auction house plugin for your Minecraft server

Why do I need zMenu?

Understanding why zAuctionHouse requires zMenu for inventory management

On this page

DownloadRequirementsServer RequirementsSupported Server SoftwareRequired PluginsRecommended PluginsInstallation Steps1. Download the Plugins2. Install the Plugins3. Start Your Server4. Configure the Plugin5. Restart Your ServerVerify InstallationFile StructureNext 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.