# \ud83d\udd52 ServerTimeLock \ud83d\udd52<\/p>\n
**Lightweight & Highly Configurable Time-Based Server Access Control**<\/p>\n
\n
\n<\/p>\n
*Control when players can join your Minecraft server with precision and flexibility*<\/p>\n<\/div>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfaf **Advanced Scheduling System**
\n– **Global Schedule**: Set the same hours for every day with a simple configuration
\n– **Per-Day Schedule**: Define unique time windows for each day of the week
\n– **Multiple Time Windows**: Allow multiple access periods per day (e.g., morning and evening sessions)
\n– **Midnight-Crossing Support**: Seamlessly handle time windows that span across midnight
\n– **Timezone Aware**: Full support for any timezone (Europe\/Warsaw, UTC, America\/New_York, etc.)<\/p>\n
### \ud83d\udd10 **Flexible Permission System**
\n– **Bypass Permission**: Grant specific players access at any time with `servertime.bypass`
\n– **OP Bypass Toggle**: Choose whether OPs can bypass restrictions
\n– **Per-Permission Control**: Separate permissions for status, reload, and force commands
\n– **Fully Configurable**: Enable or disable bypass systems as needed<\/p>\n
### \ud83d\udce2 **Multi-Channel Alert System** ### \ud83d\udd12 **Soft-Lock Mode** ### \u2699\ufe0f **Powerful Commands** ### \ud83d\udcdd **Comprehensive Logging** ### \ud83c\udfa8 **Rich Messaging** —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. **Download** the latest `ServerTimeLock.jar` from releases —<\/p>\n ## \ud83d\ude80 Quick Start<\/p>\n ### Simple Global Schedule “`yaml global-schedule: ### Advanced Per-Day Schedule “`yaml per-day-schedule: ### Multiple Time Windows “`yaml —<\/p>\n ## \ud83c\udfae Usage Examples<\/p>\n ### For Server Owners<\/p>\n **Check Server Status** **Quick Configuration Update** **Emergency Override** ### For Players<\/p>\n Players see beautiful, informative messages when: All messages support full MiniMessage formatting with colors, gradients, and styles!<\/p>\n —<\/p>\n ## \ud83d\udd27 Configuration Highlights<\/p>\n ### Timezone Configuration ### Bypass Settings ### Alert Example ### Soft-Lock Mode —<\/p>\n ## \ud83d\udccb Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \ud83c\udfa8 Placeholders<\/p>\n Use these placeholders in any message:<\/p>\n – ` —<\/p>\n ## \ud83d\udee0\ufe0f Technical Details<\/p>\n – **Platform**: Paper 1.21.5+ (API 1.21) —<\/p>\n ## \ud83d\udcd6 Examples<\/p>\n ### Midnight-Crossing Window The plugin correctly handles players online during the transition and prevents kicks during valid windows.<\/p>\n ### Weekend-Only Server ### School Schedule Server —<\/p>\n ## Support<\/p>\n – contact me on discord nickname: **we_rt**, only with important bug related things<\/p>\n —<\/p>\n ## \ud83c\udf1f Why ServerTimeLock?<\/p>\n \u2705 **Production-Ready**: Clean code, comprehensive error handling, and thorough testing —<\/p>\n **Made with \u2764\ufe0f for the Minecraft community**<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" Lightweight & Highly Configurable Time Based Server Access Control, Control when players can join your Minecraft server with precision and flexibility<\/p>\n","protected":false},"featured_media":72979,"template":"","meta":{"_minecraft_slug":"servertimelock","_minecraft_project_id":"wkTLZnZQ","_minecraft_author":"wertPL","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":116,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"servertimelock.zip","_minecraft_size_bytes":31774,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:16:53.069353Z","_minecraft_date_created":"2025-12-14T00:41:16.336693Z","_minecraft_date_modified":"2025-12-12T21:40:56.121321Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/servertimelock","_minecraft_icon_attachment_id":72979,"_minecraft_imported_at":"2026-06-08T03:24:35+00:00","_minecraft_import_hash":"949d1a6386e5dc073960b7a460e41e04","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137675","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Unlimited Alerts**: Set as many warning alerts as you need before server closing
\n– **Multiple Output Types**:
\n – \ud83d\udcac **Chat** – Traditional chat messages
\n – \ud83d\udcca **Action Bar** – Persistent top-of-screen notifications
\n – \ud83d\udcc8 **Boss Bar** – Full-width progress bar alerts
\n – \ud83c\udfac **Title** – Large center-screen announcements
\n– **Multi-Type Alerts**: Combine multiple output types for maximum visibility
\n– **MiniMessage Support**: Full rich text formatting with gradients, colors, and styles
\n– **Smart Placeholders**: Dynamic content with `
\n– **Player-Friendly**: Allow currently online players to finish their session
\n– **New Join Prevention**: Block new players from joining after closing time
\n– **Automatic Cleanup**: Reset on server opening for fresh sessions<\/p>\n
\n– `\/servertime status` – View detailed server status with time information
\n– `\/servertime reload` – Hot-reload configuration without restart
\n– `\/servertime forceopen` – Manually override schedule to open server
\n– `\/servertime forceclose` – Manually override schedule to close server
\n– **Smart Tab Completion**: Full tab completion support for all commands
\n– **Auto-Revert**: Force commands automatically revert on next schedule change<\/p>\n
\n– Schedule activation and transitions
\n– Player kicks with reasons
\n– Bypass permission usage
\n– Force command execution
\n– Configurable verbosity levels<\/p>\n
\n– **MiniMessage Format**: Modern text formatting with colors, gradients, and styles
\n– **Fully Customizable**: Every message is configurable in `config.yml`
\n– **Dynamic Placeholders**: Real-time information in all messages
\n– **Beautiful Default Messages**: Production-ready out of the box<\/p>\n
\n2. **Place** the jar file in your server’s `plugins\/` folder
\n3. **Start** your server to generate the default configuration
\n4. **Configure** `plugins\/ServerTimeLock\/config.yml` to your needs
\n5. **Reload** with `\/servertime reload` or restart your server<\/p>\n
\nPerfect for servers with consistent daily hours:<\/p>\n
\ntimezone: “Europe\/Warsaw”
\nuse-global-schedule: true
\nuse-per-day-schedule: false<\/p>\n
\n time-windows:
\n – start: “09:00”
\n end: “23:00”
\n“`<\/p>\n
\nIdeal for servers with varying weekday\/weekend hours:<\/p>\n
\ntimezone: “America\/New_York”
\nuse-global-schedule: false
\nuse-per-day-schedule: true<\/p>\n
\n monday:
\n – start: “15:00”
\n end: “22:00”
\n friday:
\n – start: “15:00”
\n end: “23:59”
\n saturday:
\n – start: “00:00”
\n end: “23:59” # Open all day
\n sunday:
\n – start: “10:00”
\n end: “22:00”
\n“`<\/p>\n
\nGreat for servers with lunch breaks or split sessions:<\/p>\n
\nglobal-schedule:
\n time-windows:
\n – start: “08:00”
\n end: “12:00”
\n – start: “14:00”
\n end: “18:00”
\n – start: “20:00”
\n end: “23:00”
\n“`<\/p>\n
\n“`
\n\/servertime status
\n“`
\nDisplays current open\/closed state, time until next change, and next window.<\/p>\n
\n“`
\n\/servertime reload
\n“`
\nApply config changes without restarting the server.<\/p>\n
\n“`
\n\/servertime forceopen
\n\/servertime forceclose
\n“`
\nManually control server access. Automatically reverts on next scheduled window.<\/p>\n
\n– Trying to join during closed hours
\n– Receiving alerts before server closes
\n– Being kicked when server closes (non-soft-lock mode)<\/p>\n
\n“`yaml
\ntimezone: “Europe\/Warsaw” # Any valid IANA timezone
\n“`<\/p>\n
\n“`yaml
\nallow-op-bypass: true # Let OPs bypass restrictions
\nenable-bypass-permission: true # Enable servertime.bypass permission
\n“`<\/p>\n
\n“`yaml
\nalerts:
\n – minutes-before: 5
\n types:
\n – CHAT
\n – TITLE
\n – ACTIONBAR
\n message: “
\n“`<\/p>\n
\n“`yaml
\nsoft-lock-enabled: true # Let online players stay, block new joins
\n“`<\/p>\n
\n|————|————-|———|
\n| `servertime.bypass` | Bypass all time restrictions | false |
\n| `servertime.admin` | Access to all commands | op |
\n| `servertime.status` | View server status | true |
\n| `servertime.reload` | Reload configuration | op |
\n| `servertime.force` | Use force open\/close commands | op |<\/p>\n
\n– `
\n– `
\n– **Java Version**: 17 or higher
\n– **Dependencies**: None (Paper API only)
\n– **Performance**: Lightweight with efficient scheduling
\n– **Thread-Safe**: Proper synchronization for concurrent access
\n– **Null-Safe**: Comprehensive null checks and error handling<\/p>\n
\n“`yaml
\nmonday:
\n – start: “22:00”
\n end: “02:00” # Continues into Tuesday morning
\n“`<\/p>\n
\n“`yaml
\nuse-per-day-schedule: true
\nper-day-schedule:
\n saturday:
\n – start: “00:00”
\n end: “23:59”
\n sunday:
\n – start: “00:00”
\n end: “23:59”
\n # Other days have no windows = always closed
\n“`<\/p>\n
\n“`yaml
\nper-day-schedule:
\n monday:
\n – start: “15:30” # After school
\n end: “21:00”
\n tuesday:
\n – start: “15:30”
\n end: “21:00”
\n wednesday:
\n – start: “15:30”
\n end: “21:00”
\n thursday:
\n – start: “15:30”
\n end: “21:00”
\n friday:
\n – start: “15:30”
\n end: “23:30” # Extended Friday hours
\n saturday:
\n – start: “10:00”
\n end: “23:30”
\n sunday:
\n – start: “10:00”
\n end: “21:00”
\n“`<\/p>\n
\n\u2705 **Highly Configurable**: Every aspect is customizable without code changes
\n\u2705 **User-Friendly**: Beautiful messages and intuitive commands
\n\u2705 **Performance Optimized**: Lightweight with minimal resource usage
\n\u2705 **Modern**: Paper API, Java 17+, and MiniMessage support
\n\u2705 **Actively Maintained**: Regular updates and bug fixes<\/p>\n