FAQ
Short answers to the questions that come up most. Click a question to expand it.
Most "is this broken?" questions are actually a feature working as designed, like the anti-exploit checks. If you are still stuck, head to Support.
Gameplay
Does breaking one block with Fortune count as more than one?
No. Progress counts actions, not items. One block broken is +1, whatever enchantments you use. See Progression.
I placed blocks and mining them gives no progress. Is that a bug?
No, that is the placed-block check. Resources with ignore-player-placed: true skip
blocks the player placed, so you cannot farm progress by placing and breaking. See
Anti-exploit.
Breaking crops gives no progress.
Some crops only count when fully grown. Wheat, Carrot, and Potato use this check by default. Let them grow fully before harvesting. See Anti-exploit.
Setup and config
Money rewards are not paying out. Why?
First, by default rewards must be claimed. Reaching a tier makes it claimable, not paid, so
open the resource in the menu and click the tier (or use the main-menu Claim All button). To pay rewards the moment
a tier is reached instead, set rewards.mode: auto in
config.yml.
If they still do not pay, money rewards need Vault and an economy plugin. If either is missing, money rewards are skipped and the rest still work. Install Vault and an economy plugin, then reload. See Tiers and Rewards.
How do I change rewards or thresholds?
Edit categories.yml, then run /collection reload. No
restart needed.
How do I change the language or the messages?
Set language in config.yml to pick a built-in language, or
edit the file in lang/ to change the wording. Reload after. See
Messages and Language.
My config edits disappeared after an update.
Check that you did not change the *-version line at the top of the file. That line
controls automatic updates. Leave it alone and your edits are kept. See
Configuration.
Will it run on my Minecraft version?
It targets the 1.21 line and needs Java 21. See Installation for the full requirements.
Placeholders
How do I show progress as 340/500 instead of just 340?
Pair _progress with _next, which is the total needed for the next tier:
%zcollections_mining_stone_progress%/%zcollections_mining_stone_next%
Once every tier is done, _next shows MAX instead of a number. See
Placeholders.
My placeholder shows nothing. What did I get wrong?
Usually the ids. %zcollections_<collection>_<resource>_progress% needs the ids from
categories.yml, not the display names, and not the block
name. Cobblestone, for example, is not a resource: it is one of the blocks the stone
resource counts.
If you want to name the block instead of the resource, use the by-block form, which looks it up for you:
%zcollections_block_cobblestone_progress%
That one returns nothing on purpose when no collection counts the block, so the line goes quiet on unrelated blocks.
Can one line follow whatever the player is breaking?
Yes. Use %zcollections_block_<material>_...% and feed it whatever token the plugin drawing
the line gives you for the block. See
Jobs Reborn.
Data and admin
Can I share progress across several servers?
Yes, switch storage to MySQL and point every server at the same database. See Storage.
A reset removed the wrong progress. Can I undo it?
No, resets cannot be undone. Be careful with /collection reset, and use a category name
to limit it to one collection. See Commands.