Prison v3.2.9

v3.2.9 - Prison Update - Enhancements to blockEvents, placeholders, support, and events

• Prison now has new commands to help provide better support and can be found under: /prison support These commands will be expanded to help make it a lot easier to get help on many issues that could be configuration based. Prison is now able to help sent some information to https://paste.helpch.at. These tools also cleans up a lot junk in the log messages so they are easier to read.

• Added a new utility feature to prison: block decays. This allows blocks to change types when they are mined. Two defaults are an obby decay and rainbow decay. Plus there is a blocks tool that will allow a custom list of blocks, as many, or as few, as you like. https://youtu.be/y4vmeC0aPIc

• Added 18 new placeholders that are focused on all ranks that are on the server. Now if you use a rank name with these placeholders, you can access almost all rank information that is available, including how many players are at a specific rank, or a list of mines that are linked to a rank.

• Rewrote how event listeners are setup in Prison to optimize them. Created tools to inspect them to help with troubleshooting. Made significant improvements.
  /prison debug blockBreakListeners

• Enhanced Prison's delayed start to better integrate with CMI's Economy without sacrificing prison's advanced startup validation of existing ranks.

• Added many new placeholders for the use within the prison commands ladders, ranks, mines, and blockEvents. Each type of these commands now has custom listings of all placeholders that will work in those areas. This large expansive set of placeholders should be able to provide the greatest amount of flexibility in customizing your servers. Use the following commands to review the latest listings:

/ranks ladder command add placeholders
{player} {player_uid} {msg} {broadcast} {inline} {inlinePlayer} {sync} {syncPlayer} {firstJoin} {balanceInitial} 
{balanceFinal} {currency} {rankupCost} {ladder} {rank} {rankTag} {targetRank} {targetRankTag}

/ranks command add placeholders
{player} {player_uid} {msg} {broadcast} {inline} {inlinePlayer} {sync} {syncPlayer} {firstJoin} {balanceInitial} 
{balanceFinal} {currency} {rankupCost} {ladder} {rank} {rankTag} {targetRank} {targetRankTag}

/mines command add placeholders
{player} {player_uid} {msg} {broadcast} {inline} {inlinePlayer} {sync} {syncPlayer}

/mines blockEvent add placeholders
{player} {player_uid} {msg} {broadcast} {inline} {inlinePlayer} {sync} {syncPlayer} {blockName} {mineName} 
{locationWorld} {locationX} {locationY} {locationZ} {coordinates} {worldCoordinates} {blockCoordinates} 
{blockChance} {blockIsAir} {blocksPlaced} {blockRemaining} {blocksMinedTotal} {mineBlocksRemaining} 
{mineBlocksRemainingPercent} {mineBlocksTotalMined} {mineBlocksSize} {blockMinedName} 
{blockMinedNameFormal} {blockMinedBlockType} {eventType} {eventTriggered} {utilsDecay}

• Upgraded the behavior of all command tools within prison to use row numbers when workig with commands, instead of having to reenter all of the commands.

• Added block filtering to BlockEvents so events can now be filtered by blocks now.

• /ranks autoConfigure has been enhanced to provide more functionality when forcing auto configure to run. This will now try to fully incorporate preexisting ranks and mines as much as possible. Preexisting mine liners will not be replaced, but block listings for the mines will be replaced with the defaults.

• When starting up prison when no mines and no ranks exist, prison will now print a few messages to the console to help direct new admins on how to configure prison.

• GUIs are being rewritten to improve performance and improve the behavior.

• SELLALL has had some significant performance improvements.

Prison v3.2.8 - Spigot 1.17 and Java 16 Support

This release fully supports Spigot 1.17 and Java 16.

Note: A bug was discovered and fixed so the internal version tied to this release is actually v3.2.8.1.

Many aspects of Prison was updated to prepare for the Spigot 1.17 and Java 16 release. Dependencies and libraries were updated. Code was changed.

• Many resources and tools that prison uses has been updated to the most recent releases to help ensure the best compatibility with Spigot 1.17 and Java 16. This also helps support some of the newer updates in other plugins.

