TimeWatcherCore

⏳ 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