GroupeZ Docs

Getting Started

Introduction to zQuests - A powerful quest plugin for Minecraft servers

zQuests is a powerful and flexible quest plugin for Minecraft servers. It allows you to create engaging quest systems that keep your players motivated and active. With deep integration with zMenu, you can create immersive experiences with beautiful quest interfaces.

What is zQuests?

zQuests is a comprehensive quest management plugin that enables server administrators to create custom quests with various objectives, rewards, and progression systems. Whether you need simple daily tasks, complex story-driven quests, or achievement-based challenges, zQuests provides all the tools you need.

Key Features

Extensive Quest Types

  • 25+ quest types including block breaking, entity killing, crafting, fishing, and more
  • Support for custom quest types via API
  • Tag-based material matching for flexible configurations

Flexible Quest Management

  • Auto-accept quests: Automatically start quests for players
  • Favorite system: Let players track their important quests
  • Quest groups: Organize quests into categories
  • Unique quests: Prevent progress on other quests during specific quest chains
  • Hidden quests: Create secret objectives

Powerful Reward System

  • Global rewards: Applied to all quest completions
  • Custom rewards: Trigger rewards when specific quest combinations are completed
  • Permissible rewards: Give bonus rewards based on permissions
  • Supports all zMenu actions as rewards

zMenu Integration

  • Custom buttons for quest display
  • Quest-specific actions
  • Dynamic inventory updates
  • Progress tracking in menus

Additional Features

  • Waypoints: Guide players to quest locations
  • Holograms: Display quest information in the world
  • PlaceholderAPI support: Display quest information anywhere
  • Database support: MySQL, MariaDB, and SQLite
  • Scoreboard integration: Update scoreboards on quest events

Quest Types Overview

CategoryQuest Types
BlocksBLOCK_BREAK, BLOCK_PLACE
EntitiesENTITY_KILL, ENTITY_DAMAGE, TAME, SHEAR
ItemsCRAFT, SMELT, ITEM_BREAK, ITEM_MENDING, ITEM_CONSUME
GatheringFARMING, FISHING, MINING
PotionsBREW, ENCHANT
ExplorationCUBOID, LOOK_AT_BLOCK, LOOK_AT_ENTITY
EconomySELL, PURCHASE
ProgressionJOB_LEVEL, JOB_PRESTIGE, EXPERIENCE_GAIN
SpecialVOTE, COMMAND, CUSTOM, ISLAND, INVENTORY_OPEN, INVENTORY_CONTENT
MiscHATCHING, RESURRECT, SMITHING

How It Works

zQuests uses YAML configuration files to define your quests. Here's a simplified overview:

  1. Quests are defined in YAML files in the quests/ folder
  2. Each quest has a type that determines how progress is tracked
  3. Actions define what counts toward quest progress
  4. Rewards are given when quests are completed
  5. Inventories display quest information using zMenu

Simple Example

quests:
  - type: BLOCK_BREAK
    name: "stone-breaker"
    display-name: "Stone Breaker"
    description: "Break 100 stone blocks"
    thumbnail: STONE
    goal: 100
    auto-accept: true
    actions:
      - material: STONE
      - material: COBBLESTONE
    rewards:
      - type: message
        messages:
          - "&aQuest completed! You broke 100 stone blocks!"
      - type: console_command
        commands:
          - "give %player% diamond 5"

This creates a quest that tracks stone and cobblestone breaking, automatically starts for all players, and gives rewards upon completion.

Why Choose zQuests?

FeaturezQuestsOther Plugins
Quest Types25+ built-inLimited
zMenu IntegrationNativeNone
Custom ActionsFull zMenu supportBasic
Favorite SystemYesRarely
Quest GroupsYesSometimes
Waypoints & HologramsYesRarely
Database SupportMySQL/MariaDB/SQLiteUsually file-based
PlaceholderAPIFull supportVaries
APIComprehensiveOften minimal

Next Steps

Ready to get started? Follow these steps:

  1. Install zQuests on your server
  2. Learn about quest configuration
  3. Explore all quest types
  4. Set up rewards for your quests
  5. Create custom inventories with zMenu

Getting Help

  • Discord: Join our Discord server for support
  • GitHub: Report issues on GitHub
  • Documentation: You're reading it!

Installation

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

On this page

What is zQuests?Key FeaturesExtensive Quest TypesFlexible Quest ManagementPowerful Reward SystemzMenu IntegrationAdditional FeaturesQuest Types OverviewHow It WorksSimple ExampleWhy Choose zQuests?Next StepsGetting Help
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.