• Prison now uses Prison's New Block Model to ensure that you always have access to all blocks that are valid on the version of Spigot that you are running. Prison uses Cryptomorin's XSeries to help ensure block compatibility and support from Spigot 1.8 through Spigot 1.17. All mines are auto updated to the newer block names and there should be no obvious changes in existing mines. New blocks should be seen in /mines block search.

• All messages within the Ranks Module have been externalized and can now be customized. Other parts of prison will be externalized in future releases, but ranks are completed. Prison is now able to auto update the language files based upon internal versioning of those files. Prison also has the provisions in place to prevent auto updating these language files, which is helpful when customizing the existing files to fit your server's themes.

• Many bug fixes and core changes to improve stability and reliability. To help with support, more internal debugging tools have been added to help troubleshoot issues when someone has challenges to get Prison to work with other plugins.

• Enhanced support for the CMI plugin Economy. Prison is able to deal with CMI's delayed activation so prison can properly perform it's pre-flight checks to ensure Ranks is properly hooked up and active.

• A General Request for Help: Are you a native speaker of another language? If so, we could use your help in providing new translations for the new Rank language file. Contact Blue or another Prison Discord staff to get it added to the next build.
  plugins/Prison/module_conf/ranks/lang/en_US.properties

Prison v3.2.7

NOTICE : v3.2.6 had a issue with performance and release v3.2.7 fixes it

Significant changes to prison for improving support related commands. The following commands are now recommended to be used to help provide details for troubleshooting.

/prison version all
/mines stats
/mines reset *all*
/mines list
/mines info <mineName> all
/mines stats

/ranks ladder list
/ranks players all all
/ranks list <ladderName>
/ranks info <rankName> 
/ranks command <rankName>

• If a mine is taking too long to reset, /mines info now includes a warning and recommends enabling Mine Reset Paging.

• For all players on the server, force rank changes with one command.
  Can use the command as /ranks set rank *all* *same* to reset all player's ranks to their current rank.

• Bug Fix: The new Mine Sweeper was added in the last release, but was accidentally always enabled. This was fixed.

• Significant changes and fixes for backpacks. New size permission, limit set, and stability improvements.
  The new backpack storage system requires manual intervention to update the data; until the old backpack is opened, the admin commands won't work. If there are backpack issues that won't resolve, then the data storage file that contains all player's backpack data must be deleted (total loss of player's contents). The file is located within plugins/Prison/backpacks/backPacksData.yml.

• Updated a few repos to their more recent releases

• Changes to player teleport to prevent looping and locking a player in place.

• Enhance how the new block model is setup to make for an easier transition to using it.

Prison v3.2.6

This is the last bug release for the v3.2.x series. The next minor release will be v3.3.0 and will start to include the long awaited support for multi-language support. We will also keep including many exciting new features like we have with the last 18 months. As a word of caution, these future release may no longer be compatible with Prison's v3.1.1 release; it is planned to make the very much needed changes to file formats for the save files for the ranks, ladders, and maybe even the players. At this time, if you are running v3.2.6 there is a very good chance you can revert back to a prior release, all the way back to v3.1.1.

With this release we have introduced our first Prison event that we are firing before we actually update the block state from within the Auto Manager (auto pickup, or even handling of normal drops from within prison). This event is named tech.mcprison.prison.spigot.api.PrisonMinesBlockBreakEvent and will pass along many of the prison internals. API support has been added to support for sellall and backpacks. Moving forward we will be adding other important events that can help with customizing prison in many new and exciting ways, and to also make such customizations much easier since you will have direct access to our internal objects without going through hoops trying to locate them.

With this being the final bug release for the v3.2.x series, the addition of new items have been kept to a minimum and has been mostly focusing on stability.

With this final release, the following have been addressed and/or added:

• Significant enhancements and fixes to backpacks, sellall, and gui. Backpacks can now be disabled in specified worlds, and can have the size set/changed. Backpacks now have a new admin GUI.

