CoreChatX 2026.2.5

Added

• Added bStats metrics for Paper and Velocity.
• Added configurable public-chat /ignore behavior through ignore.public-chat-mode and per-channel channels.<id>.ignore.public-chat-mode.

Fixed

• Fixed public mention and custom-ping ignore handling so notifications-only blocks notifications from ignored players while keeping their public chat messages visible.
• Fixed hide-message public-chat ignore mode so ignored players' public channel messages are not delivered to the viewer, including network and Discord bridge deliveries.
• Fixed legacy formatting permission checks so denied nodes such as corechatx.format.color.aqua can reliably block matching & color codes.
• Fixed denied legacy formatting codes being converted anyway after a second formatting pass.

Configuration

privacy.yml now supports:

ignore:
  public-chat-mode: "notifications-only"

channels.yml now supports per-channel overrides:

channels:
  global:
    ignore:
      public-chat-mode: "inherit"

Valid public-chat ignore modes are off, notifications-only and hide-message. Per-channel overrides also support inherit.

Permissions

• Added corechatx.format.color, corechatx.format.color.*, corechatx.format.style and corechatx.format.style.* as group permission nodes for player-authored legacy formatting.

Technical

• Paper and Velocity jars now include bStats' MIT-licensed single-file implementation and license notices without adding shaded external library jars.

CoreChatX 2026.2.5

Added

• Added bStats metrics for Paper and Velocity.
• Added configurable public-chat /ignore behavior through ignore.public-chat-mode and per-channel channels.<id>.ignore.public-chat-mode.

Fixed

• Fixed public mention and custom-ping ignore handling so notifications-only blocks notifications from ignored players while keeping their public chat messages visible.
• Fixed hide-message public-chat ignore mode so ignored players' public channel messages are not delivered to the viewer, including network and Discord bridge deliveries.
• Fixed legacy formatting permission checks so denied nodes such as corechatx.format.color.aqua can reliably block matching & color codes.
• Fixed denied legacy formatting codes being converted anyway after a second formatting pass.

Configuration

privacy.yml now supports:

ignore:
  public-chat-mode: "notifications-only"

channels.yml now supports per-channel overrides:

channels:
  global:
    ignore:
      public-chat-mode: "inherit"

Valid public-chat ignore modes are off, notifications-only and hide-message. Per-channel overrides also support inherit.

Permissions

• Added corechatx.format.color, corechatx.format.color.*, corechatx.format.style and corechatx.format.style.* as group permission nodes for player-authored legacy formatting.

Technical

• Paper and Velocity jars now include bStats' MIT-licensed single-file implementation and license notices without adding shaded external library jars.

CoreChatX 2026.2.4

Added

• Added batched Discord console live logs for Paper and Velocity. CoreChatX now edits the latest bot log message until the configured size limit is reached, then sends a new silent message.
• Added real Velocity proxy console live-log support through discord.console.live-log.
• Added nicknames.allow-special-characters, default false, to keep /nick visible text limited to A-Z, a-z, 0-9 and _ unless explicitly enabled.
• Added per-event Discord mirror overrides under discord.event-messages.events.death and discord.event-messages.events.advancement.
• Added ChatItem snapshot references to cross-server private messages so /msg and /reply can carry inspectable ChatItem previews through Velocity.

Changed

• Discord console live logs now use discord.console.live-log-format.* for max-message-chars, monospace, line-prefix, date-format and hour-format.
• /msg and /reply now render configured ChatItem tokens such as [i], [item], [inv] and related aliases instead of sending them as plain text.
• Discord item detail tooltips now resolve MiniMessage tags, including formatting and gradients, before the image renderer draws the tooltip text.
• /msg tab completion now includes matching custom nicknames and avoids suggesting the sender's own real name or nickname.
• Network chat completion entries now include plain custom nicknames, with support for @nickname completions.
• Velocity Discord nickname sync now includes the configured Minecraft nickname prefix when the player has a custom nickname, while keeping the real-name fallback unprefixed.
• Velocity third-party library logs now use the CoreChatX startup banner style and summarize present, missing and downloaded libraries without duplicate status lines.

Fixed

• Fixed Discord inbound messages after a restart sometimes reaching Minecraft without the linked player's LuckPerms prefix. CoreChatX now waits for async LuckPerms user data before final delivery.
• Fixed linked Discord inbound permission checks for offline linked players by resolving channel send permission and mute-chat bypass through async LuckPerms checks.
• Fixed private-message target lookup so custom nicknames can resolve to the real Minecraft username before local or cross-server delivery.
• Fixed Velocity private-message ChatItem routing so remote preview requests can be forwarded back to the backend that owns the original snapshot.
• Fixed Discord ChatItem selected-item actions so expired or unavailable previews return a Discord message instead of leaving the interaction pending.
• Fixed Velocity Discord inbound fanout so a message that cannot be delivered to any backend in the CoreChatX group returns a clear failure instead of failing silently.
• Fixed Velocity Discord console command replies so commands with no output no longer send the debug-style Command executed. No command output was captured. message, and translatable Velocity command output such as !glist all is rendered as readable text instead of raw translation keys.
• Fixed discord.connection-messages.channels fallback semantics so empty lists fall back to discord.default-channel-id, and the configured values are treated as Discord channel IDs.
• Fixed Velocity Discord inbound handling so route dispatch runs through the Velocity scheduler when the proxy runtime is available.

