PrisonUtils
Description
PrisonUtils is a Plugin which (as the name already suggests) adds a couple
of useful Prison Utilities to the game.
It also adds Backpacks which can be used to store items.
If you have QuickSell installed, you can also sell all Items which are inside
your Backpack.
if you have PrisonGems installed, players can purchase Backpacks
using Gems via /backpacks or [Backpack] Signs
Features
Every Feature can be disabled in the Config!
- Auto-Smelting
- Automatically tranform Items into their Block Form if you have at least 9 of them
- Fortune on all Blocks
- Permanent Potion Effects
- Unbreakable Tools
- Preventing specific Damage Causes
- Backpacks
- Blocks go straight to your Inventory/Backpack
- QuickSell Integration with Backpacks
- QuickMarket Integration with Backpacks
- Disable Weather
- Integrated Protection Plugin
- Displaying the Owner of the Pickaxe and the amount of blocks broken in the name
- Displaying the Owner of the Pickaxe and the amount of blocks broken in the lore
- Executing commands when a certain amount of blocks broken is reached
- Automatically sell Items to a QuickSell Shop when mining
- Specify what Blocks drop EXP (works for all Blocks, not only Ores)
- Automatically add EXP to your XP Bar instead of dropping it on the ground
Configuration
mining: auto-smelt: true ## Specify whether it automatically smelts mined Blocks enable-fortune: true ## You can enable/disable whether Fortune has an impact on the amount of dropped Items straight-to-inventory: true ## Specify whether mined Items go straight to your Inventory/Backpack backpacks: true ## Specify whether Backpacks are enabled prefer-backpacks: true ## Specify whether it will prefer to put Items into the Backpack or Inventory unbreakable-pickaxes: false ## Specify whether Tools take damage when being used auto-block: true ## Specify whether Valuables automatically get turned into their Block Form if you have at least 9 block-whitelist: ## Well, if you are lazy and don't want a protection plugin, you can simply disable breaking blocks which are NOT in this list. Note here that in Creative Mode you will still be able to break those. And you can disable this list by setting it to [] - STONE - COAL_ORE - IRON_ORE - GOLD_ORE - LAPIS_ORE - DIAMOND_ORE - EMERALD_ORE - QUARTZ_ORE - COAL_BLOCK - IRON_BLOCK - GOLD_BLOCK - LAPIS_BLOCK - DIAMOND_BLOCK - EMERALD_BLOCK - QUARTZ_BLOCK - REDSTONE_ORE - GLOWING_REDSTONE_ORE - REDSTONE_BLOCK autosmelt-blacklist: ## You can also specify Blocks that will be excluded from Autosmelting - LOG - LOG_2 block-counter ## Specify whether the Block Counter is enabled, without this the above 2 settings wont work soulbound-pickaxes: true ## Specify whether Pickaxes are soulbound soulbound-backpacks: true ## Specify whether Reinforced Backpacks are enabled autosell: summary-every: 100 ## Specify the amount of times AutoSell sold Items required for it to send a Stats Summary pickaxe: name: enabled: true ## Specify whether the Pickaxes Name will be affected by this Plugin prefix: '&b{PLAYER}''s ' ## Specify the Prefix of your Pickaxe suffix: ' &8[&6{BLOCKSBROKEN} Blocks broken&8]' ## The Suffix of your Prefix ## Since v1.4.5 it also allows custom Pickaxe Names to be used. If your Pickaxe Name is "Donator Pick" ## it will look like the following "mrCookieSlimes's Donator Pick [1923 Blocks broken]" ## if it has no Name it will look like this "mrCookieSlimes's Diamond Pickaxe [1923 Blocks broken]" lore: enabled: false ## Specify whether the Pickaxes Lore will be modified by this Plugin lines: - '&7Pickaxe Owner: &e{PLAYER}' ## Here are some Variables you can use in the Lore - '&7Blocks broken: &e{BLOCKSBROKEN}' - '&7Durability: &e{DURABILITY}' - '' ## Note here that this Lore will NOT delete any previous Lore, it will smartly modify it by putting the above defined Lines in front of the previous Lore axe: name: enabled: true ## Specify whether the Axe Name will be affected by this Plugin prefix: '&b{PLAYER}''s ' ## Specify the Prefix of your Axe suffix: ' &8[&6{BLOCKSBROKEN} Blocks broken&8]' ## The Suffix of your Prefix lore: enabled: false ## Specify whether the Axe Lore will be modified by this Plugin lines: - '&7Tool Owner: &e{PLAYER}' ## Here are some Variables you can use in the Lore - '&7Blocks broken: &e{BLOCKSBROKEN}' - '&7Durability: &e{DURABILITY}' - '' shovel: name: enabled: true ## Specify whether the Shovel Name will be affected by this Plugin prefix: '&b{PLAYER}''s ' ## Specify the Prefix of your Shovel suffix: ' &8[&6{BLOCKSBROKEN} Blocks broken&8]' ## The Suffix of your Prefix lore: enabled: false ## Specify whether the Shovel Lore will be modified by this Plugin lines: - '&7Tool Owner: &e{PLAYER}' ## Here are some Variables you can use in the Lore - '&7Blocks broken: &e{BLOCKSBROKEN}' - '&7Durability: &e{DURABILITY}' - '' full-inventory: sound: true ## Specify whether a Sound will be played when your Inventory is full title: true ## Specify whether a Title will be sent when your Inventory is full actionbar: false ## Specify whether a Message using the ActionBar will be sent when your Inventory is full allow-breaking-blocks: true ## Specify whether Players are still able to break Blocks with a full Inventory silktouch-whitelist: ## Specify which Blocks are affected by Silk Touch - COAL_ORE- - WEB - DIAMOND_ORE - EMERALD_ORE - GRASS - HUGE_MUSHROOM_1 - HUGE_MUSHROOM_2 - ICE - LAPIS_ORE - MYCEL - DIRT - PACKED_ICE - QUARTZ_ORE - REDSTONE_ORE fortune: use-whitelist: false ## Whether the Block Whitelist will be used block-whitelist: ## All Blocks Fortune has an Effect on, set use-whitelist to false in order to apply Fortune to every Block - COAL_ORE - REDSTONE_ORE - GLOWING_REDSTONE_ORE - LAPIS_ORE - QUARTZ_ORE - DIAMOND_ORE - EMERALD_ORE world-blacklist: ## All Worlds where Fortune will not work - world_nether level-modifier: 0.6 ## ADVANCED Set the Modifier for Levels, this will be the multiplier for the fortune level you have in order to determine the max amount of items obtainable using that level of fortune. E.G. Fortune 100 -> 100 * 0.6 = 60 -> At most 60 Items min-modifier: 0.2 ## ADVANCED Set the min. Modifier for Levels, this will be the multiplier for the fortune level you have in order to determine the min amount of items obtainable using that level of fortune. E.G. Fortune 100 -> 100 * 0.2 = 20 -> At least 20 Items regions: use-whitelist: false ## Specify whether Fortune only works in certain WorldGuard Regions whitelist: - a - b - c backpacks: ## You can also configure the Names of the Backpacks name: normal: '&eBackpack' soulbound: '&eReinforced Backpack' environment: permanent-effects: ## Specify which Effects Players permanently have - NIGHT_VISION - SATURATION prevented-damage: ## Specify which Damage Causes are cancelled - FALL - SUFFOCATION enable-weather: false ## Specify whether Weather is enabled/disabled world-blacklist: ## You can also specify worlds where this Plugin will not take affect - world_the_end - world_nether options: ## And if you don't want this Plugin to automatically update, you can simply turn it off auto-update: true block-rewards: ## Note here that this only works if you have pickaxe renaming enabled enabled: false ## Specify whether rewards for breaking a certain amount of Blocks are enabled repeating: ## Those commands will get executed every X blocks broken. Set it to [] to disable that amount '1': [] standard: ## Those commands will get executed whenever a Player breaks that certain amount of Blocks '100': - 'say {PLAYER} broke a hundred blocks' ## The Variable {PLAYER} can be used here exp: whitelist: ## Here you can specify what Blocks drop EXP - COAL_ORE - REDSTONE_ORE - GLOWING_REDSTONE_ORE - LAPIS_ORE - QUARTZ_ORE - DIAMOND_ORE - EMERALD_ORE auto-exp: true ## Specify whether EXP automatically gets added to your XP bar instead of being dropped on the ground environment: fly-on-join: false ## Here you can specify whether Players will be granted the ability to fly when they join the server
Commands/Permissions
Command | Description | Permission | ||||
/backpack <Player> <Amount of Rows> [soulbound] | Gives the specified Player a Backpack which is capable of holding the specified amount of Rows as an Inventory. If you append soulbound to the command, it will give you a reinforced Backpack | backpack.cheat | ||||
/autosell | Toggles the automatically selling of Items when mining. Requires QuickSell | PrisonUtils.autosell | ||||
Allows you to automatically pickup items as you mine | PrisonUtils.autopickup | |||||
Allows you to automatically smelt items as you mine | PrisonUtils.autosmelt | |||||
Allows you to automatically package Ores into their Block form as you mine | PrisonUtils.autoblock |
Developer API
PrisonUtils allows a lightweight API for Developers to be used in order to create custom Addons for PrisonUtils.
API Documentation
Auto-Updater and Metrics
All my Plugins are using an Auto-Updater to make sure, you're always
using the latest and hopefully most bug free version of my Plugin.
If you don't want this Plugin to be auto-updated, you can turn it off
in the config file at "options -> auto-update: true/false"
They also use a Metrics-System which collects the following Informations:
A unique identifier
The server's version of Java
Whether the server is in offline or online mode
The plugin's version
The server's version
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version
Opting out of this service can be done by editing
plugins/Plugin Metrics/config.yml and changing opt-out to true.
@mrCookieSlime Okay thanks
@bumcheese12
I will take a look at it.
Auto Smelt ain't working. Its set to true in config but doesn't work in game. PLEASE HALP
@TheBusyBiscuit Yes 1.7.3
@minama
Are you using the latest Version of QuickSell?
This plugin is great! The backpacks auto fill but when I click the Sell All sign the items dont sell out of the backpack automatically. Help?!
@Twixellzz
Nope. However it might need a decent processor.
But I made some minor performance improvements in the latest version.
So only a maxed out server like arkham can run this plugin? alright.
@TyWazHere1234
You cannot make Sell All Signs with this Plugin.
Sell All Signs are added by QuickSell.
Take a look at the QuickSell Plugin Page to see how they work.
And there is no tps issue. It just requires a little bit of Calculation to add all the fortune formulas, the auto-block feature, the auto-smelting, the adding the items to the inventory, the Backpacks etc. and some Servers just may not be able to handle it.
I am already trying to strip down every Calculation of the Plugin and try to calculate most things already on enabling the plugin but thats very time consuming.
And sorry, I wont add customizable backpacks and the UUID stuff is necessary. I could hide it but that would result in a really long empty lore which would look even more ugly.
I like the concept of the backpacks and some of the other features are helpful, also i am agreeing with @Twixellzz My servers TPS also dropped from 20 to 11 with this plugin, and if the tps issue could be fixed, also maybe add a customization to the backpack so it doesn't have to have that ugly uuid in the lore and maybe make the item customizable so i could make the backpack an enderchest instead of a normal chest. Just some suggestions, thx and i enjoy the plugin.
@Twixellzz
Well then get a better Server -_-
As I said if your Server cannot handle this, then just dont use this Plugin. There is nothing wrong with the Plugin.
If it can run 20 tps with 120 players online without the plugin, but with it run 13 that's a big problem.
@Twixellzz
It is your problem.
Backpacks always require a little bit of Calculation and your Server just isnt able to handle that.
Either buy a better server or disable some features in the config...
Upon removing the plugin: 20 TPS, Adding the plugin back: 13 TPS.
thats the same with me about have the backpacks not sure why but when selling it lags a little
We have extreme CPU's and 64gb's of ram, not our problem.
@Twixellzz
Then get a better Server :p
There is nothing I can do about that. It is already as lightweight as possible.
The whole server's TPS is constantly at 15 or lower coming from PrisonUtils.
Also, while selling it keeps lagging the server if they have a lot of backpacks (Inventory full of 54 slots)
@Twixellzz
Yep, it is ChatTitles. I will fix it.