• Prison's BlockBreak listeners will now only register if prison's mine module is enabled. The auto features will be disabled without the mine module.

• Prison now supports configuration settings for the listeners for BlockBreak related events. Supported levels are LOWEST, LOW, NORMAL, HIGH, HIGHEST, and DISABLED. Disabled will prevent the related features from working by never registering a listener. MONITOR is not supported since it is not recommended to change block states at this level. To change these settings please see the configuration file plugins/Prison/autoFeaturesConfig.yml under options.blockBreakEvents.*. The default values are LOW.

• New sanity check to require confirmation when creating a mine, or changing the size of a mine, to a size greater than 20,000 blocks. It was reported by one user that they accidentally messed up and had one point set in a previous mine, then set a point in the new mine which resulted in the destruction of a lot of their builds due to the large size the new mine. This sanity check will hopefully prevent possible errors like this.

• Placeholders have been changed to be case insensitive when performing replacements. This may help improve matching and identification of placeholders. These changes will not improve unicode matching.

• Double registering prison's placeholders with PAPI (PlaceholderAPI) so as to make it easier to use placeholders. Ever since Prison v3.2.0 placeholders were registered as all lowercase and the documentation has always clearly identified that this is the case, but few read the documents and/or stuck in trying to use all uppercase. Now uppercase usage will have better chance of working smoothly so there will be a lot less support issues raised.

• Added SellAllUtil to the Prison's API. Backpack admin GUI can now be accessed through the standard admin gui. The player GUI has support for more internal placeholders for more customization.

• The Minepacks maven repo was offline for a log time and was producing many build failures. Due to the instability of their maven repo, the generated jars were added directly to the project and the maven repo was disabled. The future prison builds will not be impacted by such repo failures from that repo again.

• Added PrisonMinesBlockBreakEvent to all auto manager event handlers. This allows the processes to be canceled and provides a wealth of internal objects to any other plugin trying to use this event. This could make it a lot easier to write customized plugins or to change the behavior of prison. This event is fired before actual updates are applied and after all of the other features have been filtered.

• Starting to add PrisonMinesBlockEventEvent class that will be fired prior to the BlockEvents. It will not be enabled until a future release.

Prison v3.2.5

Many new features and updates

• New support for mcMMO and EZBlock

• Updated support for Token Enchant, zenchantments, and Crazy Enchants. Hooked up Mine Packs to work with auto pickup and sellall.

• New Mine Access Permissions feature - Simplifies use of WorldGuard regions (can use without WG regions too so less to configure)

• Backpacks - major updates

• Sellall - major updates

• Auto features - Major rewrites and fixes. Most of the code has been refactored and duplication has been eliminated. Fixed and enhanced use of xp, durability, and wear. Auto features now supports "normal" drops using prison's internals and behaves as auto pickup does now. Improve the inventory overflow and hooks in to autosell. New feature to allow autosell to be triggered on each block break.

• Redesigned prison's command handler to be able to use common handler. Now supports more placeholders and custom placeholders for rank commands.

• Setup about 98 default items for the sellall shop. The sellall shop now covers all items within the default items within the auto configured mines.

• Many changes to GUIs

• Mines now support block counts and they are not accurate even with explosion events

• Simplified the prison startup details by removing a ton of color codes. The color codes where making it impossible to read the detail in the log files. Also removed a lot of non-active details, which can be seen with extended features through /prison version all.

• Added new /prison utils commands and features.

• Added a new feature called Mine Sweeper that will sweep all blocks within a mine and make sure the counts are updated correctly. This feature should never be used since it can have a very high overhead. But if you are using an enchantment plugin that cannot be supported by prison, then it's a viable option.

• Many other small fixes and enhancements to make prison more stable, but better overall.

Prison v3.2.4

Many new features and updates

• Many updates to the GUI and Sellall. Many new features and many new ways to customize them.

• New settings for BlockEvents to better control when they are fired and what filters can be set. Now supports Token Enchant Explosion events and Crazy Enchant explosion events. Its now much easier to control events based upon mining. Ability to filter on block types will be added soon to the alpha release.

