NimboPass is a fully season-based battle pass built for the EdSeries ecosystem (PinnaPrison, EdDungeons, EdTools, EdPets). It is completely self-contained: no Vault, no third-party battle pass core, no custom inventory code to maintain — the GUIs are 100% DeluxeMenus configs and all player data is exposed through PlaceholderAPI placeholders. If you run a prison, dungeons, tools or pets server and want a proper battle pass, this is it.
How it works
- Players complete quests to earn points, and points climb two parallel tier tracks: free and premium. Both tracks share the same points — the difference is what each can claim.
- Every tier references a reward defined in rewards.yml. Each tier grants its own rewards, and tier-up actions can also fire rewards when players level up.
- The premium pass is granted per player with /passadmin set pass <player> premium — hook your store (BuyCraft, Tebex, etc.) to that command and you're done.
- Claim validation happens server-side on the main thread: tier reached, not already claimed, correct pass. No duplicates from click / shift-click / drag exploits, by design.
Quest system
- 29 quest types out of the box: block mining, currency earning, backpack selling, sword damage, pet leveling, dungeon kills, bosses, playtime and many more — organized by plugin, each with its own filter variable (material, currency, mob, "any"...).
- Built-in playtime quests with no external dependency — server time is tracked natively and persisted per player.
- Exclusive quests: mark a quest as free-only, premium-only, or for everyone. Premium-exclusive quests don't even count progress for free players.
- Weekly phased unlock: set the season start date and each quest week unlocks automatically 7 days after the previous one. Quests from locked weeks accumulate zero progress — nothing can be pre-completed early.
- Quest completion can also run console commands, so a quest itself can hand out extra loot.
GUIs powered by DeluxeMenus
Five ready-to-use example menus ship with the plugin: main pass menu, free tiers, premium tiers, quest list and leaderboard. Copy them into DeluxeMenus, reload, done. Since everything is a DeluxeMenus config, you can restyle every icon, name and lore — quest items support progress placeholders like %total_progress%, %required_progress% and %progress_bar% directly in lore.
Placeholders (PlaceholderAPI)
- Points, tier, claims, quest progress, leaderboard positions and more.
- Every numeric placeholder has a _formatted variant: 10000 → 10k, 1500000 → 1.5M (suffixes and decimals configurable).
- Season countdown placeholders (%nimbopass_week%, %nimbopass_next_week_time%, per-quest unlock checks) make "unlocks in 2d 5h" timers trivial.
Commands & admin
- /pass — open the pass menu (or print stats in chat mode), plus stats, tiers, quests, leaderboard and claim subcommands.
- /passadmin — reload configs, grant/set points, give the pass to one player or everyone, reset players, start a new season, and inspect quest/season state.
- Player data is stored per UUID in playerdata/ with auto-save, plus a cached leaderboard that rebuilds on a timer.
Requirements
- Paper 1.21.x (Java 21)
- DeluxeMenus + PlaceholderAPI — required for the GUIs and placeholders
- EdSeries plugins are optional: PinnaPrison, EdDungeons, EdTools, EdPets. Missing plugins simply disable their quest types and reward types — everything else works normally.
All player-facing messages live in messages.yml with MiniMessage formatting, and every number, progress bar and menu title is configurable. Full documentation (English and Spanish) is included.