🌍 WorldAccessBlocker

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

# 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: [SUNDAY]
        start-time: "15:00"
        end-time: "17:00"
      # Open all day on weekends
      - days: [SATURDAY, SUNDAY]

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: [MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY]
          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 [player]	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

🐛 Bugs & Suggestions

Open an issue on GitHub or leave a comment here on Modrinth.