
⛏️X-PRISON⛏️ 2025.3.7
Everything Your Prison Server Needs – In One Plugin.
🚀 X-Prison Update: 2025.3.7
Improvements & Fixes:
🛠️ Fortune Enchant Fixes:
Resolved a long-standing issue where Nuke, Laser, Explosive, and Layer enchants were not properly granting currencies through the Fortune enchant. These enchantments now correctly contribute to your earnings, as intended.
Enjoy smoother mining and more accurate currency generation!
🛠 X-Prison 2025.3.7 – Release Notes
Release Date: July 29, 2025
🔧 Fixes
Fixed auto-sell issues, especially with non-item materials like water and unformable blocks that were causing console exceptions.
Resolved multiple bugs in event handling, improving overall system stability.
✨ Improvements
Bombs can now be thrown by right-clicking in the air, making their use more intuitive.
Currency items (tokens, money, etc.) can now be redeemed by right-clicking in the air, no block targeting required.
🎨 Additions
Added resource pack for Pickaxe Skins into download
-
🔍 Robots Finder Enchant (NEW!)
In celebration of the upcoming X ROBOTS Plugin, we’re introducing a brand new enchant: Robots Finder!-
Equip this enchant on your pickaxe to discover robots while mining.
-
The higher the enchant level, the greater the chance of uncovering rare robotic companions!
-
Perfect for players looking to gear up for the X ROBOTS update.
-
As always, thank you for playing and supporting X-Prison. 💙
X-Prison 2025.3.5 – Release Notes
Release Date: July 27, 2025
✨ What's New
Full Module Handling Refactor
Reworked the internal module system for improved stability, scalability, and performance. This lays the groundwork for future features and better plugin integrations.
🛠️ Bug Fixes
Enchantments
Resolved multiple issues affecting the behavior and reliability of certain enchantments, ensuring more consistent gameplay.
- Pickaxe Skins Module: Introduced a brand-new system for customizing pickaxe appearances using skins.
- Enchant GUI Integration: Added a new "Skins" item to the Enchant GUI that opens the Pickaxe Skins interface.
- pickaxe-skins.yml Configuration: New configuration file with default skins definitions and options for customization.

