Skip to content

Feat/anti spam(chat) - #6649

Open
MochaMilkie wants to merge 52 commits into
EssentialsX:2.xfrom
MochaMilkie:feat/anti-spam
Open

Feat/anti spam(chat)#6649
MochaMilkie wants to merge 52 commits into
EssentialsX:2.xfrom
MochaMilkie:feat/anti-spam

Conversation

@MochaMilkie

@MochaMilkie MochaMilkie commented Nov 9, 2026

Copy link
Copy Markdown

Information

This PR closes #6638.

Details

Proposed feature:
Adding a native, lightweight anti-spam system directly into EssentialsXChat. It should include basic moderation mechanics to keep chat clean without needing third-party plugins.

The core features should include:

Chat Cooldown: A configurable delay (in seconds) between messages with a bypass permission (essentials.chat.bypass.cooldown).
Duplicate Filter: Blocking identical or highly similar repetitive messages from the same player.
Caps Lock Filter: Automatically converting text to lowercase if a message contains too many capital letters (e.g., >70% CAPS).
Automated Actions: Configurable responses when spam is detected (block message, warn player, or run a command).

Environments tested:

OS: Ubuntu 26.04

Java version:

  • Most recent Paper version (26.2, git-Paper-74)
  • CraftBukkit/Spigot/Paper 1.12.2
  • CraftBukkit 1.8.8

Demonstration:

@MochaMilkie MochaMilkie changed the title Feat/anti spam Feat/anti spam(chat) Nov 9, 2026
@MochaMilkie
Change new message to accept an event to manipulate
f4e11f8 
Add checks for repeated messages with same ending, and checked for 70%+ caps and set the message to full lowercase
@MochaMilkie
Not sure I need these here
35e63e5
@MochaMilkie
Pass the event to Antispam
fe3b06f
@MochaMilkie
Add antispam settings to config.yml
bdec779
@MochaMilkie
Added antispam timer to increment timers since the players last sent …
ee3847a 
…a message.

If runable is null we recreate it and continue.
Removed unnecessary if statement
@MochaMilkie
Added checks for runable commands in response to a player sending a d…
41aba0c 
…uplicate message or a message with too many capitol letters.

Added permission bypass for chat cooldown
@MochaMilkie
Added duplicate punish and caps punish to config.yml
ab40243
@MochaMilkie
Added chat cooldown bypass to plugin.yml
a9f8dd1
@MochaMilkie
Store the message in lowercase to help prevent bypass due to messages…
2537dfe 
… being the same except for capitalization

Also check for caps abuse first to prevent the above
@MochaMilkie
Better explained features in config.yml
fb8e802
@MochaMilkie
Correct improper check for lastMessageTimer
c43ac41
@MochaMilkie
Proper initialization
988fe6e
@MochaMilkie
Fix improper chat punish checks and check if entry exists, if not add…
8f198dd 
… entry and set value to 0
@MochaMilkie
Apply changes to the map itself not the queued entry
9266d4f
@MochaMilkie
Corrected config lookups
183a911
@MochaMilkie
Corrected variables for comparison
7ca7e09
@MochaMilkie
Make hash maps concurrent for the async timer
2eda8cd
@MochaMilkie
Fire antispam before chat is processed
e32f2d2
@MochaMilkie
Make AntiSpam.java easier to maintain
b1f68a3
@MochaMilkie
fixed variable assignment
26a3c9d
@MochaMilkie
Fixed backwords logic on caps filter
20a3789
@MochaMilkie
Add the message to the map after processing
b4e9261
@MochaMilkie
Check all messages in lowercase for duplication filter
2d537b2
@MochaMilkie
Add method to separate out event types and process them correctly
babf76b
@MochaMilkie
Pass along the event only since the event holds all the data we need.
e8f8681
@MochaMilkie
Imports
7232e03
@MochaMilkie
Formatting
34c0547
@MochaMilkie
Rebuilt potions of the AntiSpam service to provide results expected w…
fdcc5e9 
…ith the feature request.
@MochaMilkie
Fire antispam after the AbstractChatEvent is created
b6bf54f
@MochaMilkie
Formatting
c248644
@MochaMilkie
Formatting
6ab4b75
@MochaMilkie
Add PlayerQuitListener to remove players from maps, releasing memory
221e449
@MochaMilkie
Another rebuild of newMessage, return if already canceled, change set…
10fffeb 
…Canceled logic
@MochaMilkie
Constructor for tests
4109b7d
@MochaMilkie
Assign the lastMessage once
408050e
@MochaMilkie
Added tests for antispam filters and cooldown
aa4699e
@MochaMilkie
Register listener in the plugin class
7f3ff86
@MochaMilkie
Make events final
47ca925
@MochaMilkie
Correct constructor issue
a47b45d
@MochaMilkie
Corrected tests to support the new comparison for duplication filters
1ed655e
@MochaMilkie
Used levenshteinDistance to calculate how similar the new message is …
c04bfdf 
…to the previous one.

This is really cool in my opinion and I used AI to help determine the right way to code this
@MochaMilkie
Formatting and imports
00792ba
@MochaMilkie
Add mention of using {player} in the punish command
cab0498
@MochaMilkie
Add isSimilar to also check for shorter similar messages
ef3366f
@MochaMilkie
Formatting
5983b18
@MochaMilkie
Remove unused method
c46f30f
@MochaMilkie
MochaMilkie marked this pull request as ready for review November 13, 2026 01:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Add lightweight built-in anti-spam system to EssentialsXChat

1 participant

@MochaMilkie