Sueta

OneBlock Lite ⭐ | GUI | Islands | Trust | ItemsAdder/Oraxen/

1.0.2 Community Build

Intuitive OneBlock islands with GUI, trust, visits, protection and custom blocks.

·Plugin


Native and tested version: Spigot/Paper 1.21.8
Designed for: Spigot/Paper 1.21.x
Recommended version: Spigot or Paper 1.21.8
Java version: Java 17 or newer
Recommended Java version: Java 21

OneBlockLite

Simple OneBlock islands with GUI, phases, trust, visits, Nether and End islands, dimension progression and island protection.

A clean and intuitive OneBlock plugin built for community servers.

Create, protect and expand your personal OneBlock island

OneBlockLite gives every player a personal island with a central regenerating block, configurable phase progression, protection, trust, visits and separate Overworld, Nether and End islands.

Players can start with /ob, create their island, return home, manage trusted players, visit trusted islands and progress through configurable phases without needing to remember many commands.

Each dimension can have separate progression, block pools, events and loot. Nether and End support can also be enabled or disabled independently by the server administrator.

Features

  • Easy and configurable GUI with /ob and /ob gui

  • Personal OneBlock islands for every player

  • Overworld, Nether and End OneBlock islands

  • Separate phase progression for each dimension

  • Nether and End portal support

  • Configurable world names for every dimension

  • Configurable phases and block pools

  • Dimension-specific phases and block pools

  • Configurable phase-based chest loot

  • Separate loot tables for each dimension

  • Random events support

  • Configurable progress boss bar

  • Trust GUI for sending, accepting, denying and removing trust

  • Visit GUI for browsing trusted online islands

  • Configurable commands, aliases and permissions

  • Configurable GUI layout, materials and slots

  • Island border protection

  • Protection against unauthorized building and breaking

  • Configurable PvP protection

  • Void rescue system

  • End world protection and dragon battle prevention

  • Protection from vanilla End structures and artifacts

  • Safe island deletion with confirmation

  • Runtime configuration reload

  • PlaceholderAPI support

  • Dynamic placeholders for visited islands

  • Custom block support for ItemsAdder, Oraxen, Nexo and CraftEngine

  • Optional Nether and End dimensions

  • bStats support

  • Premium feature previews without store links

  • No ProtocolLib required

  • No VoidWorld required

  • No EssentialsX required

How to Start

  1. Stop your server.

  2. Put the OneBlock-1.0.2-community.jar file inside your /plugins folder.

  3. Install Multiverse-Core if you want to use the recommended world creation method.

  4. Start the server once so OneBlockLite is loaded.

  5. Create the OneBlock void worlds with Multiverse-Core:
/mv create oneblock normal -g OneBlockLite
/mv create oneblock_nether nether -g OneBlockLite
/mv create oneblock_end the_end -g OneBlockLite
  1. Make sure the world names match the names configured in plugins/OneBlockLite/config.yml:
oneblock-worlds:
overworld: "oneblock"
nether: "oneblock_nether"
end: "oneblock_end"
  1. Restart the server or reload OneBlockLite:
/ob reload
  1. Players can now open the OneBlock GUI with:
/ob

Before updating from an older version, stop the server and create a backup of the OneBlockLite plugin folder.

Portal Support

Nether and End portals can send players directly to their personal OneBlock Nether or End island.

This behaves like:

/ob nether
/ob end

MultiverseNetherPortals is optional and can be used for advanced multi-world portal routing.

Recommended MultiverseNetherPortals configuration:

bounceback: true
teleport_entities: true
send_no_destination_message: true
send_disabled_portal_message: true
end_platform_drop_blocks: true

portal-auto-link-when:
nether:
prefix: ''
suffix: _nether
end:
prefix: ''
suffix: _end

worlds: {}

Make sure the dimension world names match the names configured in config.yml:

oneblock-worlds:
overworld: "oneblock"
nether: "oneblock_nether"
end: "oneblock_end"

Commands

Player commands

/ob
/oneblock
/ob gui
/ob create
/ob go
/ob overworld
/ob nether
/ob end
/ob status
/ob reset
/ob trust add <player>
/ob trust remove <player>
/ob trust accept <player>
/ob trust deny <player>
/ob visit <player>
/ob leave
/ob help
/ob premium

Administrative commands

/ob reload
/ob teleport <player>
/ob delete <player|uuid>
/ob confirm
/ignoreclaim

Default aliases

/ob menu -> /ob gui
/ob home -> /ob go
/ob island -> /ob go
/ob info -> /ob status
/ob pro -> /ob premium
/ob tp -> /ob teleport
/ob remove -> /ob delete

Commands, aliases and permissions can be enabled, disabled or customized inside commands.yml.

PlaceholderAPI Placeholders

PlaceholderAPI is optional and is only required if you want to use OneBlockLite placeholders with scoreboards, tab lists, holograms, chat plugins or other compatible plugins.

Current island placeholders

%oneblock_phase%
%oneblock_broken_blocks%
%oneblock_blocks_to_next_phase%
%oneblock_progress_percent%
%oneblock_dimension%

These placeholders automatically display information about the island the player is currently viewing.

When visiting another island, they show the visited island's data. After returning home, they show the player's own island data again.

Overworld placeholders

%oneblock_overworld_phase%
%oneblock_overworld_broken_blocks%
%oneblock_overworld_blocks_to_next_phase%
%oneblock_overworld_progress_percent%

Nether placeholders

%oneblock_nether_phase%
%oneblock_nether_broken_blocks%
%oneblock_nether_blocks_to_next_phase%
%oneblock_nether_progress_percent%

End placeholders

%oneblock_end_phase%
%oneblock_end_broken_blocks%
%oneblock_end_blocks_to_next_phase%
%oneblock_end_progress_percent%

Island and visit placeholders

%oneblock_island_radius%
%oneblock_trusted_players%
%oneblock_total_islands%
%oneblock_is_visiting%
%oneblock_viewing_owner%

Dependencies

Required

Spigot or Paper 1.21.x

Recommended for world creation

Multiverse-Core

Multiverse-Core is recommended when following the documented method for creating the Overworld, Nether and End OneBlock void worlds.

Optional

MultiverseNetherPortals
PlaceholderAPI
ItemsAdder
Oraxen
Nexo
CraftEngine
  • MultiverseNetherPortals can be used for advanced multi-world portal routing.

  • PlaceholderAPI enables OneBlockLite placeholders.

  • ItemsAdder, Oraxen, Nexo and CraftEngine enable custom blocks inside phase configurations.

Not required

EssentialsX
EssentialsX Spawn
ProtocolLib
VoidWorld

OneBlockLite includes its own void world generator and does not require VoidWorld.

Custom Blocks

OneBlockLite supports custom blocks inside phase and block pool configurations.

Supported custom block plugins

ItemsAdder
Oraxen
Nexo
CraftEngine

These integrations are optional. OneBlockLite works normally with vanilla Minecraft materials when no custom block plugin is installed.

Configuration example

blocks:

[LIST]
[*]STONE


[*]OAK_LOG


[*]ITEMSADDER:namespace


[*]ORAXEN


[*]NEXO


[*]CRAFTENGINE:namespace

[/LIST]
Use the correct block identifier provided by the custom block plugin.

Examples:

ITEMSADDER:my_pack
ORAXEN
NEXO
CRAFTENGINE:my_pack

The corresponding custom block plugin must be installed and the specified block ID must exist.

If an integration is unavailable or an invalid custom block ID is configured, check the server console and verify the block identifier in the relevant plugin configuration.

Similar projects

Plugin →