Configuration

New or changed default keys:

• config.yml -> nicknames.allow-special-characters
• discord.yml -> discord.console.live-log-format.max-message-chars
• discord.yml -> discord.console.live-log-format.monospace
• discord.yml -> discord.console.live-log-format.line-prefix
• discord.yml -> discord.console.live-log-format.date-format
• discord.yml -> discord.console.live-log-format.hour-format
• discord.yml -> discord.event-messages.events.death
• discord.yml -> discord.event-messages.events.advancement
• velocity-discord.yml -> discord.console.live-log-format.max-message-chars
• velocity-discord.yml -> discord.console.live-log-format.monospace
• velocity-discord.yml -> discord.console.live-log-format.line-prefix
• velocity-discord.yml -> discord.console.live-log-format.date-format
• velocity-discord.yml -> discord.console.live-log-format.hour-format
• velocity-discord.yml -> discord.event-messages.events.death
• velocity-discord.yml -> discord.event-messages.events.advancement

Compatibility

• CoreChatX proxy protocol is now version 27; update Paper and Velocity jars together.
• Velocity third-party libraries are expected under the lowercase plugin data folder path plugins/corechatx/libs.

Migration

• If discord.connection-messages.channels is configured, keep Discord channel IDs in that list.
• If you customized death-format, advancement-format, death-color, advancement-color, death-description or advancement-description, move those values into the matching discord.event-messages.events.<event> section.
• Review discord.console.live-log-format.* if Discord console logging is enabled, especially if you do not want monospace code blocks or timestamp prefixes.

CoreChatX 2026.2.4

Added

• Added batched Discord console live logs for Paper and Velocity. CoreChatX now edits the latest bot log message until the configured size limit is reached, then sends a new silent message.
• Added real Velocity proxy console live-log support through discord.console.live-log.
• Added nicknames.allow-special-characters, default false, to keep /nick visible text limited to A-Z, a-z, 0-9 and _ unless explicitly enabled.
• Added per-event Discord mirror overrides under discord.event-messages.events.death and discord.event-messages.events.advancement.
• Added ChatItem snapshot references to cross-server private messages so /msg and /reply can carry inspectable ChatItem previews through Velocity.

Changed

• Discord console live logs now use discord.console.live-log-format.* for max-message-chars, monospace, line-prefix, date-format and hour-format.
• /msg and /reply now render configured ChatItem tokens such as [i], [item], [inv] and related aliases instead of sending them as plain text.
• Discord item detail tooltips now resolve MiniMessage tags, including formatting and gradients, before the image renderer draws the tooltip text.
• /msg tab completion now includes matching custom nicknames and avoids suggesting the sender's own real name or nickname.
• Network chat completion entries now include plain custom nicknames, with support for @nickname completions.
• Velocity Discord nickname sync now includes the configured Minecraft nickname prefix when the player has a custom nickname, while keeping the real-name fallback unprefixed.
• Velocity third-party library logs now use the CoreChatX startup banner style and summarize present, missing and downloaded libraries without duplicate status lines.

Fixed

• Fixed Discord inbound messages after a restart sometimes reaching Minecraft without the linked player's LuckPerms prefix. CoreChatX now waits for async LuckPerms user data before final delivery.
• Fixed linked Discord inbound permission checks for offline linked players by resolving channel send permission and mute-chat bypass through async LuckPerms checks.
• Fixed private-message target lookup so custom nicknames can resolve to the real Minecraft username before local or cross-server delivery.
• Fixed Velocity private-message ChatItem routing so remote preview requests can be forwarded back to the backend that owns the original snapshot.
• Fixed Discord ChatItem selected-item actions so expired or unavailable previews return a Discord message instead of leaving the interaction pending.
• Fixed Velocity Discord inbound fanout so a message that cannot be delivered to any backend in the CoreChatX group returns a clear failure instead of failing silently.
• Fixed Velocity Discord console command replies so commands with no output no longer send the debug-style Command executed. No command output was captured. message, and translatable Velocity command output such as !glist all is rendered as readable text instead of raw translation keys.
• Fixed discord.connection-messages.channels fallback semantics so empty lists fall back to discord.default-channel-id, and the configured values are treated as Discord channel IDs.
• Fixed Velocity Discord inbound handling so route dispatch runs through the Velocity scheduler when the proxy runtime is available.

