ChatBubblePlugin
Displays a floating chat bubble above a player's head whenever they type a message — a lightweight, native alternative to hologram-based chat plugins, built entirely on Paper's own Display entity API.
What it does
When a player sends a chat message, the plugin can show it two ways at once, or just one:
- Above their head — a
TextDisplaybubble spawns above the player, automatically follows them while they move, and disappears on its own after a short delay. - In the normal chat box — the regular chat message, exactly like vanilla.
Both are independent and fully toggleable. Turn off the normal chat box and keep only bubbles, keep both, or turn off bubbles and keep vanilla chat — it's entirely up to the server owner, and players can also opt out of their own bubble individually.
Features
- 🗨️ Floating chat bubble above the head, following the player in real time
- ✅ Toggle normal chat and bubble chat independently, globally, via command or config
- 🙋 Per-player opt-out with
/bubbletoggle— saved permanently, no database needed - 🎨 Configurable text color, background color, and background opacity
- 📏 Adjustable bubble height, so it never gets hidden behind nametags
- ⏱️ Configurable display duration and character limit
- 🔄 Reload settings on the fly with
/chatbubble reload— no restart required - 🧹 Automatic cleanup on player quit/death and plugin disable — no leftover entities
Commands
| Command | Permission | Description |
|---|---|---|
/chatbubble reload |
chatbubble.admin |
Reload config.yml |
/chatbubble bubble <on|off> |
chatbubble.admin |
Toggle bubble chat globally |
/chatbubble chat <on|off> |
chatbubble.admin |
Toggle normal chat globally |
/chatbubble height <number> |
chatbubble.admin |
Adjust bubble height above the head |
/chatbubble status |
chatbubble.admin |
View current settings |
/bubbletoggle |
chatbubble.toggle (default: all players) |
Toggle your own bubble on/off |
Configuration
All settings live in config.yml, generated on first run — no need to edit any code:
settings.normal-chat.enabled— show messages in the normal chat boxsettings.bubble-chat.enabled— show messages as a bubble above the headsettings.bubble-chat.height-offset— distance above the headsettings.bubble-chat.duration-seconds— how long a bubble stays visiblesettings.bubble-chat.max-characters— truncates long messagessettings.bubble-chat.text-color/background.color/background.opacity— appearancesettings.bubble-chat.scale— bubble text size
Requirements
- Paper (or a Paper fork) 1.26.1.2
Notes
The plugin uses Paper's native TextDisplay entities rather than ArmorStands, so it stays lightweight and compatible with modern client rendering. No external dependencies are required.
