GroupeZ Docs
Effects

Enchants Applicator

Modify enchantments on items

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

The ENCHANTS_APPLICATOR effect allows you to create items that add or remove enchantments from other items. This is perfect for creating enchantment books, upgrade scrolls, or enchantment modification runes.

Configuration

effects:
  - type: ENCHANTS_APPLICATOR
    enchantments:
      - enchantment: SHARPNESS
        evolution: INCREASE
        level: 5
      - enchantment: UNBREAKING
        evolution: INCREASE
        level: 3

    # Optional: Restrict which items can have this effect
    applicable-materials:
      - DIAMOND_SWORD
      - NETHERITE_SWORD
    applicable-tags:
      - SWORDS
    applicability-blacklisted: false

Parameters

ParameterTypeRequiredDefaultDescription
enchantmentsListYes-List of enchantment modifications
applicable-materialsListNo-Items that can have this effect
applicable-tagsListNo-Item tags
applicability-blacklistedBooleanNofalseInvert applicability

Enchantment Parameters

Each enchantment entry supports:

ParameterTypeRequiredValuesDescription
enchantmentStringYesAny enchantmentThe enchantment to modify
evolutionEnumYesINCREASE, DECREASEAdd or remove levels
levelIntegerYesAnyNumber of levels to add/remove

Evolution Types

TypeDescription
INCREASEAdd the specified number of levels
DECREASERemove the specified number of levels

Behavior

  1. Application Check:

    • Verifies target item has the enchantment (for modifications)
    • Validates that resulting level won't be negative
    • If validation fails, no changes are made

  2. Level Modification:

    • INCREASE: Adds levels to existing enchantment
    • DECREASE: Removes levels from existing enchantment
    • If resulting level is 0, enchantment is removed

Examples

Sharpness Upgrade Scroll

sharpness_scroll:
  material: PAPER
  display-name: "<gradient:#ff4500:#ffd700>Sharpness Scroll</gradient>"
  lore:
    - ""
    - "<gray>Increases Sharpness by 5 levels!</gray>"
    - ""
    - "<yellow>Apply to:</yellow>"
    - "<gray>- Any sword with Sharpness</gray>"
    - ""
    - "<gold>Use in a smithing table</gold>"

  custom-model-data: 1001

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: SHARPNESS
          evolution: INCREASE
          level: 5

      applicable-tags:
        - SWORDS

      representation:
        material: PAPER
        display-name: "<gradient:#ff4500:#ffd700>Sharpness Scroll</gradient>"
        lore:
          - ""
          - "<gray>+5 Sharpness Levels</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Multi-Enchant Upgrade Book

warrior_blessing:
  material: ENCHANTED_BOOK
  display-name: "<gradient:#ff0000:#8b0000>Warrior's Blessing</gradient>"
  lore:
    - ""
    - "<gray>A powerful blessing that</gray>"
    - "<gray>enhances combat enchantments.</gray>"
    - ""
    - "<yellow>Enchantments:</yellow>"
    - "<gray>+3 Sharpness</gray>"
    - "<gray>+2 Fire Aspect</gray>"
    - "<gray>+1 Looting</gray>"

  glow: true

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: SHARPNESS
          evolution: INCREASE
          level: 3
        - enchantment: FIRE_ASPECT
          evolution: INCREASE
          level: 2
        - enchantment: LOOTING
          evolution: INCREASE
          level: 1

      applicable-tags:
        - SWORDS

      representation:
        material: ENCHANTED_BOOK
        display-name: "<gradient:#ff0000:#8b0000>Warrior's Blessing</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Efficiency Boost Rune

efficiency_rune:
  material: EMERALD
  display-name: "<gradient:#00ff00:#00aa00>Efficiency Rune</gradient>"
  lore:
    - ""
    - "<gray>Boosts mining efficiency!</gray>"
    - ""
    - "<green>+10 Efficiency</green>"
    - "<green>+3 Unbreaking</green>"

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: EFFICIENCY
          evolution: INCREASE
          level: 10
        - enchantment: UNBREAKING
          evolution: INCREASE
          level: 3

      applicable-tags:
        - PICKAXES
        - SHOVELS
        - AXES

      representation:
        material: EMERALD
        display-name: "<gradient:#00ff00:#00aa00>Efficiency Rune</gradient>"
        lore:
          - ""
          - "<gray>Apply to mining tools</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Enchantment Removal Scroll

curse_cleanse:
  material: PAPER
  display-name: "<gradient:#ffffff:#aaaaaa>Curse Cleanse</gradient>"
  lore:
    - ""
    - "<gray>Removes curses from items.</gray>"
    - ""
    - "<white>Removes:</white>"
    - "<gray>- Curse of Vanishing</gray>"
    - "<gray>- Curse of Binding</gray>"

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: VANISHING_CURSE
          evolution: DECREASE
          level: 1
        - enchantment: BINDING_CURSE
          evolution: DECREASE
          level: 1

      representation:
        material: PAPER
        display-name: "<gradient:#ffffff:#aaaaaa>Curse Cleanse</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Protection Armor Upgrade