Configuration

New or changed default keys:

• config.yml -> nicknames.allow-special-characters
• discord.yml -> discord.console.live-log-format.max-message-chars
• discord.yml -> discord.console.live-log-format.monospace
• discord.yml -> discord.console.live-log-format.line-prefix
• discord.yml -> discord.console.live-log-format.date-format
• discord.yml -> discord.console.live-log-format.hour-format
• discord.yml -> discord.event-messages.events.death
• discord.yml -> discord.event-messages.events.advancement
• velocity-discord.yml -> discord.console.live-log-format.max-message-chars
• velocity-discord.yml -> discord.console.live-log-format.monospace
• velocity-discord.yml -> discord.console.live-log-format.line-prefix
• velocity-discord.yml -> discord.console.live-log-format.date-format
• velocity-discord.yml -> discord.console.live-log-format.hour-format
• velocity-discord.yml -> discord.event-messages.events.death
• velocity-discord.yml -> discord.event-messages.events.advancement

Compatibility

• CoreChatX proxy protocol is now version 27; update Paper and Velocity jars together.
• Velocity third-party libraries are expected under the lowercase plugin data folder path plugins/corechatx/libs.

Migration

• If discord.connection-messages.channels is configured, keep Discord channel IDs in that list.
• If you customized death-format, advancement-format, death-color, advancement-color, death-description or advancement-description, move those values into the matching discord.event-messages.events.<event> section.
• Review discord.console.live-log-format.* if Discord console logging is enabled, especially if you do not want monospace code blocks or timestamp prefixes.

CoreChatX 2026.2.3

Added

• Added channel command shortcuts through channels.<id>.shortcut.
  • Running /shortcut switches the player to that CoreChatX channel.
  • Running /shortcut <message> sends one message to that channel without changing the player's active channel.
• Added Discord nickname sync with account-linking.sync-mc-name for both Paper STANDALONE and Velocity PROXY. Linked Discord members can have their Discord nickname updated to the Minecraft nickname, falling back to the real player name when no custom nickname is set.
• Added Discord event mirrors through discord.event-messages for death and advancement messages.
  • Paper STANDALONE can send the event embeds directly.
  • Velocity PROXY can send the accepted backend events once per CoreChatX group.
• Added Discord server status embeds through discord.server-status.
  • Paper STANDALONE can announce clean server startup/shutdown.
  • Velocity PROXY can announce proxy startup/shutdown and backend online/offline state changes from backend-groups.*.
  • proxy, default, and servers.<id> entries can override channels, titles, descriptions, colors, and enabled flags.
• Added /corechatx itemcache <warmup|status|cancel> with corechatx.command.itemcache to pre-render Discord ChatItem item icons into cache.
• Added ChatItem token placeholders for in-game token formats: {token}, {name}, {material}, and {amount}. {name} uses custom_name, then item_name, then the material fallback.
• Added LICENSE and THIRD-PARTY-NOTICES.md to document CoreChatX proprietary code and the third-party dependency notice summary.

Changed

• Removed shaded jar packaging. Paper now declares external runtime libraries through plugin.yml libraries, while Velocity downloads its external third-party jars into plugins/CoreChatX/libs and logs whether libraries were downloaded or already present.
• Discord ChatItem renders now default to discord-images.render.scale: 8, single-item-details-scale: 8, and single-item-details-icon-multiplier: 4.
• Velocity PlaceholderAPI resolution through PAPIProxyBridge now times out after 3 seconds and falls back to the original text instead of waiting indefinitely.

Fixed

• Fixed mentions and ping notifications for channels the target player cannot read. If the mentioned player cannot receive the channel, CoreChatX no longer pings them and no longer renders the name as an @ mention.
• Fixed Discord selected-item inspection hanging forever when the selected snapshot expired or the selected item could not be rendered. Discord now receives the configured expired-message or unavailable-message.
• Fixed intermittent missing Discord ChatItem previews in PROXY mode by sending preview packets on the server thread, allowing empty failure packets, retrying failed Discord image sends, and completing chunk transfers only once all chunks are available.
• Fixed enchanted books in Discord item rendering by including stored enchantments from EnchantmentStorageMeta, so stored enchants can appear in tooltip data and trigger enchanted rendering.
• Fixed Velocity Discord inbound delivery so backend plugin-message send failures are caught and logged per backend instead of silently breaking delivery.
• Fixed Velocity connection-message routing so proxy join/quit fanout handles backend send failures and keeps group join tracking consistent.
• Fixed Velocity YAML default synchronization for keys that existed with a null value, so missing defaults can be restored more consistently.

Configuration

New or changed default keys:

