Collections
A collection groups related resources, like ores under Mining or crops under Farming.
The structure
The plugin has two levels:
- A collection (also called a category) is a group, like Mining.
- A resource sits inside a collection, like Stone or Diamond.
Players open the main menu, pick a collection, then see every resource inside it. Each resource tracks its own progress and tiers.
What ships by default
Six collections come ready to use. You can edit, remove, or add to any of them in
categories.yml.
| Collection | Resources | Triggered by |
|---|---|---|
| Mining | Stone, Coal, Iron, Diamond, Bamboo | Breaking blocks |
| Farming | Wheat, Carrot, Potato, Sugar Cane | Harvesting crops |
| Hunting | Zombie, Skeleton, Creeper, Enderman | Killing mobs |
| Fishing | Cod, Salmon, Pufferfish, Tropical Fish | Catching fish |
| Lumberjack | Oak, Birch, Spruce, Jungle | Chopping logs |
| Divers | Playtime, Experience, Votes, Island Level | Running totals and stats |
How a resource is triggered
Every resource lists what counts toward it. There are five trigger types:
| Trigger | Counts when the player | Example |
|---|---|---|
BLOCK_BREAK | Breaks a listed block | Stone counts STONE and COBBLESTONE |
ENTITY_KILL | Kills a listed mob | Zombie counts ZOMBIE |
FISH_CATCH | Catches a listed fish | Cod counts COD |
EXP_GAIN | Earns experience | Lifetime XP, counted from install |
STAT | Reaches a stat value | Hours played, votes, island level |
The first three add one progress per action. EXP_GAIN and STAT track running totals or
polled stats instead, and power the Divers collection. See
Categories for how to set those up.
A single resource can listen for more than one block or mob. For example, Iron counts
both IRON_ORE and DEEPSLATE_IRON_ORE, so mining iron at any depth counts the same.
To learn how to change these or add your own, see Categories.