Перейти к содержимому
Mineforgian

Lodestone Warps and Tp

Turn vanilla lodestones into a global warp network using Minecraft’s server-side dialog UI.

Загрузки
167
Подписчики
2
Обновлён
14 июля 2026 г.
Лицензия
MIT

Опубликован 26 июня 2026 г.

Исходный код

Lodestone Warps

Last updated: 2026-07-13

Lodestone Warps turns vanilla Lodestones into an immersive server-side warp network for Minecraft 26.2.

Place Lodestones, discover destinations, pay a configurable teleport cost, and travel through your world without requiring every player to install a client mod. Vanilla players use Minecraft's built-in Dialog UI, while players who install the mod get a richer custom interface with favorites, search, configurable columns, and a cleaner table layout.

Why Use It?

Lodestone Warps is designed for servers that want teleportation to feel like part of Minecraft instead of a disconnected command menu.

  • Use real Lodestone blocks as warp anchors.
  • Let players discover destinations naturally.
  • Keep vanilla client support.
  • Reward players who install the optional client mod with a better UI.
  • Configure costs, cooldowns, cast time, permissions, visibility, and effects.
  • Support private bases, discoverable player locations, and global server hubs.

Client Support

Lodestone Warps works in two modes:

Server only

Players do not need to install the mod.

They can right-click registered Lodestones and use Minecraft's vanilla Dialog UI to:

  • search destinations
  • see teleport costs
  • change pages
  • teleport
  • edit Lodestones when they have permission

Server + client

Players who install the mod get the enhanced UI:

  • favorites
  • configurable columns
  • movable and resizable window
  • search
  • cleaner destination table
  • cost icons
  • owner and visibility information
  • quick editing tools

The client mod is optional, but it makes the experience much nicer.

Core Features

  • Server-side Lodestone warp network.
  • Vanilla Dialog UI support.
  • Optional enhanced client UI.
  • Private, discoverable, and global Lodestones.
  • Discovery-based warp networks.
  • Global Lodestones for lobbies, hubs, spawn areas, and shared server locations.
  • Configurable XP-level or item-based teleport cost.
  • Distance-based cost scaling.
  • Cross-dimensional teleport support.
  • Cast time that requires the player to stay still.
  • Teleport cooldown.
  • Configurable teleport particles and sounds.
  • Search and pagination.
  • Favorite destinations in the mod UI.
  • Configurable mod UI columns.
  • Rename, edit, unlink, remove, and change visibility when allowed.
  • Permission support for servers that need control.
  • Quick server config UI through /warp config.
  • Configurable command name, defaulting to /warp.
  • Safe fallback command, defaulting to /lodestone_warp.

How It Works

  1. A player sneak-places a Lodestone.
  2. The Lodestone becomes a registered warp.
  3. The player can name it and choose its visibility.
  4. Other players can discover it if it is discoverable.
  5. Global Lodestones are visible to everyone.
  6. Players right-click a registered Lodestone to open the warp UI.
  7. They choose a destination, pay the configured cost, stay still during the cast, and teleport.

Lodestone Visibility

Lodestones can have different visibility modes:

Private

Only the owner can use it.

Great for personal bases or hidden locations.

Discoverable

Other players can discover it by interacting with it.

Great for survival servers where exploration matters.

Global

Visible to everyone.

Great for spawn, hubs, shops, farms, public portals, and server landmarks.

Default Gameplay

By default, Lodestone Warps uses:

  • discovery mode
  • XP-level teleport costs
  • 1 base XP level
  • max cost of 64 XP levels
  • 10 destinations per vanilla dialog page
  • /warp as the main command
  • /lodestone_warp as fallback command

These defaults can be changed in the server config.

Basic Usage

Register a Lodestone

Sneak-place a Lodestone to register it as a warp.

Open the warp UI

Right-click a registered Lodestone with an empty hand.

Teleport

Choose a destination, pay the cost, stay still, and teleport.

Edit a Lodestone

Use the edit button from the UI, or use commands if you have permission.

Commands

Main command:

/warp

Fallback command:

/lodestone_warp

Useful commands:

/warp
/warp tp <id or name>
/warp edit <id>
/warp list
/warp reload
/warp config

