Database & Webhooks

QuantumPunish is built with performance and reliability in mind, utilizing a high-efficiency data management system.

📊 SQLite Engine

QuantumPunish uses an internal SQLite engine. No external MySQL setup is required, making it a "plug-and-play" solution for server owners.

  • Stored Data: UUIDs, IP History (for Alt-Detection), Punishment Logs, and Warning Points.

  • Performance: All database operations are handled via Asynchronous Tasks, ensuring zero impact on server TPS (No Lag).

  • Retry Mechanism: Features a built-in retry logic to handle "Database Busy" states, preventing data loss during high-traffic periods.

  • File Location: /plugins/QuantumPunish/database.db

🧹 Automated Maintenance

To keep the plugin lightning-fast, we've implemented an automated maintenance system:

  • Auto-Expiry: Punishments that have reached their end time are automatically marked as inactive.

  • Database Cleanup: Periodically prunes old or redundant data, keeping the database file lightweight and ensuring the /history command remains near-instant even after thousands of records.

🔗 Discord Webhook Integration

Get real-time, rich notifications for every disciplinary action directly in your staff Discord channel.

Webhook Features:

  • Detailed Embeds: Displays player name, staff member, reason, and updated warning point balances.

  • Dynamic Colors: Embed colors change based on punishment type (e.g., Red for Ban, Orange for Mute, Blue for Warn).

  • Staff Transparency: Keeps your entire moderation team informed of every action taken in-game.

How to Setup:

  1. Open your Discord Channel Settings.

  2. Navigate to Integrations > Webhooks > Create Webhook.

  3. Copy the Webhook URL.

  4. Paste the URL into your config.yml under the discord-webhook section.

  5. Set enabled: true and restart or reload the plugin.

PreviousHistory / LogsNextAppeal System

Last updated