Void Island Control Remastered

A remaster of Void Island Control for Minecraft 1.12.2.

Original CurseForge project: https://www.curseforge.com/minecraft/mc-mods/void-island-control

Void Island Control adds a world type for a customizable, multiplayer void world. Players create and manage isolated islands, invite teammates, and run skyblock-style play in a void overworld (with optional void nether and end). This remaster keeps that feature set, runs on Log4j-patched Forge 1.12.2-14.23.5.2864, and adds visit / spectate / list tools that work while the island owner is offline.

License and attribution (GPLv3)

This project is licensed under the GNU General Public License v3.0. The full license text is in LICENSE.md.

Original work:

• Author: Bartz24
• CurseForge: https://www.curseforge.com/minecraft/mc-mods/void-island-control
• Original source: https://github.com/Bartz24/VoidIslandControl

Remaster:

• Maintainer: kreezxil
• Source: https://github.com/kreezxil/VoidIslandControl

Bartz24's original code and this remaster are both under GPLv3. You may copy, modify, and redistribute this mod under that license. Modified versions must keep the license, keep copyright notices, and mark the changes.

What this mod does

(From the original CurseForge description, plus remaster notes.)

Void Island Control adds a world type for a customizable, multiplayer void world. It is meant for isolated islands, teams, and skyblock-style play.

Original features

• Multiplayer island create, invite, join, leave, kick, home, spawn, reset, and one-chunk mode.
• Five default island types: Grass, Sand, Snow, Wood, and Garden of Glass (if Botania and Garden of Glass are installed). Each type is configurable.
• Custom islands from structure-block .nbt files in the config folder.
• Config for fill / bottom blocks, spawn protection, overworld generation mode, cloud / horizon Y, island size and distance, void nether / end with optional structures, one-chunk mode, starter chest, starting inventory, command blocks on new islands, and commands run when the world first loads.
• Compatible as a starting-island companion for packs that also use Sky Resources (Sky Resources itself was incompatible on 1.10; this remaster is 1.12.2 only).
• 1.10 / 1.11 originals needed CompatLayer. This remaster does not — it is 1.12.2 Forge only.

Basic use (same as upstream)

Install the mod on client and server. Pick Void? World in singleplayer or set level-type=voidworld on a server. Use /island create [optional type] unless auto-create is on.

It is a normal dual-side Forge mod. The same jar goes on the dedicated server and on every client. The Forge handshake will reject a client that does not have it.

World type

• Create a world with type Void? World (singleplayer) or voidworld (server level-type).
• Overworld generation can be true void, vanilla overworld, superflat, another world type, or customized.
• Cloud height and horizon height are configurable.
• Nether and End can each be void, with optional structure generation.
• Island management runs in a configured base dimension (usually overworld).

Islands

Default types (each can be enabled or disabled in config):

Also:

• Custom islands from structure-block .nbt files in the voidislandcontrolstructures config folder. Add the file name to the Custom Islands list. A structure block data tag spawn_point sets the landing block.
• Main spawn island at grid 0,0 can use bedrock, a named type, or random.
• Player islands can use a fixed type or random.
• Island size, Y level, distance between islands, bottom block (bedrock or the island's secondary block), optional starter chest.
• Optional biome paint on the island and a range around it.
• Spawn protection and a build-range that keeps visitors from wandering off the island they are visiting.
• Auto-create islands for new players (all worlds, or dedicated servers only).
• One-chunk mode (world border 16 blocks) if enabled in config or by command.
• Optional command block under new islands (impulse / repeating / chain, facing, auto, command string).
• Commands run once when the world first loads.
• Starting inventory via /startingInv and config startingItems.
• Resist / fire resist / regen buffs on island teleport, duration configurable.

Island membership is stored in the world save as UUIDs (VoidIslandControlSaveData). That is separate from usercache.json / usernamecache.json. Those caches are only used to turn a typed player name into a UUID.

Player commands

Default command name is /island (configurable).

Visit, spectate, list, and permissions:

• Visit / spectate work while the target is online or offline if VIC has their island UUID and the name resolves (usercache.json / usernamecache.json).
• /island list prints those names (except yourself). Tab complete uses the same list.
• You cannot visit / spectate your own island (/island home is that).
• A visitor is a visible player so the host can give a tour. Spectator stays the invisible cam.
• Default visit is walk-and-talk only. Chests, machines, items, entities, combat, pickups, harvest, and place are all off until a pack dev or an island owner turns them on.
• /island home / spawn / create / join / leave ends the visit and returns survival.
• allowVisitCommand disables visit and spectate. List still works.
• allowPerPlayerOverrides (aka the whitelist) must be true or /island permission does nothing. Overrides are stored on the island, keyed by visitor UUID. Same player can have different flags on different islands. They do not have to have visited first.

Global visit flags (commandSettings.visitSettings, all default false):

Island lockdown (islandSettings, default off):

Ops are not leashed. Old islandProtection / protectionBuildRange still exist for spawn build-protect; the walk-off message is lockdown only.

Admin commands

/islandAdmin (permission level 2):

Other command

/startingInv — capture or manage the starting inventory used for new / reset players (see in-game usage).

Remaster changes

Compared with Bartz24's 1.5.3 line:

• Target Forge 1.12.2-14.23.5.2864 (Log4j / CVE-2021-44228 patched; do not ship pre-2856 Forge on a public pack).
• /island visit is a visible body: adventure, or survival for ops / harvest-place perms.
• New /island spectate, /island list, /island permission.
• Per-island visit whitelist (interact, items, entities, combat, pickup, harvest, place). Global defaults all false.
• Island lockdown config, off by default.
• Visit and spectate resolve offline players by UUID.

Requirements

• Minecraft 1.12.2
• Forge 14.23.5.2864 (or another 1.12.2 Forge ≥ 14.23.5.2856 if you knowingly change the pin)
• Java 8
• Optional: Botania + Garden of Glass for the gog island

Install the jar on client and server.

Playing

1. Drop the jar into mods on the server and on each client.
2. Set the world type to voidworld (server.properties level-type=voidworld) or pick Void? World in the create-world screen.
3. Join. Use /island create unless auto-create is on.
4. Invite teammates with /island invite.
5. See who you can visit: /island list.
6. Visit: /island visit <name>. Spectate: /island spectate <name>.
7. Owner whitelist: /island permission <name> allowBlockHarvest true (requires allowPerPlayerOverrides).

Custom structures: save with a structure block, copy the .nbt into config/voidislandcontrolstructures/, add the name to the Custom Islands list, mark spawn with data spawn_point.

Pack notes

• VIC save data survives usercache wipes. Command names may not, until the cache or Mojang can resolve the name again.
• Offline-mode servers can only resolve names that already exist in usercache unless the player is online.

Copying a world to another server

Island membership lives in the world (world/data/, VIC save, UUIDs).
Player names do not. Those live next to the server jar:

• usercache.json (vanilla)
• usernamecache.json (Forge)

If you copy only the world folder onto a test or new host, /islandAdmin list will still show every island and UUID. /island list, /island visit <name>, and /island spectate <name> will only show names the new server has already seen. Everyone else looks “missing” even though the island is there.

When you clone a world:

1. Copy the world folder.
2. Copy usercache.json and usernamecache.json from the old server root (same directory as the Forge jar) into the new server root.
3. Restart the new server.

Do not put those two JSON files only inside the world folder. They will be ignored.

Credits

• Bartz24 — original Void Island Control
• Forge / FML / MCP
• Vazkii / williewillus — Botania and Garden of Glass (optional island type)
• kreezxil — remaster, visit / spectate / list / permission, offline visit, op-survival visit