protection_blessing:
  material: NETHER_STAR
  display-name: "<gradient:#4169e1:#00bfff>Divine Protection</gradient>"
  lore:
    - ""
    - "<gray>Enhances armor protection.</gray>"
    - ""
    - "<aqua>+4 Protection</aqua>"
    - "<aqua>+3 Unbreaking</aqua>"

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: PROTECTION
          evolution: INCREASE
          level: 4
        - enchantment: UNBREAKING
          evolution: INCREASE
          level: 3

      applicable-materials:
        - NETHERITE_HELMET
        - NETHERITE_CHESTPLATE
        - NETHERITE_LEGGINGS
        - NETHERITE_BOOTS
        - DIAMOND_HELMET
        - DIAMOND_CHESTPLATE
        - DIAMOND_LEGGINGS
        - DIAMOND_BOOTS

      representation:
        material: NETHER_STAR
        display-name: "<gradient:#4169e1:#00bfff>Divine Protection</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Downgrade Scroll (For Balance)

enchant_degrade:
  material: WITHER_ROSE
  display-name: "<dark_gray>Entropy Scroll</dark_gray>"
  lore:
    - ""
    - "<gray>Weakens enchantments...</gray>"
    - ""
    - "<red>-2 Sharpness</red>"

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: SHARPNESS
          evolution: DECREASE
          level: 2

      applicable-tags:
        - SWORDS

      representation:
        material: WITHER_ROSE
        display-name: "<dark_gray>Entropy Scroll</dark_gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Craftable Enchantment Rune

fortune_rune:
  material: DIAMOND
  display-name: "<gradient:#00bfff:#1e90ff>Fortune Rune</gradient>"
  lore:
    - ""
    - "<gray>Increases fortune on pickaxes.</gray>"
    - ""
    - "<aqua>+3 Fortune</aqua>"

  effects:
    - type: ENCHANTS_APPLICATOR
      enchantments:
        - enchantment: FORTUNE
          evolution: INCREASE
          level: 3

      applicable-tags:
        - PICKAXES

      representation:
        material: DIAMOND
        display-name: "<gradient:#00bfff:#1e90ff>Fortune Rune</gradient>"
        lore:
          - ""
          - "<gray>Apply in smithing table</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

  recipe:
    type: SHAPED
    pattern:
      - "DED"
      - "ENE"
      - "DED"
    ingredients:
      - item: DIAMOND
        sign: D
      - item: EMERALD
        sign: E
      - item: NETHER_STAR
        sign: N

All Minecraft Enchantments

Here's a reference of all available enchantments:

Weapons

  • SHARPNESS, SMITE, BANE_OF_ARTHROPODS
  • KNOCKBACK, FIRE_ASPECT, LOOTING
  • SWEEPING_EDGE (Java Edition)

Tools

  • EFFICIENCY, SILK_TOUCH, FORTUNE

Armor

  • PROTECTION, FIRE_PROTECTION, BLAST_PROTECTION, PROJECTILE_PROTECTION
  • THORNS, RESPIRATION, AQUA_AFFINITY
  • DEPTH_STRIDER, FROST_WALKER, SOUL_SPEED, SWIFT_SNEAK
  • FEATHER_FALLING

Bows & Crossbows

  • POWER, PUNCH, FLAME, INFINITY
  • MULTISHOT, PIERCING, QUICK_CHARGE

Fishing

  • LUCK_OF_THE_SEA, LURE

Trident

  • LOYALTY, IMPALING, RIPTIDE, CHANNELING

Universal

  • UNBREAKING, MENDING
  • VANISHING_CURSE, BINDING_CURSE

Mace (1.21+)

  • DENSITY, BREACH, WIND_BURST

Use Cases

  1. Upgrade Scrolls: Allow players to enhance their gear
  2. Enchantment Books: Custom enchantment application items
  3. Curse Removal: Items that cleanse negative enchantments
  4. Progression System: Tiered enchantment upgrades
  5. Event Rewards: Special enchantment boosters

Tips

  • Ensure target items have the required enchantment for modifications
  • Use DECREASE carefully - can't reduce below 0
  • Combine with crafting recipes for balanced acquisition
  • Consider economy integration for purchasing upgrade scrolls
  • Great for server progression systems

Unbreakable

Make items indestructible

Attributes Applicator

Add or modify item attributes

Sur cette page

ConfigurationParametersEnchantment ParametersEvolution TypesBehaviorExamplesSharpness Upgrade ScrollMulti-Enchant Upgrade BookEfficiency Boost RuneEnchantment Removal ScrollProtection Armor UpgradeDowngrade Scroll (For Balance)Craftable Enchantment RuneAll Minecraft EnchantmentsWeaponsToolsArmorBows & CrossbowsFishingTridentUniversalMace (1.21+)Use CasesTips
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.