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,
  "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.

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"