zCustomGear - Armor Sets & Talismans 2.8.1

📦 Crates

You can now make crates. A crate is an item a player right-clicks to open. Opening it uses one from the stack and gives rewards, which can be an item, one set piece, a full set, a talisman, a talisman bag, or a console command.

Each crate is one .yml file in the new crates/ folder, exactly like sets and talismans. A starter.yml is created for you on first start, so you have a working example to copy.

Two ways to pick rewards, set with roll-mode:

• weight (the default) always gives the number of rewards you set in rolls, and each reward's chance decides how likely it is against the others. Give them all the same number and they are equally likely
• chance rolls every reward on its own percent, so chance: 25 means 25 percent. One open can give several rewards, or none at all

A reward with guaranteed: true is always given, in either mode.

The odds are worked out for you. Turn on show-rewards-in-lore and the crate item lists its rewards with the percentages filled in, using %reward% and %chance% in your own line format. You never type a percentage by hand, so the lore can never drift from what the crate actually does.

Other keys worth knowing: rolls, unique-rolls, require-empty-slot, keep-on-death, and sound. Set require-permission: true to lock a crate behind zcustomgear.crate.<id>, otherwise anyone can open it.

/zcg crate list
/zcg crate info <id>
/zcg crate give <player> <id> <amount>

With require-empty-slot: true, opening with a full inventory is refused and the player keeps the crate, so nothing is lost.

⛏️ CoreJobs Bonuses

A worn set or an active talisman can now boost CoreJobs payouts, the same way it already could with EcoJobs. Three payouts, each with its own key:

bonuses:
  integrations:
    corejobs-xp-multiplier: 1.25          # +25% job XP
    corejobs-money-multiplier: 1.10       # +10% job money
    corejobs-farmpoints-multiplier: 1.50  # +50% farmpoints

Leave a key out and that payout is untouched, so you can give more xp without giving more money. A set and a talisman that both boost xp multiply together: a 1.5 set with a 1.2 talisman gives 1.8. A boost the player already bought keeps working, and the gear stacks on top of it rather than replacing it.

Turn the whole thing on or off with integrations.corejobs in config.yml.

This needs CoreJobs 1.4.0 or newer. On an older build the bonus stays off and the console tells you to update.

📊 The Bonus Is Visible Now

The gear bonus used to be invisible. A player with a 2x set got double xp, but %corejobs_boost_xp_multiplier% still read 1, because that placeholder means the boost the player bought. Players read that as the gear being broken.

zCustomGear now reports what it is giving, so these include the gear:

Swap xp for money or farmpoints. There is nothing to switch on, it works as soon as both plugins are running, and your existing scoreboard lines keep working because %corejobs_boost_xp_multiplier% still means what it always did.

✨ Glow Keeps the Rank Prefix

A glowing armour set used to strip a player's rank prefix and name colour, whether that came from TAB, LuckPerms or Nametagedit. Now the glow applies and the rank display stays exactly as it was, and the original name colour comes back when the armour comes off.

The glow also returns on its own after a relogin or a respawn, instead of needing the armour taken off and put back on.

Keep PacketEvents installed for this. Without it the plugin still runs, but the rank prefix can disappear while glowing again. The console prints one line if it is missing.

🎨 Glow Colour or Name Colour

Minecraft uses one colour for both the glow outline and the name above the head. They are the same setting, so a coloured glow always colours the name too. That is a Minecraft limit rather than something a plugin can work around.

You can now choose which one wins:

glow:
  recolor-nametag: true

• true (the default, and how it behaved before) the glow shows the set colour and the name matches it
• false no team colours are touched, so the name keeps its rank colour and the glow shows in the rank colour instead, or white for a player with no rank

Reload with /zcg reload after editing. Nothing changes for you unless you change this option.

Want a gold glow and a red name at once? That needs a name tag plugin that draws names with display entities, such as UnlimitedNameTags or DisplayNameTags. The name is then drawn separately and is not tied to the glow colour.

📋 Version Breakdown

📦 Install

Stop the server, replace the old jar in plugins/ with zCustomGear-2.8.0.jar, and start it again. Your sets, talismans and bags all keep working, and the new keys are added to your config.yml automatically.

Two things to have in place: PacketEvents for the glow, and CoreJobs 1.4.0 or newer if you want the job bonuses.

The example set file now ships with a CoreJobs xp multiplier in it. That only affects a fresh install using the example as it comes. Your own set files are never edited, so nothing changes on a live server until you add the keys yourself.