⚔️ zMItemsBuilder

Build once. Reuse everywhere. A complete system for custom items, kits, abilities, restrictions and scalable progression.

📖 About This Plugin

zMItemsBuilder is a Minecraft (Spigot/Paper) plugin that provides a complete, YAML-driven system for creating and managing custom items on a server. Instead of building items one by one, you define them once in centralized groups and reuse them across kits, rewards, shops, events, and progression systems — with full control over their appearance, behavior, and restrictions.

• What it does: Adds an in-game GUI and command system to create custom items, group them, scale their enchantments/attributes by level, attach actions/effects, enforce behavior flags, and give them to players individually or by group.
• Why download it: It removes duplication, centralizes item definitions, and adds progression, abilities, and per-item restrictions without requiring multiple plugins or repeated YAML edits.
• Requirements & critical info: Minecraft 1.20+ and Java 17+. PlaceholderAPI is optional but supported. Configuration is YAML-based (items.yml); all commands and GUIs are documented in the linked wiki.

💡 More Than a Custom Item Plugin

Most item plugins focus on creating individual items.

zMItemsBuilder focuses on the system behind them.

Create an item once, then reuse it across groups, kits, rewards and progression systems without duplicating configurations.

Create → Configure → Reuse → Scale

🚀 Create Items Without Manual Configuration

You don't need to start by editing YAML.

Use the in-game GUI:

/zmitems create <name>

Choose your item type:

Single  →  One custom item
Armor   →  Full armor set
Tools   →  Pickaxe, axe, shovel and hoe

The item is automatically added to items.yml and can then be edited with commands.

/zmitems create nuclear_pickaxe
/zmitems rename &bNuclear Pickaxe
/zmitems enchant efficiency 10
/zmitems enchant unbreaking 5
/zmitems glow
/zmitems unbreakable

🧩 Reusable Items & Groups

Define an item once and use it wherever you need it.

groups:
  special:
    rarity: special
    items:
      - special_sword
      - special_armor
      - special_tools

Change the original item and every system using it can use the updated definition.

Less duplication. Less maintenance. More control.

🖼️ Plugin Preview

See what you can create with zMItemsBuilder.

Custom items, equipment and examples created using zMItemsBuilder.

📈 Progression System

Turn static items into scalable equipment.

Enchantments and attributes can scale by level using:

Progression can also be configured through an in-game GUI:

/zmitems progression

enchantments:
  protection:
    base: 4
    per-level: 1
    max: 10

  fire_protection:
    base: 1
    every: 3
    bonus: 1
    max: 4

⚡ Items With Abilities

Give items actual behavior instead of only changing their appearance.

Actions

• Player commands
• Console commands
• Sounds
• Click-based actions

Effects

• Passive effects while equipped
• Configurable duration and amplifier

Uses & Cooldowns

Create consumable or limited-use items:

Uses: 3/5

Configure their behavior and limits without creating separate item versions.

🔒 Full Item Control

Control what players can do with every item.

More flags are available.

🎨 Customization

Create items that actually match your server.

• Custom names & lore
• RGB colors & gradients
• Dynamic placeholders
• Rarity system
• Custom Model Data
• Custom heads & textures
• Enchantments
• Attributes
• Armor trims
• Item flags

{item_type}
{prefix_item}
{level}
{rarity}
{enchants}
{primary_color}
{secondary_color}
{gradient:text}
{attribute_level:<name>}

📦 Powerful Give System

Give individual items, entire groups or saved items.

/zmitems give NORMAL <player> <id> [amount] [prefix]

/zmitems give GROUP <player> <groupId> [prefix]

/zmitems item give <player> <name> <amount> [notify]

This makes zMItemsBuilder easy to integrate with kits, rewards, stores, events and progression systems.

🛠️ Main Commands

Below are the available command groups, organized by purpose.

Item Management

/zmitems create <name>
/zmitems clone <name> [group]
/zmitems material <material>
/zmitems rename <name>
/zmitems info
/zmitems glow
/zmitems unbreakable
/zmitems flag [flag]

Lore & Enchantments

/zmitems lore add/remove/set/reset
/zmitems lore copy
/zmitems lore paste
/zmitems enchant <name> <level>

Attributes, Effects & Actions

/zmitems attribute add ...
/zmitems attribute remove ...
/zmitems effect add ...
/zmitems effect remove ...
/zmitems effect list ...
/zmitems action add ...
/zmitems action remove ...

Progression & Administration

/zmitems progression [enchant|attribute] [item]
/zmitems item save/show/give/remove/update
/zmitems reload
/zmitems migrate

📋 What Can You Create?

⚙️ Clean & Scalable

zMItemsBuilder keeps your item definitions organized instead of spreading duplicated configurations everywhere.

📊 bStats

Anonymous statistics help improve zMItemsBuilder. Telemetry can be disabled in the configuration.