Skip to content

Using EssentialsX Chat

Loving11ish edited this page Jan 18, 2026 · 5 revisions

How To Use {CLAN} With EssentialsX Chat

In the latest versions of EssentialsX, the developers moved to using the Paper Chat Event code by default instead of the original (and more stable) Bukkit/Spigot AsyncPlayerChatEvent.

When they did this it broke how ClansLite natively injects the Clan prefix value into the {CLAN} variable inside the EssentialsX config.yml.

To fix this, there is a simple option that needs to be changed inside the EssentialsX config.yml.

  # Whether Essentials should use Paper's modern chat event system in 1.16.5+.
  # This is required for modern chat features such as hover events and click events.
  # If you're experiencing issues with other plugins that use the chat event system, you can disable this.
  # You must restart your server after changing this setting.
  paper-chat-events: true  # <-- This needs setting to `false`

The above setting is located in the EssentialsX Chat section of the EssentialsX config.yml at: chat.paper-chat-events

After changing this you MUST fully RESTART the server so the events can be registered correctly by EssentialsX.

If you find that the {CLAN} placeholder is still not registering correctly at startup, simply increase the following in the config.yml until the placeholder registers correctly:

  delay-essentials-chat-registration:
    #How long in seconds do you wish to delay the event listener registration on plugin load? [Default value: 10]
    #This only needs adjusting if you encounter issue with the {CLAN} placeholder not correctly registering.
    time: 10 # <-- Increase this gradually and test until the lowest working value is reached.

Home Page

Click Here

Clone this wiki locally