// ChatBubbles | [1.21] | [Factions/Citizens Compatible] | [PlaceholderAPI] \\

Purpose : Chat Bubbles is meant to be a free plugin that allows players' messages to appear above their head and servers to customize the way in which this works. I've seen other plugins that do this but the messages don't follow the player and that seems realllllly useless. That's where I decided to improve on what I saw already existed.

V1.20.1.a.1 Update: The visibility bug plaguing HolographicDisplays and DecentHolograms since like 1.17 has been fixed on their end. I have updated my plugin to use their fixes. All visibility related problems should finally be fixed after what feels like years!!! If you use HolographicDisplays, players must RELOG after a /reload or the holograms will not exist properly for them. This is a bug with HolographicDisplays.

Requirements :

• HolographicDisplays or DecentHolograms (preferably DecentHolograms) (If you use HolographicDisplays as of 1.20.1 make sure you use the hyperlink here. If you download from Bukkit or the most recent build, it didn't function properly for me. You need THIS specific version as of June 27, 2023 or if you're in the future any version past 3.0.3 because 3.0.3 release #258 doesn't actually work).
• ProtocolLib (Hologram libraries require this for full functionality)
  
• Factions (Optional Integration)
• Citizens (Optional Integration) Give the NPC the trait "chatbubble"

Test Servers :

• mc.kaoshkraft.net
• mc.herosfaith.eu

⟿ Easy "Configuration Mode" Switching : Allows the plugin to be utilized in different preset, yet still configurable, ways

⟿ PlaceholderAPI Implementation : Allow PlaceholderAPI placeholders to work on the plugin.
NOTE: For all of you unfamiliar with PlaceholderAPI, you must download its "modules" of placeholders before they will start working. For example, to use "%player_name%", you must first type "/papi ecloud download player" on your server to download the Player module. This is a PlaceholderAPI thing, is not my fault, and cannot be fixed on my part.

⟿ ChatBubble Formatting : Want a custom look and feel to your server? With formatting you can have more control from the server side of things on how they look.

⟿ Factions Mode : Allow Factions members to see your chat bubbles

⟿ Permissions Based : Want bubbles to be a donator perk or VIP functionality? You can do that.

⟿ Customizable Prefix/Suffix : Want your server to have a unique look and feel? You can do that.

⟿ ChatBubble Toggle : Players can independently toggle their ChatBubbles on or off given they have the permissions.

⟿ Works Perfectly on Heavily Populated Servers : Have a server with 250+ players? No issue.


⟿ [1.17.1.a.1] Hex Color Support : Type a message in the format "&#HEX" to get custom hex colors. An example would be "&#FF66FF".

⟿ [1.18.1.a.1] DecentHolograms Support : HolographicDisplays explicitly locks users out from using their plugin after every new Spigot release until they formally post an update. Pisses me off. DecentHolograms is the new goto.

⟿ [1.18.1.a.2] EventPriority Support : Although this likely won't fix inherent conflicts with many chat managing plugins, for simple things like unicode image replacers this should help a fair bit. If you know what it means, use it. If you don't, don't touch it ezpz.

⟿ [1.18.1.a.6] Citizens Support : Citizens can now speak through chatbubbles. Give them the trait "chatbubble".

⟿ [1.18.1.a.12] NPC Custom Sound Support : Per-NPC sounds are now possible to configure in config.yml. Custom resource pack sounds work. Only available with DecentHolograms installed, or both HolographicDisplays and DecentHolograms installed.

⟿ [1.19.2.a.1] Blacklist : Added a blacklist section to config.yml. Note: this does NOT blacklist general chat. If you want a standard chat filtering system, get one of the billion plugins made explicitly for that. This is merely my attempt to integrate filtering for visual chatbubbles.

⟿ [1.19.2.a.5] Config Mode 6 : @ masonhorne4 added a sixth section to config.yml. In mode 6, all messages automatically become chatbubbles unless they start with prefixes listed in config.yml.

⟿ [1.20.1.a.2] Configurable messages.yml : Added a configurable messages.yml with messages.

⟿ Check "Soon To Come" & "config.yml" for all features...

Note: All permissions are optional and if enabled, are defined by the server owner in the config.

⟿ (If in Configuration Mode 1) /cb <message> : Speaks a chatbubble. Requires permission "chatbubble.use"

⟿ /cbreload : Reloads the config. Requires permission "chatbubble.reload"

⟿ /cbtoggle : Toggles player's ChatBubbles on/off. Requires permission "chatbubble.toggle"

I see no need for a written tutorial but if you want me to post your youtube explanation or whatnot, pm me.

• [1.2.8] Factions Incorporation : This would allow Factions members to see other Factions members chat bubbles in the same faction.
• More Configuration Modes : If you have any ideas for configuration modes, let me know in the discussion section.
• [1.3.1] Plugin Update Notifier : This would notify people when there is an update available in the least annoying way possible.
• [1.3.1] Config Auto-Update : This would automatically update configs whenever the layout resets. (If you have used any version below 1.3.1 in the past, you must do a manual config backup/delete to take advantage of this feature)
• Config Changes Carry Over On Auto-Update : This would keep the changes you've made to the config if they still apply to the new config.
• [1.4.1] PlaceholderAPI Support : Self explanatory
• [1.4.1] Custom ChatBubble Format : Server owners will have way more control over the look of chat bubbles
• [1.4.2] Invisible Player Support : This makes invisible players not send a chatbubble (post-implementation edit: This only takes into consideration invisibility through Spigot API and does not work on players invisible due to packet control)
• [1.4.4] Custom Height Option : This would allow custom nametag plugins be taken into account when placing the chatbubble
• [1.4.5] Wordwrap : This would wrap the player-typed words if they are longer than the configured message length
• [1.4.6] Overlap Control : Now new messages will replace the old message's bubble
• [1.5.6] Sound Support : ChatBubbles will now be able to make a sound. Sounds can be vanilla or from custom resource packs. Test the sound name by using /playsound to ensure what you put in the config will work. Requested by @SpringBonnie.