c0fd2a2787
- Add complete PlayHours mod source code with all features: * Schedule enforcement with per-day schedules and midnight-spanning support * Login control with configurable thresholds and exemptions * Warnings and auto-kick system with countdown functionality * Force modes (NORMAL/FORCE_OPEN/FORCE_CLOSED) for maintenance * Whitelist/blacklist system for player access control * Date exceptions for holidays and special events * Multi-language support (English/French) with smart time formatting * LuckPerms integration with vanilla ops fallback * Dynamic MOTD system with real-time schedule display * Comprehensive command system with permission integration * TOML configuration with hot-reload support - Add comprehensive documentation suite: * Installation guide with step-by-step setup instructions * Complete configuration reference with all options * Commands reference with usage examples * Features overview with detailed explanations * MOTD system configuration and customization guide * Permissions system documentation with LuckPerms integration * Technical details covering architecture and limitations * Usage examples with real-world scenarios * Changelog with version history - Add resource files: * Language files (en_us.json, fr_fr.json) with localized messages * Mod metadata (mods.toml) with proper Forge configuration * Resource pack metadata (pack.mcmeta) - Update build configuration: * Gradle build system with proper dependencies * Project properties and version management * Development environment setup - Restructure documentation: * Replace old README.txt with new comprehensive README.md * Create modular documentation structure in docs/ directory * Add cross-references and navigation between documents * Include quick start guide and common use cases This commit represents the complete v1.0.0 release of PlayHours, a production-ready server operation hours enforcement mod for Minecraft Forge 1.20.1.
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.jarfrom thebuild/libs/directory - Place in your server's
mods/folder - Start the server to generate the default config
- Edit
config/playhours.tomlto your needs - Use
/hours reloador 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
All Rights Reserved © 2025 Mr-KayJayDee
For detailed information about any aspect of the mod, please refer to the specific documentation files listed above.