Placeholders
Show collection progress on scoreboards, tab lists, and holograms with PlaceholderAPI.
These only work if PlaceholderAPI is installed. Without it, the plugin skips placeholders and everything else still works.
The placeholders
| Placeholder | Shows |
|---|---|
%zcollections_total_progress% | The player's total progress across every resource |
%zcollections_discovered_count% | How many resources the player has discovered |
%zcollections_<category>_<resource>_progress% | Progress in one resource |
%zcollections_<category>_<resource>_tier% | Current tier in one resource |
Filling in category and resource
Replace <category> with a collection id and <resource> with a resource id, both from
categories.yml. For the default config:
| Placeholder | Shows |
|---|---|
%zcollections_mining_diamond_progress% | Diamond progress |
%zcollections_mining_diamond_tier% | Diamond tier |
%zcollections_farming_wheat_progress% | Wheat progress |
%zcollections_hunting_zombie_tier% | Zombie tier |
%zcollections_fishing_cod_progress% | Cod progress |
%zcollections_divers_playtime_progress% | Hours played |
%zcollections_divers_xp_tier% | Experience tier |
Stat-based Divers resources work the same way. For example,
%zcollections_divers_playtime_progress% returns the player's tracked hours played.
The ids are the keys in categories.yml, not the display names. For example, the
Lumberjack oak resource has the id oak_log, so its placeholder is
%zcollections_lumberjack_oak_log_progress%.
What they return
- A progress or tier placeholder returns a number.
- A resource the player has not discovered yet returns
0. - A placeholder that does not match any resource returns nothing.
Related pages
- Categories is where category and resource ids come from.
- Installation covers optional integrations like PlaceholderAPI.