GroupeZ Docs

Commands & Permissions

zItems commands and permissions reference

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

Complete reference for all zItems commands and permissions.

Commands Overview

CommandDescriptionPermission
/zitemsMain plugin commandzitems.command.admin
/zitems giveGive custom itemszitems.command.admin
/zitems giveeffectGive effect itemszitems.command.admin
/zitems applyeffectApply effect to held itemzitems.command.admin
/zitems vieweffectView effects on held itemzitems.command.admin
/zitems guiOpen item browser GUIzitems.command.admin
/zitems reloadReload configurationzitems.command.admin

Aliases: /zit, /zitem

/zitems give

Gives a custom item to a player.

/zitems give <item> [player] [amount]
ArgumentRequiredDescription
itemYesThe item ID from your items folder
playerNoTarget player (defaults to yourself)
amountNoNumber of items (defaults to 1)

Examples:

# Give yourself a legendary sword
/zitems give legendary_sword

# Give a player 5 vein pickaxes
/zitems give vein_pickaxe Steve 5

# Give yourself 64 of an item
/zitems give magic_apple _ 64

Tab Completion: All configured item IDs are available for auto-completion.

/zitems giveeffect

Gives the physical representation of an effect (if configured) to a player.

/zitems giveeffect <effect> [player] [amount]
ArgumentRequiredDescription
effectYesThe effect ID
playerNoTarget player (defaults to yourself)
amountNoNumber of items (defaults to 1)

Examples:

# Give yourself a vein mining rune
/zitems giveeffect vein_mining_rune

# Give a player a hammer rune
/zitems giveeffect hammer_rune Steve

Effect Representation Required

This command only works for effects that have a representation configured in their settings.

/zitems applyeffect

Applies an effect to the item you're currently holding.

/zitems applyeffect <effect>
ArgumentRequiredDescription
effectYesThe effect ID to apply

Examples:

# Apply vein mining to held pickaxe
/zitems applyeffect vein_mining

# Apply auto-sell to held item
/zitems applyeffect auto_sell

Requirements:

  • Must be holding an item
  • Effect must be compatible with the item's material
  • Item must allow additional effects (allow-additional-effects: true)
  • Effect cannot be incompatible with existing effects

/zitems vieweffect

Shows all effects currently applied to the item you're holding.

/zitems vieweffect

Output Example:

Effects on this item:
- VEIN_MINING (block-limit: 32)
- MELT_MINING
- XP_BOOST (boost: 2.0)

/zitems gui

Opens a GUI browser showing all configured items.

/zitems gui

The GUI allows you to:

  • Browse all items
  • Click to give yourself items
  • View item properties

/zitems reload

Reloads all plugin configuration files.

/zitems reload

This reloads:

  • config.yml - Main configuration
  • All files in items/ - Item definitions
  • All files in effects/ - Effect definitions

Reload Limitations

Some changes may require a server restart:

  • Custom recipes may not update immediately
  • Custom block data may require restart

Permissions

Admin Permission

PermissionDescription
zitems.command.adminAccess to all zItems commands

Granular Permissions

You can create granular permissions for specific items and effects:

Permission PatternDescription
zitems.use.<item_id>Permission to use a specific item
zitems.effect.<effect_id>Permission to use a specific effect

Permission Examples

LuckPerms Configuration

Allow staff to manage items:

# Give moderators full access
/lp group moderator permission set zitems.command.admin true

# Or give specific permissions
/lp group moderator permission set zitems.give true
/lp group moderator permission set zitems.reload true

Restrict items to VIP players:

# Allow VIPs to use legendary items
/lp group vip permission set zitems.use.legendary_sword true
/lp group vip permission set zitems.use.vein_pickaxe true

# Allow default players to use basic items
/lp group default permission set zitems.use.basic_pickaxe true

Control effect access:

# Allow VIPs to use powerful effects
/lp group vip permission set zitems.effect.vein_mining true
/lp group vip permission set zitems.effect.auto_sell true

# Allow everyone basic effects
/lp group default permission set zitems.effect.xp_boost true

PermissionsEx Configuration

groups:
  vip:
    permissions:
      - zitems.use.legendary_sword
      - zitems.use.vein_pickaxe
      - zitems.effect.vein_mining

  moderator:
    permissions:
      - zitems.command.admin

  default:
    permissions:
      - zitems.use.basic_pickaxe
      - zitems.effect.xp_boost

Command Tab Completion

All commands support tab completion:

  • Item IDs: All configured items are suggested
  • Effect IDs: All configured effects are suggested
  • Player names: Online players are suggested

Error Messages

Common error messages and solutions:

ErrorCauseSolution
Item not foundInvalid item IDCheck item file name and ID
Effect not foundInvalid effect IDCheck effect configuration
Cannot apply effectMaterial incompatibilityCheck effect's applicable-materials
Effect already appliedDuplicate effectRemove existing effect first
Incompatible effectEffect conflictCannot combine certain effects

Console Commands

All commands can be run from console with player specification:

# From console
zitems give legendary_sword Steve 1
zitems giveeffect vein_mining_rune Steve
zitems reload

PlaceholderAPI Integration

If PlaceholderAPI is installed, these placeholders are available:

PlaceholderDescription
%zitems_effects_count%Number of effects on held item
%zitems_has_effect_<id>%Returns true/false if item has effect

Example usage in item lore:

lore:
  - "<gray>Effects: %zitems_effects_count%</gray>"

Installation

Précédent

Item Configuration

Complete guide to creating custom items in zItems

Sur cette page

Commands Overview/zitems give/zitems giveeffect/zitems applyeffect/zitems vieweffect/zitems gui/zitems reloadPermissionsAdmin PermissionGranular PermissionsPermission ExamplesLuckPerms ConfigurationPermissionsEx ConfigurationCommand Tab CompletionError MessagesConsole CommandsPlaceholderAPI Integration
GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.