GroupeZ Docs
Effects

Attributes Applicator

Add or modify item attributes

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

The ATTRIBUTES_APPLICATOR effect allows you to create items that add or modify attributes on other items. This is perfect for creating attribute runes, stat boosters, or equipment upgrade items.

Configuration

effects:
  - type: ATTRIBUTES_APPLICATOR
    attributes:
      - attribute: ATTACK_DAMAGE
        operation: ADD_NUMBER
        amount: 10.0
        slot: HAND
      - attribute: ATTACK_SPEED
        operation: ADD_NUMBER
        amount: 2.0
        slot: HAND

    # Merge strategy for existing attributes
    strategy: ADD  # ADD, REPLACE, KEEP_HIGHEST, KEEP_LOWEST, SUM

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

Parameters

ParameterTypeRequiredDefaultDescription
attributesListYes-List of attributes to apply
strategyEnumNoADDHow to merge with existing attributes
applicable-materialsListNo-Items that can have this effect
applicable-tagsListNo-Item tags
applicability-blacklistedBooleanNofalseInvert applicability

Attribute Parameters

Each attribute entry supports:

ParameterTypeRequiredDescription
attributeStringYesThe attribute type
operationEnumYesHow the value is applied
amountDoubleYesThe attribute value
slotEnumNoEquipment slot restriction

Merge Strategies

StrategyDescription
ADDAdd new attributes while keeping existing ones
REPLACEReplace all existing attributes with new ones
KEEP_HIGHESTKeep only the highest value for each attribute
KEEP_LOWESTKeep only the lowest value for each attribute
SUMSum modifiers with same attribute and operation

Available Attributes

Combat Attributes

AttributeDescription
ATTACK_DAMAGEMelee damage dealt
ATTACK_SPEEDAttack cooldown speed
ATTACK_KNOCKBACKKnockback on hit

Defense Attributes

AttributeDescription
ARMORDamage reduction
ARMOR_TOUGHNESSArmor effectiveness vs strong attacks
KNOCKBACK_RESISTANCEResistance to knockback

Movement Attributes

AttributeDescription
MOVEMENT_SPEEDWalking speed
FLYING_SPEEDFlight speed (creative)
JUMP_STRENGTHJump height
SAFE_FALL_DISTANCEFall distance before damage
FALL_DAMAGE_MULTIPLIERFall damage multiplier
STEP_HEIGHTAuto-step height

Health & Combat

AttributeDescription
MAX_HEALTHMaximum health
SCALEEntity size scale
GRAVITYGravity strength
BURNING_TIMETime on fire
EXPLOSION_KNOCKBACK_RESISTANCEExplosion knockback resistance
OXYGEN_BONUSUnderwater breathing bonus
WATER_MOVEMENT_EFFICIENCYSwimming speed
BLOCK_BREAK_SPEEDMining speed
BLOCK_INTERACTION_RANGEBlock reach distance
ENTITY_INTERACTION_RANGEEntity reach distance
LUCKLuck stat
FOLLOW_RANGEEntity follow range

Minecraft 1.21+ Attributes

AttributeDescription
MINING_EFFICIENCYMining speed multiplier
SNEAKING_SPEEDSneaking speed
SUBMERGED_MINING_SPEEDUnderwater mining speed
SWEEPING_DAMAGE_RATIOSweep attack damage ratio

Operations

OperationFormulaDescription
ADD_NUMBERBase + ValueAdds flat amount
ADD_SCALARBase * (1 + Value)Adds percentage
MULTIPLY_SCALAR_1Base * ValueMultiplies by value

Equipment Slots

SlotDescription
HANDMain hand
OFF_HANDOff hand
HEADHelmet slot
CHESTChestplate slot
LEGSLeggings slot
FEETBoots slot
ARMORAny armor slot
BODYBody slot (for horses/armor stands)
ANYAny equipment slot

Examples

Damage Boost Rune

