TimeGuardian - Server

⏳ Time Guardian is a server-side mod that limits daily playtime per player and resets automatically each day, keeping servers fair and balanced.

Full control over daily playtime ⏱
Automatic resets 🔄
Fully customizable 🎨

✨ Key Features

✅ Total Playtime Control
Set a maximum daily limit per player in hours minutes or seconds

✅ Automatic Daily Reset
All timers reset at a configurable time every day

✅ 100% Server Side
Players do not need to install anything only the server requires the mod

✅ Customizable Messages
Supports color codes & or §
Dynamic placeholders {player} {hh} {mm} {ss} {quota} {reset}
Clickable links for Discord Store or Website
Spanish by default, can be customized.

✅ Lightweight and Optimized ⚡
Uses minimal resources and works with modpacks

✅ Configurable HUD
ActionBar
BossBar
AFK Messages
Custom Kick Screen
Dynamic Clickable Links

🎮 How It Works

1 Install the mod on your Forge 1.20.1 server

2 Configure the daily playtime limit and reset time in

config/timeguardian/config.json
3 Customize all messages and links in

config/timeguardian/messages.json
4 Players can play until their time runs out

5 Once time hits 0 they are notified and disconnected

6 At the configured reset time all timers restart automatically

---

⌨️ Commands

Command	Arguments	Description
/tg check	[player]	Shows your remaining time or another players
/tg set	<player> <seconds>	Sets a custom time for a player
/tg add	<player> <seconds>	Adds extra time to a player
/tg take	<player> <seconds>	Removes available time from a player
/tg reset	[player]	Resets the remaining time for a player
/tg resetall	—	Resets playtime for all players
/tg setquota	<seconds>	Sets the global daily quota
/tg setreset	HH:mm	Configures the daily reset time
/tg reload	—	Reloads configs and messages instantly

---

⚙️ Configuration Files

📄 config.jsondefaultDailySeconds → Default daily playtime per player resetTime → Daily reset time HH:mm showActionBar showBossBar showKickTitle → Toggle HUD elements afkEnabled → Pause timer when AFK groupQuotas → Set different quotas per rank useLuckPerms → Optional integration with LuckPerms

📄 messages.jsonFully customizable colors & or § Dynamic placeholders {player} {hh}:{mm}:{ss} {quota} {daily} {reset} Clickable links Just write the URL and it auto detects them

---

📌 Technical Info

Type Server Side Only
Version Forge 1.20.1
Weight Ultra light ⚡
Best for Public servers Private servers Survival RPG Competitive servers Modpacks and Economy based servers