• New Feature: Placeholder attributes. Allows very flexible formatting of almost any placeholder. Supports 32-bit hex colors even in other plugins that do not support them yet. Attributes can custom format numbers or even some text. Allows customization of bar graph placeholders within the placeholder so multiple bar graphs could all have different formatting.

• New feature: Prison utilities. These are small self contained utilities that can be used within rank commands, mine commands, or event block event commands. They can also be used outside of prison. Generally these will be functions that may not exist or cannot be ran from the console, such as repairing player's tools, weapons, or armor.

• New Feature: Mine constraints. It's now possible to specify a max number of blocks of a specific type that will be added to a mine during a reset, or ensure a min number are generated. Also you can now restrict blocks to spawn in certain bands by excluding them from top and/or bottom layers.

• Many new placeholders. Now listed on PAPI's wiki.

• Reworked the auto manager's fortune. Now supports unlimited levels.

• Now supports the Mines Backpacks plugin.

• New Feature: Internal Prison Backpacks! This is a work in progress, but is initially functional. Keep an eye on the alpha releases to get the newest features.

• Where possible, mine tags are now used in most interfaces so formatting can be enjoyed.

• Hooked up block counts to each mine. Now each mine will track how many blocks have been mined. Placeholders will be added in the future to access this information outside of prison.

• Reworked a lot of the internal permission handling. Simplifies internal code and adds new features. Setting up prison for more advanced features.

• Lock players out of being able to list all of the prison's commands.

• Prison placeholders no longer needs to be reloaded when papi is reloaded.

• Sellall now supports multiple permission based multipliers.

• Sellall now supports the use of sellall signs.

• Now can TP to a mine's spawn, or directly to the mine itself. Also the command /mines tp <mineName> has a new short cut /mtp.

• New Feature to reset all mines at the same time. /mines reset help. /mines reset *all* details' When chaining all the mines together with the resets, it disables the running of any mine commands to prevent endless loops.

Prison v3.2.3

Many new features and updates.

New Features:

• New Placeholders:

  • Rank number - (4)

• BlockEvents - Fire multiple events when breaking blocks in mines. Includes percent random chance, permissions, option to run inline or submit as a synchronous task, and link to block break events and/or TokenEnchant Explosion events.

• Mine Liners - Now is saved with the mine so when moving or resizing mines it will now auto regenerate the liner.

  • Mine Liners are now added to mines when running /ranks autoConfigure

• Many enhancements to the GUI, sellall, autosell, etc...

  • Sellall now supports permission based multipliers
  • Sellall now supports sellall signs

• Many bug fixes and performance improvements

• Initial support for 32-bit hex colors in v1.16.x clients

• Internal work:

  • new block model is almost fully functional
  • Improvements to player handler
  • Additional support for many new blocks with the old block model

Prison v3.2.2

Many new features, updates, and performance improvements, with bug fixes too.

• Major improvements to the prison command handler:

  • New Feature: Ability to assign one or more aliases to a prison command to make it easier to use. Example: the gui /mines and /ranks for players.
  • New Feature: Now supports tab completions for spigot v1.8 through v1.16.
  • Found a couple bugs in command registration and fixed them.
  • Display of sub commands now shows alias details for commands
  • The primary command /prison now shows all of prison's root commands including any aliases

• Major New Feature: /ranks autoConfigure which works on new installs of prison. Cannot have any defined mines or ranks.

  • Creates all ranks and virtual mines from A through Z and links them together.
  • Assigns the basic rank commands for each rank to add perms for the players
  • Auto generates blocks for each mine with increasing value from A to the most valuable blocks for Z

• Major New Feature: /mines set size will resize a mine by a number of blocks.

  • Directions are top, bottom, north, east, south, west, and walls. Using walls with a positive number increases size in all horizontal directions by that number of blocks. A negative number decreases its size.
  • Has the ability to "heal" the surrounding area when resizing so as to prevent voids from being left behind
  • Can use this command to move mines

