⏳ TimeWatcherCore
TimeWatcherCore is a lightweight and robust server administration utility for Minecraft 1.20.1 (Forge). It provides server owners with total control over player session lengths through a flexible system of group-based and individual time limits.
Designed for RPG servers, communities, or parental control, this mod features a real-time synchronized HUD that keeps players informed of their remaining playtime, preventing unexpected disconnections and improving the overall user experience.
🌟 Key Features
- 📅 Daily Reset System: Automatically tracks and resets player playtime based on a configurable server timezone (MX, ES, AR, CO, UTC).
- 🏷️ Rank-Based Limits (Tags): Create multiple tiers (e.g., Guest, VIP, Staff) with different daily time allowances.
- 👤 Individual Overrides: Set custom limits for specific players that bypass their assigned Tag settings.
- 🖥️ Interactive HUD: A clean, synchronized on-screen timer that displays remaining time in real-time.
- ⚠️ Smart Notifications: Sends an automated 1-minute warning to the player's chat before they are disconnected.
- 💾 External Data Storage: All settings and player progress are saved in human-readable JSON files in the server's
config folder.
🛠 Admin Commands (/tw)
All commands require Permission Level 2 (OP) or higher.
📋 General & Maintenance
/tw list - Displays all configured Tags and their respective time limits./tw reload - Reloads the configuration, tags, and player data directly from the JSON files.
🏷️ Tag Management
/tw tag create <name> <h> <m> <s> - Creates a new time group./tw tag edit <name> <h> <m> <s> - Updates the time limit for an existing group./tw tag delete <name> - Permanently removes a tag group.
👤 Player Management
/tw player assign <player> <tag_name> - Assigns a specific tag group to a user./tw player setLimit <player> <h> <m> <s> - Sets a unique time limit for a player (overrides tag)./tw player unassign <player> - Removes custom limits and returns player to the default group./tw player reset <player> - Resets the player's daily time to 0, granting them full access again for the day./tw player info <player> - Shows a detailed summary of a player's status and used time./tw player toggleHUD - Allows a player to enable or disable their visual timer.
⚙️ Global Configuration
/tw config kickMessage <message> - Customizes the disconnection message (Supports & color codes)./tw config timezone <ZoneID> - Sets the timezone for daily reset logic (e.g., UTC).
📂 Technical Details
- Version: Minecraft 1.20.1.
- Loader: Forge (Java 17).
- Storage: Data is stored at
run/config/timewatchercore/.
- Requirement: Must be installed on both Server and Client for HUD synchronization.
Developed by Giovas
