Skip to content

Troubleshooting

Jump to bottom
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

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.)

If you have tried all these options and it still does not work, please seek further support.

(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!

If you have tried all these options and it still doesn't work, then please seek further support.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

(3) There are errors in console

Please choose the option most applicable to you:

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

(3.1) The issue says Display Names cannot be longer than 16 characters

This means you are using Minecraft version 1.7, or the Travertine (or Flamecord / similar) proxy which has support for Minecraft 1.7.

In Minecraft 1.7, player display names were limited to 16 characters long. You are probably setting the display name for your players to include extra data like their prefix, and maybe even a suffix. Unfortunately, this is not supported by Minecraft 1.7.

You will need to set the display name to be something that is lesson that 16 characters. Either use MultiChat's config.yml to set the display name using display_name_format="%NAME%" to use regular player names. OR, you can still use MultiChat nicknames as the display name using display_name_format="%NICK%"... HOWEVER, you must make sure your player's nicknames are not longer than 16 characters long (including format codes). You can configure the min and max length of nicknames in the local config files for MultiChat on your spigot and sponge servers.

You might be worried about how you will display prefixes if you cannot set them in the displayname? Before, you probably had displayname as "%PREFIX%%NICK%%SUFFIX", and then your chat formats might have been like: "%SERVER% %DISPLAYNAME%:". You can still use your prefixes as you did before! Just set your chat format to look like this instead: "%SERVER% %PREFIX%%DISPLAYNAME%%SUFFIX%:" (because %DISPLAYNAME% is now just %NICK% or %NAME% depending on what you set it to in the previous step.)

If you need any extra help with this, then look for further support in our Discord, it is a common error and can be confusing if you are new to running a server.

(3.2) The issue is a NULL POINTER EXCEPTION

In most cases, null pointer exceptions are harmless. Sometimes they can happen for simple reasons such as your server lagging, or a player disconnecting unexpectedly.

If you are experiencing persistent null pointer exceptions then please seek further support.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

SEEK FURTHER SUPPORT

If you have not been able to find the solution to your problem using this automated system, then you will need to seek further support.

MultiChat has many support channels available, our preffered choices are:

MultiChat is developed by Revilo410 (Oliver Martin)
To download the latest release: Click Here

Navigation

Setup

Modules

API

Development

Clone this wiki locally