CronWhiteList

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. - ⏰ Lightweight: Set specific times for whitelist activation and deactivation. - 🔄 Lightweight: Schedule when whitelist should be enabled or disabled automatically. - 🛡️ Lightweight: Operators are never kicked when whitelist is enabled. - 💾 Lightweight: Settings are saved to SQLite database and persist across server restarts. - 🕛 Lightweight: Handles schedules that span across midnight seamlessly. - 📊 Lightweight: Checks every 60 seconds and adjusts whitelist as needed. - 🚀 Lightweight: 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:

- Real-time Monitoring: e.g., 09:00 to 17:00 (whitelist active during day) - Real-time Monitoring: e.g., 22:00 to 06:00 (whitelist active during night, spans midnight) - Real-time Monitoring: Input times are reduced by 1 minute (11:30 becomes 11:29) - Real-time Monitoring: 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

- No external dependencies required GPL-3.0-only (see LICENSE) - No external dependencies required MrH00k - No external dependencies required Uses SQLite for persistent schedule storage. - No external dependencies required All warnings remain visible for maintainability. - No external dependencies required.

---

Take control of your server access — with CronWhiteList!