MultiChat Plugin

Links

Introduction

This plugin is installed on all UniversalCraft Paper servers as well as the Waterfall servers. We donated £20 to the author of this plugin to thank them for their efforts in creating it.

Although the already installed EssentialsX collection of plugins comes with its own chat module, we have chosen to deploy and use MultiChat instead as it supports global channel chatting across all UniversalCraft Paper servers.

MultiChat also provides group chat functionality. All players are welcome to create their own chat channels for use by their friends, town residents, faction members and so on.

MultiChat provides facilities to mute players. This has not been enabled as better player silencing functionality is provided by the AdvancedBan plugin instead.

Commands

Specify either “local”, “global” for the <ChannelName> parameter in the following commands.

The /channel command can be shortened to /ch, the /global command can be shortened to /g and the /local command can be shortened to /l.

/channel hide <ChannelName>
Mute an entire channel so you no longer see any messages sent to the specified channel.

/channel show <ChannelName>
Make the content of a previously hidden chat channel visible to you again.

/channel switch <ChannelName>
Set the default chat channel that your character will talk on.

/gc
Toggle whether your default chat messages goes to either your default chat channel (local or global) or your default custom chat channel instead.

/gc <Message>
Send the text message to the custom chat channel that you nominated using the /group <ChannelName> command.

/global <Message>
Send the text message to the global chat channel which will be seen across all UniversalCraft Paper servers. This command is available to everyone, but please use this facility carefully and with consideration for other players. Abuse of this command will result in your character being muted and unable to chat in any server chat channel.

/group <GroupName>
Specify the custom chat group that the messages you create using the /gc command will be sent to.

/group admin <GroupName> <PlayerName>
Add a new administrator to a formal custom chat group.

/group ban <GroupName> <PlayerName>
Ban a player from the specified formal custom chat group. This command can only be issued by an admin of that formal group.

/group create <GroupName> [Password]
Create a new custom chat group with the specified name. A custom chat group can optionally be protected with the password of your choosing.

/group delete <GroupName>
Delete the specified custom chat group that you created using this command.

/group formal <GroupName>
Convert an informal custom chat group into a formal one. A formal group no longer has a group owner but a group of invited group admins.

/group join <GroupName> [Password]
Join a custom chat group. Specify the correct password if the group is password-protected.

/group leave <GroupName>
Leave the specified custom chat group. If you are the current owner of the custom group then you cannot leave it until you either transfer ownership to another player or delete the group entirely.

/group list <GroupName>
List the players who have joined a custom chat group.

/group transfer <GroupName> <PlayerName>
Transfer ownership of your custom chat group to the specified player.

/groups
Display a list of the currently defined custom chat groups.

/ignore <PlayerName>
Add a player to your ignore list so you don’t see any further messages from them.

/freezechat
Temporarily disable in-game chat for regular players. This command is available to moderators and higher in UniversalCraft.

/killchat
Clear the contents of your chat text window.

/local <Message>
Send the text message to the local chat channel which will be seen by all other players who are also using the same server as you.

/nick <PlayerName> <NickName>
This allows players to hide their character name and potentially impersonate another player. Because of this, this command is disabled and nick-names are not permitted within the UniversalCraft gaming environment.

/realname <NickName>
Displays the real name of a character who is playing with a nickname.

Configuration

config.yml

The config.yml file is found on the Bungeecord server.

Set default channel to local on login:

default_channel: "local"
force_channel_on_join: true

Disable staff list:

staff_list: false

Set global channel format:

globalformat: "&7[&aG&7] [&a%SERVER%&7] &7<%DISPLAYNAME%&7> &f"

localconfig.yml

The localconfig.yml file is found on each Paper server.

Set server name to be shown in the global chat channel:

server_name: "(Each UniversalCraft Paper Server Name)"

Set local channel format:

local_chat_format: "&7[&bL&7] &7<%PREFIX%%NICK%%SUFFIX%&7> &f"

Note the use of different placeholders for the local chat format. MultiChat version 1.9.5 has a small bug in it whereby the %DISPLAYNAME% placeholder only shows the prefix and suffix values (as defined in LuckPerms) when used in the global chat channel. It fails to include any prefix and suffix when displaying local chat messages.

Enable MySQL Storage:

nickname_sql: true

Suitable database connection values have been entered.