🌟 Level Add-on for BentoBox

🔍 What is Level?

Level is the ultimate competition booster for your BentoBox server! Designed for game modes like BSkyBlock, AcidIsland, and more, this powerful add-on turns your island into a battleground of block-by-block domination.

Every block you place counts toward your island level—and every block you lose could cost you your spot in the rankings. Whether you're aiming for the top ten or just flexing your creative builds, Level adds stakes, strategy, and excitement to your sky-high journey.

📘 Full Documentation
📦 Official Downloads

---

🚀 Getting Started

Ready to level up? Here's how to launch Level on your server:

1. Drop the Level add-on .jar into your BentoBox addons folder.
2. Restart your server and let the magic happen.
3. A new Level data folder and config.yml will be created.
4. Open config.yml and customize block values, settings, and behavior to suit your game mode.
5. Restart your server again to apply changes.

Now you’re all set—go build something worth leveling for! 🏗️

---

🔄 Upgrading

When updating, always read the release notes!
Some updates might require a fresh config.yml, so make backups and review changes carefully.

---

🛡️ Permissions

Level integrates directly with your permissions plugin, giving players the tools to compete while letting admins keep control.

Default permissions for BSkyBlock, AcidIsland, and CaveBlock:

permissions:    
  bskyblock.intopten:             # Show up in top 10
    default: true
  bskyblock.island.level:         # Use /is level
    default: true
  bskyblock.island.top:           # Use /is top
    default: true
  bskyblock.island.value:         # Use /is value
    default: true
  bskyblock.admin.level:          # Admin access to /is level
    default: true
  bskyblock.admin.topten:         # Admin access to /is topten
    default: true

⚠️ Players need intopten to appear in the leaderboard!

---

⚙️ Configuration: Make It Yours

The config.yml file gives you total control over how leveling works. Here's a breakdown of what you can tweak:

🎮 Game Mode Hook

Tell Level which BentoBox game modes it should connect to.

⚙️ General Settings

• Underwater Block Multiplier – Give bonus points for blocks below sea level.
• Level Cost – Set how many points are needed to gain 1 island level.
• Level Wait – Add a cooldown between level scans.
• Death Penalty – Punish deaths with level loss.
• Sum Team Deaths – Choose whether to track team deaths or just the leader's.
• Reset on Island Reset / Team Join – Wipe the death count when teams change or islands are reset.

🚫 Block Limits

Cap the number of specific blocks that count toward level (e.g., only 200 DIAMOND_BLOCKs count).

Format:

DIAMOND_BLOCK: 200

💎 Block Values

Assign point values to blocks to reward rare or hard-to-get materials.

Format:

STONE: 1
DIAMOND_BLOCK: 100

Blocks not listed are worth 0. AIR is always ignored.

🌍 World-Specific Values

Customize block values for individual worlds or game modes.

Example:

worlds:
  AcidIsland_world:
    SAND: 0
    SANDSTONE: 0
    ICE: 0

In this setup, AcidIsland disables points for sand-based blocks while using default values for everything else.

---

🏁 Final Words

Level isn’t just a numbers game—it’s a challenge, a competition, and a celebration of creativity.
Whether you're climbing the ranks or just making your mark, Level brings out the best in your builds.

💡 Need help or want to contribute? Join the community at bentobox.world and show us what your island is made of!

Now go get that top spot. 🌌
— The BentoBox Team