🌟 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

1. Place AuricPass.jar into your server's plugins folder.
2. Start or restart your server.
3. 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 .jar file 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 .jar file, delete the old plugins/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 now auricpass.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 track
• auricpass.command.open - Access to the command that opens the selected player's pass
• auricpass.command.premium - Access to the command to give or remove the premium pass
• auricpass.command.reload - Access to the command that reloads the settings and player data
• auricpass.command.xp - Access to the XP command with all its variants
• auricpass.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% - Returns true or false based 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.

• Subscribe to MIDAS YT on YouTube

🧪 Auric Tester Program

Get early access to upcoming Auric plugins and help test new features before their release.

Join if you're interested in testing plugins.

- No experience required, you can test only what you want and there's nothing to give in return. 👇