X Prison Core v2026.2.6.2

X-Prison 2025.3.2 – Release Notes

Release Date: July 25, 2025

Fixes

• Autosell System: Resolved an issue where the autosell feature failed to sell items or provide rewards when players broke blocks in mines.

🛠 Improvements

• Message Formatting: Updated all plugin messages to consistently use currency amount and name placeholders, ensuring better compatibility with custom configurations and economy setups.

X-Prison v2025.3.1 – Release Notes
Currency System Update

• 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.
  

Related Addon

• 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.
  

Notes

• 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.

X-Prison - Update 2025.3.1
Major Changes & Improvements:

• 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.

Known Issues:

• Rank Multipliers Temporarily Disabled
  Support for rank-based multipliers has been temporarily removed and will return in a future update.
  

Command Changes:
New command structure for multipliers:

Code:

/gmulti [currency] [multiplier] [duration] [time_unit]
/gmulti [currency] reset

/pmulti [player] [currency] [multiplier] [duration] [time_unit]
/pmulti [player] [currency] reset

• Tab Completion Added
  Multiplier commands now feature tab-completion for easier usage and fewer errors.
  

Placeholders for multipliers were updated: https://github.com/Drawethree/X-Prison/wiki/Placeholders

Spoiler: multipliers.yml

YAML:

messages:
  multi_received: '&e&lMULTIPLIER &8» &7You''ve &e&lENABLED &7%currency% Multiplier x%multiplier% for %time%.'
  multi_reset: '&e&lMULTIPLIER &8» &cYour %currency% Multiplier was reset.'
# Rank Multipliers settings
ranks:
  god:
    tokens: 0.8
    gems: 0.8
    money: 0.8
  demigod:
    tokens: 0.8
    gems: 0.8
    money: 0.8
  premium:
    tokens: 0.8
    gems: 0.8
    money: 0.8
# Should the plugins check for LuckPerms groups instead of Xprison permissions?
use-luckperms-groups: true
# Interval for refreshing online players rank mulipliers in minutes
rank-multiplier-update-time: 5
currency-multipliers:
  money:
    global-max: 10.0
    player-max: 10.0
  tokens:
    global-max: 5.0
    player-max: 7.5
  gems:
    global-max: 5.0
    player-max: 7.5

X-Prison – Version 2025.3

Release Date: 23rd July 2025



Changes & Improvements:

• Default Configuration Clean-Up
  Minor fixes applied to default config files for improved clarity and consistency.

New Features:

• 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.

Deprecated:

• 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.
  

Always please check our WIKI for latest changes. I am always updating it.

X-Prison Update 2025.3
Major Changes

• 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 System Overhaul

• 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.

Enchant Messages

• Added new customizable messages for the following enchantments:
  • Layer
  • Nuke
  • Laser
  • Explosive

Spoiler: currencies.yml

YAML:

messages:
  invalid_currency: '&e&lCURRENCIES &8» &fInvalid currency name.'
  no_permission: '&e&lCURRENCIES &8» &fYou do not have permission to do that!'
  not_enough_currency: '&e&lCURRENCIES &8» &fYou don''t have enough %currency%'
  your_currency: '&e&lCURRENCIES &8» &fYou have &e%amount% &f%currency%'
  other_currency: '&e&lCURRENCIES &8» &e%player%''s %currency%: %amount%'
  withdraw_successful: '&e&lCURRENCIES &8» &fYou have withdrawn &e%amount% %currency%!'
  admin_set_currency: '&e&lCURRENCIES &8» &fSuccessfuly set &e%player%''s %currency% to &e%amount%.'
  admin_give_currency: '&e&lCURRENCIES  &8» &fSuccessfuly given &e%amount% %currency% to &e%player%.'
  admin_remove_currency: '&e&lCURRENCIES &8» &fSuccessfuly removed &e%amount% %currency% from &e%player%.'
  currency_redeem: '&e&lCURRENCIES &8» &eYou redeemed &f%amount% %currency%'
  currency_send: '&e&lCURRENCIES &8» &eYou have sent &f%amount% %currency% &eto &f%player%'
  currency_cant_send_to_yourself: '&e&lCURRENCIES &8» &fYou can''t send currency to yourself.'
  currency_received: '&e&lCURRENCIES &8» &eYou received &f%amount% %currency% &efrom &f%player%.'
  currency_received_console: '&e&lCURRENCIES &8» &fYou have received &f%amount% %currency%.'
  not_a_number: '&e&lCURRENCIES &8» &f%input% is not a number!'
  player_not_online: '&e&lPRISON &8» &fPlayer &e%player%  &fis not online!'
  currency_message_disabled: '&e&lCURRENCIES &8» &f%currency% Messages &e&lOFF'
  currency_message_enabled: '&e&lCURRENCIES &8» &f%currency% Messages &e&lON'
