LodestoneTP Plugin
LodestoneTP is a survival-friendly teleporter network plugin that lets players and admins create, manage, and use teleporters by building simple multiblock structures (Lodestone + Blackstone Bricks). Everything is done through in-game Dialog GUIs.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
LodestoneTP Plugin
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
- SQLite Persistence — uses Paper's native Dialog API instead of chest menus - SQLite Persistence — create teleporters with Lodestone + Polished Blackstone Bricks - SQLite Persistence — shows missing blocks for incomplete teleporters - SQLite Persistence — group teleporters into named networks with optional permission nodes - SQLite Persistence — mark favorite destinations and sort by alphabetical, distance, or most-used - SQLite Persistence — use visibility toggles and whitelist-based access control - SQLite Persistence — create direct A↔B teleporter pairs - SQLite Persistence — optional teleport channeling and per-teleporter cooldown overrides - SQLite Persistence — support XP, item, and distance-based teleport costs - SQLite Persistence — require items to create new teleporters - SQLite Persistence — teleport particles, sounds, ambient effects, and light blocks - SQLite Persistence — progression-based advancement unlocks for discovery and usage - SQLite Persistence — zero-config storage with automatic schema migrations
How It Works
Build this structure:
```text [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.

Documentation
- CONFIGURATION.md — full config reference and example config - PERMISSIONS.md — command permissions and permission nodes - CHANGELOG.md — release history
Requirements
- Paper 1.21.11+ - Java 21+
Build
```bash ./gradlew build ```
The jar is written to `build/libs/` and auto-deployed to `server/plugins/` if that directory exists.