GroupeZ Docs

Commands & Permissions

Complete list of all commands and permissions for zVeinMiner

This page contains the complete list of all commands and permissions available in zVeinMiner.

Syntax Guide

  • < > indicates a required argument.
  • [ ] indicates an optional argument.
  • | separates multiple aliases for the same command or sub-command.

Main Command

CommandAliasesPermissionDescription
/zveinminerveinminer, zvmzveinminer.useDisplay the list of sub-commands you have access to

Running /zveinminer without arguments prints every sub-command whose permission you have, with its syntax and description. Each sub-command only checks its own permission.

Player Commands

Granted to everyone by default.

CommandPermissionDescription
/zveinminer toggle|tzveinminer.toggleToggle vein mining on/off for yourself
/zveinminer list|lzveinminer.listList the available presets with their size and tags
/zveinminer info|izveinminer.infoShow the vein size and tags of the item in your main hand
/zveinminer stats|statisticszveinminer.statsShow your vein mining statistics (blocks mined and veins mined)
  • toggle is stored per player, so your choice is kept between sessions.
  • info shows the effective data of the item: the values stored on the item, or the ones inherited from its preset. If the item has no vein miner data (or its effective vein size is 0), a "no data" message is shown.

Item Management Commands

Reserved to operators by default. All of them work on the item held in your main hand, except give.

CommandPermissionDescription
/zveinminer apply|a <preset>zveinminer.applyLink a preset to the held item
/zveinminer set|st <preset>zveinminer.setCopy the size and tags of a preset onto the held item
/zveinminer add|ad <tag>zveinminer.addAdd a tag (block tag or block material) to the held item
/zveinminer remove|r <tag>zveinminer.removeRemove a tag from the held item
/zveinminer size|s [size]zveinminer.sizeShow or change the vein size of the held item
/zveinminer give|g <player> <preset> [material]zveinminer.giveGive a player an item with a preset

apply vs set

Both commands take a preset name from config.yml (tab completion lists them), but they do not store the same thing on the item:

CommandStored on the itemEffect of a later preset change
applyOnly the name of the presetThe item follows the preset: edit the preset, /zveinminer reload, and the item uses the new values
setA copy of the preset's size and tagsThe item keeps the copied values, the preset can change without affecting it

A size or tag list stored directly on the item always takes priority over the values of a linked preset. See Presets & Tags for details.

add and remove

  • <tag> accepts a block tag name (such as COAL_ORES) or a block material name (such as DIAMOND_ORE). Tab completion of add suggests every known tag and block material; tab completion of remove suggests the tags of the item you are holding.
  • Both commands start from the item's effective tags (its own tags, or those inherited from its preset), then write the result on the item.
  • An unknown tag is refused, and adding a tag already present (or removing one that is absent) sends an error message.

size

  • Without argument, /zveinminer size displays the current (effective) vein size of the held item, 0 if it has no vein miner data.
  • [size] must be 0 or a positive integer. It cannot exceed vein-mining.max-size-limit (default 64, a value of 0 disables the limit), see Configuration.
  • /zveinminer size 0 removes the size stored on the item, so it falls back to the size of its linked preset (if any).

give

  • <player> must be the exact name of an online player.
  • [material] is any item material, DIAMOND_PICKAXE by default. An unknown or non-item material is refused.
  • The preset is copied onto the new item (same behavior as set). If the player's inventory is full, the item is dropped at their feet.

Admin Commands

CommandPermissionDescription
/zveinminer reload|rlzveinminer.reloadReload the configuration files

Console usage

Only reload, list and give can be run from the console. Every other sub-command needs an item in hand or a player context and is refused when used by the console.

Examples

/zvm list
/zvm toggle
/zveinminer apply pickaxe-1
/zveinminer set pickaxe-1
/zveinminer add COAL_ORES
/zveinminer remove DIAMOND_ORE
/zveinminer size
/zveinminer size 16
/zveinminer give Maxlego08 pickaxe-1
/zveinminer give Maxlego08 pickaxe-1 NETHERITE_PICKAXE
/zveinminer reload

Permissions

PermissionDefaultDescription
zveinminer.useEveryoneUse vein mining and the /zveinminer command
zveinminer.toggleEveryoneToggle vein mining on/off
zveinminer.listEveryoneList the available presets
zveinminer.infoEveryoneShow the vein mining data of the held item
zveinminer.statsEveryoneShow your vein mining statistics
zveinminer.reloadOPReload the configuration files
zveinminer.applyOPApply a preset to the held item
zveinminer.setOPCopy the properties of a preset to the held item
zveinminer.addOPAdd a tag to the held item
zveinminer.removeOPRemove a tag from the held item
zveinminer.sizeOPChange the vein size of the held item
zveinminer.giveOPGive an item with a preset
zveinminer.bypass.cooldownOPIgnore the vein mining cooldown
zveinminer.adminOPGrants every permission above

Vein mining itself

zveinminer.use is also checked every time a player breaks a block: without it, the player mines normally even with a configured tool. zveinminer.bypass.cooldown only matters when a cooldown is set in the configuration.

Installation

How to install zVeinMiner on your Paper server

Configuration

Every option of config.yml and messages.yml in zVeinMiner

On this page

Main CommandPlayer CommandsItem Management Commandsapply vs setadd and removesizegiveAdmin CommandsExamplesPermissions
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.