---

What is TimeLimitPlugin?

TimeLimitPlugin is a lightweight yet powerful management solution designed to keep your Minecraft community healthy and balanced. By enforcing real-world time windows and daily playtime limits, you can prevent burnout, manage server load, and ensure fair play for everyone.

[!NOTE]
Join Windows: Control when players can join (e.g., 10:00 - 17:00).
Daily Limits: Control how long players can play each day (e.g., 3 hours total).

---

Why choose TimeLimitPlugin?

• Strict Join Windows: Automate your server's opening hours. Kick players automatically when the window closes.
• Dynamic Playtime: Set default daily limits or provide custom limits for VIPs via LuckPerms groups.
• Interactive Alerts: Players receive immersive Title screen warnings and chat messages as their time expires.
• PlaceholderAPI Support: Display remaining playtime, limits, and server status in scoreboards, tab lists, holograms, and chat.
• Offline Management: Add or remove playtime for players even when they aren't online.
• Fully Bilingual: Native support for English and German languages.

---

Smart Enforcement

TimeLimit doesn't just kick; it manages the transition seamlessly:

1. Live Tracking: Every minute, online players' playtime is updated and verified.
2. Warning Sequence: Configurable alerts (e.g., 10, 5, 2, 1 min) keep players informed.
3. Graceful Kicks: Clear, localized reasons explain why access is restricted.
4. Resilient Data: Playtime resets automatically at midnight (0:00) using a smart date-check system.

---

PlaceholderAPI

TimeLimitPlugin includes a built-in PlaceholderAPI expansion with the identifier timelimit.

[!IMPORTANT]
PlaceholderAPI must be installed on your server. Player placeholders only work for online players.

Player Placeholders

Placeholder	Description
%timelimit_remaining%	Remaining minutes today (shows ∞ for bypass)
%timelimit_remaining_formatted%	Remaining time formatted (e.g. 2h 30m)
%timelimit_time_left%	Alias for %timelimit_remaining%
%timelimit_time_left_formatted%	Alias for %timelimit_remaining_formatted%
%timelimit_played%	Minutes played today
%timelimit_played_formatted%	Played time formatted
%timelimit_max%	Daily limit in minutes (includes group limits)
%timelimit_limit%	Alias for %timelimit_max%
%timelimit_max_formatted%	Daily limit formatted
%timelimit_bypass%	true / false — whether the player bypasses limits
%timelimit_limit_reached%	true / false — whether the daily limit is reached
%timelimit_used_percent%	Percentage of daily limit used (0–100)

Server Placeholders

Placeholder	Description
%timelimit_server_open%	true / false — whether the join window is currently open
%timelimit_window_open%	Alias for %timelimit_server_open%
%timelimit_window_start%	Join window start time (e.g. 10:00)
%timelimit_window_end%	Join window end time (e.g. 17:00)
%timelimit_until_close%	Minutes until the server closes (empty if closed)
%timelimit_until_close_formatted%	Time until close, formatted
%timelimit_until_open%	Minutes until the server opens (empty if open)
%timelimit_until_open_formatted%	Time until open, formatted
%timelimit_daily_limit_enabled%	true / false
%timelimit_join_window_enabled%	true / false

Examples

Scoreboard (TAB / FeatherBoard / etc.):

&7Time left: &e%timelimit_remaining_formatted%
&7Used: &e%timelimit_used_percent%%%

Tab list header:

&6Server closes in &e%timelimit_until_close_formatted%

Hologram (DecentHolograms / FancyHolograms):

&aYou have &e%timelimit_remaining% &aminutes left today

Chat format:

[%timelimit_remaining_formatted%] %player_name%

[!TIP]
Use /papi parse me %timelimit_remaining_formatted% to test placeholders in-game after installing PlaceholderAPI.

---

Commands & Permissions

Command	Action	Permission
/timeleft	View your own remaining time	none
/timelimit check <user>	Check any player's time (Online/Offline)	timelimit.admin
/timelimit add <user> <min>	Grant bonus time to a player	timelimit.admin
/timelimit remove <user> <min>	Deduct time from a player	timelimit.admin
/timelimit reload	Reload config & language files	timelimit.admin

Permissions

Permission	Description
timelimit.admin	Access to all /timelimit admin commands
timelimit.bypass	Bypass daily playtime limits
timelimit.group.<name>	Custom daily limit from group_limits in config

---

Installation

Setup Steps

1. Download the latest JAR.
2. Drop it into your server's plugins folder.
3. (Optional) Install PlaceholderAPI for scoreboard, tab, and hologram support.
4. Start the server to generate config.yml.
5. Configure your join_window and daily_limit.
6. Requires Paper 1.20.4 or newer.

[!TIP]
Grant timelimit.bypass if you want special players or OPs to bypass all daily limits!

[!NOTE]
On startup, the console will show PlaceholderAPI Expansion registriert! when PlaceholderAPI is detected and the expansion loaded successfully.

---