TimeGuardian  - Server

Quick rating

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

TimeGuardian - Server

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
Forge
Minecraft

Community voices

Reviews

List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Show per page
10
25
50
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

About

Project Details

Type
Mod
Latest Version
timeguardian-1.2.2.jar

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID

Resources

External Links

Source Issues Wiki Discord

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

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works