• channels.<id>.shortcut
• chatitems.yml -> tokens.item.token-format placeholders: {token}, {name}, {material}, {amount}
• chatitems.yml -> discord-images.render.scale: 8
• chatitems.yml -> discord-images.render.single-item-details-scale: 8
• chatitems.yml -> discord-images.render.single-item-details-icon-multiplier: 4
• account-linking.sync-mc-name
• discord.event-messages
• discord.server-status

plugin.yml now includes:

• Paper runtime libraries
• corechatx.command.itemcache

Migration

• Review discord.connection-messages.channels if you enabled Discord join/quit mirrors. Values must now be Discord channel IDs, not CoreChatX channel IDs.
• Review discord.server-status, discord.event-messages, and account-linking.sync-mc-name before enabling them, especially on Velocity networks.
• Existing configs should receive missing default keys automatically, but server owners should still compare channels.yml, chatitems.yml, discord.yml, and velocity-discord.yml with the new defaults.

CoreChatX 2026.2.3

Added

• Added channel command shortcuts through channels.<id>.shortcut.
  • Running /shortcut switches the player to that CoreChatX channel.
  • Running /shortcut <message> sends one message to that channel without changing the player's active channel.
• Added Discord nickname sync with account-linking.sync-mc-name for both Paper STANDALONE and Velocity PROXY. Linked Discord members can have their Discord nickname updated to the Minecraft nickname, falling back to the real player name when no custom nickname is set.
• Added Discord event mirrors through discord.event-messages for death and advancement messages.
  • Paper STANDALONE can send the event embeds directly.
  • Velocity PROXY can send the accepted backend events once per CoreChatX group.
• Added Discord server status embeds through discord.server-status.
  • Paper STANDALONE can announce clean server startup/shutdown.
  • Velocity PROXY can announce proxy startup/shutdown and backend online/offline state changes from backend-groups.*.
  • proxy, default, and servers.<id> entries can override channels, titles, descriptions, colors, and enabled flags.
• Added /corechatx itemcache <warmup|status|cancel> with corechatx.command.itemcache to pre-render Discord ChatItem item icons into cache.
• Added ChatItem token placeholders for in-game token formats: {token}, {name}, {material}, and {amount}. {name} uses custom_name, then item_name, then the material fallback.
• Added LICENSE and THIRD-PARTY-NOTICES.md to document CoreChatX proprietary code and the third-party dependency notice summary.

Changed

• Removed shaded jar packaging. Paper now declares external runtime libraries through plugin.yml libraries, while Velocity downloads its external third-party jars into plugins/CoreChatX/libs and logs whether libraries were downloaded or already present.
• Discord ChatItem renders now default to discord-images.render.scale: 8, single-item-details-scale: 8, and single-item-details-icon-multiplier: 4.
• Velocity PlaceholderAPI resolution through PAPIProxyBridge now times out after 3 seconds and falls back to the original text instead of waiting indefinitely.

Fixed

• Fixed mentions and ping notifications for channels the target player cannot read. If the mentioned player cannot receive the channel, CoreChatX no longer pings them and no longer renders the name as an @ mention.
• Fixed Discord selected-item inspection hanging forever when the selected snapshot expired or the selected item could not be rendered. Discord now receives the configured expired-message or unavailable-message.
• Fixed intermittent missing Discord ChatItem previews in PROXY mode by sending preview packets on the server thread, allowing empty failure packets, retrying failed Discord image sends, and completing chunk transfers only once all chunks are available.
• Fixed enchanted books in Discord item rendering by including stored enchantments from EnchantmentStorageMeta, so stored enchants can appear in tooltip data and trigger enchanted rendering.
• Fixed Velocity Discord inbound delivery so backend plugin-message send failures are caught and logged per backend instead of silently breaking delivery.
• Fixed Velocity connection-message routing so proxy join/quit fanout handles backend send failures and keeps group join tracking consistent.
• Fixed Velocity YAML default synchronization for keys that existed with a null value, so missing defaults can be restored more consistently.

Configuration

New or changed default keys:

• channels.<id>.shortcut
• chatitems.yml -> tokens.item.token-format placeholders: {token}, {name}, {material}, {amount}
• chatitems.yml -> discord-images.render.scale: 8
• chatitems.yml -> discord-images.render.single-item-details-scale: 8
• chatitems.yml -> discord-images.render.single-item-details-icon-multiplier: 4
• account-linking.sync-mc-name
• discord.event-messages
• discord.server-status

plugin.yml now includes:

• Paper runtime libraries
• corechatx.command.itemcache

Migration

• Review discord.connection-messages.channels if you enabled Discord join/quit mirrors. Values must now be Discord channel IDs, not CoreChatX channel IDs.
• Review discord.server-status, discord.event-messages, and account-linking.sync-mc-name before enabling them, especially on Velocity networks.
• Existing configs should receive missing default keys automatically, but server owners should still compare channels.yml, chatitems.yml, discord.yml, and velocity-discord.yml with the new defaults.

CoreChatX 2026.2.2

Added