• Major New Feature: /mines set liner will wrap a mine with a 2D pattern in a 3D space.

  • Adds walls and floor to the outside of a mine.
  • Adds ladders to the walls of the mine
  • Supports 9 different interesting patterns with more to be added
  • The liner auto wraps where other blocks (ie. the ground) touches the mine. It has the command option of /force to wrap the mine fully along the specified edge; this is useful when the mine is in mid-air, such as when placing it in a void world.

• New Feature: /mines set tracer clears a mine and draws the outline of the mine with pink stained glass. This gives a great ability to see the full mine and is used with the other new commands /mines set size and /mines set liner.

• New Feature: Can now set a mines area based upon your feet location when using the /mines set area feet. This is useful in void worlds where you cannot click on any blocks with the wand. This will auto generate a 1 x 1 x 1 mine that can then easily be resized with /mines set size command.

• Added a lot (over 100) of new block types for v1.16, v1.15, and v1.14 to the old prison block model. Still missing a few.

• Significant improvements to the gui's language support and support for permissions

• Bug fix: Delete mines works correctly now.

• Bug fix: /ranks list works with perms

• New feature: Mines now have tags! They have their own placeholders too.

• Many new placeholders related to mines, ranks, and even high bred player-mine placeholders that provide mine related placeholder details based upon which mine the player is actually in.

  • Prison now supports 102 base placeholders, including their aliases (shortened placeholders)
  • Placeholders for mine and ladders will have a dynamically created placeholder for each ladder and mine

• New feature: Ability to rename mines

• New Feature: Complex sorting of mines for /mines list and also the gui. Can define sort order of each mine, or to suppress a mine from the listing, which is helpful for child mines if building a parent/child relationship for mines.

• Bug fix: Corrected refund amount when using /rank demote on a player.

• Bug fix: Fixed issues with using vault. There was an issue when using different versions of vault due to a change in their api.

• New Feature: New command to move ranks on a ladder. /ranks ladder moveRank. Makes it easier to change their order.

• Added a warning if PlugMan is being used. Prison cannot be reloaded by plugman; must restart server.

  • The command /prison placeholders reload will reload the placeholders so you don't have to restart the server.

• New Feature: Mines can be linked to Ranks now!

• New Feature: Added a plain type for logging messages. This eliminates "| info |" on mine reset notifications.

• New Feature: Added a few API commands to prison to make it easier for other plugins to modify and get information on ranks and mines.

• New Feature: Link ranks to Mines. This is not used yet directly, but will help allow for automation when changing or configuring mines and ranks in the future.

• New Feature: Virtual Mines! This is a major addition in that it adds a ton of flexibility to help auto configure the whole prison plugin. You can even create virtual mines in the console, configure everything, then just go online to set the location.

• Internal improvements on managing various managers and registration of commands.

• Improvements to error handling on logging if there are issues.

• Bug Fix: Fixed issue with usage of /mines wand. Players were reporting that they would trying to get a prison wand but would never get it. Added debug info and saw that prison thought they had many wands when none were shown in their inventory. Found an issue with prison trying to cache player data which included their inventory which caused the failure when they would log out and back in due to bukkit creating new inventory objects for them, but prison still had, and was using, their old inventory. Prison no longer caches bukkit player data.

• Eliminated the obsolete items.csv file.

• Rank tags now can include spaces, just like the mine tags.

• New Features: Ops can now TP players to mines using /mines tp command. This even works from the console.

• New behavior for mines failing to load if the world is not available. If Multiverse is installed, it will defer the loading of the mine until multiverse is fully enabled. Otherwise it will revert the mine back to a virtual mine which can then be placed in an active world.

• Removed some old prison code that has been non-functional for a long time.

• Updated many docs.

• New Feature: Added XP calculations and ability to drop XP orbs with auto manager. Can have XP added directly to the player if you do not want orbs to drop.

• Added a new feature to unregister all prison commands. This helps to move prison to better support a /reload. But that is not possible yet... if you need to reload prison, you must restart the server.

