
⛏️X-PRISON⛏️ 2025.4.0.4
Everything Your Prison Server Needs – In One Plugin.
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
- Support of latest X-PrisonAPI snapshot
- Balanced all default enchantment JSON configurations
- Support of latest X-PrisonAPI snapshot
- https://github.com/Drawethree/X-PrisonAPI
- Default explosionType for explosive.json enchant is now SPHERE
- WorldEdit is no longer required as a dependency!