ProxyMessages icon

ProxyMessages -----

Customizeable messages across all servers on your proxy.



Configuration Overview:
All configurations are 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.

Note:
This plugin is only required to be on the proxy server. However, the vanilla "{player} has joined the game." messages will still appear. I recommend using a plugin on all of your backend servers to remove this message. I created and built one for your convenience, but it has no correlation to the function of the proxy plugin. Use whatever plugin you like. The build of the server-side plugin is no longer included in releases 3.0.0 and above. If you'd like to use the server-side plugin to remove the default join and leave messages, please find an old release, and download from there, or build a new one.

COLOR:

In all message options, you can insert a hex code inside brackets (example: `{#ff0066}`). All text after the hex code 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 join options. 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 syle. For example, you can stylize a chunk of text by sandwitching it between the corresponding tags.


Key Configuration Options:

  • `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`: Toggle the server switch message for all users when a player moves between servers.
  • `global-messages`: Toggle the server's ability to send player's messages across all servers.
  • `join-message-options`: Define a list of potential join messages. Use {player} as a placeholder for the player’s username.
  • `leave-message-options`: Define a list of potential leave messages. Use {player} as a placeholder for the player’s username.
  • `switch-message-options`: Define a list of potential switch messages. Use {player}, {prev} for the previous server, and {cur} for the current server as placeholders.
  • `global-message-prefix`: The prefix to global messages for other servers. Use {player} for the player sending the message, and {cur} as the server they're sending the message from.

### Global Player Messaging:

Once `global-messages` is enabled, players can toggle their messages between "global" and "local" by using any of the following commands (aliases used for convenience):
  • `toggleGM`
  • tGM`
  • `pmToggle`

Global messages mean that the user's messages will be displayed in the server they are connected to, as well as all other servers on the network.

Local messages mean that the user's messages will only be displayed in the server they are connected to.

Resource Packs:
This section discusses the ability to instate a network-wide resource pack

Under the `network-resource-pack` section of your `config.yml`:

`enabled`: toggles the resource pack on and off

Note: None of the configuration from this point forward will not matter if `enabled` is `false`

  • `url`: The download url of your resource pack
  • `sha1-hash`: The hash of your resource pack
    NOTE: At this time, a hash will do nothing, as I don't know how to properly translate it to a byte array. If you know how, please open a PR or Issue ticket on the github page for this project.
  • `prompt`: The prompt users will recieve, inquiring abotu whether they want the resource pack
  • `required`: Whether or not the resource pack is required to play on the network
  • `except`: A list of servers to ignore when sending resource packs to players.


Discord:
This section discusses the discord integration functionality features and customizability.

Under the `discord` section of your `config.yml`:

`enabled`: Toggles the discord functionality.

Note: None of the configuration from this point forward will not matter if `enabled` is `false`

  • `bot-token`: A string that represents the bot token that the plugin will attempt to connect to. This is the same as the one you might use in the DiscordSRV plugin.
  • `channel-id`: The ID of the channel you want the proxy messages to be sent to.
  • `join-color`: Hex color code to be used for the Discord embed for join messages.
  • `leave-color`: Hex color code to be used for the Discord embed for leave messages.
  • `switch-color`: Hex color code to be used for the Discord embed for switch messages.
  • `text-configuration`: Options to customize the messages that get sent. Text options support markdown formatting.
  • `online-message`: The message to be sent when the proxy boots up.
  • `offline-message`: The message to be sent when the proxy shuts down.
  • `server-count`: Toggles whether a list of active servers will be printed when booting the proxy.
  • `display-icon`: Toggles whether or not to display a provided image on startup and shutdown.

Note: `display-icon` will not work unless you provide an image for it to display. You can do this by placing an image named `icon.jpg` in your `plugins/proxymessages` directory. When turned to `true`, the plugin will detect the image and use it automatically.
Resource Information
Author:
----------
Total Downloads: 50
First Release: Feb 26, 2025
Last Update: Apr 13, 2025
Category: ---------------
All-Time Rating:
0 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings