Personally created dimensions that exist as actual generated worlds, not shared with anyone, unless you want to! Persists even if you throw away mods and the regular minecraft worlds!
A Fabric mod for Minecraft that gives each player their own persistent
pocket dimension island.
Supported Versions: Minecraft 1.20.1, 1.20.4, 1.21.11
Warning: Do not logout or disconnect while on the pocket island. This can break things since worlds are automatically unloaded.
This can be configured, this explanation uses the default configuration.
Build a frame using Nether Bricks (4 wide x 5 tall):
N N N N
N N
N N
N N
N N N N
Right-click the inside of the frame with an Emerald to activate.
Walk into the activated portal to enter your pocket island. On first entry, a
starter platform with grass blocks and a return portal frame will be created.
Enter the portal on your pocket island to return to your original location.
Important: Bring enough materials to build a return portal!
Player commands:
/pi invites - View your invitations (sent and received)/pi invite <player> - Invite a player to your island/pi invite <player> always - Invite with Always Welcome status (if enabled)/pi uninvite <player> - Revoke a player's invitation/pi togglewelcome <player> - Toggle Always Welcome for an existing invitation (if enabled)/pi portals - View all configured portal types and your island statusAdmin commands (op level 2+):
/pi admin list - List all islands/pi admin info <player> - View island details/pi admin tp <player> - Teleport to an island/pi admin delete <player> [confirm] - Delete an island (op 4)Debug commands (op level 4):
/pi debug perf enable - Enable performance monitoring/pi debug perf disable - Disable performance monitoring/pi debug perf status - Show performance status/pi debug perf reset - Reset performance countersNote: You should not need the debug commands, but they may be useful for
checking.
Config file: config/personalworlds.json
Pocket Islands offers extensive customization options, particularly for island
composition. You can define multiple portal types, each creating islands with
different materials and properties.
{
"portalTypes": [
{
"frameBlock": "minecraft:nether_bricks",
"activationItem": "minecraft:emerald",
"islandLayers": [
"minecraft:grass_block",
"minecraft:dirt",
"minecraft:stone"
],
"portalColor": "red"
}
],
"consumeActivationItem": false,
"maxInvitationsPerPlayer": 20,
"enableAlwaysWelcome": false,
"unloadEmptyDimensionDelayTicks": 600,
"cleanupIntervalTicks": 600,
"enableTeleportParticles": true,
"enableTeleportSounds": true,
"enablePortalActivationEffects": true,
"enableInvitationNotifications": true
}
Define multiple portal types to create islands with different materials:
frameBlock — Block used for portal frames (e.g., "minecraft:nether_bricks")activationItem — Item used to activate portals (e.g., "minecraft:emerald")islandLayers — Customize your starter island platform (up to 5 layers, top to bottom)["minecraft:grass_block", "minecraft:dirt", "minecraft:stone"]portalColor — Color of the portal effect (default: "red")"red", "cyan"maxInvitationsPerPlayer — Maximum invitations per player (-1 for unlimited)enableAlwaysWelcome — Enable the Always Welcome feature (default: false, requires restart)By default, visitors can only enter your island when you are online and present
on your island. The Always Welcome feature allows island owners to grant
specific guests permanent access, bypassing these restrictions.
Set enableAlwaysWelcome to true in your config and restart the server:
{
"enableAlwaysWelcome": true
}
Note: This setting requires a server restart to take effect. When disabled,
all Always Welcome commands are hidden and existing flags are ignored.
Once enabled, island owners have two ways to grant Always Welcome status:
Option 1: Invite with Always Welcome
/pi invite Steve always
This creates a new invitation with Always Welcome enabled immediately.
Option 2: Toggle existing invitation
/pi togglewelcome Steve
This toggles the Always Welcome status on an existing invitation. Run it again
to disable.
Use /pi invites to see your sent invitations. When the feature is enabled,
each invitation shows a clickable star indicator:
Sent (players who can visit you):
- Steve [★] [Revoke] ← Green star: Always Welcome ON
- Alex [☆] [Revoke] ← Gray star: Always Welcome OFF
Click the star to toggle the status directly from the chat.
| Invitation Type | Host Online + Home | Host Online + Away | Host Offline |
|---|---|---|---|
| Standard | ✓ Allowed | ✗ Denied | ✗ Denied |
| Always Welcome | ✓ Allowed | ✓ Allowed | ✓ Allowed |
Notes:
unloadEmptyDimensionDelayTicks — Delay before unloading empty dimensions (default: 600 = 30 seconds)cleanupIntervalTicks — How often to check for empty dimensions (default: 600 = 30 seconds)enableTeleportParticles — Show particle effects during teleportationenableTeleportSounds — Play sound effects during teleportationenablePortalActivationEffects — Show effects when activating portalsenableInvitationNotifications — Play sounds for invitation notificationsconsumeActivationItem — Whether the activation item is consumed on portal activation (default: false)You can define multiple portal types to create different island themes. Players
can choose which type of island they want by using different portal materials:
{
"portalTypes": [
{
"frameBlock": "minecraft:nether_bricks",
"activationItem": "minecraft:emerald",
"islandLayers": [
"minecraft:grass_block",
"minecraft:dirt",
"minecraft:stone"
],
"portalColor": "red"
},
{
"frameBlock": "minecraft:blackstone",
"activationItem": "minecraft:nether_star",
"islandLayers": [
"minecraft:netherrack",
"minecraft:soul_sand",
"minecraft:basalt"
],
"portalColor": "red"
},
{
"frameBlock": "minecraft:end_stone_bricks",
"activationItem": "minecraft:ender_pearl",
"islandLayers": [
"minecraft:end_stone"
],
"portalColor": "cyan"
}
]
}
Note: The first portal type a player uses determines their island
composition permanently.
Yes. Pocket Islands must be installed on both the server and all connecting
clients.
The client will experience severe rendering issues when looking at a portal.
Chunks will fail to load properly, causing:
This happens because the client can not properly load the textures and thus can
not show the chunks properly.
No. The mod registers custom dimension types that vanilla clients cannot
understand. Always ensure clients have the mod installed before they attempt to
use pocket island portals.
Your island is safe. Pocket islands are stored separately from the main world.
Yes, if they invite you. Use /pi invite <player> to invite someone, then
enter their portal to visit their island.
Enter the return portal on your island. It teleports you back to the exact
location you entered from.
You're safe. When you fall below Y=0, you're automatically teleported back to
your original entry location before taking any void damage. Your items and
progress are preserved.