> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/community-chat/help/troubleshooting.md). # Troubleshooting Almost everything here now tells you what is wrong in plain words, in game, without you opening a log file. `/cchat status` is the first thing to try. ## Setting up | It says | What to do | | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | The setup screen refuses the token | Discord did not recognise it. That Bot page also shows an Application ID and a Client Secret, and neither works. Press **Reset Token**, copy what it shows, and paste that. | | It started, then said Discord rejected the bot token | The same thing, one step later. Press **Back** on the setup screen, paste the real token, and go forward again. | | The chat did not start, and the message names a setting | Open `plugins/CommunityChat/hub/config.yml`, fix the line it names, then run `/cchat reload`. No restart needed. | | It says it could not read the settings file | The file's shape is wrong, not any one setting, and the message names the line. It is nearly always indentation: every community's block has to start with the same number of spaces as the one above it. If you have just brought one of the spare communities into use, delete only the `#` at the start of each of its lines and leave the spaces after it exactly as they are. | | It says no communities are set up | The `communities:` section is empty, or its lines are not indented. There must be at least one, and the file ships with a working example. | | It cannot tell which community this server is | The chat has several communities and nothing says which one this server is. It lists the names; put the right one in `run-hub-as` in `plugins/CommunityChat/config.yml`. | | Something about the licence | Your download carries its own licence. Check the [licence dashboard](https://esmp.fun/plugins/dashboard.php), or re-download the jar from where you bought it. | | A Java complaint, like `UnsupportedClassVersionError` | Java is too old. Minecraft 26.x and this plugin both need Java 25. | ## Joining a chat | Symptom | What to do | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Not set up yet" | The address and token are still the placeholders. Run `/cchat setup` and paste in the two things you were sent. | | "There is no such address as ..." | A typo, or part of the address is missing. It ends in `/c/` followed by a long code, and that last part is the piece most often lost when copying. | | "... answered, but not as a Community Chat hub" | Something is at that address, but not the chat. Nearly always a leftover `https://` at the front, or the `/c/...` missing at the end. Compare it character for character with what you were sent. | | "Nothing is answering at ..." | The chat is not running just now. Ask whoever hosts it. Nothing on your side needs changing, and it reconnects on its own. | | "No answer at all from ..." | Either your host blocks outgoing connections, which is your host's to change, or the chat is not answering, which is not. Send that line to whoever hosts the chat and ask which it is. | | It connects, then drops with an authentication error | Your token does not match the one written under your name in the chat's settings. Ask for it again. | | The message mentions an older or newer version | The plugin and the chat are on different versions and cannot talk. Everybody needs the same release. | ## Discord | Symptom | What to do | | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | The bot is online, but Discord messages never reach the game | **Message Content Intent** is off. Discord Developer Portal, your app, the Bot page, switch it ON, then `/cchat reload`. | | Game messages appear as plain bot posts instead of player names and heads | The bot does not have **Manage Webhooks** in that channel. Re-invite it with the link the setup screen gives you, or grant the permission by hand. | | Nothing arrives in one particular Discord | The wrong `chatChannelId` for that community, or the bot cannot see that channel. Right-click the channel, Copy Channel ID, and compare. | | The slash commands never appeared | The bot was invited without `applications.commands` in the link. Use the link from the setup screen, which always includes it. | ## Day to day | Symptom | What to do | | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Messages reach Discord but not another Minecraft server | That server is down or paused. Run `/cchat status` there. | | Chat stopped both ways on one server | It may be paused. `/cchat menu` says so at the top, and the button turns it back on. | | "Is my message even arriving?" | Turn on `logTraffic` in the chat's settings, then every message that crosses is printed to that server's console. | | The server hosting the chat restarted | Everyone buffers briefly and reconnects on their own. Expect a few seconds' gap and nothing more. | | A Discord admin deleted the bridge webhook | It is recreated automatically. | Still stuck? Ask in the [ESMP Discord](https://dc.esmp.fun) or email .