VisualChatChannels

A flexible chat management system for Hytale servers that introduces structured channels, distance-based communication, and text formatting.

Discord: https://discord.gg/Z9tYZ2XKRp

DEPENDENCIES: MultipleHUD & LuckPerms

Core Features

• Visual Channels: A HUD is displayed to the left of the chat to indicate the channel the player is in.
• Channel Variety: Support for Broadcast (global), Proximity (radius-based), and Aggregate (combined) channel types.
• Format & Colors: Support for legacy codes (&a, &l, …) and Hexadecimal colors (<#RRGGBB>). And support of LuckPerms for Suffix, Prefix, …
• Permission Support: Control over who can see a specific channel, or use colors.
• Channel command: /ch command that shows available channels and highlights your current one. /ch channel_id switch the player to the requested channel.

Configuration Example

{
  "Settings": {
    "MessageFormat": "&b&l[<channel> - <world>]&r &f<prefix><username><suffix>&7: &f<message>"
  },
  "Channels": {
    "All": {
      "DisplayName": "ALL",
      "Access": {
        "PermissionNeeded": false,
        "AllowedWorlds": []
      },
      "Behavior": {
        "Type": "aggregate",
        "Radius": 0
      },
      "Children": [
        "Staff",
        "Global",
        "Local",
        "Trade"
      ],
      "MessageFormat": ""
    },
    "Staff": {
      "DisplayName": "STAFF",
      "Access": {
        "PermissionNeeded": true,
        "AllowedWorlds": []
      },
      "Behavior": {
        "Type": "broadcast",
        "Radius": 0
      },
      "Children": [],
      "MessageFormat": "&6&l[S]&r &f<prefix><username>&7: &f<message>"
    },
    "Global": {
      "DisplayName": "GLOBAL",
      "Access": {
        "PermissionNeeded": false,
        "AllowedWorlds": []
      },
      "Behavior": {
        "Type": "broadcast",
        "Radius": 0
      },
      "Children": [],
      "MessageFormat": "&6&l[G]&r &f<prefix><username>&7: &f<message>"
    },
    "Local": {
      "DisplayName": "LOCAL",
      "Access": {
        "PermissionNeeded": false,
        "AllowedWorlds": []
      },
      "Behavior": {
        "Type": "proximity",
        "Radius": 32
      },
      "Children": [],
      "MessageFormat": ""
    },
    "Trade": {
      "DisplayName": "TRADE",
      "Access": {
        "PermissionNeeded": false,
        "AllowedWorlds": []
      },
      "Behavior": {
        "Type": "broadcast",
        "Radius": 0
      },
      "Children": [],
      "MessageFormat": ""
    }
  }
}

Commands

Player Commands

• /ch - Shows accessible channels and current status.
• /ch <channel_id> - Switches your active chat channel.

Admin Commands

• /vcc - Displays the admin help message and version information.
• /vcc reload - Reloads the mod configuration, channel data, and all active HUDs across the server.

Permissions

• /ch - faiizer.visualchatchannels.command.channel
• /ch <channel_id> (id permission required) - visualchatchannels.channel.<channel_id>
• /vcc - faiizer.visualchatchannels.command.visualchatchannels
• /vcc reload - faiizer.visualchatchannels.command.visualchatchannels.reload
• Use colors - visualchatchannels.chatcolor.*

If you have any bugs, requests, or suggestions, feel free to join the Discord!