Overview

VoxelPort connects a Fabric server or an Open to LAN singleplayer world to VoxelPort-operated relay infrastructure. Your game opens an outbound encrypted WebSocket connection, the relay assigns a public TCP port, and players join that address from vanilla Minecraft.

Players do not need to install the mod.

Animated VoxelPort relay flow

Requirements

Requirement	Version
Minecraft	26.x
Fabric Loader	0.18.6+
Java	25+
Token	Free from the VoxelPort Discord

Quick Start

Singleplayer world

Install the VoxelPort mod in your Fabric client.
Join the VoxelPort Discord.
Run /gettoken with the VoxelPort bot.
Open Minecraft and save the token in VoxelPort Settings.
Join your singleplayer world.
Use Minecraft's Open to LAN button.
Press Open to VoxelPort from the pause menu.
Share the copied play.voxelport.in:<assigned-port> address.

Players joining your address do not need the mod.

Dedicated server

Install Fabric Loader on your Minecraft server.
Join the VoxelPort Discord.
Run /gettoken with the VoxelPort bot.
Put the VoxelPort mod JAR in your server's mods/ folder.
Restart the server.
In the server console or as an operator, run /voxelport token <token>.
Run /voxelport start.
Share the address shown by /voxelport address.

Keep your token secret. Treat it like a password for your relay slot.

Commands

/voxelport token <token>
/voxelport start
/voxelport start <port>
/voxelport status
/voxelport address
/voxelport stop

/voxelport start uses the server's configured Minecraft port automatically. Use /voxelport start <port> only when you need to expose a different local port.

Configuration

The mod saves server settings at:

config/voxelport/settings.properties

Example config:

server_token=vp_...
public_host=play.voxelport.in
server_host=127.0.0.1
max_connections=200
relay_url=wss://voxelport.in

Leave relay_url blank or set to wss://voxelport.in unless you are testing with VoxelPort support.

How It Works

The mod opens an outbound WebSocket to the relay.
It registers using your Discord-issued server token.
The relay validates the token and assigns a stable TCP port.
Players join play.voxelport.in:<assigned-port> from vanilla Minecraft.
Minecraft traffic is bridged through the relay to your Fabric server.

The relay is a bridge, not a game server. Your world, mods, and player data stay on your own server.

The relay service and Discord bot are VoxelPort-operated infrastructure. Their internal implementation details are not documented as public source components here.

Troubleshooting

No VoxelPort token set
Run /gettoken in Discord, then run:

/voxelport token <token>
/voxelport start

Status shows disconnected
Make sure your host allows outbound HTTPS/WSS traffic to voxelport.in on port 443.

Players cannot join
Run /voxelport status or /voxelport address, then make sure players are joining the public address shown there.

Token rejected
Run /revoketoken and /gettoken again in Discord, save the new token with /voxelport token <token>, then run /voxelport start.

Disconnects with compression or packet errors
Update to the latest mod release. Current server mode buffers fragmented WebSocket frames and serializes relay writes to prevent packet-stream corruption.

License

MIT. See the included license file.

VoxelPort is not affiliated with Mojang, Microsoft, Fabric, CurseForge, Modrinth, or Discord.