**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.
\nThe plugin’s functionality is based on the Text Display entity.<\/p>\n
**[IMPORTANT]** The plugin **might not work correctly**<\/u> in Minecraft versions **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.<\/p>\n
If you have any issues\/bugs, you may leave them here.<\/p>\n
### \ud83d\udc40 Preview<\/p>\n
<\/p>\n
### \ud83c\udf20 Key features
\n– **Limit per line**: you can configure the symbols limit for each line in the `symbolsPerLine` field.
\n– **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_).
\n– **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.
\n– **Time scaling**: you can make longer messages exist for more time.
\n– **Colors and style**: you can choose the color of the text, its background, whether the text is shadowed and the color for the timer.
\n– **Rotation**: you may configure how a text display will rotate in the `pivotAxis` field.
\n– **Visibility**: 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.
\n– **Adjustable gaps**: you may configure gaps between messages and above player’s head in `gapBetweenMessages` and `gapAboveHead` fields.
\n– **PlaceholderAPI support**: you can configure a placeholder that will color your text displays.<\/p>\n
### \ud83d\udd1e Permissions<\/p>\n
– `messagesonhead.show` _(**true** by default)_ \u2014 Whether messages will appear above player’s head.
\n– `messagesonhead.admin` _(for **operators** by default)_ \u2014 Allows to use the `\/moh` command.<\/p>\n
### \ud83d\udcbb Commands<\/p>\n
– `\/moh info` \u2014 shows commands info. Aliases: `\/messagesonhead`.<\/p>\n ### \ud83d\udcc4 Default config<\/p>\n “`yml # Whether a longer message will exist for more time # Distances between messages \/ above player’s head textColor: “#FFFFFF”<\/p>\n timerEnabled: true backgroundEnabled: true # Whether a text will have a shadow # How a text display can pivot: # You may enable this if you use a plugin for per-player chat color customization (e.g., EZColors, ChatColor etc.) messages: ### \ud83d\ude80 Installation guide<\/p>\n **[IMPORTANT]** Before getting started, make sure that the plugin’s version is **compatible** with your server version.<\/p>\n 1. Download the latest version of the plugin from the Releases tab. Paper plugin (1.19.4+) that shows messages of players (chat bubbles) above their heads.<\/p>\n","protected":false},"featured_media":100668,"template":"","meta":{"_minecraft_slug":"messagesonhead","_minecraft_project_id":"sWyzxINY","_minecraft_author":"MrQuackDuck","_minecraft_license":"MIT","_minecraft_downloads":1432,"_minecraft_follows":17,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"messagesonhead.zip","_minecraft_size_bytes":465739,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T07:26:49.646360Z","_minecraft_date_created":"2025-02-06T00:25:04.672404Z","_minecraft_date_modified":"2026-05-09T22:11:18.892482Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/messagesonhead","_minecraft_icon_attachment_id":100668,"_minecraft_imported_at":"2026-06-05T18:54:47+00:00","_minecraft_import_hash":"e5bf88bafa7e041e5496569d0c5a33f6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,867],"mod_loader":[132,133],"minecraft_version":[58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-100667","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-social","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `\/moh reload` \u2014 reloads the config and makes a cleanup by removing all entities related to the plugin.
\n– `\/moh say
\nsymbolsPerLine: 30
\n# If the limit is reached, the three dots will be added at the end. -1 means there’s no limit
\nsymbolsLimit: -1
\n# Initial amount of seconds for the message to exist
\ntimeToExist: 2
\n# Whether a message will be visible to its sender
\nvisibleToSender: true
\n# Hide the message when the player is under an invisibility effect
\nhideWhenInvisible: true<\/p>\n
\nscalingEnabled: true
\n# Scaling coefficient per symbol in seconds. For example, a message with 50 symbols
\n# will exist for extra 5 seconds if the coefficient is set to 0.1 (because 0.1 * 50 = 5)
\nscalingCoefficient: 0.05<\/p>\n
\ngapBetweenMessages: 0.3
\ngapAboveHead: 0.4<\/p>\n
\n# Minimum message length threshold for the timer to be displayed
\nminSymbolsForTimer: 0
\ntimerFormat: ” (%.1f)”
\ntimerColor: “#F4CA16”<\/p>\n
\nbackgroundColor: “#000000”
\n# Range: [0, 100]
\nbackgroundTransparencyPercentage: 100<\/p>\n
\nisShadowed: true<\/p>\n
\n# VERTICAL – Can pivot around vertical axis
\n# HORIZONTAL – Can pivot around horizontal axis
\n# CENTER – Can pivot around center point
\n# FIXED – No rotation
\npivotAxis: “VERTICAL”<\/p>\n
\nplaceholderApiIntegration: false
\n# Name of a placeholder that will be put before each text line
\ncolorPlaceholder: “%ezcolors_color%”
\n# Format for text lines if `placeholderApiIntegration` is true
\nlineFormat: “&[defaultColor]&[colorPlaceholder][message]”<\/p>\n
\n “prefix”: “&#F4CA16[MessagesOnHead]”
\n “info-title”: “
\n “info-toggle-command-description”: ” &f\/moh toggle – &#D9E6EDAllows you to toggle the visibility of messages on heads.”
\n “info-reload-command-description”: ” &f\/moh reload – &#D9E6EDReloads the config and makes a cleanup by removing all entities related to the plugin.”
\n “info-say-command-description”: ” &f\/moh say – &#D9E6EDSay a message on behalf of the player.”
\n “reloaded”: “
\n “visibility-toggled-on”: “
\n “visibility-toggled-off”: “
\n “only-players”: “
\n “player-not-found”: “
\n “command-not-found”: “
\n “error-during-reload”: “
\n“`<\/p>\n
\n1. Put the downloaded `.jar` into the `\/plugins` folder of your server.
\n1. Restart your server or enter the `\/reload` command.<\/p>\n","protected":false},"excerpt":{"rendered":"