• Added Discord image rendering for ChatItem tokens sent from Minecraft: [item], [i], [armor], [hotbar], [inventory], [inv], [enderchest], [ender], [ec], and shulker previews from [item].
  • In STANDALONE, Paper renders and sends the Discord attachment directly.
  • In PROXY, Paper renders the snapshot and Velocity sends the final Discord embed/attachment for the correct proxy group.
• Added interactive Discord item inspection for non-[item] snapshots. Inventory-like renders can show dropdown menus; selecting an entry sends an ephemeral single-item preview to that Discord user. The menu expires with the same lifetime as the in-game ChatItem preview token.
• Added Minecraft-style single item renders for Discord [item] previews. The generated image uses the Minecraft bitmap font, tooltip background, custom names, lore, enchantments, potion effects, attributes, armor trims, durability, and item icon rendering instead of plain Discord embed text.
• Added Discord handling for inbound attachments. Discord images/files now appear in Minecraft as clickable [filename] components with hover text and an open-url click action; messages with only attachments are forwarded too.
• Added Discord console support:
  • discord.console in Paper discord.yml can run a standalone or per-backend console bot.
  • discord.console in Velocity velocity-discord.yml can run proxy console commands from Discord.
  • command-prefix: "" is allowed and makes every message in the console channel execute as a command.
• Added Discord player-list command support for both Paper STANDALONE and Velocity PROXY.
  • Text command default: !playerlist.
  • Slash command default: /playerlist.
  • Velocity resolves the target proxy group from discord.inbound.channel-routes.
• Added Discord text channel description updates through discord.channel-description.
  • Paper STANDALONE: updates standalone channel topics.
  • Velocity PROXY: updates text channel topics per configured network-channel.
  • Internal placeholders: {online} and {online_in_group}.
  • PlaceholderAPI placeholders are supported on Paper; Velocity can resolve them through PAPIProxyBridge when installed.
• Added Velocity-owned join/quit/first-join announcements for deployment.mode: PROXY.
  • Velocity now decides join/quit based on proxy group entry, group switch, and proxy disconnect.
  • Switching backend inside the same CoreChatX group does not announce join/quit.
  • Switching between groups sends quit to the old group and join to the new group.
• Added group-wide broadcast routing in PROXY mode. Paper /broadcast <message> now fans out to the current Velocity group instead of only the local backend, and Velocity also provides /broadcast.
• Added player head rendering support for name-only profile components such as minecraft:player_head[minecraft:profile="IceWolf23X"], in addition to heads that already contain texture properties.

Changed

• ChatItem in-game previews now use more compact layouts for single/small snapshots:
  • [item] opens a 5-slot hopper preview with the item centered.
  • [armor] opens a 5-slot hopper preview with helmet, chestplate, leggings, boots, and offhand.
  • [inventory], [hotbar], [enderchest], and shulker previews keep their existing snapshot sizes.
• Velocity Discord bridge output can resolve PlaceholderAPI placeholders through optional PAPIProxyBridge for Velocity-side formats such as player list rows, channel descriptions, join/quit messages, and fallback Discord formats.
• Paper discord.yml is now clearly split by runtime responsibility:
  • STANDALONE owns Discord bridge, account linking, login gates, player list, channel descriptions, and console.
  • PROXY keeps bridge/account-linking/login gates on Velocity, while Paper can still run a console-only backend bot if configured.

Fixed

• Fixed PlaceholderAPI placeholders staying unresolved in cross-server messages when the message had to be routed through Velocity.

• Fixed proxy join/quit symptoms where quit messages could be missing, duplicated, or formatted differently depending on which backend still had players online.

• Fixed Minecraft-to-Discord raw mention abuse. Players typing raw Discord mention syntax like <@...>, role mentions, @everyone, or @here can now be blocked from pinging Discord users/roles.

• Fixed Discord inbound attachment forwarding so attachment-only Discord messages are no longer dropped before reaching Minecraft.

• Fixed config synchronization behavior so missing default keys are added back to Paper YAML configs and Velocity YAML/properties configs instead of requiring a clean file for every new option.

Configuration

chatitems.yml now supports Discord image rendering and item menu configuration:

discord-images:
  enabled: true
  max-images-per-message: 3
  embed:
    title:
      item: "{item_name}"
      armor: "{player_nickname}'s armor"
      hotbar: "{player_nickname}'s hotbar"
      inventory: "{player_nickname}'s inventory"
      enderchest: "{player_nickname}'s ender chest"
      shulker: "{player_nickname}'s shulker"
    description:
      item:
        - "{enchantments}"
        - "{attributes}"
        - "{potion_effects}"
        - "{lore}"
        - "{armor_trim}"
        - "{banner_patterns}"
        - "{unbreakable}"
        - "{can_place_on}"
        - "{can_break}"
        - "{book_metadata}"
        - "{firework_data}"
        - "{durability_line}"
      armor: []
      hotbar: []
      inventory: []
      enderchest: []
      shulker: []
  item-menu:
    enabled: true
    placeholder: "Inspect an item"
    label-format: "Slot {slot}: {item_display_name}"
    description-format: "x{amount} - {material}"
    expired-message: "This ChatItem preview has expired."
    unavailable-message: "That item preview is unavailable."
  render:
    scale: 5
    single-item-details-scale: 5
    single-item-details-icon-multiplier: 3
  assets:
    minecraft-version: "auto"
    download-vanilla-assets: true
    resource-packs: []

