Configuration

The config.yml file is the heart of QuantumPunish. It allows you to automate moderation and customize the plugin's behavior.

📊 Database & Cleanup

• cleanup-days: To prevent the database from becoming too large, set the number of days after which expired punishments are deleted.

  • Example: 30 means any record older than 30 days that has expired will be wiped. Set to 0 to keep history forever.

🆔 ID System

Enable this to use shortcuts for common reasons.

• If enabled, you can run /ban <player> 1 instead of typing the whole reason. The plugin will automatically use "Hacking/Cheating".

🤖 Auto Punishments

Create a progression of punishments based on warning points.

• points: The threshold to trigger the action.

• action: MUTE, KICK, or BAN.

• duration: Set a timed duration (e.g., 1h, 1d) or 0 for permanent.

🤬 Chat Filter Settings

• action:

  • REPLACE: Swaps bad words with ****.

  • BLOCK: Prevents the message from being sent entirely.

  • WARN: Allows the message but automatically assigns warning points.

• detect-evasion: Intelligent engine that catches bypassed words (e.g., @pples instead of apples).

• max-repeated-letters: Limits spammy letters (e.g., haaaaack is treated as haack).

🔗 Discord Webhook

• url: Your unique Discord Webhook URL.

• enabled: Set to true to start receiving real-time logs in Discord.

---