More advanced commands for discovery, visibility, permissions, and server management are documented in the wiki.

Requirements

  • Minecraft 26.2
  • Java 25+
  • Fabric Loader 0.19.3+
  • Fabric API

Optional:

  • LuckPerms for advanced permission management
  • Mod Menu for the optional client-side config screen

Configuration

The config is generated on first run at:

config/lodestone_warp_and_tp/lodestone_teleport.json

Most server owners can start with the defaults, then tune:

  • cost type
  • base cost
  • max cost
  • cooldown
  • cast time
  • discovery mode
  • visibility rules
  • command name
  • teleport effects
  • permission fallback values

Full config reference:

Configuration Wiki

Wiki

The wiki has the full documentation:

Useful pages:

Current Status

Current stable release: 1.0.0

The mod is ready for real server testing. Feedback, bug reports, and server-use suggestions are welcome.

Ченджлог

1.0.0Релиз26.2 · 14 июля 2026 г.

Lodestone Warps 1.0.0

This is the first stable release of Lodestone Warps for Minecraft/Fabric 26.2.

Added

  • Added discoverable, private, and global Lodestone visibility modes.
  • Added discovery-based networks with networkMode: discover as the default.
  • Added global Lodestones for lobbies, hubs, and shared server destinations.
  • Added owner-aware Lodestones with stored UUID and last known username.
  • Added configurable XP-level and item-based teleport costs.
  • Added cast time, movement tolerance, cooldowns, and teleport effects.
  • Added granular permissions for use, creation, editing, visibility, global management, config, bypasses, and limits.
  • Added LuckPerms-compatible permission handling with fallback permission maps for servers without a permission manager.
  • Added dynamic per-player Lodestone limits through permissions such as lodestone_teleport.limit.10.
  • Added /warp config for server-side configuration through vanilla dialogs.
  • Added fallback permission editing through vanilla dialogs.
  • Added /warp with no arguments to open the nearby Lodestone UI.
  • Added discovery commands to grant, revoke, revoke all, grant all, list, and inspect discovered Lodestones.
  • Added UI mod support with a custom client screen, favorites, configurable columns, resize, move, center, maximize, and search.
  • Added vanilla dialog support for clients without the mod installed.
  • Added server language fallback support for vanilla dialog text.

Changed

  • Teleport cost now defaults to XP levels.
  • Default base cost is 1, max cost is 64, and vanilla dialogs show 10 destinations per page by default.
  • Players must be near a registered Lodestone to teleport, including configurable horizontal and Y-axis source ranges.
  • Vanilla and mod UIs now respect discovery visibility, permissions, cooldowns, and teleport availability.
  • The edit flow now supports renaming, changing visibility, unlinking, and removing Lodestones where permissions allow.
  • Registered Lodestones are protected from unauthorized breaking and explosions where possible.
  • Config files now live under config/lodestone_warp_and_tp/.
  • Documentation and wiki pages were refreshed for server owners, permissions, configuration, troubleshooting, and UI usage.

Notes

  • networkMode defaults to discover; set it to all if every player should see every registered Lodestone.
  • If LuckPerms is installed, Lodestone Warps lets LuckPerms decide permissions instead of granting positive fallback permissions from the config.
  • Fallback permission maps use "permission.node": true/false, so server owners can audit or disable permissions without deleting them.
  • The mod remains usable server-side for vanilla clients, while installing it on the client unlocks the enhanced UI.