currencies:
  money:
    starting-amount: 1000000
    display-name: "Money"
    format: "#,##0.##"
    short-format: false
    trim-zeros: true
    prefix: "$"
    suffix: ""
    physical-item:
      material: PAPER
      custom_model_data: 0
      name: '&e%amount% &fMoney'
      lore:
        - '&e➥ &fRight-Click to Redeem'
  tokens:
    starting-amount: 1000000
    display-name: "Tokens"
    format: "#.##"
    short-format: true
    trim-zeros: true
    prefix: "⛃"
    suffix: ""
    physical-item:
      material: SUNFLOWER
      custom_model_data: 0
      name: '&e%amount% &fTokens'
      lore:
        - '&e➥ &fRight-Click to Redeem'
  gems:
    starting-amount: 1000000
    display-name: "Gems"
    format: "#.##"
    short-format: true
    trim-zeros: true
    prefix: ""
    suffix: ""
    physical-item:
      custom_model_data: 0
      material: EMERALD
      name: '&e%amount% &fGems'
      lore:
        - '&8➥ &fRight-Click to redeem'
currency-help-menu:
  - '&e&m-------&f&m-------&e&m--------&f&m--------&e&m--------&f&m-------&e&m-------'
  - '&e&l%currency% Help'
  - '&e&m-------&f&m-------&e&m--------&f&m--------&e&m--------&f&m-------&e&m-------'
  - '&e/%currency% balance [player]'
  - '&e/%currency% pay [player] [amount]'
  - '&e/%currency% withdraw [amount]'
  - '&e&m-------&f&m-------&e&m--------&f&m--------&e&m--------&f&m-------&e&m-------'
currency-admin-help-menu:
  - '&e&m-------&f&m-------&e&m--------&f&m--------&e&m--------&f&m-------&e&m-------'
  - '&e&l%currency% Admin Help'
  - '&e&m-------&f&m-------&e&m--------&f&m--------&e&m--------&f&m-------&e&m-------'
  - '&e/%currency% set [player] [amount]'
  - '&e/%currency% give [player] [amount]'
  - '&e/%currency% remove [player] [amount]'
  - '&e&m-------&f&m-------&e&m--------&f&m--------&e&m--------&f&m-------&e&m-------'
currency-command-aliases:
  - currency
  - curr
player_data_save_interval: 60

XPrison - Release Notes 2025.2.2
New Features

• 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

---

Improvements

• 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
  

Spoiler: mining-stats.yml

YAML:

mining-summary:
  enabled: true
  duration: 60
  number-format: SHORT # Options: RAW, SHORT
  message:
    - " "
    - "&e&m--------------------------------------------------"
    - "&6⛏️ &e&lYour Mining Summary"
    - "&e➤ &7Blocks Mined: &f%blocks_mined%"
    - " "
    - "&6&l⬥ Currencies Earned:"
    - "%currencies%"
    - " "
    - "&6&l⬥ Enchant Procs:"
    - "%enchants%"
    - "&e&m--------------------------------------------------"
    - " "
  currency-format: "&a  ➤ &f%currency%: &b%amount%"
  enchant-format: "&b  • &f%enchant% &7x&3%count%"

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.

X-Prison v2025.2 – Dynamic Currency System Update

Core Changes

• 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.
  

---

API Changes

• 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.
    

---

Benefits

• 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