• discord-images.embed.title.*: controls Discord embed titles; for [item], the title is rendered into the PNG tooltip panel.
• discord-images.embed.description.item: controls single-item tooltip details. Empty metadata placeholders are skipped, so missing lore/enchantments/durability do not leave unwanted blank detail sections.
• discord-images.item-menu.*: controls the Discord dropdown menu shown under multi-item snapshots.
• discord-images.render.scale: pixel scale for inventory-like renders.
• discord-images.render.single-item-details-scale: pixel scale for the single-item tooltip text/background.
• discord-images.render.single-item-details-icon-multiplier: multiplier applied only to the item icon in the single-item details panel.
• discord-images.assets.resource-packs: optional resource pack zip/folder paths used before vanilla fallback assets.

discord.yml and velocity-discord.yml now include:

discord:
  prevent-mentions-from-minecraft: true
  connection-messages:
    enabled: false
    join-format: ""
    first-join-format: ""
    quit-format: ""
    embed:
      enabled: false
      join-color: "#57F287"
      first-join-color: "#57F287"
      quit-color: "#ED4245"
      join-description: ""
      first-join-description: ""
      quit-description: ""
  console:
    enabled: false
    channel-id: ""
    command-prefix: "!"
  player-list:
    enabled: false
    command: "!playerlist"
    register-slash-command: true
    slash-command-name: "playerlist"
  channel-description:
    enabled: false
    interval-seconds: 300
    triggers:
      on-connection: true
      on-disconnection: true
      event-debounce-seconds: 5
    entries: []

Velocity velocity-discord.yml also supports group-aware options:

account-linking:
  required-play-roles:
    groups:
      # corechatx:survival:
      #   enabled: true
      #   role-ids:
      #     - "123456789012345678"

discord:
  channel-description:
    triggers:
      on-group-change: true
    entries:
      # - channel-id: "123456789012345678"
      #   network-channel: "corechatx:survival"
      #   description: "Players {online_in_group}/{online}"
  inbound:
    channel-routes:
      # "123456789012345678":
      #   channel: "global"
      #   network-channel: "corechatx:survival"
      #   require-linked: inherit

New Velocity message file:

# velocity-messages.yml
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>"

config.yml join/quit comments now clarify that join-quit.mode: NETWORK is Velocity-owned in PROXY mode and uses velocity-messages.yml.

Commands

• Changed Paper /broadcast <message> in PROXY mode to route through Velocity to the backend group instead of sending only on the local backend.
• Added Velocity /broadcast:
  • with one configured group: /broadcast <message>;
  • with multiple groups: /broadcast <group> <message>;
  • group can be all to broadcast to every CoreChatX group.
• Added Discord !playerlist and /playerlist when discord.player-list.enabled: true.

Compatibility

• Paper and Velocity must both be updated to 2026.2.2. The CoreChatX plugin-message protocol is 26 in this release and older proxy/backend builds are not compatible.
• PAPIProxyBridge is optional on Velocity. Without it, CoreChatX still works, but Velocity-side PlaceholderAPI placeholders cannot be resolved and only CoreChatX internal placeholders such as {online} and {online_in_group} are available.
• No vanilla Minecraft assets are bundled inside the plugin jar. Discord item rendering uses cached/downloaded vanilla assets and optional resource packs from chatitems.yml.

Safety

• discord.prevent-mentions-from-minecraft: true prevents Minecraft players from triggering Discord user, role, @everyone, or @here pings through the bridge.
• Discord console commands are controlled by discord.console.allowed-user-ids and discord.console.allowed-role-ids; empty lists mean anyone with write access to the console channel can run commands.
• Discord channel description updates are interval-based and event-debounced to avoid excessive Discord channel metadata updates during mass joins/quits.

Migration

• A clean config review is strongly recommended for 2026.2.2, especially chatitems.yml, discord.yml, velocity-discord.yml, and the new velocity-messages.yml.
• Existing configs should receive missing default keys automatically, but server owners should still compare the new defaults because several Discord features are split between Paper STANDALONE and Velocity PROXY.
• In PROXY mode, configure Discord bridge/account-linking/login gates/player-list/channel descriptions on Velocity. Paper discord.yml is still useful for standalone setups and optional backend console-only bots.

CoreChatX 2026.2.2

