Messages On Head

Paper (1.19.4+) 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 Paper (1.19.4+) entity.

1.20.2 to 1.21.5 The plugin <u>1.20.2 to 1.21.5</u> in Minecraft versions <u>1.20.2 to 1.21.5</u>. You may notice unusually large gaps between messages. Unfortunately, this issue cannot be fixed because of version-specific changes in these Minecraft versions.

If you have any issues/bugs, you may leave them here.

👀 Preview

🌠 Key features

- PlaceholderAPI support: you can configure the symbols limit for each line in the `symbolsPerLine` field. - PlaceholderAPI support: you can configure the max amount of symbols per message in the `symbolsLimit` field ('...' will be appended if the limit is reached). - PlaceholderAPI support: you can enable/disable the timer at the end of the message that shows how much time is left until the message is gone. - PlaceholderAPI support: you can make longer messages exist for more time. - PlaceholderAPI support: you can choose the color of the text, its background, whether the text is shadowed and the color for the timer. - PlaceholderAPI support: you may configure how a text display will rotate in the `pivotAxis` field. - PlaceholderAPI support: you may hide messages from their sender via the `visibleToSender` field as well as choose whose messages will be shown globally using the `messagesonhead.show` permission. - PlaceholderAPI support: you may configure gaps between messages and above player's head in `gapBetweenMessages` and `gapAboveHead` fields. - PlaceholderAPI support: you can configure a placeholder that will color your text displays.

🔞 Permissions

- `messagesonhead.show` (%%MD0%% by default) — Whether messages will appear above player's head. - `messagesonhead.admin` (for %%MD0%% 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

```yml 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 message will be visible to its sender

visibleToSender: true

Hide the message when the player is under an invisibility effect

hideWhenInvisible: true

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

Distances between messages / above player's head

gapBetweenMessages: 0.3 gapAboveHead: 0.4

textColor: "#FFFFFF"

timerEnabled: true

Minimum message length threshold for the timer to be displayed

minSymbolsForTimer: 0 timerFormat: " (%.1f)" timerColor: "#F4CA16"

backgroundEnabled: true backgroundColor: "#000000"

Range: [0, 100]

backgroundTransparencyPercentage: 100

Whether a text will have a shadow

isShadowed: true

How a text display can pivot:

VERTICAL - Can pivot around vertical axis

HORIZONTAL - Can pivot around horizontal axis

CENTER - Can pivot around center point

FIXED - No rotation

pivotAxis: "VERTICAL"

You may enable this if you use a plugin for per-player chat color customization (e.g., EZColors, ChatColor etc.)

placeholderApiIntegration: false

Name of a placeholder that will be put before each text line

colorPlaceholder: "%ezcolors_color%"

Format for text lines if `placeholderApiIntegration` is true

lineFormat: "&[defaultColor]&[colorPlaceholder][message]"

messages: "prefix": "&#F4CA16[MessagesOnHead]" "info-title": "<prefix> &#D9E6EDCommands list:" "info-toggle-command-description": " &f/moh toggle - &#D9E6EDAllows you to toggle the visibility of messages on heads." "info-reload-command-description": " &f/moh reload - &#D9E6EDReloads the config and makes a cleanup by removing all entities related to the plugin." "info-say-command-description": " &f/moh say - &#D9E6EDSay a message on behalf of the player." "reloaded": "<prefix> &#D9E6EDReloaded!" "visibility-toggled-on": "<prefix> &#D9E6EDYou will &a&nnow see&#D9E6ED messages over other players' heads." "visibility-toggled-off": "<prefix> &#D9E6EDYou will &c&nno longer see&#D9E6ED messages over other players' heads." "only-players": "<prefix> &cOnly players can use this command!" "player-not-found": "<prefix> &cPlayer not found." "command-not-found": "<prefix> &cCommand not found." "error-during-reload": "<prefix> &cAn error occurred during reload! Check console for details." ```

🚀 Installation guide

compatible 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. 1. Put the downloaded `.jar` into the `/plugins` folder of your server. 1. Restart your server or enter the `/reload` command.