PlaytimeLimit

A Minecraft Paper plugin that helps server admins manage and enforce playtime limits for players, with per-day-of-week configuration, session limits, forced breaks, configurable warnings, and a daily first-login reward system.

---

Features 📅 Per-Day-of-Week Time Limits Configure playtime rules independently for each day of the week. Each day has its own settings:

• Daily Limit (daily-limit-minutes) — Total playtime allowed for that day. Once reached, the player is kicked and cannot rejoin until the next day.
• Session Limit (session-limit-minutes) — Maximum continuous playtime before a forced break. After the break, the player can log back in and continue playing (up to the daily limit).
• Enable/Disable per day — You can completely disable playtime enforcement on specific days. Example defaults: Day Monday – Friday Saturday – Sunday ⏱️ Session Limit & Forced Breaks When a player reaches their session limit, they are kicked with a friendly message and must wait for the configured break duration (default: 10 minutes) before rejoining. After the break, their session timer resets and they can continue playing until they hit the daily limit. This encourages healthy play habits — taking breaks between gaming sessions rather than playing for hours straight. 📊 Daily Limit The daily limit tracks total accumulated playtime across all sessions in a calendar day. Once the player reaches this limit, they are locked out until the next day. The daily timer resets automatically at midnight (configurable timezone, default: Asia/Shanghai).
• 🎁 Daily First-Login Command (Daily Login Reward) On a player's first login each calendar day, the plugin can execute a configurable console command. This is perfect for implementing daily login rewards — e.g., give the player a cookie, some currency, or a special item every day. Configuration: daily-first-login: enabled: true command: "give {player} minecraft:cookie 1" permission: ""
• Use {player} as a placeholder for the player's name.
• Optionally gate the reward behind a permission (leave empty for everyone).
• Each player only receives the reward once per day, tracked per UUID. ⚠️ Configurable Warnings Players receive in-game warnings when their remaining time hits certain thresholds (default: 15, 5, and 1 minute remaining). These warnings are fully customizable: warnings: enabled: true thresholds: [15, 5, 1] 🛡️ Bypass Permission Players with playtimelimit.bypass permission are completely exempt from all time limits and restrictions. 🌐 Configurable Messages All messages are fully customizable with & color codes via config.yml.
• Installation

1. Download the PlaytimeLimit-1.0.0.jar file.
2. Place it in your server's plugins/ folder.
3. Restart your server (or use a plugin manager like PlugMan to load it).
4. Edit plugins/PlaytimeLimit/config.yml to customize settings.
5. Run /playtimelimit reload to apply changes without restarting.