Connect your Minecraft server to GameVox (Paper, Fabric, NeoForge)
Copy the GameVox Link jar into plugins or mods, add the Minecraft app, follow Setup in its channel, then set the address players join with.
Copy the GameVox Link jar into your server, add the Minecraft app to your GameVox server, and follow the Setup tab in its Minecraft channel. It takes about five minutes.
GameVox Link is not an official Minecraft product. It is not approved by or associated with Mojang or Microsoft.
Requirements
| Server type | Minecraft and Java | Jar goes in | Settings file |
|---|---|---|---|
| Paper, Spigot, Purpur | 1.20 or newer, Java 17 or newer | plugins/ | plugins/GameVoxLink/config.yml |
| Fabric | 1.21.4, Java 21, with Fabric API | mods/ | config/gamevoxlink.properties |
| NeoForge | 1.21.4, Java 21 | mods/ | config/gamevoxlink.properties |
Forge servers, and Fabric or NeoForge on other versions, are not supported yet. You must be the GameVox server's owner or an admin.
1. Install the jar
- Download the server package from the Minecraft integration page. It has a folder per server type:
paper-spigot-purpur/,fabric/andneoforge/, each with anINSTALL.txt. - Stop your server and copy the jar from the matching folder into
plugins/ormods/. Delete any older GameVox Link jar. - Start the server once so it creates its settings file, then stop it.
2. Add the app
- In GameVox, open Server Settings > Integrations > Browse and add the Minecraft app.
- Open its Minecraft channel. If there is none, create a Minecraft app channel.
3. Follow Setup
Open the channel's Setup tab. Only the owner and admins see it. The steps are:
- Server type: Paper, Spigot or Purpur, Fabric, or NeoForge.
- Install: a reminder of step 1.
- Token: click Create plugin token. The endpoint and token are shown once, so keep the page open until they are in your settings file. See manage your Minecraft plugin token.
- Config file: paste the two lines Setup shows.
On Paper, Spigot and Purpur, replace the two empty lines near the top of config.yml. Keep the quotes:
endpoint: "paste the endpoint from Setup"
token: "paste the token from Setup" On Fabric and NeoForge, replace the two empty lines in gamevoxlink.properties. No quotes, no spaces:
endpoint=paste the endpoint from Setup
token=paste the token from Setup - Restart: save the file and start or restart the server.
- Connect: Setup waits for the first report, usually within 15 seconds, then moves on.
gamevoxlinkin the server console (or/gamevoxlinkin game as an operator) shows whether it is connected.
4. Set the join address
Once connected, Setup asks how players join. The address shows at the top of the channel next to Connected, with a copy button.
- Type the Host name, such as play.example.com. The Port is filled in from your server's
server-port. Change it only if players join on another port, for example through a proxy or your host. 25565 is not shown. - The host name is saved only if it resolves to the address your server connects from. Behind BungeeCord, Velocity or some hosts, it will not. If you are sure the name is right, choose Use it anyway, and it is marked Not verified.
- Or choose Show the IP address instead, or Not now.
Change it later in the channel's settings under Server address.
More than one Minecraft server
Each Minecraft app channel is its own Minecraft server, with its own token, map, players and settings. To add another, create another Minecraft channel and run its Setup.
Optional settings
- Map drawing is on by default (
mapenabledin the settings file). - Camera pictures drawn by the server are on by default. See camera views.
- Remote admin is off by default. See Minecraft remote admin.
- Player privacy: players type
/gvprivacy hideto stop GameVox showing where they are and their profile, and/gvprivacy showto undo it.
Troubleshooting
- Setup never shows Connected: check that the two lines are exactly as shown, each on its own line, and the file is saved; that you restarted after saving; that you did not make a newer token since; and that the server can reach the internet over HTTPS.
gamevoxlinkin the console says what is wrong. - Fabric does not load the mod: put Fabric API in
mods/. - Token leaked or lost: make a new one in Setup and update the file. The old one stops at once.