PlayHours - Server Operation Hours Enforcement

Version: 1.0.0 Minecraft: 1.20.1 Forge: 47.4.10 Java: 17+ Author: Mr-KayJayDee

A production-ready server-side Forge mod that enforces configurable server open hours with per-day schedules, automatic warnings, login blocking, and comprehensive admin commands.

🚀 Quick Start

Download playhours-1.0.0.jar from the build/libs/ directory
Place in your server's mods/ folder
Start the server to generate the default config
Edit config/playhours.toml to your needs
Use /hours reload or restart the server

✨ Key Features

🕒 Schedule Enforcement - Per-day schedules with midnight-spanning support
🚫 Login Control - Deny logins outside open hours with clear messages
⚠️ Warnings & Auto-Kick - Configurable warnings and automatic player removal
🔧 Force Modes - Override schedule (NORMAL/FORCE_OPEN/FORCE_CLOSED)
👥 Whitelist/Blacklist - Player access control independent of schedule
📅 Date Exceptions - Special open/closed dates for holidays and events
🌍 Multi-Language - English and French support with smart time formatting
🔑 Permissions - LuckPerms integration with ops fallback
📢 MOTD Display - Dynamic server list information with schedule status

📚 Documentation

Core Documentation

Installation Guide - Setup and installation instructions
Configuration Guide - Complete configuration reference
Commands Reference - All available commands and usage
Features Overview - Detailed feature explanations

Advanced Documentation

MOTD System - Message of the Day configuration and customization
Permissions System - Permission nodes and LuckPerms integration
Technical Details - Architecture, limitations, and implementation details
Usage Examples - Real-world scenarios and configurations

Additional Resources

Changelog - Version history and updates
Building from Source - Compilation instructions

🎯 Common Use Cases

Basic Server Hours

[defaults]
periods = ["09:00 AM-06:00 PM"]

[days]
saturday = ["02:00 PM-11:59 PM"]
sunday = ["02:00 PM-10:00 PM"]

Weekend Events

[exceptions]
open_dates = ["2025-12-31 08:00 PM-11:59 PM"]  # New Year's Eve
closed_dates = ["2025-12-25"]                   # Christmas Day

Maintenance Mode

/hours force close

🔧 Quick Commands

Command	Description	Permission
`/hours status`	Show current server status	`playhours.view`
`/hours force open`	Override to always open	`playhours.admin`
`/hours force close`	Override to always closed	`playhours.admin`
`/hours reload`	Reload configuration	`playhours.admin`

📋 Requirements

Minecraft: 1.20.1
Forge: 47.4.10+
Java: 17 or 23
Server-side only - No client mod required

🆘 Support

For issues, feature requests, or questions, please refer to the detailed documentation or contact the author.

📄 License

For detailed information about any aspect of the mod, please refer to the specific documentation files listed above.

3.4 KiB Raw Blame History