TimeGuardian - Server

By
YisusT2

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

⏳ 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.json

defaultDailySeconds → 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.json

Fully 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