Release Highlights

• 🐛 Mob spawning fixed — Vanilla mobs, fish, and squid now spawn correctly in BSkyBlock worlds. Two long-standing spawn issues are resolved in this release.
• ⚡ Modern chunk generation — The world generator has been updated to Paper's current BiomeProvider API, replacing the deprecated BiomeGrid approach.
• 🔺 Paper 1.21.11 & BentoBox 3.13.0 required — This release targets the modern Paper and BentoBox APIs. See compatibility notes below.
• 🔡 MiniMessage locale migration — All locale files updated from legacy &c color codes to MiniMessage format.

Compatibility

✔️ BentoBox API 3.13.0+ ✔️ Paper Minecraft 1.21+ ✔️ Java 21+

Upgrading

1. Take backups of your server before upgrading.
2. Stop the server.
3. Replace the BSkyBlock jar with this one in your addons folder.
4. Restart the server.
5. You should be good to go!

🔺 BentoBox version: This release requires BentoBox 3.13.0 or newer. Earlier versions of BentoBox will not load this addon.

🔡 Locale note: Locale files now use MiniMessage format for color tags (e.g. <red>…</red> instead of &c). If you have customised your locale files, update any &c/&a/etc. codes to MiniMessage equivalents.

Legend

• 🔡 locale files may need to be regenerated or updated
• ⚙️ config options have been removed, renamed, or added
• 🔺 special attention needed

---

Bug Fixes

Mobs not spawning in BSkyBlock worlds

