GroupeZ Docs
AddonszAuctionHouseRedis

Troubleshooting

Fix common zAuctionHouse Redis addon issues

Cannot connect to Redis

  • Verify Redis is running: redis-cli ping should return PONG
  • Check host and port in configuration
  • Ensure firewall allows connections on port 6379
  • If using password authentication, verify the password is correct

Items not synchronizing

  • Ensure all servers use the same MySQL database
  • Verify Redis addon is installed on all servers
  • Check console for any error messages
  • Ensure all servers can connect to Redis

Duplicated or reappearing items

If a sold item reappears in the seller's items, a purchased item is missing after switching servers, or an item becomes impossible to buy:

  • Make sure every server runs the same up-to-date version of both zAuctionHouse and the zAuctionHouse Redis addon. Older versions had cross-server synchronization bugs (ghost listings, missing purchased items, stale purchase locks) that are fixed in newer releases
  • The main plugin and the Redis addon must be updated together on all servers
  • Ensure all servers share the same MySQL/MariaDB database

High latency

  • Consider using a Redis server in the same datacenter as your game servers
  • Check Redis server resources (CPU, memory)
  • Review connection pool settings

Performance Tips

  1. Use a local Redis server - Keep Redis in the same datacenter as your servers
  2. Tune connection pool - Adjust pool settings based on your server load
  3. Monitor Redis - Use redis-cli INFO to monitor performance
  4. Enable persistence - Configure Redis RDB/AOF for data safety (optional)

Support

Need help setting up multi-server? Join our Discord server for support.

Installation

Install and configure the zAuctionHouse Redis addon

Why do I need zMenu?

Understanding why zAuctionHouse requires zMenu for inventory management

On this page

Cannot connect to RedisItems not synchronizingDuplicated or reappearing itemsHigh latencyPerformance TipsSupport
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.