# WorldTimer<\/p>\n
A Paper 1.20.1 plugin that enforces configurable time limits for specific worlds (e.g., resource worlds) with rank-based overrides via LuckPerms.<\/p>\n
## Features<\/p>\n
– **Per-world time limits** \u2014 Configure how long players can stay in each world
\n– **Rank-based overrides** \u2014 Different ranks get different time limits and cooldowns via LuckPerms permissions
\n– **Cooldown system** \u2014 Players must wait before re-entering a world after their time expires
\n– **Warning messages** \u2014 Configurable warnings at specific time thresholds
\n– **Expiry actions** \u2014 Run commands when a player’s time expires (e.g., titles, effects)
\n– **Return teleport** \u2014 Players are teleported back to their exact pre-entry location
\n– **Persistent storage** \u2014 SQLite database survives restarts and crashes
\n– **Bypass permission** \u2014 Staff can bypass all restrictions per-world<\/p>\n
## Requirements<\/p>\n
– **Paper 1.20.1+** (or compatible fork)
\n– **Java 17+**<\/p>\n
### Optional Dependencies<\/p>\n
– **LuckPerms** \u2014 For permission-based time limits and cooldowns. Without it, all players use the default values from config.
\n– **Multiverse-Core** \u2014 Works seamlessly with Multiverse-managed worlds<\/p>\n
## Installation<\/p>\n
1. Download the latest `world-timer-x.x.jar` from releases
\n2. Place it in your server’s `plugins\/` folder
\n3. Restart the server
\n4. Edit `plugins\/WorldTimer\/config.yml` to configure your worlds
\n5. Reload with `\/worldtimer reload`<\/p>\n
## Configuration<\/p>\n
“`yaml
\n# How often the plugin checks timers (in seconds)
\ntick-seconds: 1<\/p>\n
storage:
\n type: sqlite<\/p>\n
messages:
\n prefix: “&8[&bWorldTimer&8] &r”
\n warn: “&eYou have &6%time_remaining% &eremaining in &6%world%&e.”
\n expired: “&cYour time in &6%world% &chas expired.”
\n cooldown: “&cYou must wait &6%cooldown_remaining% &cbefore re-entering &6%world%&c.”<\/p>\n
worlds:
\n resource: # World name (case-insensitive)
\n enabled: true
\n main-world: “survival” # Fallback teleport world
\n teleport-location: “spawn” # Currently uses return point or spawn
\n default-limit-seconds: 1800 # 30 minutes (used if no permission)
\n default-cooldown-seconds: 600 # 10 minutes (used if no permission)
\n limit-permission-prefix: “worldtimer.limit.resource.”
\n cooldown-permission-prefix: “worldtimer.cooldown.resource.”
\n bypass-permission: “worldtimer.bypass.resource”
\n warn-at-seconds: [600, 300, 60, 10] # Warn at 10m, 5m, 1m, 10s remaining
\n expire-commands:
\n – “title %player% title {“text”:”Time is up!”,”color”:”red”}”
\n“`<\/p>\n
## Permissions<\/p>\n
### Time Limit Permissions<\/p>\n
Format: `worldtimer.limit. | Permission | Effect | **Duration formats:** `30s`, `30m`, `2h`, `1d`, `unlimited`<\/p>\n If a player has multiple limit permissions, the **highest** value is used.<\/p>\n ### Cooldown Permissions<\/p>\n Format: `worldtimer.cooldown. | Permission | Effect | If a player has multiple cooldown permissions, the **highest** value is used.<\/p>\n ### Other Permissions<\/p>\n | Permission | Description | ## Commands<\/p>\n | Command | Description |
\n|————|——–|
\n| `worldtimer.limit.resource.30m` | 30 minute limit |
\n| `worldtimer.limit.resource.1h` | 1 hour limit |
\n| `worldtimer.limit.resource.2h` | 2 hour limit |
\n| `worldtimer.limit.resource.unlimited` | No time limit |<\/p>\n
\n|————|——–|
\n| `worldtimer.cooldown.resource.5m` | 5 minute cooldown |
\n| `worldtimer.cooldown.resource.10m` | 10 minute cooldown |
\n| `worldtimer.cooldown.resource.0s` | No cooldown |<\/p>\n
\n|————|————-|
\n| `worldtimer.bypass.
\n| `worldtimer.admin` | Full access to all commands |
\n| `worldtimer.reload` | Access to `\/worldtimer reload` |
\n| `worldtimer.manage` | Access to reset\/addtime\/setcooldown commands |
\n| `worldtimer.status` | Access to `\/worldtimer status` |<\/p>\n
\n|———|————-|
\n| `\/worldtimer reload` | Reload configuration |
\n| `\/worldtimer status [player]` | View timer status for yourself or another player |
\n| `\/worldtimer reset
\n| `\/worldtimer addtime