Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

TimeGuardian - Server

Quick rating

Community listing page, reviews may not be monitored by the author.

How listings work Are you the author?

TimeGuardian - Server

By YisusT2

No reviews yet

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

Mod Loaders
Minecraft
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

⏳ 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