Commits Included

  • Remove obsolete permission debug overrides (6ec356e)
  • Prepare 1.0.0 release (cda7257)
  • Use stable Spanish wiki slugs (ed45017)
  • Merge discovery mode release work (0dbda0c)
  • Ignore local media videos (59a12ec)
  • Ignore local release checklists (4cc1f61)
  • Refresh release documentation (a0be21b)
  • Polish client UI layout and search (f5069d5)
  • Polish vanilla permission config dialog (4dbd772)
  • Improve permission limits and source range config (f5093fd)
  • Add fallback permission manager (7681bd2)
  • Update permissions and config documentation (68c11c9)
  • Polish client warp table controls (d3d80ed)
  • Polish config search and vanilla edit text (de2a074)
  • Show cooldown state in warp UIs (f765124)
  • Protect registered lodestones from explosions (385fd6e)
  • Move config into dedicated folder (86905d1)
  • Improve discovery commands (65484c1)
  • Refine permissions and lodestone limits (131a336)
  • Share teleport availability with vanilla UI (535552b)
  • Improve client warp UI (4e9ce03)
  • Update wiki for discovery and UI configuration (9215cda)
  • Add client warp UI preferences and favorites (8fab369)
  • Make vanilla dialog configuration richer (c8926a6)
  • Refine discovery permission behavior (5f05169)
  • Improve vanilla dialog editing and pagination (042943e)
  • Update wiki for discovery and ownership (ccedf96)
  • Improve lodestone edit UI and ownership defaults (7353c65)
  • Add lodestone ownership visibility (e56ffc2)
  • Fix discovery prerelease issues (934c944)
  • Use config permission defaults (34a7d60)
  • Warn about incompatible permission config (2f53769)
  • Add config permission fallback (177e345)
  • Color global warp globe marker (4a21b97)
  • Set fixed dev client username (6ddeea1)
  • Use globe emoji for global warps (8b8f8f3)
  • Draw globe icon for global warps (37a9038)
  • Mark global warps with prefix icon (13b7e5c)
  • Render XP orb as GUI sprite (d9caf88)
  • Use provided XP orb texture (8f428db)
  • Use neutral XP marker for level costs (b1c382a)
  • Avoid duplicate XP cost numbers (2df8a55)
  • Use enchanting level icon for XP costs (2831867)
  • Fix XP cost scaling defaults (e619f27)
  • Render XP orb for level costs (ffcb3f7)
  • Default teleport cost to XP levels (fe8974c)
  • Default network mode to discovery (b34e29b)
  • Document discovery mode release (a09ec25)
  • Implement discovery mode behavior (735b6d6)
  • Add discovery config and saved data (99306cb)
0.4.1Релиз26.2 · 28 июня 2026 г.

Lodestone Warps 0.4.1

Added

  • Added /warp reload to reload config/lodestone_teleport.json from disk.
  • Added /warp config to open a server-side vanilla Dialog quick config UI.
  • Added /warp config list, /warp config get <key>, and /warp config set <key> <value>.
  • Added the lodestone_teleport.config permission node for config commands and Dialog config actions.

Changed

  • Bumped the mod version to 0.4.1.
  • Updated README and roadmap with the new server-owner config tools.

Notes

  • Changing command_name or fallback_command_name still requires a server restart because commands are registered during server startup.

Commits Included

  • Add config key suggestions (bbbf395)
  • Tidy vanilla config dialog layout (516f256)
  • Add server config dialog commands (1fc64a0)
0.4.0Релиз26.2 · 28 июня 2026 г.

Lodestone Warps 0.4.0

Feature release for Minecraft 26.2.

Added

  • Added granular permission nodes for use, rename, create, remove, admin, and bypass behavior.
  • Added configurable global and per-player Lodestone registration limits.
  • Added lodestone_teleport.bypass_max_warps.
  • Added intentional registration for unregistered Lodestones with sneak + right-click.
  • Added /warp unlink <id> as an alias for unlinking registered warps.
  • Added clickable [TP], edit, and [X] actions to /warp list.
  • Added optional Mod Menu integration for clients that install the mod.
  • Added a Mod Menu config screen with sections, search, scroll, boolean switches, pending-change markers, non-default highlighting, and row tooltips.
  • Added Fabric/Mod Menu metadata links and author information.

Changed

  • Lodestones are now registered by sneak-place by default.
  • Untracked Lodestones are no longer auto-registered on normal right-click by default.
  • /warp remove <id> now unlinks the warp entry without requiring the physical Lodestone block to be broken.
  • Teleport cost is checked before starting the stand-still cast.
  • Teleport cost is still consumed only after a successful teleport.
  • Lodestone right-click handling now only runs for the main hand to avoid duplicate messages.
  • Existing config files are normalized on load and automatically filled with missing options.
  • Permission checks can be disabled with config defaults for open servers.

New Config Options

