⏳ 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