Messages On Head

MessagesOnHead is a Paper (1.19.4+) plugin that shows messages above players' heads for a little time when they send messages to the chat.
The plugin's functionality is based on the Text Display entity.

👀 Screenshots

🌠 Key features

• Limit per line: you can configure the symbols limit for each line in the symbolsPerLine field.
• Max symbols limit: you can configure the max amount of symbols per message in the symbolsLimit field ('...' will be appended if the limit is reached).
• Timer: You can enable/disable the timer at the end of the message that shows how much time is left until the message is gone.
• Time scaling: you can make longer messages exist for more time.
• Colors and style: you can choose the color of the text, its background, whether the text is shadowed and the color for the timer.

🔞 Permissions

• messagesonhead.admin (for operators by default) — Allows to use the /moh command.

💻 Commands

• /moh info - shows commands info.
• /moh reload — reloads the config and makes a cleanup by removing all entities related to the plugin.
• /moh say <player> <msg> — says a message on behalf of the player.

Aliases: /messagesonhead.

📄 Default config

symbolsPerLine: 30
# If the limit is reached, the three dots will be added at the end. -1 means there's no limit
symbolsLimit: -1
# Initial amount of seconds for the message to exist
timeToExist: 2

# Whether a longer message will exist for more time
scalingEnabled: true
# Scaling coefficient per symbol in seconds. For example, a message with 50 symbols
# will exist for extra 5 seconds if the coefficient is set to 0.1 (because 0.1 * 50 = 5)
scalingCoefficient: 0.05

# Whether messages should be displayed on the same level as the nickname (for servers with nicknames disabled)
lowerMode: true

textColor: "#FFFFFF"

timerEnabled: true
# Minimum message length threshold for the timer to be displayed
minSymbolsForTimer: 0
timerFormat: " (%.1f)"
timerColor: "#F4CA16"

backgroundEnabled: true
backgroundColor: "#000000"
backgroundTransparencyPercentage: 100 # Range: [0, 100]

isShadowed: true

messages:
  "prefix": "&#F4CA16[MessagesOnHead]"
  "info-content": "<prefix> &#D9E6EDCommands list:
  \n &f/moh reload - &#D9E6EDReloads the config and makes a cleanup by removing all entities related to the plugin.
  \n &f/moh say - &#D9E6EDSay a message on behalf of the player."
  "reloaded": "<prefix> &#D9E6EDReloaded!"
  "player-not-found": "<prefix> Player not found."
  "command-not-found": "<prefix> &cCommand not found."
  "error-during-reload": "<prefix> &cAn error occurred during reload! Check console for details."

🚀 Installation guide

[IMPORTANT] Before getting started, make sure that the plugin's version is compatible with your server version.

1. Download the latest version of the plugin from the Releases tab.
2. Put the downloaded .jar into the /plugins folder of your server.
3. Restart your server or enter the /reload command.