• Fix bug with prison command registration if the command already exists. Bukkit will auto prepend the supplied conflict prefix to make the command unique. This prefix could be applied multiple times. The problem was that if this would happen, prison was not capturing that information, nor was it redisplaying to the users so they would have no idea what command they would have to enter.

• Found that the scoreboard named Scoreboard-r was buggy and causing problems. Spent a lot of time tracking it to the correct lines of code in that plugin. Confirmed it was a bug in prison.

• Bug Fix: prison command handler was unable to properly register commands with uppercase letters. It would register them, but you wouldn't be able to use them.

• Fix how some commands are registered so they are tied to module registration. This helps ensure the commands that are related to a module are not enabled if the modules are not loaded.

• Many fixes to the gui, to various mine and rank commands. And many internal core functions.

Prison v3.2.1

Many new features, updates, performance improvements, and bug fixes.

• Fixes issues with integrations such as LuckPerms (all versions now supported) and added more integration support
• Compatible with v1.16.x and should even work with v1.17.x too!
• Upgraded Gradle to v5.6.4
• Upgrade the core build version of prison to Spigot v1.13.2
• Updated a lot of internals to be more compatible from v1.8.x through 1.16.x. Is only possible with spigot v1.13.2. Prison uses the versions specific code for the version of the server.
• Now has over 80 placeholders, including aliases which a short abbreviations
• Placeholders now exist for the mines, ladders, and even player-mines where it reports on mine statuses based upon which mine the player is in at he moment
• Many new notification options
• Many new mine related features
• Mines now have mine commands so you can custom trigger mine related actions when they reset, both before and after the reset.
• Players can now TP to mines by giving them new perms
• Many new rank features
• New GUI screens!
• New Prestige system built in!
• New selllall feature!
• New automanager features: auto pickup, auto smelt, auto block. Can give global access, use as lore on tools and weapons, or through permission based access to customize your ranks and donor benefits!
• New slime block physics! Ever wanted to jump about 60 blocks high? Enable it and give it a try by jumping on a slime block.
• New extensive documentation, which is still a work in progress, but there is still a lot there.
• Plus many more new features and fixes. Check out the change log within github master branch for far more details.

Compatible versions

• Minecraft 1.8.8
• Minecraft 1.9.4
• Minecraft 1.10.2
• Minecraft 1.11
• Minecraft 1.12.2
• Minecraft 1.13.2
• Minecraft 1.14.2
• Minecraft 1.15.x
• Minecraft 1.16.x

Prison v3.2 - The Hadron Update

Changelog

• Prison is now under new leadership! It is now being lead by RoyalBlueRanger (@rbluer on GitHub)
• Works with Minecraft 1.14.4
• Added PlaceholderAPI support
• Updated the updater
• Updated bStats
• Updated Google GSON
• Improved Prison UX
• Improved /mines list
• Refactored the mines module to improve maintainability.
• Added decimal block chances in Prison Mines.
• Added a GUI for adding blocks to mines (called Block Search)
• Added extra emphasis on testing.
• Added a confirmation stage before deleting a mine.
• Added targeted mine messages
• Added a default/fallback spawnpoint for mines
• Added mine teleportation
• Added volume to the mines info.
• Added soft deletion of databases and tables in file storage.
• Fixed an issue where players were not being teleported out of mines upon reset.
• Fixed othet issues with player suffocation.
• Fixed an issue where blocks could be added to the mine with a 0% chance of appearing.
• Fixed a bug with mine resets not being randomised each time.
• Fixed a bug where some servers will get a NullPointerException when enabling the mines module.
• Fixed a bug where mines would not add, set, and delete blocks properly.
• Removed unused dependencies, making the final JAR slimmer.
• Removed Guava caching

Compatible versions

• Minecraft 1.8.8
• Minecraft 1.9.4
• Minecraft 1.10.2
• Minecraft 1.11
• Minecraft 1.12.2
• Minecraft 1.13.2
• Minecraft 1.14.2

Known Issues

• If a player logs out or sets a home while within a mine, they will always suffocate in the mine.