⏳ 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