TimeLimiter – Per-Player Daily Playtime Limit (Forge, Server-Side)

TimeLimiter lets you define how long each person can play on the server per day. The mod displays a bossbar with the remaining time, sends warnings as you approach the limit, and politely disconnects the player when their time runs out. The counter resets automatically each day at the configured time.

Main Features

1. Configurable daily limit (minutes): global value plus per-player overrides (by UUID or name).

2. Automatic reset by day/time and timezone: the counter resets at the specified time (e.g. 00:00 America/Mexico_City).

3. Bossbar with progress: shows remaining time in real time, with customizable colors.

4. Warning percentages: notifications at 80/90/100% usage (configurable).

5. Customizable messages: welcome, time added/removed, reset, and a formatted kick screen with colors and clickable links.

6. Login grace period: if a player has no time left, they can still see the world for a few seconds before being kicked.

7. Daily persistence: stores playtime in JSON files by date inside the world folder.

8. Server-side only: players don’t need to install anything on their client.

How it affects user experience

1. Healthy and predictable play: every player knows exactly how much time they have left thanks to the bossbar and warnings.

2. Simple administration: operators can assign limits per user without complex commands; data is saved per day and resets automatically.

3. Clear and respectful disconnection: when time runs out, players see a large, understandable message before being disconnected, avoiding confusion.

4. Timezone compatibility: ideal for international communities; the “new day” is based on your chosen timezone, not just the server clock.

Basic Configuration

The file config/timelimiter.json is generated on first launch. Key options:

1. dailyLimitMinutes: default daily minutes.

2. perUserMinutes: map of { "UUID_or_name": minutes }.

3. reset.time and reset.timezone: daily reset time and timezone.

4. warnPercents: list of percentages for warnings.

5. bossbar.color and bossbar.timeColor: colors for the bar and time text.

6. messages.*: customize all messages, including the multiline kick screen.

7. graceOnLoginSeconds: grace seconds if joining with no time left.

Notes and Limitations

1. Tracks time while the player is connected (does not distinguish AFK).

2. Adds no commands and requires no special permissions.

3. Designed for Forge servers. Does not modify the world or add items/biomes.

Example Use Cases

1. Family or school servers that want healthy schedules.

2. Communities that want to fairly distribute playtime without daily micro-management.