<div align="center"> <h1><img src="https://api.iconify.design/lucide:hourglass.svg?color=%23FF5E5E&width=128&height=128" width="48" height="48" align="middle"> TimeLimitPlugin</h1> <h3>The ultimate control over player playtime and server access windows.</h3> <img src="https://api.iconify.design/lucide:timer.svg?color=%23FF5E5E&width=256&height=256" width="200" alt="TimeLimit Logo"> <p> <a href="https://modrinth.com/plugin/timelimit"><img src="https://img.shields.io/modrinth/dt/timelimit?style=for-the-badge&color=FF5E5E&label=Downloads" alt="Downloads"></a> <img src="https://img.shields.io/badge/Minecraft-1.20.4+-blue?style=for-the-badge" alt="Minecraft Version"> <img src="https://img.shields.io/badge/Platform-Paper%20/%20Spigot-orange?style=for-the-badge" alt="Platform"> <img src="https://img.shields.io/badge/PlaceholderAPI-Supported-FFD700?style=for-the-badge" alt="PlaceholderAPI"> </p> </div> --- ## <img src="https://api.iconify.design/lucide:info.svg?color=%233B82F6&width=128&height=128" width="32" height="32" align="middle"> 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. > > **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). --- ## <img src="https://api.iconify.design/lucide:sparkles.svg?color=%23F59E0B&width=128&height=128" width="32" height="32" align="middle"> Why choose TimeLimitPlugin? - <img src="https://api.iconify.design/lucide:calendar-days.svg?color=%2306B6D4&width=128&height=128" width="24" height="24" align="middle"> **Strict Join Windows**: Automate your server's opening hours. Kick players automatically when the window closes. - <img src="https://api.iconify.design/lucide:gauge.svg?color=%23EF4444&width=128&height=128" width="24" height="24" align="middle"> **Dynamic Playtime**: Set default daily limits or provide custom limits for VIPs via LuckPerms groups. - <img src="https://api.iconify.design/lucide:bell.svg?color=%238B5CF6&width=128&height=128" width="24" height="24" align="middle"> **Interactive Alerts**: Players receive immersive Title screen warnings and chat messages as their time expires. - <img src="https://api.iconify.design/lucide:brackets.svg?color=%23FFD700&width=128&height=128" width="24" height="24" align="middle"> **PlaceholderAPI Support**: Display remaining playtime, limits, and server status in scoreboards, tab lists, holograms, and chat. - <img src="https://api.iconify.design/lucide:user-plus.svg?color=%23EAB308&width=128&height=128" width="24" height="24" align="middle"> **Offline Management**: Add or remove playtime for players even when they aren't online. - <img src="https://api.iconify.design/lucide:languages.svg?color=%2322C55E&width=128&height=128" width="24" height="24" align="middle"> **Fully Bilingual**: Native support for **English** and **German** languages. --- ## <img src="https://api.iconify.design/lucide:shield-check.svg?color=%2364748B&width=128&height=128" width="32" height="32" align="middle"> 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. --- ## <img src="https://api.iconify.design/lucide:brackets.svg?color=%23FFD700&width=128&height=128" width="32" height="32" align="middle"> PlaceholderAPI TimeLimitPlugin includes a built-in (https://www.spigotmc.org/resources/placeholderapi.6245/) expansion with the identifier **`timelimit`**. > > **PlaceholderAPI** must be installed on your server. Player placeholders only work for **online** players. ### <img src="https://api.iconify.design/lucide:user.svg?color=%233B82F6&width=128&height=128" width="24" height="24" align="middle"> 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 l