Configuration

Configuration

Last updated: 2026-06-27

The config is generated on first run:

config/lodestone_teleport.json

Options

{
  "costItem": "minecraft:diamond",
  "baseCost": 1,
  "blocksPerExtraCost": 500,
  "crossDimensionMultiplier": 2.0,
  "maxCost": 64,
  "allowCrossDimension": true,
  "maxDialogDestinations": 24,
  "teleportSourceRange": 8,
  "teleportCastSeconds": 2,
  "teleportCastMoveTolerance": 0.2,
  "teleportCooldownSeconds": 3,
  "teleportEffects": true,
  "vanillaTeleportEffect": "end",
  "modTeleportEffect": "lodestone",
  "requirePermissions": false,
  "commandName": "warp",
  "fallbackCommandName": "lodestone_warp",
  "serverLanguage": "en_us"
}

Cost

costItem

The item used as teleport payment.

Example:

"costItem": "minecraft:diamond"

baseCost

Minimum teleport cost.

blocksPerExtraCost

Adds extra cost based on same-dimension distance.

crossDimensionMultiplier

Multiplier used for cross-dimensional teleports.

maxCost

Maximum final cost. Use 0 for no cap.

Teleport Rules

allowCrossDimension

Allows or blocks teleports between dimensions.

teleportSourceRange

Players must be near a registered Lodestone before teleporting.

• 8: default radius in blocks.
• 0: disables this requirement.

teleportCooldownSeconds

Server-side cooldown after a successful teleport.

• 3: default cooldown in seconds.
• 0: disables cooldown.
• Any positive value is measured in seconds.

teleportCastSeconds

Stand-still cast time before teleporting.

• 2: default cast duration in seconds.
• 0: disables the cast and teleports immediately.

teleportCastMoveTolerance

How far the player can move during the cast before it is cancelled.

• 0.2: default tolerance in blocks.
• 0: requires the player to stay exactly still.

Teleport Effects

teleportEffects

Enables or disables teleport particles and sounds.

vanillaTeleportEffect

Effect preset used for vanilla clients.

Default:

"vanillaTeleportEffect": "end"

modTeleportEffect

Effect preset used when the player has Lodestone Warps installed on the client.

Default:

"modTeleportEffect": "lodestone"

Supported presets:

• end: End/portal-style particles and Enderman teleport sound.
• lodestone: brighter Lodestone-style particles using portal, end rod, and enchant effects.
• none or off: disables that preset.

UI

maxDialogDestinations

Maximum destinations shown in the vanilla Dialog UI.

The custom mod UI has pagination.

Permissions

requirePermissions

• true: use LuckPerms/Fabric Permissions API.
• false: everyone can use and rename Lodestones.

Development Permission Overrides

For local debugging, runClient and runServer can simulate permission results without LuckPerms:

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

The same flags can also be passed as JVM system properties:

.\gradlew.bat runClient -Dlodestone_teleport.use=true -Dlodestone_teleport.rename=true

These overrides are intended for development only and take priority over requirePermissions.

Commands

commandName

Primary command. Default:

"commandName": "warp"

fallbackCommandName

Safe fallback command. Default:

"fallbackCommandName": "lodestone_warp"

Lodestone Warps always tries to register the fallback command, then tries the primary command if it is available.

Language

serverLanguage

Controls server-side fallback text, mostly for vanilla clients that do not have the mod language files.

Supported values:

• en_us
• es_es

Default:

"serverLanguage": "en_us"