Alpha Release Warning

This is an ALPHA build of AwesomeChat (26.x). The plugin has been updated to support the latest Minecraft versions, but it has not undergone thorough testing. You may encounter bugs, instability, or incomplete features.

If you experience any issues, please report them on GitHub: 👉 https://github.com/HackerADF/AwesomeChat/issues

Thank you for helping improve AwesomeChat!

AwesomeChat v1.0.9

New Features

Chat Channels

• Shortcut commands -- Define custom command aliases per channel (e.g., /staffchat, /adminchat) in config. Supports both toggle mode (/staffchat) and one-shot send (/staffchat <message>).
• Join/leave messages -- Configurable per-channel messages when players join or leave a channel, with {player} and {channel} placeholders.
• Channel alerts -- Optional broadcast to channel members when someone joins or leaves. Disabled by default, configurable per channel.

Chat Logging

• Channel tracking -- Chat logs now record which channel a message was sent in, including one-shot messages and shortcut command messages.
• Rich log display -- Timestamps show relative time with full UTC date on hover. Channel tags display with contextual hover info. Messages are click-to-copy.

CI/CD

• Automated dev builds -- GitHub Actions pipeline builds and publishes dev releases on every push to main.
• CI skip support -- Commits with [ci skip] or changes to non-code files (docs, gradle wrapper) skip the build pipeline.

Bug Fixes

• DiscordSRV compatibility -- Fixed messages leaking to Discord before AwesomeChat could filter or reroute them. Added a legacy AsyncPlayerChatEvent handler that independently mirrors cancellation and censoring decisions, since DiscordSRV defaults to the deprecated event. Uses a cached filter result to avoid double-counting violations.
• SQLite SQLITE_BUSY on startup -- The PRAGMA journal_mode=WAL statement was not being closed, holding a database lock that caused createTable() to fail with a file lock error. (#1)
• Debug log spam -- Removed leftover test code that dumped the full server plugin list to console on every dependency check during startup and reload.

Improvements

• Comment cleanup -- Rewrote comments across the codebase for clarity and consistency.

Configuration

This release introduces config version 19. The plugin will automatically migrate existing configs. New config options per channel:

channels:
  staff:
    command: "staffchat"
    join-message: "&aYou are now in the &f{channel} &achannel."
    leave-message: "&cYou have left the &f{channel} &cchannel."
    alerts:
      enabled: false
      join: "&e{player} joined {channel}."
      leave: "&e{player} left {channel}."

Full Changelog

https://github.com/HackerADF/AwesomeChat/compare/cc799457ed6bf65ef1d72799d998bc9a6628c936...v1.0.9

🚀 AwesomeChat v1.0.8-BETA Changelog (official)

🚨NOTE: This is a BREAKING change, the config migrator is still expirimental and is likely to break. You may need to delete and regenerate the plugin folder if things are not working as expected. As always, make sure to back it up first.

NEW

• New chat filter system, easier to use and configure.
• Chatlog Support

Bug Fixes

• Fixed hex color codes (&#RRGGBB) not parsing in chat formats, hover messages, or console
• Fixed hex colors rendering as wrong colors due to Component.text() not interpreting BungeeCord hex format — now uses Adventure LegacyComponentSerializer
• Fixed hex colors in per-group formats rendering as the wrong color — extractTrailingColor now correctly identifies §x hex sequences instead of treating the last § pair as a standalone color
• Fixed per-group hovers not working — HoverManager methods now accept the player's group for per-group hover lookups
• Fixed /ignore toggle not working reliably — replaced HashMap/HashSet with ConcurrentHashMap for thread safety between async chat and main thread commands
• Fixed /unignore and /unblock commands not registering
• Fixed color code permission bypass via uppercase & codes — color pattern matching is now case-insensitive
• Fixed persistent chat colors and manual & codes being stripped from messages — buildComponentFromFormat now wraps messages using Adventure's component tree instead of serializing to plain text
• Fixed auto-broadcaster indexing errors
• Fixed config version mismatch causing config to regenerate on every startup
• Fixed [item] and [inventory] formats not working
• Fixed chatcolor gui and default permissions
• Fixed per-group-hovers not working properly
• Fixed ignored messages still taking up a blank space
• Fixed Anti-Advertising chat filter module breaking
• Fixed colors not properly registering in the per-group-format section

🚀 AwesomeChat v1.0.7-DEV Changelog

New Features

• Chat Channels — Staff, admin, VIP + custom channels with per-channel formats, sounds, and permissions (/ch join, /ch send, /ch leave)
• Ignore System — Block players from chat and PMs with persistent JSON storage (/ignore, /ignore list)
• Mute Chat — Server-wide chat mute toggle with bypass permission (/mutechat)
• Clear Chat — Self or global chat clear with bypass and announcements (/clearchat)
• Emoji Shortcuts — 20 built-in :shortcode: → unicode replacements, permission-gated
• Censor Mode — Alternative to blocking: replaces matched words with **** instead of cancelling the message
• Join/Leave Messages — Per-group join, leave, first-join, MOTD, and sounds with EssentialsX vanish support
• Mention System — @player, @(role), @everyone, @here with per-type highlight colors, sounds, and action bar notifications
• Item Display — [item], [inventory], [enderchest], [/command] triggers in chat with hover tooltips and snapshot GUIs
• Chat Radius — Distance-based local chat with per-group radii, shout prefix for global messages, cross-world toggle
• Chat Logging — SQLite/MySQL storage with /chatlogs search, time filters, and clickable pagination
• Per-Group Sounds — Different chat sounds per LuckPerms group
• Per-Group Hovers — Component-specific hover text (username + message) with per-group overrides and click actions
• Public API — AwesomeChatAPI interface for other plugins to access violations, permissions, and managers
• Config Migration — Incremental v3 → v6 migrator that preserves user settings and adds new sections automatically

Bug Fixes

• Fixed hex color codes (&#RRGGBB) not parsing in chat formats, hover messages, or console
• Fixed hex colors rendering as wrong colors due to Component.text() not interpreting BungeeCord hex format — now uses Adventure LegacyComponentSerializer
• Fixed auto-broadcaster indexing errors
• Fixed config version mismatch causing config to regenerate on every startup

Fixed a bug causing configuration files to be reset everytime the server restarts. (credit to Dragos George for reporting this bug!)