AOneBlock for BentoBox
Immerse Yourself in the World of OneBlock!
The AOneBlock modification transports you to a unique adventure where you find yourself on a single block floating in cosmic emptiness. This idea, originally created for single-player by IJAminecraft, has been completely reworked for multiplayer and built on the BentoBox platform for island games.
With this exciting plugin, you can run a server where each player creates their own OneBlock island. The magical block at the center of the island has an amazing property - when broken, it instantly replaces itself with a new block. Players progress through various development stages, starting with an easy "Plains" phase with abundant building materials and animals, then moving to more challenging stages like "Underground," as well as phases related to the Nether and the End. A full cycle includes about 12,000 blocks, providing long and exciting gameplay. After completing the last phase, players return to the initial stage.
Although AOneBlock has similarities to SkyBlock, it's a completely different gaming experience with unique challenges. Players face resource scarcity but in a different form - for example, water can be extremely hard to obtain in early stages, and cobblestone generators lose their importance thanks to the magical block. The main goal is to offer fresh challenges for fans of island modes.
The plugin is completely ready to use immediately after installation, while offering administrators extensive configuration options through configuration files, BentoBox parameters, and additional addons.
Installation
Important: AOneBlock requires the BentoBox plugin to be installed.
- First, download and install BentoBox.
- Place the AOneBlock.jar file in the plugins/BentoBox/addons folder.
- Start the server.
- The system will automatically create necessary worlds and data folders, including config.yml and phase configuration files.
- Log into the game and use the /ob command to start playing!
- Additional settings:
- Stop the server
- Edit config.yml and phase files according to your preferences
- Delete automatically created worlds if the changes require it
- Restart the server
Compatibility
We focus on the latest versions of Minecraft, but also provide builds for older versions through the Customize tab on the download site or on the GitHub releases page.
Commands
The main command for players is /ob, for administrators - /oba. Use /ob help or /oba help to view the full command list. Details about placeholders and permissions can be found in the documentation.
Frequently Asked Questions
Q: What phases exist?
A: There are 12 phases total: Plains, Underground, Winter, Ocean, Jungle, Swamp, Dungeon, Desert, Nether, Plenty, Desolation, Deep Dark, and End. Each phase contains blocks, chests, items, and mobs appropriate to the theme.
Q: How many total blocks are in the phases?
A: Currently 12 thousand blocks!
Q: What happens after the last phase?
A: The phases repeat in a cycle.
Q: Why do I keep falling and dying!
A: There are survival tricks, but it might be difficult at first! You need to build platforms to avoid falling.
Q: I can't catch blocks when mining! How to do it?
A: Not all blocks can be caught, but remember - this block is infinite!
Q: Why do some blocks appear more frequently than others?
A: It's a random process! You can configure the relative probability in the configuration files of the phases folder. Administrators can also set specific blocks to appear at certain times.
Q: How to identify the magical block?
A: Hit it - it will emit green particles. It's also located at the center of your island.
Q: My magical block disappeared! How to get a new one?
A: You'll need to place a block in that spot. As a last resort, you can die and the block will regenerate.
Q: My magical block turned into liquid! How to mine it?
A: Use a bucket.
Q: What mobs can appear?
A: Each phase has its own set of mobs. Be careful - they can push you off the island! If you listen carefully, you can hear hostile mobs approaching.
Q: I don't have time to react to hostile mobs appearing!
A: Be prepared. Listen carefully when mining blocks - you'll hear hostile mobs before they appear. In dangerous phases, build defensive structures. Remember that blocks can be mined from quite a distance.
Q: When mobs appear, my defenses get destroyed! Why?
A: Mobs create space to spawn. If something is in the way, it will be broken and dropped. You need to build considering this feature to prevent suffocation mechanic exploitation.
Q: Do chests appear?
A: Yes. Chests appear with random items from the current phase. There are common, uncommon, rare, and epic chests. Chests with sparkles are particularly valuable.
Q: Can I reach the Nether or End on this map?
A: The standard Nether exists by default, but there is no End world - only an End phase.
Q: What is the ultimate goal?
A: It's whatever you want it to be!
Phase Configuration
Configuration files for setting up phases are located in the phases folder.
For each phase, there are two files - one contains blocks and mobs, the other contains chests.
The first number in any file indicates how many blocks need to be mined to reach this phase. This is the phase's key number. Each phase also has a name, icon, biome, and the following sections:
- name
- icon
- fixed blocks
- holograms
- biome
- start commands
- end commands
- first completion commands
- requirements
- blocks
- mobs
The chest file only contains the phase number and a chests section.
Name
Phase name
Icon
Material for displaying the icon
Fixed Blocks
List of blocks that will generate at specific mined block counts. The numbers relate to the phase, not the player's overall count. If you define 0 here, then firstBlock is not required and will be replaced with this block.
Holograms
Hologram lines to display. The key number is the phase block where the hologram is shown. Chat color codes can be used. A hologram plugin is not required for these holograms. The first hologram (before Phase 1) is located in your localization.
Biome
Biomes for this phase.
Commands
A list of commands that can be executed at the start and end of a phase. Commands are executed as Console, unless the command has the [SUDO] prefix, then the command is executed as the player triggering the commands.
These placeholders in the command string will be replaced with appropriate values:
- [island] - island name
- [owner] - island owner's name
- [player] - name of the player who broke the block triggering the commands
- [phase] - name of this phase
- [blocks] - number of broken blocks
- [level] - your island level (requires Levels Addon)
- [bank-balance] - your island bank balance (requires Bank Addon)
- [eco-balance] - player's economy balance (requires Vault and an economy plugin)
Examples:
start-commands:
- 'give [player] WOODEN_AXE 1'
- 'broadcast [player] just started OneBlock!'
end-commands:
- '[SUDO]summon minecraft:wither'
These commands are executed only on first phase completion
end-commands-first-time:
- 'broadcast &c&l[!] &b[player] &fhas completed the &d&n[phase]&f phase for the first time.'Requirements
You can set a requirement set to start the phase:
- economy-balance - minimum player economy balance (requires Vault and an economy plugin)
- bank-balance - minimum island bank balance (requires Bank Addon)
- level - island level (requires Levels Addon)
- permission - permission string
Example:
requirements: bank-balance: 10000 level: 10 permission: ready.for.battle
Blocks
The blocks section contains Bukkit Materials with relative probability. All probability values are summed for the entire phase, and the chance of a block being placed equals the relative probability divided by the sum of all probabilities.
Mobs
The mobs section contains mobs that can spawn, their relative probability along with blocks. You can only list living entities that can spawn in this list.
Chests
If CHEST is listed in the blocks section, it will be randomly filled according to this section. You can define as many chests as you want. The first number is a unique chest number. Then follows the chest contents including the slot number and item stack contents. Finally, the chest's rarity is specified: COMMON, UNCOMMON, RARE, or EPIC. The best way to configure chests is to do it in-game. Fill a chest with the desired contents and, while looking at it, enter the command /oba setchest <phase> <rarity>, where <phase> is the phase name and rarity is the rarity. Use tab completion to view options. The chest will be automatically added to the oneblocks.yml file and ready to use. Deleting chests currently must be done by editing the oneblocks.yml file and reloading the addon.
Be very careful when editing chest items and verify that the material is a genuine Bukkit material and spelled correctly.
Other Addons
OneBlock is an addon that uses the BentoBox API. You can add all the usual addons to OneBlock, such as Challenges, Likes, Level, Warps, etc., but it's not required.
