WorldAccessBlocker

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

<feature> is nether, end, elytra, or a custom world name.

---

🔧 PlaceholderAPI

---

💻 Compatibility

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.