Alpha 4 - "The Flattening"

Description

This pre-release fixes a few bugs and adds some nice new features!

About the "Flattening"

We're close to a first Beta release. Therefore, we're trying to make sure everything we did up to nowadays is following our code guidelines. This phase will be splited on a few Alpha releases and will consist in the final API breaking changes on both addons and BentoBox. Alongside the flattening, addons will progressively be made available on CodeMC's Maven repository so that you can start to mess around with them. It's starting with AcidIsland and BSkyblock !

1.13.2

BentoBox is currently not officially supporting 1.13.2. However, given that Spigot updated fastly, it should be safe to say that BentoBox won't run into weird issues. Don't forget to submit a bug report if you get to be extremely unlucky !

Update your addons !

BSkyBlock and AcidIsland both received an update to support Alpha 4 and must be updated.
Other addons may not need to be updated.

Changelog

How to read it

Each change/tweak/bug fix is listed in the corresponding category.
If a change is likely to do something that needs the user to keep a close eye on, then it is labelled with an icon.

Here is a list of the labels:

• ⚠️ - the change is breaking the API and/or deprecate some parts of it. It theorically should only concern addons, so make sure to update them as well!
• 🔠 - locale files may need to be regenerated or updated.
• ⚙️ - config options have been removed, renamed or added.

Contents

• API

1. Added WorldSettings#isDeathsCounted.
2. Added User#spawnParticle(Particle, Particle.DustOptions, double, double, double).
3. ⚠️ Removed Util#getPermValue(Player, String, int).
4. Added User#getPermissionValue(String, int).
5. Fixed a mistake in IslandWorldManager's javadoc.

• Tweaks

1. 🔠 Added the addon name to the version's world list (#285).

• Bug fixes

