Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
π AuricPass - The Ultimate Battle Pass Experience
AuricPass is a lightweight, highly customizable, and independent Battle Pass plugin for your Minecraft server. Reward your players with an engaging progression system, featuring both Free and Premium tracks, custom GUI designs, and a unique Prestige system!

π Dependencies
- PlaceholderAPI (Optional)
- Preference missions plugin (Required)
You can use the plugin the same way without a quest plugin, but you will need a way to deliver the XP with /auricpass xp give/remove/reset/check <player> <amount>
π¦ Installation
- Place
AuricPass.jarinto your server'spluginsfolder. - Start or restart your server.
- Configure AuricPass from the files generated in
plugins/AuricPass/.
π Updating
- For minor updates (for example,
1.1.0β1.1.1), simply replace the existing.jarfile with the new version and restart your server. - For major updates (for example,
1.1.0β1.2.0), back up your current configuration and any important plugin data, replace the.jarfile, delete the oldplugins/AuricPass/folder, and restart the server so the new files can be generated. - After the update, restore or reapply your previous configuration and review the new configuration options before continuing.
- If you're updating from 1.1.x or earlier, also check your permissions plugin. All
auricpass.commands.*permission nodes are nowauricpass.command.*(singular). See the Permissions section below.
β¨ Key Features
- Free & Premium Tracks: Offer a standard reward line for everyone and an exclusive premium line to monetize your server.
- Prestige System (Extra Rewards): The grind never stops! Players who reach the max level enter an infinite loop, earning "Extra Rewards" for every specific amount of XP they gather.
- Smart 6-Row GUI: Fully customizable menus with intelligent math-based pagination. Design your layout exactly how you want it.
- Advanced Item Customization: Every item in the GUI supports custom model data, hidden enchant glow, unbreakable items, and fine control over the vanilla tooltip. Gate any item behind a permission β hide it entirely for players who lack it, or let them see it but block interaction with a custom deny message.
- Standalone XP Economy: AuricPass uses its own XP system via commands (
/auricpass xp give). This means you can integrate it with ANY other plugin (Quests, MythicMobs, Crates) just by running a console command! - Season System: End the current season with a single command, automatically saving a backup. Restore any previous season instantly if needed. Fully configurable history limit.
- Advanced Command Execution: Rewards can trigger multiple actions. Use tags like
[console],[player],[message], or[close]to execute exactly what you need. - Hex Colors & MiniMessage: Create stunning visuals with RGB gradients and modern formatting.
- Real PlaceholderAPI Integration: All
%auricpass_*%placeholders work natively in any PAPI-compatible plugin. Supports per-player lookups like%auricpass_level_Steve%. PlaceholderAPI is completely optional β AuricPass has its own internal placeholder engine!
βοΈ Commands
/auricpass open [player]- Opens the GUI. (auricpass.command.open)/auricpass xp give/remove/reset/check <player> <amount>- Manage XP. (auricpass.command.xp)/auricpass premium give/remove <player>- Gives or removes the premium pass. (auricpass.command.premium)/auricpass season end/restore/list [name]- Manage seasons. (auricpass.command.season)/auricpass reload- Reloads config, languages and player data. (auricpass.command.reload)
π Permissions
You can also grant the premium pass with the permission auricpass.premium. The auricpass.admin node grants all sub-permissions at once.
auricpass.premium- Grants the player access to the Premium reward trackauricpass.command.open- Access to the command that opens the selected player's passauricpass.command.premium- Access to the command to give or remove the premium passauricpass.command.reload- Access to the command that reloads the settings and player dataauricpass.command.xp- Access to the XP command with all its variantsauricpass.command.season- Access to the season management commands
π Placeholders
Requires PlaceholderAPI for use in external plugins. The internal engine works everywhere inside AuricPass without it.
%auricpass_level%- Displays the player's current level%auricpass_xp%- Shows the XP the player has earned at their current level%auricpass_required%- Shows the total XP required to advance to the next level%auricpass_xp_left%- Shows the XP still needed for the next level%auricpass_premium_status%- Displays the player's status (Premium or Free)%auricpass_premium%- Returnstrueorfalsebased on the player's premium status
All placeholders also support per-player lookups by appending the player name: %auricpass_level_Steve%, %auricpass_xp_Alex%, etc.
π My Socials (Spanish Content / Contenido en EspaΓ±ol)
Note: My social media channels and community are entirely in Spanish! You are welcome to join, but please keep the language barrier in mind.


