AdvancedChat-AC

# AdvancedChat-AC **Version:** 1.0.0 &nbsp;|&nbsp; **Author:** Spy &nbsp;|&nbsp; **API:** Spigot / Paper 1.13 – 1.21+ (https://cdn.modrinth.com/data/cached_images/b6a8613305c7a7d68abbf1d9fab01d39bb48ecc3_0.webp) ](https://www.gtxgaming.co.uk/) AdvancedChat-AC gives every player control over what they see in chat. They can silence the entire public chat, block specific players, view who they have ignored, and the server automatically stops advertising messages before they reach anyone — all with no lag, no database, and no extra setup. --- ## How It Works — Quick Overview - **Chat Toggle** — a player runs `/chattoggle` and from that point on, no public chat messages appear for them at all. They run it again and chat comes back. Their preference is saved and survives restarts. - **Ignore** — a player runs `/ignore Steve` and Steve's messages stop appearing for them personally. Steve sees nothing different — he can still chat normally; only the player who ignored him cannot see his messages. Running `/ignore Steve` again un-ignores him. - **Ignore List** — `/ignorelist` prints every player name that person has ignored, sorted alphabetically. - **Ad Filter** — every message is checked against a word list and a domain extension list before it reaches anyone. If it matches, the sender gets a warning and the message is silently dropped. OPs can bypass this. All of this happens on an **async thread** — the main server tick is never touched during a chat event. --- ## Installation 1. Place `AdvancedChatv2.jar` inside your server's `plugins/` folder. 2. Start or restart the server. 3. Three files are generated automatically: - `plugins/AdvancedChatv2/config.yml` — all player-facing messages - `plugins/AdvancedChatv2/block.yml` — ad filter word list and domain extensions - `plugins/AdvancedChatv2/playerdata.json` — created on first save, stores toggle and ignore state No database. No extra plugins. No configuration required to get started. --- ## Commands ### `/chattoggle` | Field | Value | |---|---| | Aliases | `/ctoggle`, `/tc` | | Permission | `advancedchat.toggle` | | Who can use | All players by default | **What it does:** Toggles whether the player sees public chat. - **Chat is ON by default** for every player. Running `/chattoggle` turns it OFF — they no longer receive any public chat messages from anyone. - Running `/chattoggle` again turns it back ON — they see chat normally again. - The player's own messages are not affected. They can still type and send; they just will not see incoming messages from others while toggled off. - This setting is **saved to disk** and persists across restarts, reconnects, and server crashes. - Toggle state is stored only for players who have turned it OFF — players with chat on use zero memory. --- ### `/ignore <player>` | Field | Value | |---|---| | Aliases | `/unignore` | | Permission | `advancedchat.ignore` | | Who can use | All players by default | | Tab-complete | Yes — suggests all currently online players | **What it does:** Hides or un-hides a specific player's chat messages from you. This is a personal toggle — it only affects what **you** see. The ignored player is never notified. - Running `/ignore Steve` once hides all of Steve's future chat messages from you. - Running `/ignore Steve` again brings his messages back. - Works on **offline players** — you can ignore someone who is not currently online. The name is resolved through Bukkit's offline player cache. If the player has never joined the server, the command tells you they were not found. - You cannot ignore yourself. - Each player's ignore list is stored individually. Ignoring Steve does not affect anyone else's view of Steve's messages — only yours. - When you un-ignore your last player and your ignore list becomes empty, the memory used by your list is freed immediately. --- ### `/ignorelist` | Field | Value | |---|---| | Aliases | `/ilist`, `/ignoredlist` | | Permission | `advancedchat.ignore` | | Who can use | All players by default | **What it does:** Displays a formatted list of every player you are currently ignoring. Names are resolved from UUID to username using Bukkit's offline player cache — no extra lookups or delays. The list is sorted alphabetically. If you are not ignoring anyone, a message tells you so and hints how to use `/ignore`. --- ## Permissions | Permission node | What it grants | Who has it by default | |---|---|---| | `advancedchat.toggle` | Use `/chattoggle` | All players | | `advancedchat.ignore` | Use `/ignore` and `/ignorelist` | All players | | `advancedchat.bypass.filter` | Send any message without ad-filter checks | OPs only | --- ## Ad Filter Every message sent in public chat is scanned before it reaches any player. The scan is done in-memory and adds no measurable overhead. There are **three layers** of detection: ### 1. Blocked Words (`block.yml` → `blocked-words`) A list of plain text phrases. If any phrase appears **anywh