"maxLodestonesGlobal": 0,
"maxLodestonesPerPlayer": 0,
"registerPlacedLodestonesOnlyWhenSneaking": true,
"autoRegisterUntrackedLodestones": false

Permissions

New or expanded permission nodes:

lodestone_teleport.use
lodestone_teleport.rename
lodestone_teleport.create
lodestone_teleport.remove
lodestone_teleport.admin
lodestone_teleport.bypass_cost
lodestone_teleport.bypass_cooldown
lodestone_teleport.bypass_max_warps
lodestone_teleport.mode.all
lodestone_teleport.mode.discover

mode.all and mode.discover are reserved for the future discovery system.

Compatibility

  • Minecraft: 26.2
  • Fabric Loader: >=0.19.3
  • Fabric API: 0.152.2+26.2
  • Java: 25+
  • Optional client-side: Mod Menu

Notes

This is a strong feature release, but not a 1.0 yet. Discovery mode, owner policies, and deeper admin tooling are still planned for later releases.

Commits Included

  • Release Lodestone Warps 0.4.0 (191fb40)
  • Avoid duplicate Lodestone use handling (db790ae)
  • Validate teleport cost before casting (b07c1fc)
  • Move config help into tooltips (cf829ec)
  • Add config field help and pending markers (c13382e)
  • Fill Fabric metadata for Mod Menu (b2283bc)
  • Add switches and scroll to Mod Menu config (df27812)
  • Improve Mod Menu config layout (427afc9)
  • Add optional Mod Menu config screen (92757c9)
  • Allow sneak registration of unlinked Lodestones (4158500)
  • Document Lodestone limits and unlinking (77da65e)
  • Add Lodestone limits and unlink behavior (ccf9de9)
  • Document granular permissions roadmap (ef6fb34)
  • Add granular Lodestone permissions (c852eaf)
  • Normalize Lodestone config on load (7dc0b17)
0.3.0Релиз26.2 · 28 июня 2026 г.

Lodestone Warps 0.3.0

Feature release for Minecraft 26.2.

Added

  • Added configurable server-side teleport cast time.
  • Added stand-still movement validation during teleport casting.
  • Added configurable teleport cooldown after successful teleports.
  • Added configurable teleport particles and sounds.
  • Added vanilla teleport effect preset:
    • end
  • Added mod-client teleport effect preset:
    • lodestone
  • Added effect presets:
    • end
    • lodestone
    • none
    • off
  • Added cast start, cast cancelled, cast already active, and cooldown messages.

Changed

  • Teleport cost is still consumed only after a successful teleport.
  • Cooldown is now marked only after a successful teleport.
  • Java fallback text now defaults to English consistently.
  • README, wiki configuration docs, and roadmap were updated for teleport effects and cast settings.

New Config Options

"teleportCastSeconds": 2,
"teleportCastMoveTolerance": 0.2,
"teleportCooldownSeconds": 3,
"teleportEffects": true,
"vanillaTeleportEffect": "end",
"modTeleportEffect": "lodestone"

Notes

Existing servers keep their current config/lodestone_teleport.json.

To use the new defaults on an existing server, add the new config options manually or regenerate the config.

Compatibility

  • Minecraft: 26.2
  • Fabric Loader: >=0.19.3
  • Fabric API: 0.152.2+26.2
  • Java: 25+

Commits Included

  • Release Lodestone Warps 0.3.0 (c6707da)
0.2.1Релиз26.2 · 27 июня 2026 г.

Lodestone Warps 0.2.1

Patch release for Minecraft 26.2.

Changed

  • Permission checks are now disabled by default for new server configs.
  • Players without rename permission no longer see rename/edit actions in the vanilla Dialog UI.
  • Players without rename permission no longer see rename/edit actions in the custom mod UI.
  • The custom mod UI now expands teleport buttons when edit buttons are hidden.
  • Updated README content for Modrinth/CurseForge presentation.
  • Updated wiki configuration examples to use the new default permission behavior.

Added

  • Added development permission overrides for local testing:
    • lodestone_teleport.use
    • lodestone_teleport.rename
  • Gradle runClient and runServer now forward those debug permission overrides.

Notes

Existing servers keep their current config/lodestone_teleport.json.

To use the new default manually on an existing server, set:

"requirePermissions": false

