Compatibility
Minecraft: Java Edition
1.21.6
1.21
1.20
1.19.4
Platforms
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Links
Creators
Details
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.
If you have any issues/bugs, you may leave them here.
👀 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.
- Rotation: you may configure how a text display will rotate in the
pivotAxis
field. - Adjustable height (1.21.6+): you may configure gaps between messages and above player's head in
gapBetweenMessages
andgapAboveHead
fields. - PlaceholderAPI support: you can configure a placeholder that will color your text displays.
🔞 Permissions
messagesonhead.show
(true by default) — Whether messages will appear above player's head.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
# 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-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.
- Download the latest version of the plugin from the Releases tab.
- Put the downloaded
.jar
into the/plugins
folder of your server. - Restart your server or enter the
/reload
command.