Docs

FAQ & Troubleshooting

Frequently asked questions and troubleshooting steps for Hytale DiscordSync.

Frequently Asked Questions

Is this a Minecraft plugin?

No. DiscordSync is built natively for the Hytale Server using Hytale's JavaPlugin architecture (com.hypixel.hytale.server.core.plugin.JavaPlugin). It does not run on Bukkit, Spigot, or Paper.

Which Java version is required?

Java 21 or newer is required to run both the Hytale server and DiscordSync.

Does DiscordSync cause server lag?

No. All Discord communication (JDA gateway, HTTP requests, embed delivery) runs asynchronously on a dedicated scheduled thread pool, completely decoupled from Hytale's main tick loop.

Troubleshooting

Bot does not receive messages from Discord

  • Go to the Discord Developer Portal.
  • Under the Bot tab, ensure Message Content Intent is toggled ON.
  • Verify that the bot has permissions to view and read messages in the specified channel.

"Error: Channel ID not found"

  • Make sure Developer Mode is enabled in Discord (User Settings -> Advanced -> Developer Mode).
  • Right-click the channel, click Copy Channel ID, and verify that the 18-19 digit ID matches channelId in config.json.

Slash commands are not showing up

  • Ensure the bot was invited with the applications.commands OAuth2 scope.
  • Global slash commands can take up to an hour to propagate across Discord, although in server-specific test guilds they usually appear immediately.
FAQ & Troubleshooting | Hytale DiscordSync Docs