⚔️ zMItemsBuilder

Build once. Reuse everywhere.
The ultimate system for custom items, armor/tool sets, and scalable kits.

💡 Why zMItemsBuilder?

Most item plugins only create standalone items. zMItemsBuilder was built from the ground up to power complete progression systems—from Prison, KitPvP, RPG, Skyblock, and Factions servers, to reward and economy systems.

With a single centralised configuration, you manage your entire item catalogue, with automatic enchantment scaling, advanced formatting, rarity, and usage restrictions.

Traditional Plugins	zMItemsBuilder
❌ Manual item duplication	✅ Reusable registry
❌ Static enchantments	✅ Dynamic scaling
❌ No kit integration	✅ Native kit system
❌ Basic formatting	✅ RGB gradients
❌ No restrictions	✅ Full abuse control
❌ Hard to maintain	✅ Clean, scalable config

🖼️ Gallery

📸 Click to see screenshots and examples

Armor Sets	Formatting & Lore	Kit GUI

Commands in Action	Item Creation	In-Game View

🚀 Main Features

Icon	Feature	Description
🛡️	Armor Sets	Auto‑generate full sets (helmet, chestplate, leggings, boots).
🛠️	Tool Sets	Create pickaxe, axe, shovel, hoe, and sword in seconds.
⚔️	Custom Items	Weapons, keys, coins, heads, consumables, and anything else.
📈	Level System	Enchantments, attributes, and effects scale with level (linear, interval, static).
🎨	Formatting Engine	RGB gradients, dynamic placeholders, automatic secondary colours, and prefixes.
🔒	Restrictions	Block drop, craft, placement, repair, enchanting, smelting, and more.
🧩	Reusable Items	Define an item once and reuse it across unlimited kits.
📦	Kit System	Build scalable kits from your global item pool with level inheritance.
🌎	Multi‑Language	English and Spanish included, easily extendable.
⚡	Optimised Performance	Asynchronous processing, 0% TPS impact, built for large servers.
🆔	Unique Identity	NBT IDs, Custom Model Data, and resource pack support.
📊	bStats	Anonymous statistics to improve the plugin (configurable).

📈 Dynamic Enchantment Scaling

Create complex progression curves without duplicating configs. Define a formula and the engine calculates values automatically based on the item's level.

Method	Example	Use Case
Base + per level	`base: 4, per-level: 1, max: 10`	Linear with cap
Every X levels	`base: 1, every: 3, bonus: 1, max: 4`	Interval scaling
Fixed	`sharpness: 8`	Static value

⚙️ Full example of a scalable item

items:
  levels_set:
    mode: armor
    base-material: NETHERITE
    pieces: [helmet, chestplate, leggings, boots]
    name: "&f{item_type} &8▸ {prefix_item} {level}"
    lore:
      - ""
      - " {gradient:🕮 Enchantments:}"
      - "{enchants}"
    enchantments:
      protection:
        base: 4
        per-level: 1
        max: 10
      fire_protection:
        base: 1
        every: 3
        bonus: 1
        max: 4
      blast_protection:
        base: 1
        every: 3
        bonus: 1
        max: 4
      projectile_protection:
        base: 1
        every: 3
        bonus: 1
        max: 4
      mending: 1
    attributes:
      attack_damage:
        attribute: MAX_HEALTH
        amount:
          base: 2
          per-level: 0.5
          max: 15
        operation: ADD_NUMBER
        slot: CHESTPLATE
    restrictions:
      - NO_DROP
      - NO_CRAFTING
      - NO_ENCHANTING

🔒 Per‑Item Restrictions

Control exactly what players can (or cannot) do with each item.

Restriction	Description
`NO_DROP`	🚫 Cannot be dropped
`NO_CRAFT`	🔨 Cannot be used in crafting
`NO_PLACE`	🧱 Cannot be placed in the world
`NO_USE`	🖱️ Cannot be used (right‑click)
`NO_CONSUME`	🍽️ Cannot be consumed (food/potions)
`NO_EQUIP`	⚔️ Cannot be equipped
`NO_ANVIL`	🔧 Cannot be repaired/combined in anvil
`NO_SMITHING`	⚒️ Cannot be used in smithing table
`NO_GRINDSTONE`	🌀 Cannot be used in grindstone
`NO_ENCHANT`	📖 Cannot be enchanted at a table
`NO_BREWING`	🧪 Cannot be used in brewing
`NO_FURNACE`	🔥 Cannot be smelted

🧩 Reusable Kit System

Stop copying and pasting. Define an item once and reuse it across all your kits.

Traditional Approach	zMItemsBuilder
❌ Copy 100+ items	✅ Single definition
❌ Edit 50 files	✅ Update one source
❌ Inconsistent data	✅ Always in sync
❌ Heavy configs	✅ Minimal config
❌ Slow to maintain	✅ Fast and scalable

📋 Example kit configuration

