Proxy Messages

# Proxy-Messages ## Unified System and Player Messages for Your Velocity/Paper Network ProxyMessages is a powerful Velocity plugin designed to unify your network’s messaging system across all servers. ProxyMessages can be configured to send messages to players across all servers for player chat messages, proxy connections, disconnections, and server changes. Whether you run a small network or a large-scale operation, ProxyMessages helps you deliver a seamless player experience by synchronizing key messages across your entire server network. Join (https://discord.gg/C2PJNTN97u) !(https://github.com/user-attachments/assets/fe5e1ed0-9c39-49ef-b246-d282ac1a4d0f) ## Key Features: * Global messages so players can communicate with one another, even if they aren't connected to the same server. * Configurable Messages: Customize join, leave, server switch, and player messages with ease, tailoring them to fit the tone and style of your server network. * Extendable configuration options: **PlaceholderAPI support!** * Multiple Message Variants: Create multiple potential messages for each event, allowing for variety and keeping the experience fresh for your players. * Custom Colors with HEX Support: Enhance your messages with custom colors using HEX codes to match your server's branding or aesthetic. * Kyori Adventure TextDecoration: custom text formatting beyond just color! * Ability to instate network-wide resource packs. * Integration with Discord to keep your sever network connected over discord! ### Configuration Overview: All configuration is managed on the proxy side, meaning there’s no need to synchronize settings across individual backend servers. Simply edit the `config.yml` file located in `plugins/proxymessages/` on your proxy server to get started. ### The Paper Plugin: The paper plugin's role was extended in version 4.0.0 of this plugin. The versions after 4.0.0 of the paper plugin are not compatible with unversioned ones that came before it. #### Pre 4.0.0 --- ProxyMessages can work standalone on a velocity server. However, due to limitations in the velocity API, it cannot edit or change the vanilla messages that normally appear on servers. These include the vanilla join and leave messages, as well as vanilla chat messages on the server that the player is connected to. If you'd like remove the vanilla join and leave messages, and format chat messages, please use the provided paper plugin on all of your backend servers. Once the paper plugin is installed, the aforementioned features will automatically start working. No extra configuration is needed. #### 4.0.0 and beyond --- The paper plugin does everything that the pre-4.0.0 versions did, with the addition that they now are a requirement for PlaceholderAPI support. The paper plugin is **required** to be installed on all backend servers if `enable-papi` is true **in the proxy config**. If you do not care for PlaceholderAPI support, ensure that `enable-papi` is set to false, and the paper plugins will be optional. It is still highly recommended, as it improves the user experience. The option is there for you. In the same way as before, no additional configuration is needed on the paper plugin, simply install it. All configuration is still on the velocity plugin. | `enable-papi` | Paper Plugin? | Paper Plugin Version | | ----------- | ------------- | -------------------- | | `false` | Optional | >= 4.0.0 | | `true` | Required | >= 4.0.0 | | N/A | Optional | < 4.0.0 | **Table 1**: Overview of paper plugin requirements --- ### **COLOR**: In all message options, you can insert a hex code inside brackets (example: `{#ff0066}`). All text after the hex code **except player names** will be turned into that color. You can use this multiple times in one string for a multicolored message. Default color for all text is yellow. ### **STYLING** In all message options, you can use Kyori Adventure TextDecoration options to further style your text. Options include: * `{bold}` - text after this tag is bold * `{italic}` - text after this tag is italic * `{strike}` - text after this tag has strikethroughs * `{underline}` - text after this tag is underlined * `{obfuscate}` - text after this tag is obfuscated Two sets of these tags will "open" and "close" their style. For example, you can stylize a chunk of text by sandwiching it between the corresponding tags. ### Key Configuration Options: * `enable-papi`: enable PlaceholderAPI support, see below for more information. * `default-player-color`: The default color for players who haven't set a color for their name. * `choose-color`: Whether or not players are allowed to set the color of their name. * `global-network-join`: Toggle the join message for all users when a player joins the network. * `global-network-leave`: Toggle the leave message for all users when a player leaves the network. * `global-network-switch