1. Fixed teleporting to an island by using a member's name causing an exception (#300).
2. 🔠 Added English locale text for schem commands (#305).
3. Fixed tons of code smells (as usual).
4. Fixed island.maxhomes permission being sometimes not correctly appended to the addon's permission prefix.

• Features

1. ⚙️ Deaths are now only counted if this is enabled in the gamemode world (#164 ; check the gamemode's config file).
2. 🔠 Added the admin why command (/bsb why on BSkyBlock ; /acid why on AcidIsland). It will reveal why a player can do something on an island. Extract of the commit message: I want admins to be able to understand this better so that they can give us better bug reports or fix it themselves. When the player did something, it would be reported in the console.
3. Added schem clipboard selection display using particles. Here is how it looks.
4. 🔠 ⚙️ Request confirmation when /is sethome is used while being in the Nether/End (#237). Options were also added to disallow setting an home in the Nether or in the End.

Alpha 3

Description

This pre-release fixes a few bugs and potentially contains a few API breaking changes.

Don't forget to update your addons as well.

How to read the changelog

Each change/tweak/bug fix is listed in the corresponding category.
If a change is likely to do something that needs the user to keep a close eye on, then it is labelled with an icon.

Here is a list of the labels:

• ⚠️ - the change is breaking the API and/or deprecate some parts of it. It theorically should only concern addons, so make sure to update them as well!
• 🔠 - locale files may need to be regenerated or updated.
• ⚙️ - config options have been removed, renamed or added.

Changelog

• API

1. ⚠️🔠 Splited AdminSchemCommand into proper subcommands: see world.bentobox.bentobox.api.commands.admin.schem package for more details.
2. Added ConfirmableCommand#askConfirmation(User, String, Runnable).
3. Added User#spawnParticle(Particle, Particle.DustOptions, int, int, int).
4. ⚠️ Moved AddonState to Addon.State.
5. ⚠️ Moved YmlCommentParser and YmlConfiguration in world.bentobox.bentobox.util.yaml package.
6. ⚠️ Moved HeadGetter and HeadRequester in world.bentobox.bentobox.util.heads package.
7. ⚠️ Moved SafeTeleportBuilder to SafeSpotTeleport.Builder.
8. ⚠️ Modified SafeSpotTeleport to add a boolean overrideGamemode parameter.
9. Added IslandWorldManager#inWorld(World).

• Tweaks

1. ⚙️ Added island.cooldown.coop and island.cooldown.trust to avoid using invite's cooldown for these commands.
2. Made PVPListener use Notifier: it is now less ''spammy''.
3. 🔠 Removed general.errors.unknown-player-name from locales.
4. 🔠 Added a [name] variable in general.errors.unknown-player (#263).
5. 🔠 Implemented protection for standard Nether and End (BentoBoxWorld/BSkyBlock#9).
6. 🔠 Display BentoBox version in /bentobox version (#284).

• Bug fixes

1. Panels size could be higher than 54.
2. Fixed the Settings panel that was using outdated logic.
3. Fixed players considered "unknown" until they created/joined an island.
4. Fixed typo in SchemsManager.
5. Fixed trusted and coop members being protected like visitors (#258).
6. Fixed closing vanilla inventories when clicking outside of them.
7. Fixed a bunch of code smells.
8. Fixed AdminTeleportCommand overriding the player's gamemode when teleporting (#262).
9. Fixed island protection being applied to standard Nether and End (BentoBoxWorld/BSkyBlock#9).
10. Fixed handling of the Nether portal when standard Nether is enabled.
11. Partially fixed critical exceptions when loading outdated addons (#280).
12. Fixed dying outside of an island's space causing spectator mode (#286).
13. Fixed error when saving schems containing a Shulker (#293).

Alpha 2

⚠️ This version has some issues with Panels. They will be fixed in the next Alpha release, as we will be implementing a better API to manage them.

Description

This pre-release fixes a few bugs and potentially contains a few API breaking changes.

Java support

This pre-release introduces a better Java 10 support. While BentoBox is still not fully updated to this version (we are waiting for Java 11, which is the next LTS), it should be able to run.

Spigot 1.13.1

Alpha 2 is using Spigot 1.13.1. We highly recommend you to update from 1.13, not to mention that a lot of bugs have been fixed in both Minecraft and Spigot.

Official addons

There should be no need to update the official addons alongside this pre-release.

How to read the changelog

Each change/tweak/bug fix is listed in the corresponding category.
If a change is likely to do something that needs the user to keep a close eye on, then it is labelled with an icon.

Here is a list of the labels:

• ⚠️ - the change is breaking the API and/or deprecate some parts of it. It theorically should only concern addons, so make sure to update them as well!
• 🔠 - locale files may need to be regenerated or updated.
• ⚙️ - config options have been removed, renamed or added.
• 🔺 - the original build contained a major bug or an exploit that has been fixed. Redownload BentoBox as soon as possible.

Changelog

• API

1. PanelBuilder#nextSlot() was not returning the expected value.
2. ⚠️ Made Notifier.Notification nested class private. Note: addons or external plugins shouldn't have been able to use this.

• Tweaks

1. ⚙️ Removed general.check-updates : it is unused.
2. Changed island distance particles (/<admincommand> range display) to be gray REDSTONE instead of TOWN_AURA.
3. ⚙️ Removed purge-related settings.
4. ⚠️ ⚙️ Renamed all database-related settings and methods to replace db with database.
5. ⚙️ Moved confirmation-time to island.confirmation.time.
6. ⚠️ ⚙️ Removed kick-wait and leave-wait. The confirmation time is now generic across all of the commands.
7. ⚙️ Renamed and moved invite-wait, ban-wait and reset-wait to island.cooldown.<x>.
8. ⚙️ Moved island.require-confirmation.<command> to island.confirmation.commands.<command>.
9. WORLD_SETTING flag type is now using a GRASS_BLOCK block as an icon instead of a GRASS item.

• Bug fixes

1. Panel size was incorrectly set.
2. Last login timestamp in Island information was sometimes 0 due to how OfflinePlayer works in Bukkit.
3. Metrics were loaded even though it was set to false in config. Note: Metrics are still not yet fully implemented.
4. Fixed BentoBox not loading addons due to Java 10 restrictions.
5. 🔠 Fixed color formatting in general.errors.no-permission in the en-US locale.
6. Fixed NPE when an invite gets rejected.
7. Fixed Enter/Exit messages not being sent when the player teleports to an island.
8. Fixed Invincible Visitors settings panel still using general.errors.you-need.

Trial of Java 10 version

Do not use it unless you're told to do so, as there are potentially some bugs.

Java 10 version just for preliminary testing.

Alpha 1

About this alpha pre-release

This pre-release, Alpha 1, fixes a few bugs that caused unexpected behaviours on various addons. It does not add any new features nor it brings API breaking changes.

Alpha 1 has not been built using Spigot 1.13.1 API, however it works fine on both 1.13 and 1.13.1.

Bug Fixes

• [Major] Entities in schems were not being pasted
• [Major] Deaths were not being counted
• [Major] Recognition of e.g. bskyblock.settings.* was not happening
• [Major] Protected items, e.g., chests, could be broken, thereby bypassing protection
• [Minor] Falling players starting an island could die from fall damage
• [Minor] API addRank or removeRank could remove trust, coop and sub_owner ranks
• [Minor] Endermen were dropping two blocks when killed if they held them

100% Feature Complete (Updated Aug 19 - hotfix)

About this release

100% feature complete pre-release version. This version will have bugs so be careful if you use it on a server. Major structural pieces are in place and are not expected to be redone, therefore the API will be quite stable.
However please keep in mind that this version can still contain bugs that might require some refactoring on the API. If you don't feel confident in using this pre-release, then don't use it and wait for 1.0 which should come out in a few weeks.

We will also follow a compliant semantic versioning, as stated on this page, for further versions :

• 0.9.0-SNAPSHOT: dev builds. They should not be used.
• 0.9.0-alpha: alpha builds. They will mainly be focused on new features and improvements to the current API.
• 0.9.0-beta: beta builds. They will be focused on bugs fixes.
• 1.0.0-rc: final pre-release(s).
• 1.0.0: release.

Warnings

• BentoBox and its addons are 1.13 only.
• Some bugs are known to be caused by Minecraft. They will likely be fixed in the upcoming 1.13.1 release.
• Make sure to take backups, to update carefully and to keep your Spigot updated as much as possible.
• BentoBox and its addons do not contain all the features that ASkyBlock/AcidIsland used to have, that's a fact. Be patient while we progressively add them back.

How to read the changelog

Each change/tweak/bug fix is listed in the corresponding category.
If a change is likely to do something that needs the user to keep a close eye on, then it is labelled with a big bold label like this one: LABEL:

Here is a list of the labels:

• BREAKING: - the change is breaking the API and/or deprecate some parts of it. It theorically should only concern addons, so make sure to update them as well!
• LOCALE: - locale files may need to be regenerated or updated.
• HOTFIX: - the original build contained a major bug or an exploit that has been fixed. Update BentoBox as soon as possible.

Changelog

• API

1. Added CompositeCommand(Addon, CompositeCommand, String, String...) constructor.
2. Changed the main package declaration restriction to be world.bentobox.bentobox. This will allow us to create our addons using a "conventional" package naming.
3. BREAKING: Removed deprecated CompositeCommand#setParameters(String).
4. More Javadoc!
5. Created a sub-class of CompositeCommand called ConfirmableCommand.
6. All the "wait" settings have been switched to int instead of long.
7. BREAKING: Made DatabaseSetup an interface. Note: addons usually don't implement their own database handlers, they use BentoBox built-in ones. However, let's take good habits and label this change as breaking!
8. Removed FlyingMobEvents protection listener. It was basically a (very old) duplicate of the GEO_LIMIT_MOBS' flag listener.
9. Removed unused InventorySave and InventoryStore classes.
10. IslandEnterEvent and IslandExitEvent are now properly fired.
11. Shaded bStats in BentoBox and replacing Metrics class by BStats class. It will later be used to allow addons to register their own metrics through BentoBox.
12. BREAKING: Removed IslandsManager#metrics_getCreatedCount() and IslandsManager#metrics_setCreatedCount(int). Note: these methods were not used by the official addons, however it's labelled as breaking because custom addons could have used them.
13. BREAKING: Removed the current Placeholders support (world.bentobox.bentobox.api.placeholders package + world.bentobox.bentobox.lists.Placeholders.java). It was unused. Note: it will be re-implemented when we'll find a good API design for them.
14. BREAKING: Removed entity and tile limit settings from WorldSettings (#getEntityLimits(), #getTileEntityLimits()). Note: the functionality of limiting certain entities or tile entities can be
    provided by an addon instead.
15. Added support for depend and softdepend in addon.yml. Note: an addon cannot (soft-)depend from a plugin. An API will be provided soon for that.

• New features

1. Commands can require the player to have a specific minimum rank on the island to be able to execute it. See general.rank-command in the config.
2. Added coop, uncoop, trust and untrust commands.
3. Added /bentobox reload - it only reload locales for now.

• Tweaks

1. Removed Herobrine.
2. LOCALE: removed general.errors.you-need > the [permission] variable is now handled in general.errors.no-permission.
3. LOCALE: moved all confirmation-related references to commands.confirmation.xxx.
4. LOCALE: renamed protection.panel.flag-item.xxx_rank to use a dash (-) instead of an underscore (_).
5. Minor code cleanup.
6. Made the reset command use the command cooldown API.
7. Adjusted event listeners priority to stop spamming the console with island lock and ban.
8. Changed enter/exit messages to be notifications (messages that are only sent once within 5 seconds).
9. LOCALE: added colors in en-US.
10. LOCALE: added jp-JP locale.
11. LOCALE: fixed typos in en-US.
12. Removed custom metrics for now (was not used).
13. Improved admin delete command to properly delete the player's island.

• Bug fixes

1. Fixed locale references in /bentobox version.
2. Fixed UUID lookup telling that players are "known" although they never connected to the server (#232).
3. Fixed some issues depending on the OS's locale.
4. Fixed tons of code smells.
5. Fixed locale files being saved from BentoBox into addon locales.
6. Fixed error when loading add-on with no locale files.
7. Fixed resetname command making the island enter/exit messages disappear.
8. Fixed config files saving on Windows.
9. Fixed a few bugs when copying files using the FLATFILE database.
10. Fixed "Unknown player!" error occuring even if the player was connected on the server when the server is using MYSQL database.
11. Fixed FLATFILE database not saving files properly on the 1st time.
12. HOTFIX: for bug where players cannot issue commands after relogging in.

92% Feature Complete - FC-0.9 HOTFIX

WARNING: Use the build 334 from CodeMC CI because locale references in BentoBoxVersionCommand weren't updated. https://ci.codemc.org/job/BentoBoxWorld/job/bentobox/334/

92% feature complete and not bug-free pre-release version. This version is a hot-fix for FC-0.9.

WARNING: BentoBox and its addons are 1.13 only.

NOTE: There should be no need to update your addons for this update.

NOTE: Some bugs are known to be caused by Minecraft. They will likely be resolved with Minecraft's 1.13.1.
NOTE: Make sure to take backups, to update carefully and to keep your Spigot updated as much as possible.

---

Changelog :

• API

1. AdminDeleteCommand is nearly finished.
2. Updated some Javadoc.
3. Deprecated setParameters(String) in favor of setParametersHelp(String) in CompositeCommand.
4. Removed purge-related events (they were unused).
5. Actually removed Constants class.
6. Fixed default parameters and description in CompositeCommand.

• New features
  • No new features.
• Tweaks

1. Updated en-US locale to FC-0.92.

• Bug fixes

1. Fixed help commands not working properly.

90% Feature Complete

90% feature complete and not bug-free pre-release version.

WARNING: BentoBox and its addons are 1.13 only.
WARNING: This update contains API breaking changes, make sure to update your addons as well.

NOTE: Some bugs are known to be caused by Minecraft. They will likely be resolved with Minecraft's 1.13.1.
NOTE: We know some early adopters are already using BentoBox on their "production" server. Make sure to take backups, to update carefully and to keep your Spigot updated as much as possible (there is nearly 5 new builds every day)!

---

Changelog :

• API

1. BREAKING: Ready-to-use island and admin commands have been moved to the world.bentobox.bentobox.api.commands package. Feel free to use them in your Gamemode addons !
2. Removed Constants class. It was useless.
3. Added generic commands cooldown handling in CompositeCommand : #setCooldown(UUID, UUID, int) and #checkCooldown(User, UUID).
4. BREAKING: Renamed following classes :

BSBDatabase -> Database
BSBDbSetup -> DatabaseSetup
BSBConfig -> Config
DatabaseConnecter -> DatabaseConnector
FlatFileDatabaseConnecter -> FlatFileDatabaseConnector
MongoDBDatabaseConnecter -> MongoDBDatabaseConnector
MySQLDatabaseConnecter -> MySQLDatabaseConnector

5. Updated some javadoc and made it display everything.
6. Removed IslandSpawnCommand. It was an empty class.
7. Updated ItemParser to use the new BANNER material names.
8. Added authors and obsolete variables to BentoBoxLocale. They are currently not used.
9. Created a new "format" for locales meta information :

meta:
  authors:
  - tastybento
  - Poslovitch
  banner: "WHITE_BANNER:1:STRIPE_SMALL:RED:SQUARE_TOP_RIGHT:CYAN:SQUARE_TOP_RIGHT:BLUE"
  version: "FC-0.81"

10. Added #getNewOwner() and #getOldOwner() in TeamMakeLeaderEvent.
11. Added AdminDeleteCommand. Note: this is a WIP and it hasn't been tested properly.

• New features

1. Added /bentobox command. It has currently no technical use, it has mainly been implemented as a placeholder for commands to come.
2. Bypass protection permissions are now differenciated for each flag (e.g: BREAK_BLOCKS) and where they apply (everywhere or island). As an example, bskyblock.mod.bypass.BREAK_BLOCKS.island will only allow the player to break blocks inside an island's protection range. bskyblock.mod.bypass.PLACE_BLOCKS.everywhere will allow it to place blocks everywhere (inside and outside an island's protection range). Note: this is a long-awaited feature and we would be really pleased to get some feedback about it!

• Tweaks

1. Brought back automated #setDescription(String) and #setParameters(String) for CompositeCommand. It has been previously removed due to an infinite loop.
2. Updated some of the commands to use the confirmation API.
3. Updated some of the commands to use the cooldown API. Note: some commands are known to not be using it at the moment.
4. Removed following unused settings from Settings : recoverSuperFlat and muteDeathMessages.
5. Made fakePlayers an experimental config setting. Note: this has currently no effect over BentoBox, however the experimental value will later be used to explicitely tell that this setting might be dangerous to use.
6. Updated locales to use the new banner format.
7. Updated locales to use the new "meta" format.

• Bug fixes

1. Fixed EndermanListener to use BlockData instead of MaterialData.
2. Added missing protection.flags.PVP_OVERWORLD.active in en-US locale.
3. Fixed schems not being pasted correctly. They now use BlockData as well.
4. Fixed commands tab-completer not working on 1.13.
5. Fixed spawners being incorrectly handled in schems.
6. Fixed /island team kick <player> not kicking the player (even though it was said he was).
7. Fixed tons of code smells.

FC 81% Release

Installation

I recommend a fresh install for this version because a lot has changed. If you plan to use MySQL, you'll need to create a database yourself, e.g., bentobox and set the config settings in config.yml of BentoBox.

1. BentoBox is the main plugin. Put it in your plugins folder.
2. Run the server and BentoBox will create some folders, one of them called addons
3. Stop the server and edit config.yml as you like
4. Place all the add-ons (or whichever ones you want) into the addons folder
5. Start the server. The add-ons will make their folders and config files
6. (Optional) Stop the server and edit the configs how you like, then restart.

We are still in development, so by all means report bugs, but we may need to ignore them if we know about them already. Thanks!

80% Feature Complete - 1.13 update!

80% feature complete and not bug-free pre-release version.

WARNING: We updated BentoBox to fully support 1.13. This means that BSkyBlock & AcidIsland addons can not currently run on BentoBox.

NOTE: BSkyBlock's commands have been removed from BentoBox. In the current state, BentoBox is doing "nothing".

---

Changelog :

• API

1. Better exception handling with locales.
2. Changed BSBLocale constructor to BSBLocale(Locale, YamlConfiguration).
3. Changed BSBLocale#merge(File) to BSBLocale#merge(YamlConfiguration).
4. Removed acid-related events : EntityDamageByAcidEvent, ItemDestroyByAcidEvent, ItemFillWithAcidEvent, PlayerDrinkAcidEvent.
5. Better addon loading handling.
6. BREAKING CHANGE: renamed world.bentobox.bbox to world.bentobox.bentobox.
7. Removed GameType enum in Constants.
8. Description and parameters references for CompositeCommand are now set automatically, but can still be overridden.

• New features

1. Updated to 1.13 (31st July 2018 Spigot version).

• Tweaks

1. Removed a few unused references in en-US locale.
2. Fixed typos in en-US locale.
3. Made TNT a PROTECTION flag (was previously a SETTING).

• Bug fixes

1. Fixed incorrect YAML format in pl-PL locale.
2. Fixed invalid banner for pl-PL locale.