Goxy Plugin Configuration Error

Error Description

Players cannot join subservers in the Goxy network because the Goxy plugin is missing on the target server or is misconfigured (e.g., invalid or missing token in config.yml). The issue manifests as connection errors or lack of synchronization with the Goxy dashboard.

warningError Symptoms

Players see connection errors in the Minecraft client. Server logs (latest.log) may show errors related to:

• Missing Goxy plugin
• Invalid or missing token

Error Screenshot

Possible Causes

magnifying-glassWhat Could Be the Cause?

• Goxy plugin not installed: The plugin is not in the plugins folder of the target server.
• Missing token: The config.yml file lacks a valid token generated in the Goxy panel.
• Incorrect configuration: Token or other settings in config.yml are wrong or outdated.
• Subserver not added: The target server is not registered in the Goxy panel.

Fix Steps

toolsHow to Fix the Error?

1. Install the Goxy plugin:
   • Download the latest version from the admin panel .
   • Upload the .jar file to the plugins folder on the target server (e.g., Paper/Spigot).
   • See Network Setup Guide.
2. Generate and configure the token:
   • Log in to the Goxy panel .
   • Generate a new token in network settings.
   • Paste it into config.yml in the Goxy plugin folder on the server.
   • See Token Setup Guide.
3. Verify subserver configuration:
   • In the Goxy panel, ensure the subserver is added to the network.
   • Confirm the IP and port are correct.
   • See Add Server Guide.
4. Reset plugin configuration:
   • Stop the server.
   • Delete config.yml in the Goxy plugin folder.
   • Restart the server — the plugin will generate a new config.yml.
   • Re-enter the token as in step 2.
5. Update the Goxy plugin:
   • Download the latest version from the Goxy panel and replace the old .jar in plugins.
6. Restart the server:
   • Restart and check console logs (latest.log) for Goxy plugin errors.
7. Contact support:
   • If the issue persists, reach out on Discord.

check-markError Fixed!

After completing the steps, your server should sync correctly with Goxy. If the issue persists, contact us.

Links & Resources

linkQuick access to everything

Here are the key links to our resources — all in one place!

Resource	Link
Goxy Homepage	goxy.io
Admin Panel	dashboard.goxy.io
Status Page	status.goxy.io
Discord Community	Join Discord
Awesome Goxy List	View list
API Documentation	API Docs