1.0 - The Beginning of a long Journey...

Description

We finally did it. This took us three years, but we did it! BentoBox is finally production-ready. If you don't mind, we still have a long way to go, at your side ❤️.

Now, sit back. Relax. Take a deep breath. And take advantage of this moment of reading to look at the past, observe the present and imagine the future.

Thanks to everyone ❤️.

Update your addons

Official addons will all receive an update in the following hours or days. Thanks to our incredible crew, you might expect some exciting newcomers as well!

About supported server softwares and server versions

Due to the potential data-loss risks or errors that could occur when running BentoBox on an incompatible server software and/or server version, BentoBox will now stop loading in such an environment.

Therefore, you must run BentoBox on a 1.13.2 Spigot server. Not Bukkit/CraftBukkit. Paper and TacoSpigot are officially not supported, but BentoBox should load correctly.

Changelog

Legend

• ⚠️ may break parts of the API.
• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Contents

API

1. ⚠️ Replaced FlagBuilder with Flag.Builder. Renamed some of the methods (#409).
2. ⚠️ Made Flags final so it cannot be extended.
3. ⚠️ Added GameModeAddon (#415). This is a specific implementation of Addon which creates its own Game world. More information with this video.
4. Greatly improved the Javadoc!
5. ⚠️ IslandWorldManager's methods are now using GameModeAddon.
6. ⚠️ Removed AdminClearresetsCommand and AdminClearresetsallCommand.
7. Added set and reset subcommands to a new AdminResetCommand (#353).
8. ⚠️ Fixed AddonDescription to use a valid Builder pattern.
9. Finished implementation of Addon#onReload().
10. Added AdminReloadCommand for addons to use.
11. Added LogEntry and LogEntryListAdapter.
12. ⚠️ Renamed Island#addToBanList(UUID) to Island#ban(UUID, UUID).
13. ⚠️ Renamed Island#removeFromBanList(UUID) to Island#unban(UUID, UUID).
14. Added ConfigEntry#hidden().
15. Removed @since Javadoc tags. They were useless because they were added during the Alpha process.

Features

1. 🔺 Implemented ability to have multiple schems (#104, #207, #378, #408). Schems can be named anything, but the partner nether or end worlds must be pre-fixed with nether- or end- in the filename. Additional schems can be added by the admin into the schem folder, or they can be stored in the jar file of the add-on. Both are supported.
2. 🔡 Added DISABLE_TELEPORT_WHEN_FALLING flag (WORLD_SETTING) (#403). It will prevent players from teleporting back to their islands using commands when they're falling into the void.
3. 🔺 🔡 Added DISPENSER, DROPPER, HOPPER flags (PROTECTION) (#401). These were previously protected by the CHEST flag).
4. 🔺 🔡 /<admin> clearresets and /<admin> clearresetsall are replaced with /<admin> resets reset. Use @a instead of the player's name to reset the resets counter of all players (#353).
5. 🔡 Added /<admin> resets set <player> <resets> (#353).
6. 🔺 🔡 ⚙️ Implemented asynchronous schem pasting (#376). Current schem are compatible, however you must update them to the new format (by pasting them and re-saving them) in order to avoid issues such as torches popping, etc... If you were using the default ones, you just need to delete the schems folder and restart your server.
7. 🔡 ⚙️ Added ban limit (#423).
8. 🔡 Added ITEM_FRAME flag (PROTECTION) (#391).
9. /bentobox reload now reloads Addons that support reloading (#370).
10. 🔺 🔡 ⚙️ Removed general.allow-obsidian-scooping and made it a WORLD_SETTING flag OBSIDIAN_SCOOPING (#432).

Tweaks

1. 🔺 🔡 Renamed CHEST flag to CONTAINER (#402). Players will need to update the value as it will be resetted to default.
2. ⚙️ Removed general.starting-money from the config (#432).
3. Added defensive code in JSON-based databases.
4. Improved some config comments.
5. Metrics: added islands count.
6. ⚙️ Removed island.custom-ranks from the config (#432).
7. Made general.rank-command experimental in the config.
8. 🔡 Improved the "successfully loaded" message in the console.

Bug fixes

1. Fixed /bentobox reload not reloading correctly the locales from addons (#417).
2. Fixed code smells (lots of them!).
3. Fixed commands being registered with their main label as fallbackPrefix. E.g.: /is from BSkyBlock was registered as /island:is instead of /bskyblock:is.
4. Fixed IslandCreatedEvent/IslandResettedEvent being fired too early.

Work in progress

This release contains some features that are still being worked on. However, we couldn't remove them safely from the production branch, as some features relies on some of these changes. Therefore, we disabled them for this release so they won't do anything bad. Once they'll be fully implemented, we'll let you know!

1. Automated island ownership transfer (#167).
2. Island logs / Island history / Island timeline.

Alpha 13 - Santa Claus is coming to town!

Description

We're obviously late - but well, where's the fun of developing a plugin on our free time if we had to sleep one hour a day to keep up with daily releases? We know there are some new Skyblock plugins that came out recently. And that they actually catched up in less than a month what we did in two years. But we're working with ❤️, and you'll see the difference!

This pre-release might be the last one, actually. A lot of work still has to be done, especially on addons and user experience, but the metrics we gather talk for themselves: 70 servers are using BentoBox while we're still in alpha. Even though that's nothing compared to the 2000+ servers using ASkyBlock and the old AcidIsland, that's impressive. Thanks!

Today, we've got some crunchy new features, tweaks and bug fixes that'll make everyone's life easier 🙂.

Update your addons

Official addons will all receive an update in the following days, in order to use all the new features that got added in Alpha 12 & 13.

Changelog

Legend

• ⚠️ may break parts of the API.
• 🚧 classes or methods have been deprecated.
• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Contents

• API

1. Plugins will now be able to request data from addons using Addon#request(String, Map<String, Object> (#400 @HyKurtis). Note that this is still a WIP - addons need to be updated to use this new system. But we sincerely hope it will make creating external plugins requesting addon's data a lot easier!
2. LocalesManager: added #getOrDefault(User, String, String) and #getOrDefault(String, String).
3. ⚠️ Removed deprecated methods in Island.

• Features

1. 🔡 Added NAME_TAG flag (#390).
2. 🔡 🔺 Splited PORTAL flag into NETHER_PORTAL and END_PORTAL (#388). NETHER_PORTAL and END_PORTAL will be using the default protection values, not PORTAL's one, so please make sure to tell your players that they may need to change these settings on their island.
3. 🔡 🔺 Added support for translatable "starting" sign (#372). The sign must have [start] as its first line.

• Tweaks

1. Players trying to go through an End portal while they are not allowed to will receive the "Island protected" message. It was previously silently denying the action.
2. Added some metrics related to the database type and the default language.
3. Added website to plugin.yml.
4. BentoBox now only tries to enable/disable addons if there is at least one addon loaded.

• Bug fixes

1. Fixed NPE when reloading BentoBox after deleting the locales folder (#385).
2. Fixed island deletion deleting some blocks of nearby islands (#405).

Alpha 12 - It's freezing cold outside!

Description

Winter is coming. Unless you live in the southern hemisphere. In that case, would you consider sending us some of the Sun back? - Thanks.
This pre-release fixes bugs and introduces a bunch of tweaks and features

Addons will be updated on December, 16th.

In order to fully take advantage of all the features that got added in this version, you will have to update your addons (especially BSkyBlock / AcidIsland) once we release an update for both of them.

Changelog

Legend

• ⚠️ may break parts of the API.
• 🚧 classes or methods have been deprecated.
• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.

Contents

• API

1. 🔡 Added AdminDeathsCommand, AdminDeathsSetCommand and AdminDeathsResetCommand to allow admins to set/reset death count of players (#76).
2. Fixed code smells.
3. 🔡 Added IslandInfoCommand with the following aliases: info, who (#361). This is basically a copy/paste from AdminInfoCommand.
4. 🚧 Deprecated Island#showInfo(BentoBox, User, World) and Island#showMembers(BentoBox, User, World). They are replaced with equivalents that only requires an User as parameter: Island#showInfo(User) and Island#showMembers(User).
5. Added Addon#onReload() (#370). It currently has no effect.
6. Improved various Javadoc bits.

• Features

1. 🔡 Added FROST_WALKER protection flag (#183). Frosted ice generation was previously protected by the PLACE_BLOCK flag.
2. 🔡 Coops are now removed of the island when all island members are logged out (#335).
3. 🔡 Added EXPERIENCE_PICKUP protection flag (#217).

• Tweaks

1. Made the "tried to paste schem" error less confusing.
2. 🔡 Added commands.help.syntax-no-parameters to avoid layout inconsistencies in the command help layout (#379).
3. Language names in the Language Panel are now longer italicized.
4. 🔡 World Settings flags that are using a "sub-panel" now have their name yellow (configurable in localization files) (#383).
5. 🔡 Added colors to the Settings Panel's categories (configurable in localization files as well) (#383).
6. Upgraded bStats dependency to 1.4. I don't really know what this brings, but keeping things up to date is fine!

• Bug fixes

1. Fixed animals which could be bred or fed to grow up while BREEDING was not allowed (#366).
2. Fixed AdminVersionCommand returning nothing (#374). It now displays the addon's version.
3. 🔡 Fixed some multi-line localization colors (#383 (comment)).
4. 🔡 Fixed some formatting in all localization files.

Alpha 11 - The "We're LAAAATE" update

Description

This pre-release brings some bug fixes, although it is mainly focused on improving the consistency in the code.

When will BentoBox be released ?

I originally planned to release BentoBox (1.0) by the end of November, but I have to admit we're late. Therefore, the new goal is to release BentoBox by the end of December!

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.

• ⚠️ may break parts of the API.
• 🚧 classes or methods have been deprecated.
• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.

Contents

• API

1. ⚠️ Removed previously deprecated methods and classes (check Alpha 9's changelog).
2. Fixed some code smells.
3. Replaced all the code referencing to team leader. This was a long-time misleading conception (it comes from ASkyBlock): island owners were sometimes known as "team leaders", sometimes "leaders" and sometimes "owners". As of today, it will be "owner" everywhere.
4. Added IslandsManager#getIslandCount(World).
5. Added some defensive code in User#getPermissionValue(...) to prevent bugs in case the provided permissionPrefix was ending with a dot.

• Features

1. ⚙️ Finished implementation of max-islands config option for Gamemode addons. No need to update your addons, as this was an unfinished feature that was already implemented.

• Tweaks

1. 🔡 Removed en-GB and fr-FR locales: they were outdated. An updated French locale is on the way.
2. 🔡 Updated all locales to match the consistency of the code regarding "island owners". You must regenerate your locale files as the previous ones will be out of sync!

• Bug fixes

1. Fixed NPE when using Nether portal when there was no Nether world (#365).
2. Removed a forgotten "DEBUG" when using buckets.
3. Fixed team.maxsize (max team size) permission not working (#114).

Alpha 10 - Bug fixes

Description

This pre-release fixes bugs that were brought by some changes in Alpha 9.

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.

• ⚠️ may break parts of the API.
• 🚧 classes or methods have been deprecated.
• 🔠 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.

Contents

• API

1. Provided some debug for developpers using the Database API.

• Bug fixes

1. Fixed BREEDING not protecting turtle breeding (#348).
2. Fixed lowercased or mixed-case enum entries in database not being read when loading databases (BentoBoxWorld/Challenges#33).
3. Fixed the Yaml database no longer working properly as of Alpha 9.

Alpha 9 - Running late...

Description

⚠️ It seems this release has some issues with Yaml databases. A bug fix version will be released as soon as possible.

This pre-release brings in bug fixes and deprecates some methods that needed to be renamed to ensure consistency.
You won't need to update your addons alongside this release.

We're running some delay with our original planning. Alpha 9 should have been the last alpha before the actual 1.0 release, however that logically won't be the case.

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.

• ⚠️ may break parts of the API.
• 🚧 classes or methods have been deprecated.
• 🔠 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.

Contents

• API

1. Improved some bits of Javadoc.
2. Added LocalesManager#get(String).
3. 🚧 Deprecated #getTeamLeader(...) methods in CompositeCommand, IslandCache and IslandsManager : they are renamed to #getOwner(...).
4. Added a generic IslandEvent that provides the Reason why it was called (#346).
5. ⚠️ 🚧 Moved addon exceptions to world.bentobox.bentobox.api.addons.exceptions; older ones got deprecated.
6. Added a generic event to expose addon info via K,V pairs (#352 (comment)).

• Features

1. ⚙️ 🔠 Added FISH_SCOOPING flag to prevent players from scooping fishes using a water bucket (#349).
2. Added pagination to the Settings panel (WIP).
3. ⚙️ 🔠 Added TURTLE_EGGS flag to prevent players from crushing turtle eggs (#348).

• Tweaks

1. 🔠 Replaced %bsb_plugin_name% in all locale files by BentoBox.
2. 🔠 Removed de-DE locale: it was outdated.
3. 🔠 Updated zh-CN locale (@CNAmira).
4. Flags in the Settings panel are now sorted alphabetically based on the player's locale (WIP).

• Bug fixes

1. Fixed PVP not protecting players from being set to fire using flame arrows (#336).
2. Cooped players now lose the coop when they logout or on server shutdown (#335).
3. Fixed ARMOR_STAND not protecting players from moving armor stands using fishing rods (#350).
4. Fixed error when tab-completing some commands with no island (#358).

Alpha 8 - Provision of patches

Description

This pre-release is intended to fix bugs. A few new features were also added. And there is not a single API breaking change 🙂.

You won't need to update your addons alongside this release.

Placeholders

Although Placeholders integration is implemented in BentoBox, Addons are currently not registering their own placeholders. This is due to a few incoming changes, which is keeping us from adding them.

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.

• 🔠 - locale files may need to be regenerated or updated.
• ⚙️ - config options have been removed, renamed or added.

Contents

• API

1. Improved Javadoc.
2. Slight optimizations in PlaceholdersManager.
3. Added MultiverseCoreHook.
4. Added CycleClick(String, int, int) constructor (#332).

• Features

1. ⚙️ 🔠 Added COARSE_DIRT_TILLING in WORLD_SETTING flags. This helps avoid players tilling coarse dirt using a hoe to obtain dirt (#337).

• Tweaks

1. LOCK flag can now only be applied to the MEMBER rank at maximum. This means that island owners can no longer lock their island to the island members or island sub-owners: they can still do so for trusted, cooped and visitors (#332).
2. Player file is now preventively saved in the database after they create an island.

• Bug fixes

1. Fixed obsidian scooping replacing the whole bucket stack with lava buckets (#338).
2. Fixed errors that could occur when adding island to the grid (#326). Also introduced some defensive code there.
3. Fixed errors spamming console when teleporting to non-BentoBox worlds (#310).
4. Fixed protection checks not correctly taking into account standard Nether and End (#331).
5. Fixed teleporting back from standard Nether to island.
6. Fixed island members dying when joining an island locked to members (#332).
7. Fixed a few bugs with protection (#336):

• Placing boats is now prevented by PLACE_BLOCKS;
• Using bone meal is now prevented by PLACE_BLOCKS;
• Fixed interaction with Shulker Boxes (CHEST);
• Flower pots interaction is now prevented by CHEST;
• Using name tags is now prevented by PLACE_BLOCKS;
• Hurting pufferfish is now prevented by HURT_MONSTERS;
• Hurting other types of fish is now prevented by HURT_ANIMALS;

8. Fixed the ENDER_CHEST flag not using the Notifier.

Alpha 7 - The very small super tiny update that fixes (a) huge bad bug(s)

Description

This pre-release fixes a major bug with Placeholders implementation (you basically couldn't run BentoBox if you didn't have PlaceholderAPI in the plugins folder).
There is no need to update your addons alongside this release.

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.

Contents

• API

1. ⚠️ Renamed AbstractFlagListener to FlagListener.
2. ⚠️ Moved all PlaceholderAPIHook's inner classes to their own classes in the \api\placeholders\placeholderapi folder.

• Bug fixes

1. Fixed BentoBox not launching when PlaceholderAPI wasn't installed on the server.
2. Fixed double chests pasting in certain orientations that could cause an ArrayOutOfBoundsException (#326).

Alpha 6 - The protection killer

Description

This pre-release fixes a major bug with protection and also implements PlaceholderAPI integration. Addons now have to register their own placeholders. If you've got any idea of placeholders you'd like us to add, feel free to post them here : #322.
There is no need to update your addons alongside this release.

The Challenges addon still didn't receive an update, is it safe to keep it?

Yes, it is. Some of its minor features may no longer work, but the addon is globally working fine.

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!

Contents

• API

1. Added PlaceholdersManager. You can get it using BentoBox#getPlaceholdersManager().
2. ⚠️ Removed AbstractFlagListener#getWhy() - it was internally not used and was most likely not used by addons.

• Features

1. Implemented PlaceholderAPI integration (#322).

• Bug fixes

1. Fixed protection listeners not being registered in Bukkit as the plugin was no longer considered as "loaded" at the time the registration was taking place.

Alpha 5 - The (not so) Spooky update!

Description

This pre-release fixes a few bugs and brings us the ability to hook into plugins, such as Vault and soon PlaceholderAPI! This version also introduces a lot of API breaking changes. They are necessary to provide you the nicest API when we will release 1.0 (before 2019).

Update very carefully !

A lot of config options changed, but please take a closer look to the database type:

• If you were using FLATFILE, please change it to YAML.
• If you were using MONGO, please change it to MONGODB.

"The Flattening", part 2

Level and WelcomeWarpSigns got updated and received their "Flattening update". They are now both available on CodeMC's Maven repository.
⚠️ There is a minor data loss risk for these two addons. If this occurs, just ask your players to recalculate their island level (if you're using Level) or to re-create their warp (if you're using WWS).
⚠️ Config & locales for both addons will be regenerated, as their name changed. Make sure to update carefully !

1.13.2

There was no significant change to Spigot's API between 1.13.1 and 1.13.2, so it's now safe to say that BentoBox officially supports 1.13.2 !

Update your addons !

Each addon you're using must be updated, otherwise they just won't launch (yes, I made it so that it won't spam your console with a huge load of errors ❤️).

Where is the Challenges addon ?

Ahum... Well, I didn't have the time to update this one yet. So, as we said in 2016, keep calm and wait for Poslovitch to fix that.

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/fixed some Javadoc in a few classes.
2. ⚠️ IslandsManager: renamed #getCount() to #getIslandCount(); renamed #makeLeader(...) methods to #setOwner(...).
3. Added Addon#getPermissionPrefix(): it is a method that returns the permission prefix automagically generated from the addon's name.
4. ⚠️ Removed CompositeCommand#setPermissionPrefix(String): it is now inherited from the Addon's.
5. ⚠️ Renamed AdminTeamMakeLeaderCommand to AdminTeamSetownerCommand.
6. ⚠️ Renamed TeamEvent.TeamMakeLeaderEvent to TeamEvent.TeamSetownerEvent.
7. ⚠️ Lowercased some command class names to better fit how they are actually working in game : AdminClearresetsallCommand, AdminClearresetsCommand, AdminGetrankCommand, AdminSetrankCommand.
8. ⚠️ Replaced Addon#setEnabled(boolean) by Addon#setState(Addon.State).
9. Removed YmlConfiguration and YmlCommentParser as they weren't used.
10. AddonsManager: removed #loadAddonsFromFile(), renamed #setLoader(...) to #setLoaders(...).
11. ⚠️ ⚙️ DatabaseSetup.DatabaseType: renamed MONGO to MONGODB.
12. ⚠️ DatabaseConnector: removed #loadYamlFile(...) and #saveYamlFile(...) as they weren't generic to all database connectors.
13. Added AbstractJSONDatabaseHandler<T>.
14. ⚠️ Made all DatabaseHandlers' and DatabaseConnectors' constructors package-private: these shouldn't have been used by any external plugin/addon.
15. ⚠️ Moved TypeAdapters in database/json/adapters package.
16. ⚠️ Moved DATABASE_FOLDER_NAME to AbstractDatabaseHandler<T>.
17. ⚠️ ⚙️ Renamed FLATFILE database type (and related files) to YAML.
18. Fixed some code smells.
19. Implemented the Hooks API: Hook and HooksManager.
20. Implemented Vault integration: VaultHook.
21. ⚠️ Removed AddonInterface and put its methods in Addon.

• Features

1. Implemented Vault integration: money reset on island join/leave should now be working.

• Tweaks

1. Changed the command /is team setleader <player> to /is team setowner <player>.
2. ⚙️ general.database.type: renamed FLATFILE to YAML, added JSON and renamed MONGO to MONGODB.
3. ⚙️ Renamed island.customranks to island.custom-ranks and made it experimental (Spooky!).
4. Added some safety checks to the config loading: some options will now be using their default value if the one in the configuration is invalid, instead of throwing ugly stacktraces.

• Bug fixes

1. 🔠 Fixed some entries in the en-US locale being invalid.
2. Fixed island protection range not being updated after a login if there was a permission change (#256).
3. Fixed outdated addons causing errors in console when loading (#281).
4. Fixed the AddonsManager disabling not-enabled addons.
5. Fixed the [label] text variable being replaced by "invite" in the invite notification (#315).
6. Fixed island members sometimes not being recognized and therefore considered as visitors on their own island (#318).
7. Fixed [version] text variable in config comments always being replaced by BentoBox's version instead of the addon's (#312).