UnstablePortal

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.