PlayerTimeLimit

## 🇬🇧 English # ⏱ Player Time Limit Mod **PlayerTimeLimit** is a server-side (not client-side) Minecraft mod for Fabric that allows setting daily playtime limits per player, resetting them daily, and managing this time through commands and a public API. Perfect for educational, family, or controlled-play servers. --- ## 📌 Features - ⏳ Configurable daily time per player. - ⚠️ Customizable warnings before time runs out. - 📤 Automatic kick when time ends. - 🔁 Automatic daily reset based on timezone. - 💬 Customizable messages. - 🧠 Offline player support (UUID cached). - 📊 Informative BossBar on screen. - 🔒 Permissions support with **LuckPerms**. - 📦 Public API for other mods. --- ## 🧪 Commands All commands start with `/plt` and support **player autocompletion**, even if they are **offline**. ```bash /plt check <player> # Shows remaining time /plt info <player> # Shows detailed status (time, paused, depleted) /plt addtime <player> <sec> # Adds time to player /plt removetime <player> <sec> # Removes time from player /plt resettime <player> # Resets time to default value /plt pause <player> # Pauses player's time counter /plt resume <player> # Resumes time counter /plt reload # Reloads YAML configuration file ``` --- ## 🔐 LuckPerms Permissions Each command requires specific permissions which you can assign using plugins like LuckPerms: | Permission | Description | |--------------------------------------|----------------------------------------| | `PLimitTime.admin` | Access to all commands | | `PLimitTime.command.check` | View player time and info | | `PLimitTime.command.addtime` | Add time to players | | `PLimitTime.command.removetime` | Remove time from players | | `PLimitTime.command.resettime` | Reset player time | | `PLimitTime.command.pause` | Pause a player's time | | `PLimitTime.command.resume` | Resume a player's time | | `PLimitTime.command.reload` | Reload YAML configuration | > ✅ If **LuckPerms** is not available, `hasPermissionLevel(4)` (operator) will be used as a fallback. --- ## ⚙️ YAML Configuration Path: `config/playertimelimit.yaml` ```yaml defaultTime: 18000 reset: time: "00:00" timezone: "America/Mexico_City" warnings: - time: 1800 message: "⏳ 30 minutes of playtime remaining." - time: 900 message: "⏳ 15 minutes of playtime remaining." - time: 120 message: "⏳ 2 minutes left. Get ready!" messages: timeExpired: " Your playtime for today has ended. See you tomorrow!" welcome: " Welcome! You have %time% seconds of playtime remaining." timeAdded: " %time% seconds have been added to your session!" timeRemoved: " %time% seconds were removed from your session." timeReset: " Your time has been reset to %time% seconds." paused: "✨ Your time is currently paused." bossbar: message: "Remaining time: %hours%h %minutes%m %seconds%s" color: WHITE ``` --- ## 🧩 Public API The mod exposes a public API for integration with other mods. You can access it from: ```java import com.TNTStudios.playertimelimit.Playertimelimit; import com.TNTStudios.playertimelimit.api.PlayerTimeLimitAPI; PlayerTimeLimitAPI api = Playertimelimit.getAPI(); // Usage examples api.addTime(uuid, 300); // Add 5 minutes api.removeTime(uuid, 60); // Subtract 1 minute api.pause(uuid); // Pause time api.resume(uuid); // Resume time int time = api.getTime(uuid); // Get remaining time boolean paused = api.isPaused(uuid); // Check if paused ``` --- ## 🧩 Requirements - (https://modrinth.com/mod/fabric-api) - Java 17+ - (https://luckperms.net) for advanced permission management. --- ## 📄 License **PlayerTimeLimit** is an `All Rights Reserved` licensed project. Usage is permitted for private, educational, and personal servers. Public redistribution or modification is not allowed without prior authorization. --- ## 🙌 Credits Developed by **TNTStudios**. Designed to promote responsible, controlled, and customizable gameplay in Minecraft communities. Thanks for using **PlayerTimeLimit**! 🎮 --- ## 🇪🇸 Español # ⏱ Player Time Limit Mod **PlayerTimeLimit** es un mod para servidores (no cliente) de Minecraft en Fabric que permite establecer límites de tiempo de juego por jugador, reiniciarlos diariamente, y gestionar estos tiempos a través de comandos y una API pública. Ideal para servidores educativos, familiares o con control de juego. --- ## 📌 Características - ⏳ Tiempo diario configurable por jugador. - ⚠️ Advertencias configurables previas al fin del tiempo. - 📤 Kick automático al terminar el tiempo. - 🔁 Reinicio diario automático basado en zona horaria. - 💬 Mensajes per