Skip to content

Troubleshooting

Oliver Martin edited this page Apr 30, 2020 · 13 revisions

Hello and welcome to the new troubleshooting page for MultiChat.

Here you can find solutions to the most common problems that can occur when setting up the plugin.

Firstly, please select the category that most applies to you:


(1) Plugin commands/permissions are missing or not working

Please choose the category that most applies to you:

(1.1) Some commands are available (like /nick), but not others

If you type the /multichat command, and it is recognised but you do not have permission to use it , please see (1.2) I don't have permission to use commands even when I am opped.

If commands such as /multichat do not seem to exist at all, then you probably do not have MultiChat installed on your proxy server (i.e. Bungeecord, Waterfall...)

Please select the most relevant option below:

(1.1.1) I do not know what a proxy server / bungeecord is

If you do not know what a proxy server is, then unfortunately MultiChat is probably not the plugin for you! A proxy server allows you to combine multiple Minecraft servers together into one. MultiChat is a plugin to allow you to chat between all your different Minecraft servers. If you still want to use MultiChat, then you will need to get a proxy. See (1.1.2) I do not have a proxy server / bungeecord.

(1.1.2) I do not have a proxy server / bungeecord

If you do not have a proxy server, then unfortunately MultiChat might not be the plugin for you! A proxy server allows you to combine multiple Minecraft servers together into one. MultiChat is a plugin to allow you to chat between all your different Minecraft servers.

Currently MultiChat supports the Bungeecord proxy, and by extension Waterfall, Travertine and many others.

If you want to learn more about proxy servers, see: https://www.spigotmc.org/wiki/bungeecord/

(1.1.3) I use a different proxy like Lilypad or Velocity

Unfortunately right now MultiChat only supports the Bungeecord proxy, and by extension Waterfall, Travertine and many others. We have plans to support Velocity in the near future, but it is unlikely we will support Lilypad as this proxy is now largely outdated.

(1.2) I don't have permission to use commands even when I am opped

When you use a plugin like MultiChat on the proxy server (i.e. Bungeecord), permissions need to be set on both your individual servers AND on the proxy. "OP" only applies to your individual servers. So this means you have not yet setup the permissions on your proxy (or if you have then they are not working).

While it is possible to set up proxy permissions in your bungeecord server's "config.yml", it is not recommended. You would be much better off using a permission manager such as LuckPermsBungee, or BungeePerms.

If you already use LuckPerms, then it is possible to sync your existing permissions with your proxy permissions using a MySQL database. See their help pages for how to do this.


(2) Chat is not appearing on some or all servers

Please choose the situation that most applies to you:

  • (2.1) I am sending chat messages but they are not going to any of my other servers
  • (2.2) Chat works on some servers, but not others

(2.1) I am sending chat messages but they are not going to any of my other servers

If chat messages are not going to ANY of your other servers, then please make sure the multichat plugin jar file is in BOTH your proxy plugins folder AND your spigot/sponge plugins folder.

If you are confident that you have placed the MultiChat jar on ALL your servers, then please make sure all your servers are running the same version of MultiChat.

If it is still not working then check your multichat "config.yml" file. Is global chat turned on?

In 99.9% of cases, the "fetch_spigot_displaynames" option MUST be TRUE. If you have this set to FALSE, then it is probably stopping your chat working! Please set "fetch_spigot_displaynames" to true to fix your issue. (Even if you use Sponge, this option will still need to be true. It is a 'legacy' setting that was created before we supported Sponge.)

(2.2) Chat works on some servers, but not others

If chat messages are working for some servers but not others, then please make sure the multichat plugin jar file is on ALL of your spigot/sponge servers.

If you are confident that you have placed the MultiChat jar on ALL your servers, then please make sure all your servers are running the same version of MultiChat.

If it is still not working then check your multichat "config.yml" file. Make sure the servers that aren't working are NOT listed in the "no_global" section as this excludes them from global chat.

Now, make sure that IP-FORWARDING is turned ON for all your spigot/sponge servers. (This can be done in the spigot.yml file for Spigot and see this link for Sponge.) If IP forwarding is not enabled, then the player UUIDs being used by the proxy and spigot/sponge servers do not match, and MultiChat will be unable to send any messages. Try doing /multichat debug in your proxy console and then sending chat messages in game. If you see any notice like "Message abandoned", "Could not find player", "Is IP forwarding on?", then you still have not enabled your IP forwarding correctly!


(3) There are errors in console