GroupeZ Docs

Installation

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

This guide will walk you through the process of installing zQuests on your Minecraft server.

Requirements

Before installing zQuests, make sure your server meets the following requirements:

RequirementVersion
Minecraft1.20.4 to 1.21.4
JavaJava 21 (required)
Server SoftwareSpigot, Paper, or Folia
zMenuRequired

Required Dependency

zMenu is required for zQuests to work. Make sure to install zMenu before installing zQuests.

Recommended Setup

For the best experience, we recommend using Paper or its forks. This enables MiniMessage formatting support and provides better performance.

Modded Servers

Modded server software (Forge, Fabric with Bukkit compatibility layers) is not supported.

Download

You can download zQuests from:

Installation Steps

Step 1: Install Dependencies

First, make sure you have the required plugins installed:

  1. zMenu - Download from Modrinth or SpigotMC
  2. PlaceholderAPI (Recommended) - Download from SpigotMC

Step 2: Download zQuests

Download the latest version of zQuests.jar from one of the sources listed above.

Step 3: Install the Plugin

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

Step 4: Verify Installation

After starting your server, verify that zQuests loaded correctly:

  1. Check the server console for:

    [zQuests] zQuests has been enabled!

  2. Run the command /zquests help in-game or from console

Step 5: Initial Configuration

After the first startup, zQuests will create the following folder structure:

plugins/zQuests/
├── config.yml                    # Main configuration file
├── messages.yml                  # Message translations
├── holograms.yml                 # Hologram configurations
├── waypoints.yml                 # Waypoint configurations
├── quests/                       # Quest definition files
│   ├── blocks.yml                # Block-related quests
│   ├── brew.yml                  # Brewing quests
│   ├── craft.yml                 # Crafting quests
│   ├── enchants.yml              # Enchanting quests
│   ├── entities.yml              # Entity-related quests
│   ├── farming.yml               # Farming quests
│   ├── fish.yml                  # Fishing quests
│   └── smelt.yml                 # Smelting quests
└── inventories/                  # zMenu inventory files
    └── quests.yml                # Default quest inventory

Optional Dependencies

zQuests integrates with several plugins for enhanced functionality:

PluginPurpose
PlaceholderAPIDisplay quest data in other plugins
zEssentialsHolograms and waypoints support

Economy Plugins

PluginIntegration
zShopSELL and PURCHASE quest types
VaultEconomy rewards

Job Plugins

PluginIntegration
zJobsJOB_LEVEL and JOB_PRESTIGE quest types

Skyblock Plugins

PluginIntegration
SuperiorSkyBlock2ISLAND quest type

Block Tracking

PluginIntegration
BlockTrackerTrack placed blocks for anti-exploit

Mob Stacker

PluginIntegration
WildStackerProper counting of stacked mobs

Database Configuration

zQuests supports multiple storage options:

SQLite (Default)

SQLite is the default storage option and requires no additional configuration. It's suitable for small servers and testing.

storage-type: SQLITE

SQLite Limitations

SQLite is recommended only for testing and small servers. Some features may have limited functionality with SQLite. For production servers, use MySQL or HikariCP.

MySQL

For better performance and full feature support, use MySQL:

storage-type: MYSQL

database-configuration:
  table-prefix: "zquests_"
  host: 192.168.10.10
  port: 3306
  user: your_username
  password: 'your_password'
  database: zquests
  debug: false

HikariCP provides connection pooling for optimal database performance:

storage-type: HIKARICP

database-configuration:
  table-prefix: "zquests_"
  host: 192.168.10.10
  port: 3306
  user: your_username
  password: 'your_password'
  database: zquests
  debug: false

Troubleshooting

Plugin Not Loading

If zQuests doesn't appear in /plugins:

  1. Check console for errors during startup
  2. Verify zMenu is installed and loaded
  3. Make sure you're using Java 21 or newer
  4. Verify the JAR file isn't corrupted

zMenu Not Found

If you see "zMenu not found" errors:

  1. Make sure zMenu is in the plugins folder
  2. Verify zMenu loads before zQuests (check load order)
  3. Update both plugins to their latest versions

Database Connection Failed

If database connection fails:

  1. Verify database credentials are correct
  2. Check that the database server is running
  3. Ensure the database user has proper permissions
  4. Check firewall settings

Quests Not Tracking

If quest progress isn't being tracked:

  1. Verify the quest is active for the player (/zquests start <player> <quest>)
  2. Check that the quest type matches the action
  3. Verify material/entity names are correct
  4. Enable debug mode in config.yml to see detailed logs

Updating zQuests

To update zQuests:

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

Backup First

Always backup your configuration files before updating, especially the quests/ folder containing your quest definitions.

Next Steps

Now that zQuests is installed, learn how to:

  1. Configure quests
  2. Explore quest types
  3. Set up rewards
  4. Use commands and permissions

Getting Started

Introduction to zQuests - A powerful quest plugin for Minecraft servers

Quest Configuration

Learn how to configure quests in zQuests

On this page

RequirementsDownloadInstallation StepsStep 1: Install DependenciesStep 2: Download zQuestsStep 3: Install the PluginStep 4: Verify InstallationStep 5: Initial ConfigurationOptional DependenciesRecommended PluginsEconomy PluginsJob PluginsSkyblock PluginsBlock TrackingMob StackerDatabase ConfigurationSQLite (Default)MySQLHikariCP (Recommended)TroubleshootingPlugin Not LoadingzMenu Not FoundDatabase Connection FailedQuests Not TrackingUpdating zQuestsNext 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.