ChatKoruma

╔══════════════════════════════════════════════════════════════╗
║ ChatKoruma v1.0.2 — Documentation ║
║ by halilctn ║
╚══════════════════════════════════════════════════════════════╝
Short alias: /ck (full command: /chatkoruma)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
chatkoruma.admin
→ Grants access to all /ck commands.
→ Default: OP
chatkoruma.bypass
→ Exempts the player from all chat protections
(spam, flood, repetition, caps, letter lengthening).
→ Default: OP
→ Note: exempt-groups and exempt-players lists also
grant the same bypass effect.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GENERAL COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/ck yardim
→ Shows the list of all commands.
/ck durum
→ Shows the active/inactive status and settings of all protections.
/ck reload
→ Reloads the config.yml file.
All settings, exempt lists, and Discord settings are updated instantly.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PROTECTION SETTINGS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/ck spam ac
/ck spam kapat
/ck spam <ms>
→ Enables/disables spam protection or sets the delay time
between messages. (e.g., /ck spam 2000 → 2 seconds delay)
/ck flood ac
/ck flood kapat
/ck flood sure <ms>
/ck flood sayi <n>
→ Enables/disables flood protection or sets the sliding window duration
and the maximum allowed number of messages within this duration.
(e.g., /ck flood sure 5000 → 5 seconds | /ck flood sayi 4)
/ck tekrar ac
/ck tekrar kapat
→ Enables/disables protection against sending the exact same message consecutively.
/ck caps ac
/ck caps kapat
/ck caps <ratio>
→ Enables/disables capital letter protection or sets the threshold ratio.
(e.g., /ck caps 0.7 → fix if 70% of the message is capitalized)
/ck karakter <n>
→ Sets the minimum character count required for caps check.
(e.g., /ck karakter 4 → caps is not applied to messages shorter than 4 characters)
/ck harf ac
/ck harf kapat
/ck harf maks <n>
/ck harf duzelt
/ck harf engelle
→ Enables/disables letter lengthening protection, sets the maximum allowed
repeated character count, or changes the mode.
duzelt → automatically trims the message (e.g., heyyy → heyy)
engelle → completely blocks the message and throws a warning
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WARNING SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/ck uyari ac
/ck uyari kapat
→ Enables/disables the warning system.
When disabled, violations only delete the message without issuing a warning or mute.
/ck uyari sayisi <n>
→ Sets how many warnings will be issued before muting.
(e.g., /ck uyari sayisi 3 → mute on 3rd violation)
/ck uyari mute-sure <ms>
→ Sets the automatic mute duration.
(e.g., /ck uyari mute-sure 60000 → 1 minute mute)
/ck uyari sifirlama <ms>
→ Sets after how long the warning counter will reset.
Can be disabled by entering 0.
(e.g., /ck uyari sifirlama 600000 → reset after 10 minutes)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MUTE COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/ck mute <player>
→ Manually mutes the player for the default duration specified in the config.
/ck mute <player> <ms>
→ Mutes the player for the specified duration.
(e.g., /ck mute Notch 300000 → 5 minutes)
/ck unmute <player>
→ Unmutes the player.
/ck uyarilar <player>
→ Displays the current warning count of the player.
/ck sifirla <player>
/ck reset <player>
→ Resets all chat data of the player (warnings, spam timer,
flood history). Does not remove active mutes.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
EXEMPT GROUP MANAGEMENT (LuckPerms)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/ck yetkili
→ Shows the list of exempt groups.
/ck yetkili ekle <group>
→ Adds the group to the bypass list.
(e.g., /ck yetkili ekle vip)
/ck yetkili kaldir <group>
→ Removes the group from the bypass list.
Note: If LuckPerms is not installed, group bypass is disabled.
The chatkoruma.bypass permission works in all cases.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
EXEMPT PLAYER MANAGEMENT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/ck oyuncu
→ Shows the list of exempt players.
/ck oyuncu ekle <player>
→ Adds the player to the bypass list (can also be added while offline).
(e.g., /ck oyuncu ekle Notch)
/ck oyuncu kaldir <player>
→ Removes the player from the bypass list.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FILES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
plugins/ChatKoruma/config.yml
→ All settings, messages, Discord, and time formats.
plugins/ChatKoruma/violations.log
→ Warning and mute logs (filename can be changed via config).
plugins/ChatKoruma/mutes.yml
→ Persistent record of active mutes.
Mutes persist even if the server restarts.
Expired records are cleaned up automatically.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
QUICK SETUP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Copy the ChatKoruma-1.0.2.jar file into the plugins/ folder.
Start the server → plugins/ChatKoruma/config.yml is generated.
Configure Discord webhook, exempt groups, and
protection thresholds inside config.yml.
Apply changes instantly using /ck reload.
Requirements : Spigot / Paper 1.20.x, Java 17+
Soft-dependency : LuckPerms (optional, for group bypass)
══════════════════════════════════════════════════════════════