To test permissions in development:

.\gradlew.bat runClient -Plodestone_teleport.use=true -Plodestone_teleport.rename=false

Compatibility

  • Minecraft: 26.2
  • Fabric Loader: >=0.19.3
  • Fabric API: 0.152.2+26.2
  • Java: 25+

Commits Included

  • Release Lodestone Warps 0.2.1 (de63c15)
  • Refine permission defaults and UI visibility (8de5fc1)
  • Use Inicio for Spanish wiki home (168809b)
  • Polish Spanish wiki and limit builds (cb06115)
  • Fix Spanish wiki sidebar labels (b6fe7ef)
  • Add custom wiki sidebar (f5e9dab)
  • Automate GitHub wiki publishing (188f528)
0.2.0Релиз26.2 · 27 июня 2026 г.

Lodestone Warps 0.2.0

Feature release for Minecraft 26.2.

Added

  • Added LuckPerms-compatible permissions through Fabric Permissions API.
  • Added lodestone_teleport.use permission.
  • Added lodestone_teleport.rename permission.
  • Added requirePermissions config option.
  • Added configurable command names:
    • commandName
    • fallbackCommandName
  • Added default /warp command.
  • Added safe fallback /lodestone_warp command.
  • Added teleport by Lodestone display name.
  • Added duplicate-name handling for /warp tp <name>.
  • Added clickable duplicate-name destination choices.
  • Added serverLanguage config option for vanilla UI fallback text.
  • Added English and Spanish wiki documentation.
  • Updated README for Modrinth and CurseForge usage.

Changed

  • Lodestone Warps now always tries to register the safe fallback command.
  • Clickable duplicate-name teleport choices now use internal custom actions instead of chat commands.
  • Vanilla UI fallback text now defaults to English.

Fixed

  • Avoided Minecraft's command confirmation screen when clicking duplicate-name teleport choices.

Compatibility

  • Minecraft: 26.2
  • Fabric Loader: >=0.19.3
  • Fabric API: 0.152.2+26.2
  • Fabric Permissions API: 1.0.1+c3369b134c
  • Java: 25+

Notes

Servers that do not want permission checks can set:

"requirePermissions": false

Servers that want vanilla UI text in Spanish can set:

"serverLanguage": "es_es"

Commits Included

  • Release Lodestone Warps 0.2.0 (c4e6406)
0.1.1Релиз26.2 · 27 июня 2026 г.

Lodestone Warps 0.1.1

Patch release for Minecraft 26.2.

Fixed

  • Improved the custom mod UI layout.
  • Moved the custom mod UI higher on the screen.
  • Added pagination to the custom mod UI destination list.
  • Added translated pagination labels.
  • Reset pagination to the first page when searching.
  • Reserved footer space so pagination and rename controls do not overlap the destination list.

Notes

The vanilla Dialog UI is unchanged in this release.

Commits Included

  • Release Lodestone Warps 0.1.1 (b69166f)
0.1.0Релиз26.2 · 26 июня 2026 г.

Lodestone Warps 0.1.0

Second public release for Minecraft 26.2.

What's New

  • Added an optional client-side custom Lodestone Warps interface.
  • Vanilla clients still use the existing server-side Dialog UI.
  • Added automatic client detection through Fabric networking.
  • Added a table-style warp list for modded clients:
    • Warp name
    • Coordinates
    • Dimension
    • Cost
  • Added item icons for teleport costs in the custom client UI.
  • Added per-destination rename buttons in the custom client UI.
  • Added instant UI refresh after renaming a warp.
  • Added server-side validation requiring players to be near a registered lodestone before teleporting.
  • Added teleportSourceRange config option.
  • Added translation keys for the custom client UI.
  • Added a roadmap checklist for future features.

Compatibility

  • Minecraft: 26.2
  • Fabric Loader: >=0.19.3
  • Fabric API: 0.152.2+26.2
  • Java: 25+

Notes

The mod remains fully usable server-side for vanilla clients. Installing the mod on the client enables the enhanced custom UI.

Commits Included

  • Release Lodestone Warps 0.1.0 (e77ef1f)
  • Add release workflows and mod icon (5a14d5e)

Комментарии

Загружаем…