WorldAccessBlocker

# 🌍 WorldAccessBlocker (https://img.shields.io/bstats/servers/26810?color=blue&label=Servers)](https://bstats.org/plugin/bukkit/WorldAccessBlocker/26810) (https://img.shields.io/bstats/players/26810?color=red&label=Players)](https://bstats.org/plugin/bukkit/WorldAccessBlocker/26810) (https://img.shields.io/github/license/denfry/WorldAccessBlocker)](https://github.com/denfry/WorldAccessBlocker/blob/master/LICENSE) **WorldAccessBlocker** temporarily restricts access to the **Nether**, the **End**, **elytra flight**, and **custom worlds** — by a fixed date or a recurring weekly schedule. Built for **Paper** and its forks (**Purpur**, **Folia**). --- ## ✨ Features - ⏳ **Date-based restrictions** — block a feature until a specific date and time. - 📅 **Recurring schedules** — allow access only on certain days and time windows (e.g. weekends, or Sundays 15:00–17:00). - 🌋 **Nether blocker** — cancels portal creation, portal travel, and ender-pearl teleports. - 🐉 **End blocker** — prevents End portal activation (and the trip to the End). - 🪽 **Elytra control** — block equipping and/or flight independently. - 🗺️ **Custom worlds** — restrict any named world by date or schedule. - 🚪 **Fallback teleport** — send blocked players to a configurable world spawn. - 🎫 **Per-player bypasses** — grant a timed bypass with `/wab bypass`, revoke with `/wab remove`. - 🔌 **PlaceholderAPI support** — expose restriction state and time-left to scoreboards / TAB. - 🌐 **Multi-language** — English and Russian included; add your own `.yml`. - ♻️ **Live reload** — apply config changes without a restart via `/wabreload`. - 🧵 **Folia-native** — uses the regional scheduler on Folia (no thread-safety warnings). - 🔔 **Update notifications** — admins get an in-game alert when a new version is out. --- ## 📦 Installation 1. Download the latest `WorldAccessBlocker.jar`. 2. Drop it into your server's `plugins/` folder. 3. Restart the server. 4. Edit `plugins/WorldAccessBlocker/config.yml` to taste, then run `/wabreload`. --- ## ⚙️ Configuration ```yaml # Message language: "en" or "ru" language: "en" # Server time zone (important for recurring schedules!) time-zone: "Europe/Moscow" nether: disable: true # Used only when there is NO `recurring` block (blocked until this date): restriction-date: "2025-03-10 00:00:00" disable-portal-creation: true disable-teleportation: true # Weekly schedule. If this block is present, `restriction-date` is IGNORED. # Each period is an OPEN (allowed) window — outside these windows access is blocked. recurring: periods: # Open only on Sundays, 15:00–17:00 - days: start-time: "15:00" end-time: "17:00" # Open all day on weekends - days: end: disable: true disable-portal-activation: true # Empty list = no open windows = ALWAYS blocked recurring: periods: elytra: disable: true disable-equip: true disable-flight: true custom-worlds: lobby_world: disable: true recurring: periods: - days: start-time: "09:00" end-time: "17:00" # Where blocked players are teleported (world name → its spawn) fallback-spawns: default: "world" nether: "hub" ``` > **How the schedule works:** when `recurring:` is set, each period defines an **open** window. If the current day/time falls inside a period, access is **open**; otherwise it is **blocked**. An empty `periods: ` means **always blocked**. --- ## 🧩 Commands & Permissions | Command | Permission | Default | Description | |---|---|---|---| | `/wab bypass <player> <feature> <seconds>` | `wab.bypass` | op | Grant a timed bypass | | `/wab remove <player> <feature>` | `wab.bypass` | op | Remove a bypass | | `/wab status ` | `wab.status` | all | Show restriction status | | `/wabreload` | `wab.reload` | op | Reload config without a restart | `<feature>` is `nether`, `end`, `elytra`, or a custom world name. --- ## 🔧 PlaceholderAPI | Placeholder | Returns | |---|---| | `%wab_nether_blocked%` | `true` / `false` | | `%wab_end_blocked%` | `true` / `false` | | `%wab_elytra_blocked%` | `true` / `false` | | `%wab_time_left_nether%` | time remaining (or schedule) | | `%wab_time_left_end%` | time remaining (or schedule) | | `%wab_time_left_elytra%` | time remaining (or schedule) | --- ## 💻 Compatibility | Platform | Versions | Status | |---|---|---| | Paper | 1.20.5 – 1.21.4 | ✅ Full support | | Purpur | 1.20.5 – 1.21.4 | ✅ Full support | | Folia | 1.20.5+ | ✅ Native scheduler | **Requires Java 21.** Spigot/Bukkit are not supported (the plugin uses Paper's Adventure & scheduler APIs). --- ## 📊 Stats [![bSta