-
Improved Currency Hook Compatibility:
Resolved issues with handling external currency systems, specifically:-
Vault
-
CoinsEngine
-
-
Default Message Updates:
-
Refreshed default messages for:
-
AutoSell
-
Bombs
-
Enchants
-
-
Messages now offer improved clarity and formatting.
-
-
Sell Price Editor GUI Enhancements:
-
Updated GUI elements to display currency names and formatted amounts for better readability and consistency.
-
-
Autosell System: Resolved an issue where the autosell feature failed to sell items or provide rewards when players broke blocks in mines.
-
Message Formatting: Updated all plugin messages to consistently use currency amount and name placeholders, ensuring better compatibility with custom configurations and economy setups.
- ✅ Updated to latest Currency API changes for improved flexibility and third-party integration.
- This update enables full support for external currencies like Vault, through the new XPrisonCurrencyHandler system.
- Internal logic now properly delegates to external handlers when defined, allowing custom economy hooks.
- Released new addon: X-Prison Vault Economy Hook
➤ Seamlessly integrates Vault-based economy as an X-Prison currency.
➤ Perfect for using EssentialsX, CMI, or other Vault-supported plugins inside modules like AutoSell and Enchants.
- This update affects currency handling logic internally. If you're using custom currencies or third-party integrations, please ensure they implement the new handler structure.
- No changes are needed for default users — everything continues to work out of the box.
-
Full Refactor of the Multipliers Module
The entire multipliers system has been overhauled for improved flexibility, performance, and future expansion.
-
Per-Currency Global Multipliers
Global multipliers can now be set independently for each currency type. -
Per-Currency Player Multipliers
Player multipliers now also support separate values for each currency. -
Enchants Adapted to Player Multipliers
Enchants now correctly calculate currency rewards based on the player's active multipliers.
-
Rank Multipliers Temporarily Disabled
Support for rank-based multipliers has been temporarily removed and will return in a future update.
-
✨ Tab Completion Added
Multiplier commands now feature tab-completion for easier usage and fewer errors.
-
Default Configuration Clean-Up
Minor fixes applied to default config files for improved clarity and consistency.
-
Per-Currency Max Amount Cap
You can now define a max-amount for each currency individually in the config, allowing precise control over balance limits.
-
number-format Removed from Mining Stats
The number-format option in the mining summary section is no longer used.
→ It now respects each currency's individual formatting (format, short-format, etc.), for a more consistent and centralized configuration experience.
- Removed Tokens & Gems Modules
- Deprecated tokens.yml and gems.yml configuration files.
- All previous Tokens and Gems data have been reset due to this structural change.
- Replaced with the fully dynamic and unified Currency Module.
- Vault Economy Removed
- Vault is no longer a dependency.
- A default "money" currency is now defined directly within the new Currencies system.
- No need for external economy plugins — currencies are handled natively by X-Prison.
- Currency Module Fully Implemented
- Supports custom, dynamic currencies with full integration into the plugin’s economy logic.
- GUI Integrations
- Added Currencies Section to both the Main Menu and Help GUI.
- Enchanting interfaces (Enchant / Disenchant GUIs) now support configurable currency items.
- History Tracking
- The History Module now logs all currency changes per player, allowing detailed tracking and rollback options.
- Added new customizable messages for the following enchantments:
- Layer
- Nuke
- Laser
- Explosive
- Added support for H2 Database integration.
- Default database system switched to H2 for improved performance and ease of setup.
-
🪓 Mining Statistics Module
Introduced a brand-new mining summary system:-
Displays blocks broken, earned currencies, and enchant procs
-
Fully configurable in mining-stats.yml
-
Shown to players on a timed interval
-
-
💣 Bomb Fuse Particles
Bombs now emit smoke particles before exploding, giving a visible fuse countdown effect
-
Removed XP Drops from Blocks
Breaking blocks will no longer drop experience orbs, improving performance and reducing clutter -
Unified Summary Broadcast
The previous autosell broadcast task has been removed
➜ All earnings are now sent as part of the mining statistics message -
API Compatibility
Adapted internal codebase to align with the latest XPrison API changes
🔥 X-Prison v2025.2.1 – Mine Bomb Enhancements
Release Date: July 21, 2025
✨ New Features
-
Right-Click Bomb Throwing
Players can now throw mine bombs using right-click, adding a more intuitive and dynamic way to use them.
🛠️ Improvements
-
Bomb Display Name on Use
Mine bombs now correctly show their custom display name when thrown or dropped, improving clarity and player feedback. -
Updated
bombs.yml
Defaults
The default configuration file (bombs.yml
) has been refreshed to include more up-to-date and balanced settings.
-
🔥 Removed: use_tokens_currency from prestiges.yml and ranks.yml.
-
✅ Replaced with a new flexible currency setting that supports any registered currency.
-
-
🪙 Added: currency-name field in tokens.yml and gems.yml.
-
➕ Allows renaming currencies to match your server theme (e.g., "Credits", "Crystals", etc.).
-
-
🛠️ Added: currency configuration option to:
-
autosell.yml
-
ranks.yml
-
prestiges.yml
-
🎯 This defines which currency is used per feature, giving you full control over economy design.
-
-
🧩 Adapted all core systems to support the new dynamic currency API.
-
🆕 Introduced XPrisonCurrencyAPI
-
📚 Allows developers to register, retrieve, and manage custom currencies via code.
-
-
🧹 Removed CurrencyType enum
-
🧼 Cleaned up in favor of the new XPrisonCurrency interface-based system.
-
-
❌ Removed XPrisonGemsAPI and XPrisonTokensAPI
-
🗑️ Deprecated and replaced by the unified XPrisonCurrencyAPI.
-
-
🎨 Fully customizable currency names and logic
-
🔌 Developers can easily hook in their own currency systems
-
📂 Cleaner configuration files with per-feature currency control
-
🛠️ Stronger, more scalable core economy architecture
- Small bug fixes to improve stability and consistency
- Internal code cleanup and optimization for better performance
- Updated dependency versions to ensure better compatibility between minecraft versions
-
Updated all default enchant configurations to improve balance and functionality.
-
Redesigned the Enchant / Disenchant GUI, now featuring separate sections for TOKENS and GEMS enchants for easier navigation.
-
Added new messages and item configurations to enchants.yml to enhance customization options.
- Addon System Implementation
A modular addon system has been introduced! You can now:- Drop .jar addons into plugins/X-Prison/addons
- Register custom enchants, features, or modules without modifying the core
- Use X-Prison-Addon-Class in MANIFEST.MF to define entry points
- Manage addon metadata like name, author, description, and version
- Easily enable/disable addons via GUI or command (GUI support in progress)


- Updated to Support Latest X-Prison API
- Full compatibility with the latest Spigot 1.21.7 API
- Updated internal APIs for enchants, events, and hooks
- Ensures stability with modern plugin environments
- Addons must implement XPrisonAddon interface with onEnable() and onDisable() methods.
- Include a MANIFEST.MF with X-Prison-Addon-Class and optional metadata:
properties