BentoBox

SkyBlock, OneBlock, AcidIsland, and more - all in one plugin

BentoBox powers island-style game modes for Paper servers. Pick the game modes you want, drop them in, and you're running. No forks, no outdated code — one actively maintained platform that stays current with every Minecraft release.

Game modes available:

• BSkyBlock — classic SkyBlock, successor to the original ASkyBlock
• AOneBlock — the popular OneBlock experience
• AcidIsland — survive in a sea of acid
• Boxed — expand your world by completing advancements
• CaveBlock — underground survival
• SkyGrid — scattered blocks, maximum adventure
• Poseidon — underwater island challenge
• And more community-created game modes

Why server admins choose BentoBox:

• Run multiple game modes on one server with shared features (challenges, warps, levels, leaderboards)
• 20+ addons let you customize exactly the experience you want
• Actively maintained and always up to date with the latest Minecraft version
• Free and open source — used on 1,100+ servers worldwide
• Rich API for developers who want to build custom addons

Full Documentation

Installation

1. Place the BentoBox jar in your plugins folder
2. Start the server
3. Download the game mode and feature addons you want from this site or download.bentobox.world and place them in the plugins/BentoBox/addons folder
4. Restart the server — you're good to go

Addons

These are some popular Gamemodes:

• AcidIsland: You are marooned in a sea of acid!
• AOneBlock: Start to play with only 1 magical block.
• Boxed: A game mode where you are boxed into a tiny space that only expands by completing advancements.
• BSkyBlock: The successor to the popular ASkyBlock.
• CaveBlock: Try to live underground!
• SkyGrid: Survive in world made up of scattered blocks - what an adventure!

All official Addons are listed here:

• Addons

There are also plenty of other official or community-made Addons you can try and use for your server!

Documentation

• Start reading: https://docs.bentobox.world
• For developers: Javadocs

Bugs or Issues

File bugs on GitHub. Confused? Ask on Discord. Note: we are not a company, so please be kind with your requests.

Developers

• Jenkins (untested and mostly unstable builds)
• Javadocs

What about contributing?

Join the BentoBox community. You don't need to know any programming language to start helping us.

You can contribute by:

• Donating or sponsoring the developers
• Coding new addons
• Adopting an Addon and maintaining it
• Translating text for BentoBox and Addons (We use GitLocalize to make this easier)
• Submitting good bug reports or helpful feature requests
• Fixing bugs and submitting Pull Requests for the fixes

If you contribute code it must be in agreement with:

• our license
• our code of conduct
• our contribution guidelines

Report bugs and suggest features

Bugs and feature requests must be filed on our issue tracker.

Pull requests

We consider Pull Requests from non-collaborators that contain actual code improvements or bug fixes. Do not submit PRs that only address code formatting because they will not be accepted.

API

BentoBox uses Maven, and its Maven repository is kindly provided by CodeMC.

Maven

<repositories>
  <repository>
    <id>codemc-snapshots</id>
    <url>https://repo.codemc.org/repository/maven-snapshots</url>
  </repository>
  <repository>
    <id>codemc-repo</id>
    <url>https://repo.codemc.org/repository/maven-public/</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>world.bentobox</groupId>
    <artifactId>bentobox</artifactId>
    <version>PUT-VERSION-HERE</version>
    <scope>provided</scope>
  </dependency>
</dependencies>

Gradle

repositories {
  maven { url "https://repo.codemc.org/repository/maven-public/" }
}

dependencies {
  compileOnly 'world.bentobox:bentobox:PUT-VERSION-HERE-SNAPSHOT'
}

Note: Due to a Gradle issue with versions for Maven, you need to use -SNAPSHOT at the end.