damage_rune:
  material: BLAZE_POWDER
  display-name: "<gradient:#ff4500:#ff0000>Damage Rune</gradient>"
  lore:
    - ""
    - "<gray>Increases attack damage.</gray>"
    - ""
    - "<red>+10 Attack Damage</red>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: ATTACK_DAMAGE
          operation: ADD_NUMBER
          amount: 10.0
          slot: HAND

      applicable-tags:
        - SWORDS
        - AXES

      representation:
        material: BLAZE_POWDER
        display-name: "<gradient:#ff4500:#ff0000>Damage Rune</gradient>"
        lore:
          - ""
          - "<gray>Apply in smithing table</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Speed Boost Gem

speed_gem:
  material: EMERALD
  display-name: "<gradient:#00ff00:#00aa00>Speed Gem</gradient>"
  lore:
    - ""
    - "<gray>Increases movement speed.</gray>"
    - ""
    - "<green>+20% Movement Speed</green>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: MOVEMENT_SPEED
          operation: ADD_SCALAR
          amount: 0.2
          slot: FEET

      strategy: ADD

      applicable-materials:
        - NETHERITE_BOOTS
        - DIAMOND_BOOTS
        - IRON_BOOTS

      representation:
        material: EMERALD
        display-name: "<gradient:#00ff00:#00aa00>Speed Gem</gradient>"
        lore:
          - ""
          - "<gray>Apply to boots</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Warrior's Essence

warrior_essence:
  material: NETHER_STAR
  display-name: "<gradient:#ffd700:#ff8c00>Warrior's Essence</gradient>"
  lore:
    - ""
    - "<gray>The essence of a true warrior.</gray>"
    - ""
    - "<yellow>Combat Attributes:</yellow>"
    - "<gray>+15 Attack Damage</gray>"
    - "<gray>+50% Attack Speed</gray>"
    - "<gray>+2 Attack Knockback</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: ATTACK_DAMAGE
          operation: ADD_NUMBER
          amount: 15.0
          slot: HAND
        - attribute: ATTACK_SPEED
          operation: ADD_SCALAR
          amount: 0.5
          slot: HAND
        - attribute: ATTACK_KNOCKBACK
          operation: ADD_NUMBER
          amount: 2.0
          slot: HAND

      strategy: ADD

      applicable-tags:
        - SWORDS

      representation:
        material: NETHER_STAR
        display-name: "<gradient:#ffd700:#ff8c00>Warrior's Essence</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Tank Armor Upgrade

tank_upgrade:
  material: IRON_BLOCK
  display-name: "<gradient:#808080:#696969>Tank Upgrade</gradient>"
  lore:
    - ""
    - "<gray>Become an unstoppable tank!</gray>"
    - ""
    - "<white>Defense Attributes:</white>"
    - "<gray>+10 Armor</gray>"
    - "<gray>+5 Armor Toughness</gray>"
    - "<gray>+50% Knockback Resistance</gray>"
    - "<gray>+10 Max Health</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: ARMOR
          operation: ADD_NUMBER
          amount: 10.0
          slot: CHEST
        - attribute: ARMOR_TOUGHNESS
          operation: ADD_NUMBER
          amount: 5.0
          slot: CHEST
        - attribute: KNOCKBACK_RESISTANCE
          operation: ADD_SCALAR
          amount: 0.5
          slot: CHEST
        - attribute: MAX_HEALTH
          operation: ADD_NUMBER
          amount: 10.0
          slot: CHEST

      strategy: ADD

      applicable-materials:
        - NETHERITE_CHESTPLATE
        - DIAMOND_CHESTPLATE

      representation:
        material: IRON_BLOCK
        display-name: "<gradient:#808080:#696969>Tank Upgrade</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Miner's Blessing

miner_blessing:
  material: GOLDEN_PICKAXE
  display-name: "<gradient:#ffd700:#daa520>Miner's Blessing</gradient>"
  lore:
    - ""
    - "<gray>Blessed by the mining gods.</gray>"
    - ""
    - "<yellow>Mining Attributes:</yellow>"
    - "<gray>+50% Block Break Speed</gray>"
    - "<gray>+2 Block Reach</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: BLOCK_BREAK_SPEED
          operation: ADD_SCALAR
          amount: 0.5
          slot: HAND
        - attribute: BLOCK_INTERACTION_RANGE
          operation: ADD_NUMBER
          amount: 2.0
          slot: HAND

      strategy: ADD

      applicable-tags:
        - PICKAXES

      representation:
        material: GOLDEN_PICKAXE
        display-name: "<gradient:#ffd700:#daa520>Miner's Blessing</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Replace Strategy Example

