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.