OneBlock Islands Mod

Overview

OneBlock Islands is a server-management companion mod for the EreliaStudio OneBlock mod.

The original OneBlock mod remains responsible for gameplay, including world generation, block regeneration, rewards, expeditions, dungeons, progression, and the OneBlock HUD.

OneBlock Islands adds the multiplayer server features needed to give each player or group a private and protected OneBlock world.

Main purpose

The mod connects:

Player UUID
    ↓
Island ownership and membership
    ↓
Dedicated OneBlock world

Each island has:

• One owner.
• Zero or more trusted members.
• A separate persistent OneBlock world.
• Protection against unauthorized access and editing.
• A stable world name based on the owner's UUID.

Player experience

When a player executes:

/island

the mod automatically:

1. Checks whether the player already owns or belongs to an island.
2. Creates a new OneBlock world if no island exists.
3. Saves the ownership information.
4. Transfers the player into the island.
5. Reuses the same island on future executions.

Running /island repeatedly does not create duplicate islands.

The command can therefore be connected to a spawn portal named My Island.

Island membership

Owner

The owner can:

• Enter the island.
• Build and break blocks.
• Use containers and interactive blocks.
• Invite other players.
• Remove members.
• View the member list.

Member

A trusted member can:

• Enter the island.
• Build and break blocks.
• Use containers and interactive blocks.
• Participate in OneBlock gameplay.

Members cannot manage the island or remove its owner.

Other players

Players who are neither the owner nor a member:

• Cannot enter the island through normal world transitions.
• Are redirected safely to the spawn world.
• Cannot break, place, damage, or interact with island content.

Administrators

Administrators can bypass island and spawn protection using the configured permissions.

No administrator usernames are hard-coded.

Commands

Player commands

/island
/island home

Creates an island when necessary or returns the player to their existing island.

/island members

Displays the island owner and current members.

/island invite <player>

Invites an online player to the owner's island.

/island accept

Accepts a pending invitation and joins the island.

/island kick <player>

Removes a member from the island.

/island leave

Leaves an island. Owners cannot abandon their island with this command.

Administrative commands

/island admin info <player>
/island admin create <player>
/island admin add <owner> <player>
/island admin remove <owner> <player>
/island admin delete <owner> confirm

The delete command removes ownership metadata only. It does not delete the island world files.

Persistence

Island data is saved in:

hytale-server/mods/com.EreliaStudio_oneblock-islands/islands.json

Persistent identity uses player UUIDs rather than usernames. Players can therefore change their username without losing their island.

The database stores:

• Island ID.
• OneBlock world name.
• Owner UUID.
• Member UUIDs.
• Pending invitations.
• Visitor-related fields for future expansion.
• Creation time.

Writes use a temporary file and atomic replacement where supported, reducing the risk of corrupted data after a crash.

World naming

New island worlds use a stable internal name:

ob_<owner-uuid>

For example:

ob_152bf566d062498485e267a51a0192bd

The name does not depend on the player's current username.

Island protection

Inside registered island worlds, only owners, members, and authorized administrators can perform player-caused mutations.

The mod currently protects:

• Block damage.
• Block breaking.
• Block placement.
• Block interactions.
• Containers and other usable blocks.
• Entity interactions.

Protection is applied only to player actions, allowing the OneBlock mod and server-controlled mechanics to continue regenerating blocks and running progression normally.

World-entry protection

Protection is not limited to hiding commands.

When a player enters or reconnects inside a OneBlock world, the mod verifies that they are authorized. Unauthorized players are redirected to the spawn world.

This helps prevent access through:

• Saved locations.
• Login restoration.
• Teleportation commands from other mods.
• Old homes or previous locations.
• Direct cross-world transfers.

Legacy OneBlock worlds without ownership metadata are treated as administrator-only until their ownership is repaired or migrated.

Spawn hub

The mod can create a persistent void world named:

spawn

When the world does not already exist, it creates:

• A void environment.
• A safe spawn point.
• A minimal 9×9 stone platform.
• Disabled PvP.
• Disabled fall damage.
• Disabled NPC spawning.

Normal players cannot modify the spawn world, while administrators with the bypass permission can edit it.

The initial platform is intentionally simple and can be replaced with a custom hub build.

Permissions

oneblockislands.admin

Allows use of the island administrative commands.

oneblockislands.protection.bypass

Allows staff to bypass island and spawn protection.

The normal /island player commands do not require a broad wildcard permission.

Integration with other mods

EreliaStudio OneBlock

OneBlock Islands uses the existing Java OneBlockWorldService directly to create, load, and enter OneBlock worlds.

It does not duplicate OneBlock gameplay.

Admin Portals

A portal in the spawn hub can execute:

/island

as the interacting player, creating the intended My Island experience.

WorldProtect

WorldProtect can provide additional hub-region flags, map visualization, fire-spread control, and other defense-in-depth features.

EliteEssentials

EliteEssentials can provide moderation and staff tools. Teleport features such as homes, back, TPA, RTP, and player warps should remain disabled so they do not undermine island isolation.

What the mod does not replace

OneBlock Islands does not implement:

• OneBlock block regeneration.
• Loot or reward selection.
• Expeditions.
• Dungeons.
• Crystals.
• Progression.
• OneBlock world-generation internals.
• The OneBlock HUD.

Those features remain the responsibility of the main EreliaStudio OneBlock mod.

Summary

OneBlock Islands turns the existing OneBlock gameplay mod into a secure multiplayer server experience by adding:

• One persistent island per owner or group.
• UUID-based ownership.
• Trusted membership.
• Automatic island creation and return.
• World-entry enforcement.
• Island grief protection.
• A protected spawn hub.
• Administrative repair tools.
• Direct integration with the existing OneBlock API.