[PR #541] by @gochi9

The ChunkGenerator was not overriding shouldGenerateMobs(), which defaults to false in the Bukkit API. This silently suppressed vanilla mob spawning in all BSkyBlock-generated worlds. The method now correctly returns true, restoring normal mob spawn behaviour.

Water animals (fish, squid) not spawning naturally

[PR #537] Fixes BentoBox #2593

Fish and squid stopped spawning naturally in BSkyBlock worlds after the 1.21 platform migration. The fix resolves the underlying world generator issue that was preventing water animal spawn conditions from being met.

---

Other Improvements

• ⚡ Migrate chunk generator to generateNoise() + BiomeProvider API, replacing the deprecated generateChunkData() + BiomeGrid approach used since older Paper versions [commit 32152b6]
• 🔺 Update BentoBox API dependency from 2.7.1 to 3.13.0 [commit 407b483]
• 🔡 Migrate all locale sign text from legacy &c color codes to MiniMessage format across 17 language files
• Update CI to build on JDK 21 and migrate test stack to JUnit 5 + MockBukkit [PR #549]

---

What's Changed

• 🐛 Fix mob spawning in BSkyBlock worlds by @gochi9 in https://github.com/BentoBoxWorld/BSkyBlock/pull/541
• 🐛 Fix water animals not spawning naturally by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/pull/537
• ⚡ Migrate chunk generator to BiomeProvider API by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/commit/32152b6
• 🔺 Bump BentoBox API version to 3.13.0 by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/commit/407b483
• 🔡 Migrate locale sign text to MiniMessage format by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/commit/45a78a2
• Update Russian localisation by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/commit/ebce16b
• Migrate to Paper 1.21.11, Java 21, JUnit 5 + MockBukkit by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/pull/549

Full Changelog: https://github.com/BentoBoxWorld/BSkyBlock/compare/1.19.1...1.20.0

This release fixes an issue in new world creation where water creatures were not spawning naturally because the FLAT type of world height of the world became -63, i.e., one block above -64. Unfortunately, this fix doesn't change existing worlds. It can only affect new worlds.

To fix current worlds

Use are your own risk! Take a backup copy of your world beforehand

You need to edit or replace the level.dat file in the bskyblock_world folder. The simple approach is to copy a level.dat file from a generic world and paste over it, e.g. the world folder's copy. Then restart the server, and it should work. Alternatively, if you have a NBT editor, then you can change the level.dat file of the world NBT tags to look like this:

Compatibility

✔️ BentoBox API 2.7.1 or later only ✔️ Minecraft 1.21.3+ only ✔️ Java 21

Upgrading

0. Make sure you are upgrading to MC 1.21.3 or later!
1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

Changelog

Legend

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

What's Changed

• Release 1.20.1 by @tastybento in https://github.com/BentoBoxWorld/AcidIsland/pull/164

Full Changelog: https://github.com/BentoBoxWorld/AcidIsland/compare/1.20.0...1.20.1

Compatibility

• ✔️ BentoBox API 2.7.1+ only!
• ✔️ Minecraft 1.21.3 or later only
• ✔️ Java 17

Updating

0. Installed 1.21.3 or later!
1. Stop server
2. Make backups
3. Copy this jar over the last jar
4. Restart the server
5. You should be good to go!

Changelog

Legend

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

What's Changed

• 🔺MC 1.21.3 update by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/pull/533
• Version 1.19.0 by @tastybento in https://github.com/BentoBoxWorld/BSkyBlock/pull/534

Full Changelog: https://github.com/BentoBoxWorld/BSkyBlock/compare/1.18.1...1.90.0

Blueprints for islands have been updated to use the Minecraft 1.20.4 blocks.

Compatibility

• ✔️ BentoBox API 2.0.0
• ✔️ Minecraft 1.20.4
• ✔️ Java 17

Updating

1. Stop server
2. Make backups
3. Copy this jar over the last jar
4. (Optional) Move or remove the blueprints folder BentoBox/addons/BSkyBlock/blueprints so that updated ones can be saved from the Jar.
5. Restart the server
6. You should be good to go!

Changelog

Legend

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

What's Changed

• Update Github Action build script (commit: 8a97bca)
• Added distribution required for Github Action (commit: 48967ef)
• Update perms list (commit: cefefef)
• Fix deprecation code for setting world settings (commit: 7a67d2b)
• ⚙️Fix duplicate permission listing (commit: ffd5e9f)
• Fix typo (commit: 6c91835)
• Updated POM version numbers (commit: 6cbf4ee)
• Update Jacoco (commit: 0e0c0b2)
• Update pom.xml (commit: 44d8e1c)
• Add Modrinth publish workflow for GitHub Actions (commit: 01e6f92)
• Fix syntax (commit: d47493c)
• Syntax (commit: 24b963f)
• GitHub Action test (commit: d066e58)
• More Action (commit: 246a4d4)
• Update to BentoBox 2.0.0 API (commit: 25fba16)
• ⚙️Updated island blueprints to 1.20.4 (commit: 32251d4)
• Fix tests (commit: bc19f35)
• 🔡 French by @gitlocalize-app in #501
• Release 1.17.1 - Fix for L-Shaped Island name issue by @tastybento in #511

Contents

This is the QuickStart pack for BSkyBlock. This includes BentoBox and these addons to make it a full game:

• Challenges
• Level
• Warps
• ControlPanel
• DimensionalTrees
• Biomes
• Bank

Compatibility

✔️ BentoBox API 1.23

✔️ Minecraft 1.19

✔️ Java 17

Installation

1. Extract this ZIP file into your '/plugins' directory. This will place BentoBox.jar in the '/plugins' directory, and the addons will be in '/plugins/BentoBox/addons'
2. Start the server.
3. The addon will create worlds and a data folder and inside the folder will be a config.yml.
4. Stop the server .
5. Edit the config.yml how you want.
6. Delete any worlds that were created by default if you made changes that would affect them.
7. Restart the server.

Commands

• /island is the main player command.
• /bsbadmin is the top level admin command

There are many sub commands. See the command help or docs for help. These commands themselves can be changed in the config if you wish.

Changelog

Legend

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

Changes

• Update to BentoBox 1.23 API

What's Changed

• 🔡 Update RU by @gitlocalize-app in https://github.com/BentoBoxWorld/BSkyBlock/pull/486
• 🔡 Update FR by @gitlocalize-app in https://github.com/BentoBoxWorld/BSkyBlock/pull/485
• 🔡 Update DE by @gitlocalize-app in https://github.com/BentoBoxWorld/BSkyBlock/pull/484
• 🔡 Update FR by @gitlocalize-app in https://github.com/BentoBoxWorld/BSkyBlock/pull/487
• Update README.md by @blombergs5 in https://github.com/BentoBoxWorld/BSkyBlock/pull/493
• Return to plugin.yml by @BONNe in https://github.com/BentoBoxWorld/BSkyBlock/pull/498

New Contributors

• @blombergs5 made their first contribution in https://github.com/BentoBoxWorld/BSkyBlock/pull/493

Full Changelog: https://github.com/BentoBoxWorld/BSkyBlock/compare/1.16.0...1.16.1