Voxel Turf Server Manager - Takaro

Manage your Voxel Turf dedicated server with Takaro — players, server control, teleports, and more. A free Voxel Turf Server Manager.

Connect your Voxel Turf server to Takaro — player events, chat bridge, server announcements, and admin control from the Takaro dashboard.

Download Latest Release Sign Up for Takaro (Free)

Player Events Join, leave, chat, and death events tracked in Takaro in real time.

Admin Actions Kick, ban, broadcast, give items, teleport, and read inventory from Takaro.

Server Lifecycle Server start, stop, and world-save events delivered as log events.

Drop-in No client mod. The bridge auto-launches with the server — nothing to run by hand.

How It Works

Voxel Turf server (1.9.9)         bridge.exe (auto-launched)           Takaro
┌───────────────────────────┐     ┌──────────────────────────┐    ┌──────────────┐
│ TakaroConnector Lua mod   │     │ bridge.js                │    │ Takaro Cloud │
│  · player / chat / death  │─UDP─│  · WebSocket client      │──▶ │ wss://connect│
│  · inventory, kick, give  │◀UDP─│  · request / response    │◀── │  .takaro.io/ │
└───────────────────────────┘     └──────────────────────────┘    └──────────────┘
   winmm.dll in the server root launches bridge.js and shuts it down with the game.

The Lua mod runs inside your Voxel Turf server. A small winmm.dll placed in the server root auto-launches bridge.exe — a self-contained program with no Node.js or other runtime required — which holds the WebSocket connection to Takaro. The bridge starts and stops with the game; there is no separate program to run and no client-side install.

One hard requirement before you start:

Voxel Turf 1.9.9 beta branch. The connector uses an API that does not exist in 1.9.8 stable. On the wrong version the server runs but Takaro never connects (endless "UDP timeout" in the bridge log). See Step 1.

Nothing else to install — no Node.js, no runtime. The bridge ships as a self-contained bridge.exe that starts and stops with your server.

Step 1 — Put Your Server on the 1.9.9 Beta

Using SteamCMD, update the Voxel Turf Dedicated Server (app id 526340) to the beta branch:

force_install_dir C:\path\to\your\voxelturf\server
login anonymous
app_update 526340 -beta beta
quit

The beta branch is labelled "Public Beta" and is the 1.9.9 line — no password needed. Run it without validate so it does not remove the mod files.

Pin the beta. A plain app_update 526340 (or a Steam auto-update) reverts to 1.9.8 and breaks Takaro. Always include -beta beta in whatever update script you use.

Step 2 — Get a Takaro Account & Register Your Server

Sign up at takaro.io and log in at app.takaro.io.
Go to Game Servers → Create Game Server and choose Generic.
Copy the Registration Token it generates — you'll paste it in Step 4.

Step 3 — Install the Mod

Download the latest release ZIP and extract it directly into your Voxel Turf server folder. The ZIP is laid out so its contents land in the right places:

C:\path\to\your\voxelturf\server\
├── winmm.dll                         <-- lands in the server ROOT (launches the bridge)
├── vtserver.exe                      (already there)
└── mods\
    └── TakaroConnector\              <-- the mod
        ├── TakaroConfig.txt
        ├── bridge\
        │   └── bridge.exe            (self-contained — no Node.js needed)
        └── scripts\
            ├── server_scripts.txt
            └── server\takaro_connector.lua

winmm.dll must sit in the same folder as vtserver.exe (the server root), not inside mods\. That file is what starts the bridge.

Step 4 — Configure

Open mods\TakaroConnector\TakaroConfig.txt and set:

SERVER_NAME=My Voxel Turf Server
REGISTRATION_TOKEN=paste-your-token-from-step-2-here
GAME_PORT=5728
EXTERNAL_SECRET=123456
ENABLED=true

Key	Required?	Description
`SERVER_NAME`	Yes	Any name — used as this server's identity in Takaro.
`REGISTRATION_TOKEN`	Yes	Token from the Takaro dashboard (Step 2).
`GAME_PORT`	Optional	Your server's UDP port. Default `5728`; match it to your `--port` if you changed it.
`EXTERNAL_SECRET`	Optional	Localhost-only shared secret. Leave as `123456` unless you also change it in `takaro_connector.lua`.
`ENABLED`	Optional	Set `false` to disable without removing the mod.

Step 5 — Start & Verify

Start your Voxel Turf server normally — the mod and bridge load automatically. To confirm it's working:

Server console shows [TC] takaro_connector.lua loaded OK and [TC] defineExternalCommands callback called.
mods\TakaroConnector\bridge.log shows Identified with Takaro and VoxelTurf server started, with no repeating UDP timeout lines.
Your server turns online / reachable in the Takaro dashboard within a few seconds.
Have a player join and chat — player-connected and chat-message appear in Takaro's event stream.

Admin status command. In-game, an admin can type /takarostatus to see tracked-player count, queued events, and the shared secret.

Events Sent to Takaro

Event	When it fires
`player-connected`	A player joins. Carries gameId (player id), name (steam name), steamId.
`player-disconnected`	A player leaves (detected on the next roster scan, a few ticks).
`chat-message`	A player sends a public chat message.
`player-death`	A player's death counter increases.
`log` — server started	The server finishes loading and the bridge connects.
`log` — world saved	The world is saved to disk.
`log` — server stopped	The server process exits.

Takaro has no built-in start/stop/save event, so those are delivered as log events — create a module Hook on the log event and match the message text.

Actions Takaro Can Run

Action	What it does
`testReachability`	Confirms the server is online.
`getPlayers`	Returns the current online player list.
`getPlayerInventory`	Returns a player's inventory items (name, code, amount).
`sendMessage`	Broadcasts a server message to all players.
`sendMessageToPlayer`	Sends a private message to one player.
`kickPlayer` / `banPlayer` / `unbanPlayer`	Moderation by game id.
`giveItem`	Adds an item to a player's inventory.
`teleportPlayer`	Teleports a player to X/Z coordinates.
`executeCommand`	Dispatches a console command.

Troubleshooting

Bridge log shows endless "UDP timeout waiting for game response"

Your server is on 1.9.8, not the 1.9.9 beta. The Lua loads but the external API never registers (you won't see defineExternalCommands callback called). Redo Step 1 with -beta beta and confirm the version is 1.9.9.

Nothing happens / no bridge.log at all

Make sure winmm.dll is in the server root (next to vtserver.exe), not in mods\.
Make sure your antivirus didn't quarantine bridge.exe (it's an unsigned bundled executable). Allow it and restart the server.

Bridge connects but Takaro says "Unreachable"

Check REGISTRATION_TOKEN matches the dashboard; regenerate it if it was already used.
Outbound HTTPS to connect.takaro.io:443 must not be firewalled.

Anything else

Open an issue at github.com/mad-001/Voxel-Turf-Server-Manager/issues and include mods\TakaroConnector\bridge.log and your server console output.