EasyChannels

EasyChannels is a Minecraft mod enabling players to create and manage custom chat channels with extensive options for message behavior and appearance.

### Compatibility:

Required: Fabric API
Embedded: Text Placeholder API, Fabric Permissions API
Made to Work With:
- Styled Chat
  - If the local channel from EasyChannels is enabled, only the style format for the regular chat provided by Styled Chat will be overwritten.
- LuckPerms
  - If you want to use LuckPerms and the Placeholder API, you'll need to install the LuckPerms Placeholder API Hook mod.

--- ### Documentation:

General Settings

enabled - Enables or disables the mod.
Type: boolean, Default: true
command_argument_name - Command argument name for messages.
Type: string, Default: "message"
permissions_required_message - Message for insufficient permissions.
Type: string, Default: "<red>You don't have the required permissions to use this chat channel."
Local Variables: ${player}, ${message}

Local Channel

enabled - Enables/disables the local chat channel.
Type: boolean, Default: true
format - Message format in local channel.
Type: string, Default: "<white><bold>[L]</bold></white> <gold>${player}</gold> <gray>>></gray> <white>${message}"
Local Variables: ${player}, ${message}
radius - Visibility radius (set -1 to disable).
Type: int, Default: 50
dimension_only - Restrict messages to the same dimension. Ignored if radius enabled.
Type: boolean, Default: true

Custom Channels

enabled - Enables/disables the channel.
Type: boolean, Default: true
literal - Command literal for channel access.
Type: string
format - Custom message format.
Type: string, Default: "<gold>${player}</gold> <gray>>></gray> <yellow>${message}"
Local Variables: ${player}, ${message}
radius - Visibility radius (set -1 to disable).
Type: int, Default: -1
dimension_only - Restrict messages to same dimension (ignored if radius enabled).
Type: boolean, Default: false

Permissions

Both local and custom channels allow permission settings. By default, channels do not require any permissions to send or receive messages. If you add a permission check, either for the sender or receiver, the operator level is always required. A permission manager like LuckPerms is necessary to use permission nodes.

permission_sender - Defines the sender's permission requirements.
permission: Permission node to send messages (default: null)
operator_level: Operator level to send messages (default: 0)
permission_receiver - Defines the receiver's permission requirements.
permission: Permission node to receive messages (default: null)
operator_level: Operator level to receive messages (default: 0)

Permission Example:

{
  "permission_sender": {
    "permission": "easychannels.send",
    "operator_level": 4
  },
  "permission_receiver": {
    "permission": "easychannels.receive",
    "operator_level": 0
  }
}

Full Configuration Example

```json { "enabled": true, "command_argument_name": "message", "permissions_required_message": "You don't have the required permissions to use this chat channel.", "local_channel": { "enabled": true, "format": "[L] ${player} >> ${message}", "radius": 50, "dimension_only": true }, "custom_channels": [ { "enabled": true, "literal": "global", "format": "${player} >> ${message}", "radius": -1, "dimension_only": false }, { "enabled": true, "literal": "staff", "format": "${player} >> ${message}", "radius": -1, "dimension_only": false, "permission_sender": { "permission": "easychannels.send.staff", "operator_level": 0 }, "permission_receiver": { "operator_level": 4 } } ]

Riser876