# How to Set Up OneBlock on Your Minecraft Server (/docs/minecraft/setup-oneblock)



OneBlock is a skyblock variant where players stand on a single block that regenerates infinitely. Breaking it gives random blocks, items, and spawns mobs — progressing through phases as you mine.

Setting Up OneBlock [#setting-up-oneblock]

There are two ways to run OneBlock: as a **plugin** (Paper/Spigot) or as a **datapack/map**.

Plugin Method (Recommended) [#plugin-method-recommended]

<div className="fd-steps">
  <div className="fd-step">
    Install the OneBlock plugin [#1-install-the-oneblock-plugin]

    Go to `Plugins` on the [XGamingServer panel](https://panel.xgamingserver.com) and search for "OneBlock" (AOneBlock by tastybento is the most popular).

    Alternatively, download from [SpigotMC](https://www.spigotmc.org/resources/) and upload the `.jar` to `/plugins/` via `Files`.
  </div>

  <div className="fd-step">
    Install BentoBox (required) [#2-install-bentobox-required]

    AOneBlock runs on BentoBox, a modular island management framework. Install BentoBox first, then add AOneBlock as an addon:

    * Upload `BentoBox.jar` to `/plugins/`
    * Create `/plugins/BentoBox/addons/` folder
    * Upload `AOneBlock.jar` to the addons folder
  </div>

  <div className="fd-step">
    Restart the server [#3-restart-the-server]

    Restart from `Console` to generate config files.
  </div>

  <div className="fd-step">
    Configure the plugin [#4-configure-the-plugin]

    Edit `/plugins/BentoBox/addons/AOneBlock/config.yml` via `Files`:

    ```yaml
    world:
      # Name of the OneBlock world
      friendly-name: "OneBlock"
      # Starting island distance
      distance-between-islands: 400
    ```
  </div>

  <div className="fd-step">
    Set up permissions [#5-set-up-permissions]

    Give players access to OneBlock commands:

    ```
    /ob — Main OneBlock command
    /ob create — Create an island
    /ob home — Teleport to your island
    /ob phases — View available phases
    /ob count — Check your block break count
    ```
  </div>
</div>

Datapack/Map Method [#datapackmap-method]

<div className="fd-steps">
  <div className="fd-step">
    Download a OneBlock map [#1-download-a-oneblock-map]

    Download a pre-made OneBlock map from sites like Planet Minecraft.
  </div>

  <div className="fd-step">
    Upload the world [#2-upload-the-world]

    Follow the [Upload Custom World](/docs/minecraft/upload-custom-world) guide to replace your server's world folder.
  </div>

  <div className="fd-step">
    Install required datapacks [#3-install-required-datapacks]

    Some OneBlock maps require specific datapacks. Upload them to `/world/datapacks/` via `Files`.
  </div>
</div>

OneBlock Phases [#oneblock-phases]

The default AOneBlock plugin progresses through phases:

1. **Plains** — Basic blocks, wood, stone
2. **Underground** — Ores, caves, hostile mobs
3. **Winter** — Snow, ice, polar bears
4. **Ocean** — Water, coral, fish, guardians
5. **Jungle** — Tropical blocks, parrots, ocelots
6. **Nether** — Nether blocks, blazes, ghasts
7. **End** — End blocks, endermen, shulkers

Each phase unlocks after mining a certain number of blocks.

> 💡 **Tip:** OneBlock is great for small groups or SMP servers. It gives each player their own progression path while still allowing multiplayer collaboration.

> 📝 **Note:** The BentoBox + AOneBlock combination also supports other gamemodes like BSkyBlock, AcidIsland, and CaveBlock. You can run multiple island gamemodes on one server.

See also: [Upload Custom World](/docs/minecraft/upload-custom-world) | [Manage Datapacks](/docs/minecraft/manage-datapacks)

If you need help, join our [Discord](https://discord.xgamingserver.com/).