๐Ÿ•ต๏ธAnti-Bot

The anti-bot system protects against chat bots and spam accounts by enforcing cooldowns after joining and detecting bot-like behavior. Configuration is in moderation/antibot.yml.

Configuration

enabled: true

# Seconds after join before player can chat
chat-cooldown-seconds: 5

# Seconds after join before player can use commands
command-cooldown-seconds: 3

# Maximum messages per minute (0 = unlimited)
max-messages-per-minute: 20

# Maximum similar messages before action
max-similar-messages: 3

# Similarity threshold (0.0 - 1.0)
similarity-threshold: 0.8

# Kick on detection (after 3 warnings)
kick-on-detection: true

# Kick message
kick-message: "Bot-like behavior detected."

How It Works

Join Cooldowns

New players must wait before interacting with chat:

  • chat-cooldown-seconds โ€” Wait before sending chat messages

  • command-cooldown-seconds โ€” Wait before using commands

Rate Limiting

Players are limited to max-messages-per-minute messages per minute. Exceeding this rate triggers bot detection.

Similarity Detection

If a player sends max-similar-messages messages that are more than similarity-threshold similar to each other, they are flagged.

Kick on Detection

When kick-on-detection is true, players flagged for bot-like behavior are kicked after 3 warnings.

Settings Reference

Setting
Type
Default
Description

chat-cooldown-seconds

integer

5

Seconds after join before chatting

command-cooldown-seconds

integer

3

Seconds after join before commands

max-messages-per-minute

integer

20

Message rate limit (0 = unlimited)

max-similar-messages

integer

3

Similar messages before flagging

similarity-threshold

float

0.8

How similar messages must be (0.0-1.0)

kick-on-detection

boolean

true

Kick flagged players

Last updated