CronWhiteList

A lightweight Minecraft plugin that automates server whitelist management through time-based scheduling. Designed for performance, administration, and server control.

---

🔧 Features

• /cronwhitelist <active_time> <inactive_time>: Configure when whitelist should be active and inactive.
• /cronwhitelist start: Start the automatic whitelist scheduler.
• /cronwhitelist stop: Stop the automatic whitelist scheduler.
• /cronwhitelist status: Display current cronjob status.
• ⏰ Time-Based Management: Set specific times for whitelist activation and deactivation.
• 🔄 Automated Control: Schedule when whitelist should be enabled or disabled automatically.
• 🛡️ Operator Protection: Operators are never kicked when whitelist is enabled.
• 💾 Persistent Configuration: Settings are saved to SQLite database and persist across server restarts.
• 🕛 Cross-Midnight Support: Handles schedules that span across midnight seamlessly.
• 📊 Real-time Monitoring: Checks every 60 seconds and adjusts whitelist as needed.
• 🚀 Startup Behavior: Automatically resumes configured schedules on server restart.
• ⚡ Lightweight: Minimal resource usage with efficient SQLite storage.

🗂️ Supported Minecraft Versions

• Paper/Spigot 1.21.x

⚙️ Configuration

• SQLite database stores all schedule configurations and persists across server restarts.
• All times are automatically adjusted by subtracting 1 minute for precise timing.
• Plugin operates with 60-second check intervals for optimal performance.

🛠️ Commands

Command	Description
/cronwhitelist <active_time> <inactive_time>	Configure schedule times (HH:MM format)
/cronwhitelist start	Start the automatic whitelist scheduler
/cronwhitelist stop	Stop the automatic whitelist scheduler
/cronwhitelist status	Show the current cronjob status

🔐 Permissions

Node	Description
cronwhitelist.admin	Allows access to all CronWhiteList commands

Default: op (only operators can use the plugin)

🎮 How it Works

1. Use /cronwhitelist <active_time> <inactive_time> to set your schedule (e.g., /cronwhitelist 14:00 22:00).
2. The plugin automatically starts the cronjob and begins monitoring.
3. At the specified times, the whitelist will be enabled or disabled automatically.
4. Operators are protected and will never be kicked when whitelist activates.
5. Non-whitelisted players are automatically kicked when whitelist becomes active.

🔗 Time Management System

CronWhiteList includes intelligent time handling for various scenarios:

• Standard Day Schedule: e.g., 09:00 to 17:00 (whitelist active during day)
• Night Schedule: e.g., 22:00 to 06:00 (whitelist active during night, spans midnight)
• Automatic Adjustment: Input times are reduced by 1 minute (11:30 becomes 11:29)
• Persistent State: Configuration survives server restarts and maintains schedule
• Real-time Monitoring: Checks every 60 seconds and applies changes immediately

💡 Use Cases

• Restrict server access to specific hours (e.g., maintenance windows).
• Create "members-only" hours during peak times.
• Automatically manage whitelist for events or scheduled activities.
• Protect server resources during off-hours while allowing trusted players.

📝 Technical & Legal

• License: GPL-3.0-only (see LICENSE)
• Author: MrH00k
• Database: Uses SQLite for persistent schedule storage.
• No suppression of static analysis warnings: All warnings remain visible for maintainability.
• No external dependencies required.

---

Take control of your server access — with CronWhiteList!