Added

• Added Discord image rendering for ChatItem tokens sent from Minecraft: [item], [i], [armor], [hotbar], [inventory], [inv], [enderchest], [ender], [ec], and shulker previews from [item].
  • In STANDALONE, Paper renders and sends the Discord attachment directly.
  • In PROXY, Paper renders the snapshot and Velocity sends the final Discord embed/attachment for the correct proxy group.
• Added interactive Discord item inspection for non-[item] snapshots. Inventory-like renders can show dropdown menus; selecting an entry sends an ephemeral single-item preview to that Discord user. The menu expires with the same lifetime as the in-game ChatItem preview token.
• Added Minecraft-style single item renders for Discord [item] previews. The generated image uses the Minecraft bitmap font, tooltip background, custom names, lore, enchantments, potion effects, attributes, armor trims, durability, and item icon rendering instead of plain Discord embed text.
• Added Discord handling for inbound attachments. Discord images/files now appear in Minecraft as clickable [filename] components with hover text and an open-url click action; messages with only attachments are forwarded too.
• Added Discord console support:
  • discord.console in Paper discord.yml can run a standalone or per-backend console bot.
  • discord.console in Velocity velocity-discord.yml can run proxy console commands from Discord.
  • command-prefix: "" is allowed and makes every message in the console channel execute as a command.
• Added Discord player-list command support for both Paper STANDALONE and Velocity PROXY.
  • Text command default: !playerlist.
  • Slash command default: /playerlist.
  • Velocity resolves the target proxy group from discord.inbound.channel-routes.
• Added Discord text channel description updates through discord.channel-description.
  • Paper STANDALONE: updates standalone channel topics.
  • Velocity PROXY: updates text channel topics per configured network-channel.
  • Internal placeholders: {online} and {online_in_group}.
  • PlaceholderAPI placeholders are supported on Paper; Velocity can resolve them through PAPIProxyBridge when installed.
• Added Velocity-owned join/quit/first-join announcements for deployment.mode: PROXY.
  • Velocity now decides join/quit based on proxy group entry, group switch, and proxy disconnect.
  • Switching backend inside the same CoreChatX group does not announce join/quit.
  • Switching between groups sends quit to the old group and join to the new group.
• Added group-wide broadcast routing in PROXY mode. Paper /broadcast <message> now fans out to the current Velocity group instead of only the local backend, and Velocity also provides /broadcast.
• Added player head rendering support for name-only profile components such as minecraft:player_head[minecraft:profile="IceWolf23X"], in addition to heads that already contain texture properties.

Changed

• ChatItem in-game previews now use more compact layouts for single/small snapshots:
  • [item] opens a 5-slot hopper preview with the item centered.
  • [armor] opens a 5-slot hopper preview with helmet, chestplate, leggings, boots, and offhand.
  • [inventory], [hotbar], [enderchest], and shulker previews keep their existing snapshot sizes.
• Velocity Discord bridge output can resolve PlaceholderAPI placeholders through optional PAPIProxyBridge for Velocity-side formats such as player list rows, channel descriptions, join/quit messages, and fallback Discord formats.
• Paper discord.yml is now clearly split by runtime responsibility:
  • STANDALONE owns Discord bridge, account linking, login gates, player list, channel descriptions, and console.
  • PROXY keeps bridge/account-linking/login gates on Velocity, while Paper can still run a console-only backend bot if configured.

Fixed

• Fixed PlaceholderAPI placeholders staying unresolved in cross-server messages when the message had to be routed through Velocity.

• Fixed proxy join/quit symptoms where quit messages could be missing, duplicated, or formatted differently depending on which backend still had players online.

• Fixed Minecraft-to-Discord raw mention abuse. Players typing raw Discord mention syntax like <@...>, role mentions, @everyone, or @here can now be blocked from pinging Discord users/roles.

• Fixed Discord inbound attachment forwarding so attachment-only Discord messages are no longer dropped before reaching Minecraft.

• Fixed config synchronization behavior so missing default keys are added back to Paper YAML configs and Velocity YAML/properties configs instead of requiring a clean file for every new option.

Configuration

chatitems.yml now supports Discord image rendering and item menu configuration:

discord-images:
  enabled: true
  max-images-per-message: 3
  embed:
    title:
      item: "{item_name}"
      armor: "{player_nickname}'s armor"
      hotbar: "{player_nickname}'s hotbar"
      inventory: "{player_nickname}'s inventory"
      enderchest: "{player_nickname}'s ender chest"
      shulker: "{player_nickname}'s shulker"
    description:
      item:
        - "{enchantments}"
        - "{attributes}"
        - "{potion_effects}"
        - "{lore}"
        - "{armor_trim}"
        - "{banner_patterns}"
        - "{unbreakable}"
        - "{can_place_on}"
        - "{can_break}"
        - "{book_metadata}"
        - "{firework_data}"
        - "{durability_line}"
      armor: []
      hotbar: []
      inventory: []
      enderchest: []
      shulker: []
  item-menu:
    enabled: true
    placeholder: "Inspect an item"
    label-format: "Slot {slot}: {item_display_name}"
    description-format: "x{amount} - {material}"
    expired-message: "This ChatItem preview has expired."
    unavailable-message: "That item preview is unavailable."
  render:
    scale: 5
    single-item-details-scale: 5
    single-item-details-icon-multiplier: 3
  assets:
    minecraft-version: "auto"
    download-vanilla-assets: true
    resource-packs: []