perfect_stats:
  material: DIAMOND
  display-name: "<aqua>Perfect Stats Crystal</aqua>"
  lore:
    - ""
    - "<gray>Replaces all attributes with</gray>"
    - "<gray>perfect balanced stats.</gray>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      strategy: REPLACE  # Removes existing attributes!

      attributes:
        - attribute: ATTACK_DAMAGE
          operation: ADD_NUMBER
          amount: 20.0
          slot: HAND
        - attribute: ATTACK_SPEED
          operation: ADD_NUMBER
          amount: 4.0
          slot: HAND

      applicable-tags:
        - SWORDS

      representation:
        material: DIAMOND
        display-name: "<aqua>Perfect Stats Crystal</aqua>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Craftable Speed Boots Upgrade

swiftness_crystal:
  material: PRISMARINE_SHARD
  display-name: "<gradient:#00ffff:#1e90ff>Swiftness Crystal</gradient>"
  lore:
    - ""
    - "<gray>Enhances boot speed.</gray>"
    - ""
    - "<aqua>+30% Movement Speed</aqua>"
    - "<aqua>+20% Jump Strength</aqua>"

  effects:
    - type: ATTRIBUTES_APPLICATOR
      attributes:
        - attribute: MOVEMENT_SPEED
          operation: ADD_SCALAR
          amount: 0.3
          slot: FEET
        - attribute: JUMP_STRENGTH
          operation: ADD_SCALAR
          amount: 0.2
          slot: FEET

      strategy: ADD

      applicable-materials:
        - NETHERITE_BOOTS
        - DIAMOND_BOOTS
        - IRON_BOOTS
        - GOLDEN_BOOTS
        - CHAINMAIL_BOOTS
        - LEATHER_BOOTS

      representation:
        material: PRISMARINE_SHARD
        display-name: "<gradient:#00ffff:#1e90ff>Swiftness Crystal</gradient>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

  recipe:
    type: SHAPED
    pattern:
      - "PEP"
      - "ESE"
      - "PEP"
    ingredients:
      - item: PRISMARINE_SHARD
        sign: P
      - item: EMERALD
        sign: E
      - item: SUGAR
        sign: S

Use Cases

  1. Stat Upgrades: Allow players to customize item stats
  2. Progression System: Tiered attribute upgrades
  3. Class Items: Role-specific stat modifiers
  4. Balance Tools: Items that normalize stats (REPLACE strategy)
  5. Event Rewards: Powerful stat boosters

Strategy Comparison

# ADD - Keeps existing + adds new
strategy: ADD
# Result: Item has both old and new attributes

# REPLACE - Removes all, adds new
strategy: REPLACE
# Result: Only new attributes remain

# KEEP_HIGHEST - Keeps highest for each attribute
strategy: KEEP_HIGHEST
# Result: For each attribute, only the highest value is kept

# SUM - Combines same attribute+operation
strategy: SUM
# Result: +5 damage + +3 damage = +8 damage

Tips

  • Use ADD for stacking upgrades
  • Use REPLACE for setting exact values
  • Use KEEP_HIGHEST for best-in-slot systems
  • Use SUM for cumulative upgrades
  • Consider balance when setting attribute values
  • Test with different equipment slots
  • Combine with crafting recipes for balanced acquisition

Enchants Applicator

Modify enchantments on items

Metadata Overview

Configure special item properties with metadata

Sur cette page

ConfigurationParametersAttribute ParametersMerge StrategiesAvailable AttributesCombat AttributesDefense AttributesMovement AttributesHealth & CombatMinecraft 1.21+ AttributesOperationsEquipment SlotsExamplesDamage Boost RuneSpeed Boost GemWarrior's EssenceTank Armor UpgradeMiner's BlessingReplace Strategy ExampleCraftable Speed Boots UpgradeUse CasesStrategy ComparisonTips
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.