LodestoneTP

See CHANGELOG.md for release history and notable changes.

What Is LodestoneTP?

LodestoneTP is a survival-friendly Paper plugin that lets players create, manage, and use teleporters by building a simple multiblock structure around a Lodestone. The plugin focuses on native in-game dialogs, low-friction setup, and admin-friendly configuration without requiring external GUIs or complex commands.

Core Features

• Dialog-based UI — uses Paper's native Dialog API instead of chest menus
• Multiblock Teleporters — create teleporters with Lodestone + Polished Blackstone Bricks
• Structure Hologram Preview — shows missing blocks for incomplete teleporters
• Teleport Networks — group teleporters into named networks with optional permission nodes
• Favorites & Sorting — mark favorite destinations and sort by alphabetical, distance, or most-used
• Private/Public Access — use visibility toggles and whitelist-based access control
• Linked Teleporters — create direct A↔B teleporter pairs
• Warmup & Cooldowns — optional teleport channeling and per-teleporter cooldown overrides
• Flexible Costs — support XP, item, and distance-based teleport costs
• Creation Fees — require items to create new teleporters
• Effects & Atmosphere — teleport particles, sounds, ambient effects, and light blocks
• Custom Advancements — progression-based advancement unlocks for discovery and usage, including automatic Magnetic Discovery when a player obtains a Lodestone
• Configurable Admin Bypass — choose whether OPs and lodestonetp.admin skip teleporter gameplay rules (cooldowns, costs, access, creation fees); admin commands and GUIs always remain available
• SQLite Persistence — zero-config storage with automatic schema migrations

How It Works

Build this structure:

[Polished Blackstone Bricks]
[Lodestone]
[Polished Blackstone Bricks]

Then interact with the Lodestone to create or use a teleporter. If the structure is incomplete, the plugin can show a holographic build preview to guide the player.

In-Game Hologram

To see a hologram preview of the actual structure, simply press Shift and left-click the Lodestone.

Teleportation GUI

In-Game Admin GUI

Using the in-game admin GUI, you can configure all settings directly in game.

Admin & Permissions

Server operators and players with lodestonetp.admin can always use admin commands (/lodestonetp reload, /lodestonetp admin) and the in-game admin panel.

Whether they also bypass teleporter gameplay rules is controlled by adminBypass in config.yml (default: true). When disabled, admins use teleporters like regular players unless they hold explicit bypass permissions (for example lodestonetp.warmup.bypass or lodestonetp.network.bypass).

Toggle this at runtime from the admin GUI under Admin Bypass, or edit adminBypass directly. See CONFIGURATION.md and PERMISSIONS.md for details.

Documentation

• CONFIGURATION.md — full config reference and example config
• PERMISSIONS.md — command permissions and permission nodes
• CHANGELOG.md — release history

Requirements

• Paper 26.1.2+
• Java 25+

Build

./gradlew build

The jar is written to build/libs/ and auto-deployed to server/plugins/ if that directory exists.