Merge pull request #205 from PrisonTeam/bleeding_pull_v3_2_6

Bleeding pull v3.2.6, getting ready for the next one (3.2.7 or 3.3.0 IF multi-language support update).
PrisonTeam · Apr 11, 2021 · f0aaa2e · f0aaa2e
2 parents 7774b54 + 57c9b68
commit f0aaa2e
Show file tree

Hide file tree

Showing 65 changed files with 3,533 additions and 2,067 deletions.
diff --git a/docs/changelog_v3.2.x.md b/docs/changelog_v3.2.x.md
diff --git a/docs/knownissues_v3.2.x.md b/docs/knownissues_v3.2.x.md
@@ -7,10 +7,41 @@ a short list of To Do's. This list is intended to help work through known
 issues, and/or to serve as items that should be added, or fixed.
 
 
+# Random Issues - Alpha v3.2.6
+
+
+* Sometimes Player Ranks lores placeholders from placeholderAPI aren't working, 
+it's unknown why it's happening.
+
+
 # To Do Items - During Alpha v3.2.5
 
 
-* Issue with `/ranks autoConfigure` if Mines module is disabled.  Gets a NPE, which is not surprising.  Note: line number is from v3.2.4 so does not match source anymore.
+
+* BlockEvents - Action based upon blocks broken, not a percent chance.
+
+
+NOT an Issue: OfficiallyGuo — Today at 5:41 AM
+[19:34:33 INFO]: | Prison |  Spigot18Blocks.getBlockType() : Spigot block cannot be mapped to a prison BlockType : CONCRETE id = 251 data = 11  BlockType = null
+Should I worry about this? Prison Version: 3.2.5.  Even tho I get this message, there aren't any actual errors happening in-game.
+NOTE: This is not an issue.  OfficiallyGuo is running spigot 1.12.2 and trying to use concrete. More of a reason to use the new block model.
+
+
+* Warning if using `/mines set area` and volume is over 20k in size.  Could possibly be an error.
+
+
+* ladder commands
+
+
+* global virtual mine:  To apply mine commands & blockEvents to all other mines.
+
+
+
+* TP cooldowns - for /mines tp
+  - Take a look at how essentialsX deals with it
+
+
+DONE * Issue with `/ranks autoConfigure` if Mines module is disabled.  Gets a NPE, which is not surprising.  Note: line number is from v3.2.4 so does not match source anymore.
 [21:00:38 WARN]: Caused by: java.lang.NullPointerException
 [21:00:38 WARN]:        at tech.mcprison.prison.spigot.SpigotPlatform.getModuleElementCount(SpigotPlatform.java:1077)
 [21:00:38 WARN]:        at tech.mcprison.prison.ranks.commands.RanksCommands.autoConfigureRanks(RanksCommands.java:202)
@@ -29,6 +60,7 @@ issues, and/or to serve as items that should be added, or fixed.
 
 Look at sellall and XMAteral's use of parse.  Needs to handle it with an item stack.
 
+
 Personal mines.  Work in conjunction with a plot world?
 - sellable and so would be the features with various upgrades
 - Create a new module based upon Mines with new features to support player interactions and upgrades.

diff --git a/docs/prison_changelog_v3.2.0.md b/docs/prison_changelog_v3.2.0.md
@@ -9,7 +9,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 Greetings!  I'm delighted that you are interested in the build logs for the

diff --git a/docs/prison_changelog_v3.2.1.md b/docs/prison_changelog_v3.2.1.md
@@ -9,7 +9,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 Greetings!  I'm delighted that you are interested in the build logs for the

diff --git a/docs/prison_changelog_v3.2.2.md b/docs/prison_changelog_v3.2.2.md
@@ -9,7 +9,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 Greetings!  I'm delighted that you are interested in the build logs for the

diff --git a/docs/prison_changelog_v3.2.3.md b/docs/prison_changelog_v3.2.3.md
@@ -9,7 +9,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 Greetings!  I'm delighted that you are interested in the build logs for the

diff --git a/docs/prison_changelog_v3.2.4.md b/docs/prison_changelog_v3.2.4.md
@@ -9,7 +9,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 Greetings!  I'm delighted that you are interested in the build logs for the

diff --git a/docs/prison_changelog_v3.2.5.md b/docs/prison_changelog_v3.2.5.md
@@ -9,7 +9,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 Greetings!  I'm delighted that you are interested in the build logs for the

