Vanguard - XPrison Addon v1.0

Vanguard — Battle Pass Enchant Addon for X-Prison​

Premium Addon for X-Prison Enchants

This plugin is a custom enchantment addon for the X-Prison Core.
It does NOT work as a standalone plugin and requires X-Prison (with the Battle Pass module) to function.

Click to expand...

---

What is Vanguard ?​

Vanguard is a pickaxe enchant that turns mining into Battle Pass progression — every proc pours bonus Battle Pass XP straight into your current season and races players up the tiers.

---

How It Works​

• On a chance-based proc while mining, Vanguard awards bonus Battle Pass XP to the player's current season.
• The XP amount scales with enchant level — higher level, faster progression.
• XP flows through the official Battle Pass API, so it respects XP boosters and fires the normal tier-up flow.
• Faster pass progression makes the Premium Battle Pass track far more tempting to buy — a built-in retention & monetization multiplier.

---

Graceful Fallback​

• If the Battle Pass module is disabled, or no season is currently active, Vanguard falls back to a configurable currency payout (default MONEY) of an equivalent amount.
• The enchant is never wasted — it always rewards the player.
• Built entirely on official X-Prison APIs — zero core edits, no replaced files. Installs and updates cleanly.

---

Configuration (JSON)​

{
"class": "dev.drawethree.vanguard.enchant.VanguardEnchant",
"id": 1101,
"rawName": "vanguard",
"name": "<gradient:#00E0FF:#7B2FFF>Vanguard</gradient>",
"enabled": true,
"increaseCostBy": "baseCost * pow(1.07, level)",
"maxLevel": 25,
"initialCost": 60,
"currency": "GEMS",
"pickaxeLevelRequired": 1,
"chance": 0.05,
"xpToGive": "5 + (level * 3)",
"sounds": true,
"message": "<gradient:#00E0FF:#7B2FFF><bold>VANGUARD</bold></gradient> <dark_gray>»</dark_gray> <white>+<aqua>%amount%</aqua> <white>Battle Pass XP",
"fallback": {
"enabled": true,
"currency": "money"
},
"prestige": {
"enabled": false,
"maxPrestige": 5,
"requiredActivationsFormula": "2000 * pow(10, prestige)",
"multiplierPerPrestige": 0.2
},
"refund": {
"enabled": true,
"guiSlot": 46,
"percentage": 50.0
},
"gui": {
"name": "<gradient:#00E0FF:#7B2FFF>Vanguard</gradient>",
"material": "EXPERIENCE_BOTTLE",
"slot": 46,
"customModelData": 0,
"description": [
"<gray>Every proc pours bonus <aqua>Battle Pass XP</aqua>",
"<gray>straight into your current season,</gray>",
"<gray>racing you up the tiers as you mine.</gray>",
"",
"<dark_gray>Falls back to a currency reward on servers</dark_gray>",
"<dark_gray>without an active Battle Pass season.</dark_gray>"
]
}
}

---

Requirements​

• X-Prison Plugin (version 2026.2.6.0 or newer)
• Battle Pass module enabled for the headline behaviour
• Java 17+
• Tested with Spigot, Paper, and Purpur (built for 1.21+)
• Works alongside other X-Prison enchant addons

---

Perfect for Driving Premium Sales​

Vanguard was designed with premium Battle Pass conversion in mind. You can easily:

• Use faster pass progression to upsell your premium track
• Sell the enchant itself via GUI shop
• Bundle it with premium ranks or donor perks

---

Installation​

1. Drop Vanguard.jar into your plugins/X-Prison/addons folder
2. Reload or restart your server
3. Use the in-game Enchant GUI to apply the enchant!
4. Configure the enchant to your liking under plugins/X-Prison/addons/Vanguard/vanguard.json

---

Support​

Need help or want custom enchants built?
Reach out via DM or join our Discord server.

​