Prison Documents - Table of Contents
Prison’s Auto Manger deals with the whole block breaking events. It’s able to provide advanced features such as auto pickup, auto smelt, and auto block, along with providing the player with XP, applying OP fortune, plus many other features. All with maintaining full compatibility from Spigot v1.8 through Spigot v1.16.
Auto Manager is a very complex “process” and as a result, there are many features that can be configured, and many possible interactions with other plugins. Needless to say, there are many things that can go wrong, especially when it may not be configured correctly.
This document tries to cover some of those configurations and settings in other plugins to get things working at their best.
This document contains information on how to configure TokenEnchant and Crazy Enchant
(content coming soon)
Please Note: that these instructions apply to Prison v3.2.4 and later only.
Please Note: that as of Prison v3.2.5-alpha.11 some of these settings may not be required, especially in relation to WorldGuard and if you are using Mine Access Permissions.
Please Note: As of prison v3.2.6-alpha.1 Event priorities have been added to prison. Changing the event priorities may make it easier to get prison to work better with TE instead of having to change the event priorities on TE. If the follow directions do not work well for you, then try changing a few of the the prison’s event priorities. Currently I do not have any documentation to explain how this may help.
prison.mines.a. You may add the other flags if you want, as suggested at the top of this document.WorldGuard: Please note: Sometimes you might have to add the WorldGuard flag block-break in order to get this to work. /region flag prison_mine_<mine-name> block-break allow It may be a WG version issue. Spigot v1.8.8 requires this flag, while Spigot v1.15.2 does not appear to require it. Your success may vary. It may also be a good idea to add it either way.
lp creategroup prison.mines.aPlayer Permissions: The player must have the permission that is tied to the afore mentioned region. For example the group perm: prison.mines.a And assign it with: /lp user RoyalBlueRanger parent set prison.mines.a
plugins/TokenEnchant/enchants/ directory. Start the server to have TE generate the configuration files related to that enhancement.plugins/TokenEnchant/config.yml at bottom with the two settings: TEBlockExplodeEvent.process: true and TEBlockExplodeEvent.pickup: true as default values. Both of these must be set to false for this to work with prison.plugins/TokenEnchant/enchants/Exposive_config.yml must be adjusted. First run your server to generate this file if you have not done so yet. Find Potions.Explosive.occurrence: random and change it to always for testing purposes. Then locate the setting of Potions.Explosive.event_map.BlockBreakEvent: HIGHEST which is the default value (HIGHEST), and change it to a value of LOWEST. Failure to change this setting will result in the failure of TE from being able to fire the TEBlockExplodeEvent.TokenEnchant: To create a pickaxe with an explosion enchant do the following: From within the game, give yourself a diamond pickaxe (/give <playerName> diamond_pickaxe 1 or diamondpickaxe) and enchant it with the command /te enchant Explosive 1 or up to a level of 10. Run as OP, or if you need tokens to use, give yourself some from the console with /te add <playerName> 100.
plugins/Prison/autoFeaturesConfig.yml change the setting options.isProcessTokensEnchantExplosiveEvents: true to a value of true. The default value is true, but double check to ensure it set correctly. PLEASE NOTE: This setting is used even if options.general.isAutoManagerEnabled: false is disabled (set to false).Prison: Auto Manager: If Auto Features is disabled (which means auto pickup is also disabled), then the blocks still must be processed and broken by prison to prevent blocks outside of the mine from being broken. To enable prison to drop blocks normally within the mines, while honoring the TE Explosive event, then you will have to enable the setting isProcessNormalDropsEvents: true (set to true). Prison will calculate the drops and will drop them where the blocks were originally (not at the player’s feet). The internal calculations that prison uses for the drops are the same calculations it uses for the auto pickups.
isProcessNormalDropsEvents: true is enabled when auto features is disabled. This setting can be left on even when auto features is enabled since auto features will override it.Please note that these instructions apply to Prison v3.2.4 and later only.
Please follow the directions for Token Enchant explosion that are listed above.
But ignore everything that is listed for Token Enchant since Crazy Enchants is much simpler to configure. At this time I am not aware of any special changes that you need to make to the Crazy Enchant’s configurations.
To enable the processing of the Crazy Enchant BlockExplodeEvent enable this configuration:
isProcessCrazyEnchantsBlockExplodeEvents: true (enable by setting to true)
Prison provides a few options for controlling fortune. But before those options are discussed, the process of how fortune is calculated may be a very important topic to understand since it’s not a simple calculation.
Initially, prison uses Bukkit’s Block.getDrops() function to get a set of ItemStacks of the drops related to the block that is being broken. These drops are not fully inclusive as you would find within a vanilla game, but are somewhat limited, and they do vary from one version of spigot to another (1.8 vs 1.16 could be drastically different).
So to correct for omissions, such as a percent chance flint would be dropped with mining of gravel, and to adjust for the limited range of fortune within the vanilla server, prison has to make adjustments.
With Fortune, the standard is for fortune 1 through 3. But with OP prison setups, Prison needs to support higher fortune levels.
With a standard block break event, you break one block and you get one drop. That is standard without fortune. So the way Prison detects if fortune is applied, is if there is more than one block provided for a drop. With fortune 3 being the highest possible level to influence the drops, Prison checks the tool to see what it’s fortune level is, then uses that within the calculations.
So if the tool has a fortune level of three or less, then Prison does nothing with the drops since everything is already taken care of. But if the fortune level is greater than 3, then Prison must make adjustments to the drops.
The way prison extends the drops for higher fortune levels for tools with a fortune over three, is to divide the standard drop by three (since it maxes out at three), then multiplies that value by the actual fortune level on the tool. The reason is that all of the random variables that went in to calculating the standard drop have already been applied, so all that needs to be done is to extend the total drop amount to cover the tool’s actual fortune level. Since a fortune 3 has a higher chance to adding more to the drop compared to a fortune 1, then we can assume those random chances are reflected in the standard drop. This also means prison should not apply a random chance to the drops since that chance was already applied.
One issue with extending the fortune on the standard drops is that the amounts can appear to be much higher than what would be expected. So prison provides a way to apply a multiplier to the results to pull down that generated value.
If Auto Pickup is enabled
If Auto Pickup is disabled, and Process Normal Drops is Enabled
At this time, Prison does not provide any support for silk touch. Internally the basics are in place, but there has never been a request to enable anything related to silk touch within the mines.
Sometimes the durability on the tools used for mining are applied, and sometimes they are not.
Prison has the ability to enable durability calculations to add wear to the tools, if needed. If bukkit is applying the durability calculations and wear, and if the prison calculations are also enabled, then too much durability wear could be applied to your tools (a doubling effect).
When it is calculated to apply wear to the tools, it only adds 1 to the total durability on the tool. When the durability, or wear, exceeds the max durability level for the tool, then the tool will break.
The tool’s durability level will impact, and reduce, the chance to add wear to the tool. Also if the tool has the Durability Resistance enchantment, levels 1 through 100, it too will make it more difficult to add wear to the tool. If the Durability Resistance enchantment has a level of 100 (or no specified level assumes to be 100), then no wear will ever be applied to the tool.
Prison has the ability to give the player XP for mining certain kinds of blocks. The XP can be give either directly, or though the generation of XP Orbs.
Prison provides block break counts on tools through the use of lore, if enabled. This will track how blocks a tool has broken over it’s life span.