All Products / Minecraft / Plugins / zCollections | Collections & Rewards

v1.5.2: 1.5.2 | Modded content, subcategories, and the island membership lock

25 September 2026

zCollections v1.5.2
Modded mobs and items track on their own, collections can hold subcategories, and island level rewards can be put behind a membership wait.

🎣 Modded Mobs, Ores and Fish

A resource can now track a modded mob or item instead of a vanilla one, through MythicMobs for mobs and ItemsAdder for blocks and items.

This fixes modded content that shares a vanilla type underneath. A MythicMobs mob that is secretly a pig used to count for the pig collection as well, so killing it fed both. Now it only counts for the resource you set up for it, and killing a real pig only counts for the vanilla one. Same for ItemsAdder ores, wood and fish.

Use mythicmobs-types for mobs and itemsadder-ids for blocks and items. Both plugins are optional, and without them nothing changes.

📁 Subcategories

A collection can hold a group inside it now, so Fishing can contain a Pirate Dimension Fish group, each fish inside it with its own counter, tiers and rewards.

The group shows as a greyed out locked icon until a player catches one of its items, then it opens normally
Each entry inside unlocks on its own, and the rest stay locked
Back buttons walk the whole way out: a tier menu goes to the group, the group goes to the collection
Works the same in Mining, Farming and Hunting, with mythicmobs-types in place of itemsadder-ids for mobs

A ready to copy example is in the categories.yml header comment.

🖼 ItemsAdder Icons

Menu icons can be ItemsAdder items, so players see the real custom fish, ore or crop model instead of a plain vanilla stand in. Put itemsadder: 'namespace:item' next to a resource's material. Custom model data numbers work as icons too.

A wrong id falls back to the plain material and logs one warning, and without ItemsAdder everything looks as it did before.

🏝 Island Membership Lock

Island level rewards can now be held behind a stay on the same island, so nobody hops onto a high level island, claims everything and leaves.

Until the wait is done, the island level collection is not discovered at all and nothing in it can be claimed
Changing island, or having none, starts the clock again from zero. Every new island needs its own full wait, even for a player who has claimed tiers before
Once the wait is done the reached tiers unlock for good, and can be claimed later even after leaving
Claimed tiers stay claimed forever, so a player who claimed level 5 on one island can never claim level 5 again on another
On a new island with a higher level, only the extra tiers wait out that island's own clock
/collection island <player> shows the island the plugin sees and how long the player has been on it

Turning it on: add island-membership: 48h to your island level resource in categories.yml, right under material:, then run /collection reload. It is off until you do.

The plugin reads which island a player is on from island.placeholder in config.yml, which defaults to SuperiorSkyblock2's %superior_island_uuid%. Every player's clock starts the first time the plugin sees them after the update, so everyone waits once.

📦 Upgrading

Stop the server, replace the jar in plugins/ with zCollections-1.5.2.jar, start it again. Progress carries over with no reset, and config.yml, menus.yml and the language files update themselves while keeping your edits. categories.yml is never touched.

📋 Version Breakdown

Version	Focus
`1.5.2`	The wait now gates discovery of the island level collection, not just claiming, and every new island needs its own full wait.
`1.5.1`	Joining a high level island no longer unlocks the collection straight away.
`1.5.0`	The island membership lock, with claimed tiers staying claimed across islands.
`1.4.0`	Subcategories inside a collection, and ItemsAdder items or custom model data as menu icons.
`1.3.0`	MythicMobs and ItemsAdder tracking, so modded content stops counting toward the vanilla type it is built on.

Need help or found a bug? Join the Discord.
Join the Discord

Enjoying the plugin? A ⭐ review goes a long way!

v1.2.0: 1.2.0 | An action bar while you gather, and placeholders that follow the block

22 August 2026

zCollections v1.2.0
A live action bar while players gather, placeholders that show what a collection is counting toward, and a tidier claim.

📢 An Action Bar While You Gather

One line above the hotbar, refreshed every time a player breaks or catches something, showing the collection progress for that exact item: the resource name, the current total, a bar, what is needed for the next tier, and how much they just gained.

With a jobs plugin installed, the same line also carries the job that just paid, the xp and the money, so everything about the block a player broke sits together in one place. Break something that counts for two collections and you still get one line, not two fighting each other.

YAML

progress-actionbar:
  enabled: true

It ships off, so turn it on and reload. The bar itself is yours: length, filled and empty symbols, and both colours. The wording lives in your language file, and setting a line to '' hides that part.

Only one plugin can write to the action bar at a time. If your jobs plugin is still showing its own payment line there, the two will overwrite each other and blink. Switch its display off, or move it to chat, and let this line show both parts.

🔗 Placeholders That Show the Goal

A placeholder can now show what a collection is counting toward, not only the count, so a line reads 340/500 instead of just 340. Alongside _progress and _tier you now have _next, _remaining, _percent, _maxtier, _name and _category.

You can also name a block, a mob or a fish instead of a collection id, and the placeholder finds the right collection on its own:

Code

%zcollections_block_cobblestone_progress%
%zcollections_entity_zombie_tier%
%zcollections_fish_cod_next%

Cobblestone is not a collection of its own, it belongs to stone, and it is resolved for you. That means one line can follow a player from mining to woodcutting to fishing without a single collection name typed by hand.

A finished collection reads MAX rather than a stray number
A block no collection counts comes back empty, so the line goes quiet instead of showing a zero
_name uses your own collection names from your language file

Nothing you already wrote changed. The old placeholders work exactly as before.

🎁 A Tidier Claim

Claim All prints one tidy block in chat: a header line, then one line per tier showing the tier and the reward it paid, so a player sees exactly what they just claimed. Rewards and tiers used to be listed separately, which said the same thing twice.

The global Claim All button now lives on the main page only, rather than also appearing inside resource menus.

🖥 Menu Control

Pin an inline resource to an exact slot. A resource inside an inline: true collection can take its own slot: and page:, exactly like a collection does. Resources with no slot keep auto-filling around the ones you placed
Hide the close button per menu. Set close-button.enabled: false on any menu in menus.yml and players close it with Esc as usual. On by default
Back goes where you expect. Opening a resource from an inline category and pressing Back now returns straight to the main page, instead of stopping at an in-between menu first

📋 Version Breakdown

Version	Focus
`1.2.0`	Placeholders for the next tier and everything around it, plus block, mob and fish ids in place of a collection id so one line follows the player.
`1.1.0`	The progress action bar, showing collection progress for whatever was just gathered, with job xp and money alongside it.
`1.0.0`	Pinned slots for inline resources, a per-menu close button toggle, a tidier Claim All block in chat, and smoother back navigation out of inline categories.

📦 Install

Stop the server, replace the old jar in plugins/ with zCollections-1.2.0.jar, and start it again. Progress and settings carry over, the config files update themselves, and nothing needs resetting.

Need help or found a bug? Join the Discord.
Join the Discord

Enjoying the plugin? A ⭐ review goes a long way!