zCustomGear - Armor Sets & Talismans

zCustomGear
Custom armor sets & talismans with rarity tiers and full-set bonuses
By zArrowTan (Arrow Plugins). Formerly zArmorSets.

Overview

zCustomGear lets you build custom armor sets and talismans in YAML, each with its own rarity tier and bonuses that activate when the full set is worn or the talisman is held. Define potion effects, attribute boosts, gameplay toggles, particles, and economy perks, then hand the gear out and let players chase the tiers. One jar, Minecraft 1.18 to 1.21.11+, zero required dependencies.

🛡 Armor Sets

Define sets in YAML with fully configurable rarity tiers, from Common to Mythic
Bonuses activate only when the configured set is worn, with an optional partial-bonus mode for wearing 2 or 3 pieces
Pieces are matched via PersistentDataContainer tags, so they never collide with vanilla items
Items from the creative menu or other plugins won't trigger sets, only properly tagged gear does

Bonus Types

Potion Effects: any effect, with hide-particles support
Attribute Modifiers: max-health, attack-damage, and more
Gameplay Toggles: no-hunger, glowing with team color, fire and fall immunity, unbreakable
Particles: native Bukkit particles with color support on dust particles, configurable type, interval, offset, and count
Smart Glow Color: resolves set-level, then rarity-level, then none, so a tier color is the default and any set can override it

Talismans

Inventory-held trinkets that grant bonuses passively, and multiple stack
Optional timer: a consumable countdown that ticks only while carried, pauses when stored, and destroys the item at zero
Right-click activation gate: crate drops can be resold before the countdown ever starts
Talismans support the same bonus types and integrations as armor sets

Live Item Refresh

Edit a set's YAML and run /zcg reload, already-distributed items rebuild their name, lore, model data, and unbreakable flag in place from the current config
Enchantments are left untouched, so anvil work survives a refresh
Optional keep-on-death per set and per talisman, tagged items survive death and snap back to the correct slot on respawn

Integrations

All integrations are soft-depends. If the plugin isn't installed, zCustomGear just logs an info line and carries on.

EcoJobs: per-set and per-talisman XP multiplier
EconomyShopGUI: sell multiplier applied across the shop GUI, quick-sell, sell-all, shopstands, and auto-sell chests
ItemsAdder: use a custom item as the base (itemsadder: namespace:id), with the resource-pack texture preserved and a material fallback when missing
PacketEvents: glow color survives rank and nametag plugins like TAB and LuckPerms-Prefix

Storage

SQLite by default (file-based) or MySQL via a HikariCP pool
All database I/O runs off the main thread
If MySQL fails to connect, the plugin falls back to SQLite automatically and logs a warning
Config is managed by BoostedYAML, so new keys auto-migrate on update without touching your edits

⚙ Defining a Set

Drop a file into plugins/zCustomGear/sets/<id>.yml. A fully annotated dragonlord.yml ships as a reference.

YAML:

id: dragonlord
display-name: "&#ff6b6bDragonlord Set"
rarity: legendary
required-pieces: 4
activation-message: "&#ffd700You feel the power of the Dragonlord!"
pieces:
  helmet:     { material: NETHERITE_HELMET,     unbreakable: true, custom-model-data: 1001 }
  chestplate: { material: NETHERITE_CHESTPLATE, unbreakable: true, custom-model-data: 1002 }
  leggings:   { material: NETHERITE_LEGGINGS,   unbreakable: true, custom-model-data: 1003 }
  boots:      { material: NETHERITE_BOOTS,      unbreakable: true, custom-model-data: 1004 }
bonuses:
  potion-effects:
    - { type: STRENGTH, amplifier: 1, hide-particles: true }
  attributes:
    max-health: 4
    attack-damage: 2
  toggles:
    no-hunger: true
    glowing: true
    glow-color: RED
  particles:
    enabled: true
    type: FLAME
    color: "255,215,0"
    interval-ticks: 10
    offset: 0.5
    count: 5
  integrations:
    ecojobs-xp-multiplier: 1.25
    economyshopgui-sell-multiplier: 1.15

Commands

Base command /zcustomgear (aliases /zcg, /customgear).

/zcg list
List defined armor sets
/zcg info <set>
Show details for a set
/zcg give <player> <set> [piece|all]
Give a piece or full set to a player
/zcg test [set]
Equip a set on yourself for testing
/zcg talisman <list|info <id>|give <player> <id>>
Talisman management
/zcg reload
Reload all config and live-refresh tagged items

Permissions

zcustomgear.admin (op)
Full access
zcustomgear.use (true)
Receive bonuses
zcustomgear.give (op)
Use /zcg give
zcustomgear.reload (op)
Use /zcg reload
zcustomgear.set.<id> and zcustomgear.talisman.<id>
Required when a set or talisman has require-permission: true

Requirements

Minecraft: 1.18 to 1.21.11+ (single jar)
Server software: Spigot or Paper
Java: 17 or higher
Optional: EcoJobs, EconomyShopGUI, ItemsAdder, PacketEvents

Installation

Drop the jar into your plugins/ folder.
Start the server once to generate the config, an example set, and an example talisman.
Edit your sets and talismans, then run /zcg reload.

First start needs internet once so the server can download the runtime libraries (cached afterward).

Metrics

This plugin uses bStats to collect anonymous usage stats. You can opt out anytime in plugins/bStats/config.yml.

Support

Need help, found a bug, or want to suggest a feature? Join the Discord. Full documentation is linked in the banner above.

Click here to join the Discord

Gear up. Tier up.

zCustomGear - Armor Sets & Talismans v2.1.0

Overview Dependencies History Discord Documentation DudeATS