Common Issues/Questions

This answers our frequently asked questions and our most reported issues.

Please see this page first BEFORE reporting issues or asking questions.

FAQs

How do I see the plugin permissions?

See our plugin's permissions, whether they are given to you and/or everyone, through the /ucolor permissions command.

How do I see what /ucolor commands are there?

Simply use /ucolor ? and you'll be given a list of the commands from there with more information.

For Java 15+ support on servers older than 1.16, why do you require NashornPlus plugin?

NashornPlus is required for those Java 15+ and on versions below 1.16 because the Nashorn JavaScript engine is no longer shipped by default. This is a solution to that problem and it's just a drag and drop to your server to get working. You can download NashornPlus from here. If you're using 1.16 or greater, NahshornPlus isn't required.

Common Issues

Name colors and/or nickname do not display in chat.

The most common cause for this is for those who have Essentials, CMI, or another plugin that prevents modification of a user's display name. If this applies to you, make sure to toggle the prevention off.

  • For Essentials users, you'll need to change change-displayname inside its config from true to false.

  • For CMI users, you'll need to change Change under the DisplayName inside their config from true to false.

  • For other plugins that offer this feature, you'll need to find it either through its documentation or elsewhere.

This can also be caused by improper configuration of your chat formatting system. Make sure you're using a placeholder that shows the player's displayname (eg. %player_displayname% and %ultracolorpro_colored_nickname%).

When a username color is set, the color goes all the way through the chat. If I set the chat color to white, it still has the closing angle bracket colored.

This is an issue with the server's chat format plugin's configuration, rather than with UltraColor. This issue is most reported with EssentialsXChat.

  • To fix this if you're using EssentialsXChat, go to the format/s options of the EssentialsXChat section of EssentialsX config, and add a &f or &r before the {MESSAGE} part for your format/s. Then reload EssentialsX.

  • UltraColorPro shouldn't have this issue if you use its format system.

  • For other chat plugins, please refer to their documentation on configuring their chat system.

I reloaded with PlugMan, /reload, or another plugin (eg. ServerUtils) and the plugin has stopped working.

When you reload with plugins like PlugMan or do /reload, it can cause memory leaks and possible other issues.

To ensure memory leaks don't happen in these cases with our plugin, you need to reload the plugin using /ucolor reload or reboot your server. This common tip can also be applied with almost every other plugin you'll encounter. If you notice a plugin that doesn't have a reload command or changes don't get applied after reloading, the next best thing is to reboot your server.

MySQL isn't synchronizing when players switch servers.

This is largely because saving a player's data on the previous server they were on was completed after the loading has started on the current server.

Due to how the database system works, we have to delay the loading to allow time for the saving to be completed. This delay is configurable in the settings file in Load_After_Ticks inside the Database section.

The default should work for most servers, even with players that have quite some saved. However, depending on your server hardware and what your players have stored, you may need to adjust this value to fit your situation.

Be sure to read the comments above the Load_After_Ticks option as they give useful info on how to best configure this delay. If you have questions, feel free to reach out to our support team.

Last updated