CoreChatX 2026.2.1.5

Added

• Added Discord player-list commands:
  • Paper discord.yml -> discord.player-list.* for STANDALONE servers.
  • Velocity velocity-discord.yml -> discord.player-list.* for PROXY networks.
  • Supports text command !playerlist, optional slash command /playerlist, CHANNEL / DM / EPHEMERAL visibility, embed color/title, max-players, line-format and more-format.
• Added Velocity /broadcast support. With one CoreChatX group the syntax is /broadcast <message>; with multiple groups the syntax is /broadcast <group|all> <message>.
• Added proxy-routed Paper broadcasts. In deployment.mode: PROXY, Paper /broadcast now routes through Velocity to the whole CoreChatX group instead of only the current backend.
• Added velocity-messages.yml as the Velocity-side source of truth for PROXY network join, quit and first-join formats.

Changed

• In PROXY mode, join-quit.mode: "NETWORK" is now fully Velocity-owned. Paper no longer renders or mirrors network join/quit messages; Velocity decides proxy join, proxy quit, same-group switch suppression and cross-group switch announcements.
• Velocity connection messages now render MiniMessage formats directly from velocity-messages.yml, including {player_name}, {player_nickname} and {count}.
• Discord /link <code> on Velocity now refuses ambiguous link codes if the same pending code exists in more than one CoreChatX group.
• Existing velocity-config.properties, velocity-discord.yml and velocity-messages.yml files now receive missing bundled default keys on startup instead of only being created when absent.
• The Velocity startup banner now points to https://github.com/IceWolf23X/CoreChatX-issues.

Fixed

• Fixed proxy join/quit edge cases where disconnect messages could be missing, duplicated, or sent with fallback plain formatting when players switched backend or disconnected with other players online.
• Fixed switching from a CoreChatX group to an unmapped backend so the old group receives the correct quit announcement.
• Fixed required Discord link/role pre-checks on Velocity failing open when a backend group cannot be resolved. When the login gate is active and the target backend is not mapped, Velocity now denies the login and logs the missing backend-groups.<server> mapping.
• Fixed duplicate plain nicknames in PROXY by adding Velocity-side validation before saving player settings. A custom nickname can no longer collide with another stored custom nickname or with another online player's real name in the same group.
• Fixed Discord player-list output sanitization so configured nicknames, server names and templates are plain, mention-safe Discord text.
• Fixed Minecraft-to-Discord mention safety for raw Discord mention tokens when discord.prevent-mentions-from-minecraft: true is enabled.

Configuration

discord.yml now includes standalone player-list settings:

discord:
  player-list:
    enabled: false
    command: "!playerlist"
    register-slash-command: true
    slash-command-name: "playerlist"
    response-visibility: "CHANNEL"
    max-players: 80
    embed:
      color: "#5865F2"
      title: "Online players ({count})"
      empty-description: "No players are currently online."
      line-format: "- {player_nickname}"
      more-format: "... and {hidden_count} more."

velocity-discord.yml now includes proxy player-list settings:

discord:
  player-list:
    enabled: false
    command: "!playerlist"
    register-slash-command: true
    slash-command-name: "playerlist"
    response-visibility: "CHANNEL"
    max-players: 80
    embed:
      color: "#5865F2"
      title: "Online players ({count})"
      empty-description: "No players are currently online."
      line-format: "- {player_nickname} - {server}"
      more-format: "... and {hidden_count} more."

velocity-messages.yml is new:

nicknames:
  prefix: ""

first-join:
  enabled: true
  counter-enabled: true

join-quit:
  join-enabled: true
  quit-enabled: true
  join: "<dark_gray>[</dark_gray><green>+</green><dark_gray>]</dark_gray> <white>{player_nickname}</white>"
  quit: "<dark_gray>[</dark_gray><red>-</red><dark_gray>]</dark_gray> <white>{player_nickname}</white>"
  first-join: "<dark_gray>[</dark_gray><gradient:#79d6b8:#5aa9ff>Welcome</gradient><dark_gray>]</dark_gray> <white>{player_nickname}</white><gray> is joining for the first time as player </gray><white>#{count}</white><gray>.</gray>"

Permissions

• Velocity /broadcast uses the existing corechatx.command.broadcast permission.

Compatibility

• Paper and Velocity CoreChatX jars must be updated together. The plugin-message protocol is now 21; mixed Paper/Velocity versions are not supported.

Migration

• A clean setup is still recommended for the 2026.2.x line, especially on proxy networks. Regenerate fresh Paper and Velocity config files, then manually reapply server-specific values such as deployment.*, network-channel, backend-groups.*, channel formats, Discord token, Discord routes and required Discord role IDs.
• In PROXY, configure network join/quit/first-join messages in velocity-messages.yml. Paper messages.yml remains the source for STANDALONE and local-only Paper announcements.