UnstablePortal
UnstablePortal makes Nether travel unpredictable: when a player enters a vanilla Nether portal (Overworld → Nether), there is a configurable chance to be teleported to a random location in the Nether.
It includes an optional safety mode that can clear certain blocks around the player (whitelist-only) and build a platform under them after teleport.
Features
Random teleport on vanilla Nether portal usage (Overworld → Nether).
Configurable chance, random radius, and Y-range.
Two behaviors: keep vanilla portal flow (replace destination) or cancel the portal exit and force a direct teleport.
Safety post-processing: clears nearby blocks from a whitelist and ensures a platform under the player.
Commands & permissions
Commands:
/unstableportal reload — reloads the config.
Permissions(LuckPerms):
unstableportal.bypass — bypass unstable teleport.
unstableportal.admin — allows /unstableportal reload.
Configuration
Key options in config.yml:
chance (0–100), teleport-radius, y-min, y-max, message,
nether-world(use if you have custom Nether world name), cancel-portal-exit,
safe-mode, safe-radius, platform-size, safe-floor-block, safe-whitelist-blocks
Compatibility notes
plugin.yml sets api-version: "1.20".
The plugin uses Adventure components for messages, which is fully supported on Paper/Purpur-based servers (and may require shading if targeting pure Spigot). Default config includes Nether materials like BASALT and BLACKSTONE, so the intended gameplay is modern Nether versions.
