Totem of Null

A Paper plugin that repurposes the Totem of Undying (when enchanted with Mending) into a reusable utility item for relocating players via temporary, restricted Nether portals.

Overview

Right-clicking a Totem of Undying enchanted with Mending cancels its normal behavior and opens a chat-based prompt requesting a target player's username. Once a valid, online target is provided, the plugin locates a safe location 5 to 15 blocks from that player, constructs a temporary Nether portal there, and teleports the activating player into it.

The portal created in this process is exempt from triggering a Nether dimension transition for the player who created it, for as long as they remain inside that specific portal instance. Once they leave, the restriction is lifted. If the player or anyone else re-enters the same portal afterward, it functions as a standard Nether portal.

The item itself has no durability cost and is not consumed on use.

Features

No custom crafting recipe required: functionality is tied to a Totem of Undying with the Mending enchantment
Chat-based target selection, with support for cancellation at any point before a target is confirmed
Automated location validation: checks for solid ground, sufficient air space, absence of liquids, and absence of other entities before placing a portal
Fallback handling for cases where no valid natural location is found, with forced space clearing that explicitly preserves bedrock, barriers, command blocks, and other protected block types
Per-instance portal restriction logic, isolated to the specific player and specific portal created during that activation
Automatic cleanup of restriction data on player disconnect or portal exit
Configurable search radius, attempt limits, restriction timeout, and portal lifetime via config.yml
Fully customizable player-facing messages
Designed to support multiple simultaneous activations from different players without state conflicts

Obtaining the Item

This item is intended to be granted by server administrators, typically via command:

/give @s totem_of_undying[enchantments={mending:1}]

Compatibility

Minecraft version: 1.21.x
Server software: Paper (and Paper-based forks)
No external plugin dependencies

Permissions

This plugin does not currently implement a permission node restricting use of the item. Server administrators should manage access through item distribution. A permission-gated variant can be made available on request.

Support

For bug reports or feature requests, please use the comments section or the project's issue tracker. This plugin is actively maintained.