# Step 1: define the item once
items:
  special_armor:
    mode: armor
    base-material: NETHERITE
    pieces: [helmet, chestplate, leggings, boots]
    name: "&f{item_type} &8▸ {prefix_item}"
    lore:
      - ""
      - " {gradient:🕮 Enchantments:}"
      - "{enchants}"
      - ""
      - " {gradient:⚡ Abilities:}"
      - "   {primary_color}&l•&r &fExtra hearts {secondary_color}+5"
      - "   {primary_color}&l•&r &fStrength level {secondary_color}+2%"
      - "   {primary_color}&l•&r &fSpeed level {secondary_color}+2%"
      - "   {primary_color}&l•&r &fResistance level {secondary_color}+2%"
      - ""
      - " {gradient:⌛ Rarity:} {secondary_color}{rarity}"
      - ""
      - " {primary_color}₪ &fObtain this by buying"
      - " &fit at {secondary_color}store.servername.net&f."
    enchants:
      protection: 10
      unbreaking: 5
      mending: 5
    item-flags:
      - HIDE_ENCHANTS
    behavior-flags: []
    attributes:
      max_health:
        attribute: MAX_HEALTH
        amount: 10.0
        operation: ADD_NUMBER
        slot: ALL
      strength:
        attribute: ATTACK_DAMAGE
        amount: 0.02
        operation: ADD_NUMBER
        slot: ANY
      speed:
        attribute: MOVEMENT_SPEED
        amount: 0.02
        operation: ADD_NUMBER
        slot: LEGGINGS
      resistance:
        attribute: KNOCKBACK_RESISTANCE
        amount: 0.02
        operation: ADD_NUMBER
        slot: CHESTPLATE

  special_tools:
    mode: tools
    base-material: NETHERITE
    pieces: [pickaxe, axe, hoe, shovel]
    name: "&f{item_type} &8▸ {prefix_item}"
    lore:
      - ""
      - " {gradient:🕮 Enchantments:}"
      - "{enchants}"
      - ""
      - " {gradient:⌛ Rarity:} {secondary_color}{rarity}"
      - ""
      - " {primary_color}₪ &fObtain this by buying"
      - " &fit at {secondary_color}store.servername.net&f."
    enchants:
      efficiency: 10
      unbreaking: 5
      mending: 3
    item-flags:
      - HIDE_ATTRIBUTES
      - HIDE_ENCHANTS
    behavior-flags: []

  special_sword:
    mode: single
    material: NETHERITE_SWORD
    name: "&f{item_type} &8▸ {prefix_item}"
    lore:
      - ""
      - " {gradient:🕮 Enchantments:}"
      - "{enchants}"
      - ""
      - " {gradient:⌛ Rarity:} {secondary_color}{rarity}"
      - ""
      - " {primary_color}₪ &fObtain this by buying"
      - " &fit at {secondary_color}store.servername.net&f."
    unbreakable: true
    enchants:
      sharpness: 8
      looting: 5
      sweeping_edge: 3
      fire_aspect: 2
      unbreaking: 5
      mending: 5
    item-flags:
      - HIDE_ATTRIBUTES
      - HIDE_ENCHANTS
    behavior-flags: []

# Step 2: reuse it in any kit
kits:
  special_armor:
    rarity: special
    items:
      - special_armor
      - special_sword
      - special_tools
  level_1:
    level: 2 # ← scales automatically
    items:
      - level_set

⚡ Main Commands

Command	Description	Permission
`/zmitems create <kit> <prefix>`	Gives a full kit	`zmitemsbuilder.create`
`/zmitems reload`	Reloads config and languages	`zmitemsbuilder.reload`
`/zmitems material <material>`	Changes the held item's material	`zmitemsbuilder.material`
`/zmitems info`	Shows technical info (ID, CMD, etc.)	`zmitemsbuilder.info`
`/zmitems lore add/remove/set/reset`	Edits item lore	`zmitemsbuilder.lore`
`/zmitems enchant <enchant> <level>`	Adds or removes enchantments	`zmitemsbuilder.enchant`
`/zmitems rename <name>`	Renames the held item	`zmitemsbuilder.rename`
`/zmitems item save/show/give/remove/update`	Manages saved items	`zmitemsbuilder.item`
`/zmitems migrate`	Opens migration GUI for old items	`zmitemsbuilder.migrate`

Basic Permissions

Permission	Description
`zmitemsbuilder.use`	General command usage
`zmitemsbuilder.create`	Create kits
`zmitemsbuilder.reload`	Reload configuration
`zmitemsbuilder.update`	Receive update notifications
`zmitemsbuilder.lore`	Edit lore
`zmitemsbuilder.enchant`	Edit enchantments
`zmitemsbuilder.rename`	Rename items

🛠️ Technical Details

Aspect	Specification
API	Paper 1.21+
Java	21 or higher
Configuration	YAML (`config.yml`, `lang/*.yml`, `saved_items.yml`)
Engine	Asynchronous processing
Identification	NBT/PDC (`id_item`) + CustomModelData
Placeholders	Native + PlaceholderAPI
Storage	YAML (flat files)
Languages	English and Spanish
Performance	0% TPS impact

📊 bStats

Anonymous statistics help us improve the plugin. You can disable them in the config.

📦 What Can You Create?

📋 Full list of items and systems

Equipment: armor sets, tools, weapons, shields.
Economy: coins, tokens, keys, vouchers.
Rewards: crates, daily rewards, playtime rewards, battle pass rewards.
Utility: event items, cosmetics, store items, consumables, teleport items.
Customisation: custom heads, custom textures, CustomModelData.

❤️ Built for Performance

Feature	Benefit
✔ Clean configuration	Easy to understand and maintain
✔ Reusable components	Reduces duplication by >90%
✔ Lightweight	Minimal resource usage
✔ Scalable	Handles 1000+ items without lag
✔ Asynchronous processing	Zero impact on main thread
✔ Smart caching	Instant data access

🌟 Why Choose zMItemsBuilder?

Aspect	zMItemsBuilder	Other Plugins
Dynamic scaling	✅	❌
Reusable items	✅	❌
Kit system	✅	⚠️ Limited
RGB gradients	✅	❌
Full restrictions	✅	⚠️ Basic
Multi‑language	✅	❌
0% TPS impact	✅	⚠️ Variable
Pure YAML	✅	⚠️ Mixed

🎯 Build once.

🔄 Reuse everywhere.

📈 Scale infinitely.

zMItemsBuilder – the ultimate system for servers that demand professional item, gear, and progression management.

zMItemsBuilder

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details