Milestones | By Omega Plugins

• Unlimited config-driven chains. One YAML file per milestone type in milestones/ — add a file, it loads on /ms reload. Ships with two polished examples: Farming (112 tiers: Farmer → Harvester → Cultivator → Harvest Lord → Agronomist → Crop Sovereign → Land Baron → Crop Emperor → Harvest Titan → Agrarian Overlord → Cosmic Cultivator → Harvest Deity → Stellar Sovereign → Void Harvester → Harvest God → Legend of the Harvest) and Playtime (75 tiers, hourly to 18h then every 12 hours to 35 days).
• Chained unlocking. requires: gates each milestone on previous ones being claimed. Claim a tier → chat announces the next unlock.
• Rewards = any console commands. The shipped files pay out via eco give, tokens give, credits, ocrates give, ac give — swap in any plugin's commands. Matching reward-display: lines keep the GUI honest.
• Two progress types. PLAYTIME (real-time tracker, seconds-based) and CROPS_HARVESTED (per-crop counters — omit material: to count all five crops together, or set material: WHEAT for a private per-crop chain).

The custom-hoe compatibility layer (the differentiator)
Four counting paths, all config-tunable in config.yml:

1. Normal uncancelled BlockBreakEvent (fully-grown crops only)
2. Cancelled breaks — for hoes that handle drops/replanting themselves (count-cancelled-crop-breaks, with optional one-tick verification cancelled-break-verify)
3. Vanilla right-click PlayerHarvestBlockEvent
4. Packet-hoe fallback — hoes that fire no event at all are caught by watching for crop item drops (count-crop-drops), with a strict surface check you can disable (require-crop-surface, default off)

Plus trust mode (trust-crop-break-events, default on) for hoes that replant before the event fires, and a dedupe window (dedupe-window-ms: 50) so hoes that fire duplicate events per crop can't inflate progress. /ms debug logs every seen crop event — counted or skipped, with reasons — so buyers can diagnose any hoe plugin in minutes. Seeds can never count: seed materials are on a permanent denylist even if a config names them.

GUI system

• Main menu: category buttons with per-category progress/{ready} in lore, optional glow when rewards are waiting, position overrides via category-slots:, auto-pagination
• Category pages: 54-slot menus, LOCKED (red) / IN PROGRESS (yellow) / UNLOCKED (green) / CLAIMED (orange) items, each with fully editable material, name, label, bar color and lore
• 15+ lore placeholders ({level} {name} {type} {status} {description} {current} {target} {unit} {percent} {bar} {rewards} {requires} {player} {page} {pages} {category}) — multi-line placeholders vanish cleanly when empty
• Viewer stats head: own skin, completed/total, progress bar, claimable count, auto-glow when rewards wait
• Two-tone filler frames (filler-accent: top-row/bottom-row/sides/corners), back arrow, page arrows, no empty air anywhere

Commands, permissions, placeholders
Command Perm Effect
/milestones · /ms milestones.use (default: true) Open the menu
/ms reload milestones.admin (default: op) Live-reload every config
/ms save milestones.admin Force-save all cached progress
/ms debug milestones.admin Toggle crop-event console logging
All 7 PAPI placeholders work for offline players too (lazy-load from disk): %milestones_progress_<id>% · %milestones_progress_raw_<id>% · %milestones_target_<id>% · %milestones_status_<id>% · %milestones_claimed_<category>% · %milestones_total_<category>% · %milestones_counter_<counter>%

Engineering & polish (worth stating on the page)

• Performance: the listener pays one precomputed set-lookup before any work — 99%+ of block breaks exit immediately; only real harvests reach the engine. Playtime ticks cheaply with no per-milestone storage (progress is always derived from one shared counter).
• Data safety: background autosave (default 300s) + save on quit + synchronous shutdown save + /ms save. Config versioning backs up outdated files as .old and regenerates them — updates never wipe a server's customization.
• Config niceties: master enabled: toggle that freezes counting/GUI/rewards instantly, log-rewards console audit of every payout, hex colors (&#FFAA00) everywhere, zero hard-coded strings.
• Extensibility: public thread-safe read-only API (MilestonesAPI) for other plugins, and the type system is documented for adding new milestone types (e.g. blocks broken, mobs killed) with one enum constant + one event-feed line.

Suggested FAQ for the page

• My economy/tokens/crates plugin? Yes — rewards are just console commands.
• Custom hoes? Built for it — four counting paths, dedupe, and /ms debug to verify.
• Own categories? Yes — every category is a YAML file in milestones/.
• Progress lost on restart? Never — three-layer persistence.
• AFK? Playtime counts real online time; hook the tracker tick if you run an AFK plugin.
• Spigot category: Miscellaneous (alternates: Economy if you lead with payouts, Utility if you lead with tracking).

IMAGES:
Main GUI:

Playtime GUI:
https://media.discordapp.net/attach...4201f89c7041190eb912b2&=&width=768&height=391
Farming GUI:
https://media.discordapp.net/attach...576850ff81848cd4ae154e&=&width=768&height=390

Dependencies
(Credit rewards) MultiEco > MultiEco | By Omega Plugins | SpigotMC - High Performance Minecraft Software (free)
(Crate rewards) Crates > Crates | By Omega Plugins (Not free)
(Money Rewards) Vault > Vault | SpigotMC - High Performance Minecraft Software (free)
(Tokens Rewards) ManticHoes (Not free)

Discord: https://discord.gg/KQcCjsGxQP