• discord-images.embed.title.*: controls Discord embed titles; for [item], the title is rendered into the PNG tooltip panel.
• discord-images.embed.description.item: controls single-item tooltip details. Empty metadata placeholders are skipped, so missing lore/enchantments/durability do not leave unwanted blank detail sections.
• discord-images.item-menu.*: controls the Discord dropdown menu shown under multi-item snapshots.
• discord-images.render.scale: pixel scale for inventory-like renders.
• discord-images.render.single-item-details-scale: pixel scale for the single-item tooltip text/background.
• discord-images.render.single-item-details-icon-multiplier: multiplier applied only to the item icon in the single-item details panel.
• discord-images.assets.resource-packs: optional resource pack zip/folder paths used before vanilla fallback assets.

discord.yml and velocity-discord.yml now include:

discord:
  prevent-mentions-from-minecraft: true
  connection-messages:
    enabled: false
    join-format: ""
    first-join-format: ""
    quit-format: ""
    embed:
      enabled: false
      join-color: "#57F287"
      first-join-color: "#57F287"
      quit-color: "#ED4245"
      join-description: ""
      first-join-description: ""
      quit-description: ""
  console:
    enabled: false
    channel-id: ""
    command-prefix: "!"
  player-list:
    enabled: false
    command: "!playerlist"
    register-slash-command: true
    slash-command-name: "playerlist"
  channel-description:
    enabled: false
    interval-seconds: 300
    triggers:
      on-connection: true
      on-disconnection: true
      event-debounce-seconds: 5
    entries: []

Velocity velocity-discord.yml also supports group-aware options:

account-linking:
  required-play-roles:
    groups:
      # corechatx:survival:
      #   enabled: true
      #   role-ids:
      #     - "123456789012345678"

discord:
  channel-description:
    triggers:
      on-group-change: true
    entries:
      # - channel-id: "123456789012345678"
      #   network-channel: "corechatx:survival"
      #   description: "Players {online_in_group}/{online}"
  inbound:
    channel-routes:
      # "123456789012345678":
      #   channel: "global"
      #   network-channel: "corechatx:survival"
      #   require-linked: inherit

New Velocity message file:

# velocity-messages.yml
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>"

config.yml join/quit comments now clarify that join-quit.mode: NETWORK is Velocity-owned in PROXY mode and uses velocity-messages.yml.

Commands

• Changed Paper /broadcast <message> in PROXY mode to route through Velocity to the backend group instead of sending only on the local backend.
• Added Velocity /broadcast:
  • with one configured group: /broadcast <message>;
  • with multiple groups: /broadcast <group> <message>;
  • group can be all to broadcast to every CoreChatX group.
• Added Discord !playerlist and /playerlist when discord.player-list.enabled: true.

Compatibility

• Paper and Velocity must both be updated to 2026.2.2. The CoreChatX plugin-message protocol is 26 in this release and older proxy/backend builds are not compatible.
• PAPIProxyBridge is optional on Velocity. Without it, CoreChatX still works, but Velocity-side PlaceholderAPI placeholders cannot be resolved and only CoreChatX internal placeholders such as {online} and {online_in_group} are available.
• No vanilla Minecraft assets are bundled inside the plugin jar. Discord item rendering uses cached/downloaded vanilla assets and optional resource packs from chatitems.yml.

Safety

• discord.prevent-mentions-from-minecraft: true prevents Minecraft players from triggering Discord user, role, @everyone, or @here pings through the bridge.
• Discord console commands are controlled by discord.console.allowed-user-ids and discord.console.allowed-role-ids; empty lists mean anyone with write access to the console channel can run commands.
• Discord channel description updates are interval-based and event-debounced to avoid excessive Discord channel metadata updates during mass joins/quits.

Migration

• A clean config review is strongly recommended for 2026.2.2, especially chatitems.yml, discord.yml, velocity-discord.yml, and the new velocity-messages.yml.
• Existing configs should receive missing default keys automatically, but server owners should still compare the new defaults because several Discord features are split between Paper STANDALONE and Velocity PROXY.
• In PROXY mode, configure Discord bridge/account-linking/login gates/player-list/channel descriptions on Velocity. Paper discord.yml is still useful for standalone setups and optional backend console-only bots.