diff --git a/docs/prison_changelog_v3.2.6.md b/docs/prison_changelog_v3.2.6.md
@@ -0,0 +1,205 @@
+[Prison Documents - Table of Contents](prison_docs_000_toc.md)
+
+## Prison Build Logs for v3.2.5 - 2021-04-01
+
+## Build logs
+ - **[v3.2.6-alpha - Current](changelog_v3.2.x.md)**
+ - **[v3.2.0 - 2019-12-03](prison_changelog_v3.2.0.md)**&nbsp;&nbsp;
+**[v3.2.1 - 2020-09-27](prison_changelog_v3.2.1.md)**&nbsp;&nbsp;
+**[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
+**[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
+**[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
+
+
+Greetings!  I'm delighted that you are interested in the build logs for the
+Prison plugin.  I'm wanting to provide a more formal documentation as to what 
+is going on in each build so you have a better idea if it may be something 
+that you need.
+
+
+
+
+
+# v3.2.6 2021-04-10
+
+
+
+* **v3.2.6 2021-04-10**
+
+
+* **Start to add in a PrisonMinesBlockEventEvent class.**
+It has been disabled because it cannot be used yet; the BlockEvents need to under go some major changes to support its use.
+Currently the BlockEvents receive only references to the sources (block names and not the actual blocks), but in order to hook this up properly, all blocks and details need to be passed.  The current system for controlling the BlockEvents is unable to support that kind of an environment right now. It will be changed in the very near future to get this working.
+
+
+* **v3.2.6-alpha.4 2021-04-09**
+
+
+* **Fix to the new PrisonMinesBlockBreakEvent.**
+Found out the hard way that since this extended the BlockBreakEvent it was picking up all the registered handlers for the BlockBreakEvent. LOL  So fixed that to prevent a possible stack overflow exception within prison.
+
+
+* **New Feature: Added PrisonMinesBlockBreakEvent to all auto manager event handlers.**
+This allows the canceling of prison's handling of the block break event before they are processed.  This event type also contains the mine in which the blocks exist in, along with the list of any exploded blocks.  This event also identifies the BlockEventType along with the TokenEnchant triggered event if it is set.  Through these prison related objects (Mines and SpigotBlock) the consuming plugin can extract a lot of detailed information about the event and conditions.  The event also includes getOriginalTargetBlock() function that can be used with any of the provided blocks in this event to identify what the original block within the mine was set to, along with the mine's stats that goes along with that block.
+
+
+* **Fixed a backpack error for backpack set size**
+If too many items were in a backpack and it got resized to a smaller
+  size than the number of them, it won't give an error anymore.
+
+
+* **Fixed backpacks issue with dimensions**
+Custom backpacks dimensions were resetting when adding an item to the backpack.
+
+
+* **v3.2.6-alpha.3 2021-04-07**
+
+
+* **Removed the minepacks maven repo and just included the api jar because their maven repo was failing for over 24 hours.**
+Removed jetbrain annotations since they were preventing the project from compliing since the classes could not be found by the compiler.  By changing the build.gradle script to remove the maven repo for minepacks it forced an update and the updated resources were unable to locate jetbrains classes.
+
+
+* **Player GUI aka /gui ranks have more internal placeholders**
+You can now use {rankName} and {rankTag} for the Player Ranks GUI lore
+  editor in the guiconfig.yml, they'll be replaced automatically with the
+  rank name and rank tag.
+
+
+* **Option to enable or disable numbers in the /gui ranks or /ranks for players**
+It's now possible to show or not the rank number in the GUI by changing in the guiconfig.yml
+  this option: 
+  Number_of_Rank_Player_GUI: false
+
+
+* **Edited /gui main GUI design and added backpack admin button**
+Added Backpack Admin button to the /gui so it's available directly from there.
+
+
+* **Added SellAllUtil to the PrisonAPI**
+You can now access the whole SellAllUtil from the PrisonAPI with
+  the getPrisonSellAll method.
+
+
+* **Added a character to prevent the collapse of the indents under some reporting conditions... generally when copying and pasting in to other tools.**
+
+
+* **Many SellAll GUI Fixes**
+SellAll GUIs will now update dynamically, some double messages errors got fixed,
+  also a typo that was breaking the delay GUI.
+
+
+* **SellAllUtil for SellAll**
+Moved many sellall code management to the SellAllUtil class, this can add new
+  issues but also fix many, please report them if you found any.
+
+
+* **SellAll disabled worlds**
+It's now possible to add disabled worlds where /sellall sell and /sellall auto toggle won't
+  work to sellall from the sellallconfig.yml.
+
+
+* **Trying to double register Prison with papi, once as normal, and with upper case prefix.**
+
+
+* **Changed placeholder replacements to be case insensitive when performing the replacements.**
+This probably only applies to chat prefixes.
+This probably will not be unicode sensitive.
+
+
+* **Provide a sanity check when creating a mine greater than 20,000 blocks.**
+If a mine is a lot larger than expected, it may be due to a stray point set from another mine, which a super huge mine could destroy the surrounding builds.  So if something is horribly wrong with the selection, it may save someone's builds.
+
+
+* **Backpack Admin Player Backpacks List GUI**
+A sub-GUI of the Admin Player List GUI, which will show all the backpacks own by a Player, only a maximum of 54 backpacks of the Player can be shown, pages will be added in the future.
+
+
+* **Backpack Admin Player List GUI**
+A sub-GUI of the backpacks ADMIN GUI that will show a list of players owning at least one backpack, only 54 players can be shown for now, not one more, pages will be added in the future.
+
+
+* **Backpack admin GUI**
+A new admin GUI for backpacks got added, you can open it with /backpack admin.
+  NOTE: You need the permission prison.admin to use it.
+
+
+* **Backpack Internal Error fixed**
+Fixed an internal backpack saving error, this didn't compromise the use of backpacks but just the ADMIN management.
+
+
+* **v3.2.6-alpha.2 2021-04-03**
+
+
+
+* **Modified how the configuration of the block break events are processed to give better granular control over them.**
+Added a BlockBreakPriority of DISABLED so individual events can be fully controlled, even turned off.
+Expanded the block break related priorities so they can be better controlled and even disabled.  This will allow for a fine grained control over each plugin instead of lumping them all together, along with prison.
+These changes should provide a much greater degree of flexibility to help get environments working properly.
+
+
+* **Backpack disabled worlds**
+It's now possible to disable backpacks in some worlds, give a look to the backpacksconfig.
+
+* **Enabled /backpack set size**
+Enabled /backpack set size command, it must be a multiple of 9.
+  The permission to use it is prison.admin.
+  The format of the command's /backpack set size <Owner> <Size> <Id>, ID
+  is OPTIONAL and required only for multiple backpacks when enabled.
+
+
+* **Add the block break event priority to the /prison version command.**
+
+
+* **Added a new auto features option to control the BlockBreakEvent priority.**
+It defaults to LOW (what it's been set to for the last 4 versions), but the vaild options are:
+LOWEST, LOW, NORMAL, HIGH, and HIGHEST.
+The monitor priority is not available since block states must not be changed at that priority.  The existing monitors will remain set to a MONITOR priority irrespective to what priority is set.
+
+
+* **Prevent prison's BlockBreak event listeners from registering if they are not enabled.**
+For the core listeners, this means the mine module must be enabled.
+
+
+* **Close GUI Message**
+A new message got added to the messages FILE that will be shown when closing a Prison GUI with the close GUI button (Message -> GuiClosedWithSuccess:).
+
+
+* **Player Ranks GUI (/gui ranks or /ranks for players) Lore is now customizable**
+It's possible to customize the GUI lore from the guiconfig.yml for Player Ranks.
+
+
+* **Added /gui reload command**
+It's now possible to reload GUIs with the /gui reload command.
+
+
+
+* **Set the current bleeding branch to v3.2.6-alpha.1
+
+
+
+
+# v3.2.5 2021-04-01
+Release of next bug update: 
+
+**The April Fools release**. LOL I thought it was April 1st, but it really was March 31st.  I was fooled. lol
+
+
+Set the version to v3.2.5.
+
+
+# **v3.2.4 2021-03-01**
+  Release v3.2.4.
+
+
+
+# V3.2.3 2020-12-25 
+**Merry Christmas!!**
+Release of next bug update.
+
+
+
+# V3.2.2 Release - 2020-11-21
+
+
diff --git a/docs/prison_docs_000_toc.md b/docs/prison_docs_000_toc.md
@@ -22,7 +22,8 @@
 **[v3.2.2 - 2020-11-21](prison_changelog_v3.2.2.md)**&nbsp;&nbsp;
 **[v3.2.3 - 2020-12-25](prison_changelog_v3.2.3.md)**&nbsp;&nbsp;
 **[v3.2.4 - 2021-03-01](prison_changelog_v3.2.4.md)**&nbsp;&nbsp;
-**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**
+**[v3.2.5 - 2021-04-01](prison_changelog_v3.2.5.md)**&nbsp;&nbsp;
+**[v3.2.6 - 2021-04-11](prison_changelog_v3.2.6.md)**
 
 
 

diff --git a/docs/prison_docs_012_setting_up_prison_basics.md b/docs/prison_docs_012_setting_up_prison_basics.md
@@ -89,6 +89,27 @@ Some of the important details that are listed:
 custom currency and that currency cannot be found in any economy.
 
 
+<hr style="height:1px; border:none; color:#aaf; background-color:#aaf;">
+
+
+# Server Start Up Script
+
+
+If you are leasing a server from a hosting service you may not be able to customize the startup script. But if you have control over it, then the following information may help.
+
+
+`java -Xdebug -Xms2g -Xmx4g -jar spigot-1.16.5.jar -nogui`
+
+
+Example of enabling debug hooks for the server.  This is used with Eclipse, and may work with other IDEs since it's a java directive.
+
+`java -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 -Xms2g -Xmx8g -jar spigot-1.16.5.jar -nogui --log-strip-color`
+
+
+Note: The use of `--log-strip-color` may or may not work within your environment.
+
+
+
 <hr style="height:1px; border:none; color:#aaf; background-color:#aaf;">
 
 
@@ -111,7 +132,7 @@ everything from the first line to the last. Please take a screen print and provi
 discord with a detailed explanation of the issue.  Include everything from:
 
 ```
-	[16:21:30 INFO]: [Prison] Enabling Prison v3.2.1-alpha.13
+	[16:21:30 INFO]: [Prison] Enabling Prison v3.2.5
 ```
 
 through:

diff --git a/docs/prison_docs_311_guide_automanager.md b/docs/prison_docs_311_guide_automanager.md
@@ -34,10 +34,13 @@ This document contains information on how to configure TokenEnchant and Crazy En
 # To get TokenEnchant's TEBlockExplosionEvent to work with prison, you must follow these settings:
 
 
-Please note that these instructions apply to **Prison v3.2.4** and later only.
+**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 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.