EasyMessages

EasyMessages is a lightweight Bukkit, Spigot, Paper, and Folia plugin for customizing common server messages, normal chat, and private messages. Each supported message can keep the default server behavior, use a custom format, or be hidden.

The plugin is designed for Minecraft 1.7.8 up to the latest server versions while keeping Java 8 compatibility.

Features

• Customize join and quit messages
• Customize kick reasons and kick broadcasts
• Customize normal Minecraft chat formatting
• Customize private messages sent through tell/msg/w commands
• Customize death messages, including combat, mobs, projectiles, items, and common causes
• Customize advancement messages
• Send custom resource pack status messages
• Hide messages you do not want to show
• Keep original server messages when you do not want to change them
• Supports legacy & color codes
• Supports built-in placeholders
• Supports PlaceholderAPI when installed
• Uses bStats for anonymous usage metrics
• Includes /easymessages reload
• Supports Folia

Message Modes

Each configurable message uses one of these modes:

DEFAULT

Keeps the original server message or behavior.

CUSTOM

Replaces the original message with the format from config.yml.

DISABLE

Hides or blocks the message.

Supported Messages

Join Messages

Change the message shown when a player joins the server.

Quit Messages

Change the message shown when a player leaves the server.

Kick Messages

Control both the message shown to the kicked player and the broadcast shown to other players.

Chat Messages

Control the normal Minecraft chat format.

Example:

chat:
  mode: CUSTOM
  message: "&f<displayname>&8: &f<message>"

With PlaceholderAPI:

chat:
  mode: CUSTOM
  message: "%luckperms_prefix%&f<displayname>&8: &f<message>"

Private Messages / Tell

Customize private messages sent with commands such as /tell, /msg, /w, /whisper, and /message.

Example:

tell:
  sender:
    mode: CUSTOM
    message: "&dTo &f<receiver_displayname>&8: &f<message>"

  receiver:
    mode: CUSTOM
    message: "&dFrom &f<sender_displayname>&8: &f<message>"

The sender format should normally use receiver placeholders, because it is shown to the player who sent the tell. The receiver format should normally use sender placeholders.

Death Messages

Customize different types of death messages, including default deaths, player kills, item kills, mob deaths, projectile deaths, fall deaths, lava, fire, void, drowning, and explosions.

Advancement Messages

Customize advancement messages and choose whether hidden advancements should be announced.

Resource Pack Messages

Send custom messages when a resource pack is accepted, downloaded, loaded, declined, failed, invalid, or discarded by the client.

Colors and Placeholders

The plugin uses legacy color codes with &.

Examples:

• &a green
• &c red
• &e yellow
• &f white
• &7 gray
• &l bold
• &o italic
• &n underline
• &r reset

Global Placeholders

• <prefix> - the configured EasyMessages prefix
• <player> - the player's username
• <displayname> - the player's display name
• <world> - the player's current world
• <x> - the player's X coordinate
• <y> - the player's Y coordinate
• <z> - the player's Z coordinate
• <uuid> - the player's UUID

Chat Placeholders

• <message> - the message written by the player

Tell Placeholders

• <sender> - the sender's username
• <sender_displayname> - the sender's display name
• <receiver> - the receiver's username
• <receiver_displayname> - the receiver's display name
• <message> - the private message text
• <target> - the target name used in tell error messages

Death Placeholders

• <killer> - the player who caused the death
• <killer_displayname> - the killer's display name
• <mob> - the mob that caused the death
• <item> - the item used to cause the death
• <cause> - the technical death cause

Advancement Placeholders

• <advancement> - the advancement name
• <advancement_key> - the technical advancement key

Resource Pack Placeholders

• <status> - the technical resource pack status

PlaceholderAPI

PlaceholderAPI is optional. If it is installed, EasyMessages can parse placeholders such as %luckperms_prefix%, %vault_prefix%, or %player_name%.

Enable or disable it in config.yml:

settings:
  placeholderapi:
    enabled: true

EasyMessages declares PlaceholderAPI as a soft dependency, so the plugin still works without it.

bStats

EasyMessages uses bStats to collect anonymous usage metrics, such as server version and player count. Server owners can disable bStats globally in the bStats configuration folder.

Commands

/easymessages reload - reloads the configuration without restarting the server.

Permission:

easymessages.admin

Example Configuration

messages:
  chat:
    mode: CUSTOM
    message: "%luckperms_prefix%&f<displayname>&8: &f<message>"

  tell:
    sender:
      mode: CUSTOM
      message: "&dTo &f<receiver_displayname>&8: &f<message>"

    receiver:
      mode: CUSTOM
      message: "&dFrom &f<sender_displayname>&8: &f<message>"

  join:
    mode: CUSTOM
    message: "&a+ &f<player> &7joined the server."

  quit:
    mode: CUSTOM
    message: "&c- &f<player> &7left the server."

Compatibility

EasyMessages targets Java 8 and is intended to run on Bukkit, Spigot, Paper, and Folia from Minecraft 1.7.8 through the latest supported server versions.