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
- Use
/cronwhitelist <active_time> <inactive_time>to set your schedule (e.g.,/cronwhitelist 14:00 22:00). - The plugin automatically starts the cronjob and begins monitoring.
- At the specified times, the whitelist will be enabled or disabled automatically.
- Operators are protected and will never be kicked when whitelist activates.
- 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!
