Teleport Mod — Commands & Configuration

 

Heads‑up: Player‑to‑Player teleport (TP2P) is new in v1.0.9. It should work, but please test it on your server.

 

A lightweight server‑side teleport system with homes, back, spawn, and TP2P. Optionally, teleports can cost “walk credit” that players earn automatically by moving around (walking/running/swimming). Costs scale with 3D distance and configurable multipliers and can be combined with cooldowns.

All persistent data is saved as JSON files in the mod’s data folder.

---

 

Commands

/sethome [name]

Save your current position as a home.

• Default name is default if omitted.

• Overwrites if a home with the same name already exists.

• Single mode: only one home named default is allowed; any other name returns an error.

---

/home [name]

Teleport to a saved home.

• Default name is default if omitted.

• Has a cooldown (HomeCooldownSeconds).

• If teleport costs are enabled and the target isn’t free, the cost is deducted from your walk credit (see Walk Credit & Costs).

• Sets your previous position for /back.

• Distance is calculated in full 3D (X, Y, Z).

---

/back

Return to your previous position (the spot you were at before your last /home or /tospawn).

• Has its own cooldown (BackCooldownSeconds).

• May cost walk credit if configured (see Walk Credit & Costs).

• Only available if EnableBackCommand is true.

---

/listhomes

List all saved home names you own.

---

/homeinfo

Show the coordinates for all your saved homes.

---

/delhome <name>

Delete a specific home by name.

• Single mode: only the default home can be deleted.

---

/delallhomes

Delete all your homes.

---

/renamehome <oldName> <newName>

Rename a saved home without moving it.

• Single mode: renaming is disabled.

---

/tospawn, /tpspawn, /tptospawn

Teleport to the world’s default spawn position.

• Has a cooldown (SpawnCooldownSeconds) if enabled.

• May cost walk credit if configured (see Walk Credit & Costs).

• Sets your previous position for /back.

• Only available if EnableSpawnCommands is true.

---

/walkcredit

Display your current walk credit and a summary of the cost settings (global toggle and multipliers).

---

/listhomescost

From your current position, list for each home:

• Approximate 3D distance in blocks,

• Calculated teleport cost (given current multipliers),

• Whether your current walk credit is sufficient.

---

Player‑to‑Player Teleport (TP2P) (v1.0.9 and up)

Availability: TP2P features are available only if EnableTP2P (tp2pEnabled) is true. TP2P may have its own cooldown and cost settings; distance is calculated in full 3D (X, Y, Z).

/tp2p <player>

Send a teleport request to the specified player.

• The recipient must respond with /tpaccept <player> or /tpdeny <player>.

/tpaccept [player]

Accept a pending TP2P request from the specified sender and perform the teleport.

• If teleport costs are enabled and this teleport isn’t free, the cost is deducted from your walk credit at acceptance time (see Walk Credit & Costs).

• Sets your previous position for /back (so you can return to where you were before acceptance).

/tpdeny [player]

Deny a pending TP2P request from the specified sender.

/tp2pcost [player]

Show the TP2P teleport cost to the specified player; if omitted, shows the cost to all online players.

---

Walk Credit & Costs (optional system, 1.0.7 and up)

• Walk credit is earned automatically as the player physically moves around the world (measured every WalkSampleIntervalMs).

• Teleports can consume walk credit based on the 3D distance between the current position and the destination.

Master switch

• TeleportCostEnabled (true/false) — enables the entire credit system.

Global base multiplier

• TeleportCostMultiplier — applied to all teleport types that are not free.

Per‑command multipliers & free toggles

• Home (non‑default): HomeTeleportMultiplier

• Default home: DefaultHomeMultiplier, DefaultHomeFree (if true, /home default is free)

• Back: BackTeleportMultiplier, BackTeleportFree

• Spawn: SpawnTeleportMultiplier, SpawnTeleportFree

• TP2P: TP2PTeleportMultiplier, TP2PTeleportFree

Cost formula

cost = distance_in_blocks × TeleportCostMultiplier × (per-command multiplier)

• If a teleport is marked as free, its cost is 0 even if the system is enabled.

• The mod prevents counting teleport jumps as “walked distance”.

Persistence

• Walk credit is stored and periodically saved (WalkSaveIntervalMs, set ≤ 0 to disable periodic autosave).

• On death, you can optionally reset walk credit to 0 (ResetWalkOnDeath) or lose a percentage (DeathWalkLossPercent). You can also suppress counting the first post‑respawn movement tick (SuppressRespawnTick) so respawn/teleport displacement doesn’t grant credit.

---

Configuration (file: MHT_config.json)

Note: Keys are case‑sensitive. Values shown below are examples—use the JSON at the end as a ready‑to‑paste sample.

Mode

• TeleportMode: "multi" or "single".

  • multi: players can set multiple named homes.

  • single: only one home named default is allowed. On load, extra homes are collapsed into a single default home.

Cooldowns (seconds)

• HomeCooldownSeconds — delay between /home uses.

• BackCooldownSeconds — delay between /back uses.

• SpawnCooldownSeconds — delay between /tospawn uses.

Feature toggles

• EnableSpawnCommands — enable /tospawn, /tpspawn, /tptospawn.

• EnableBackCommand — enable /back.

• EnableTP2P — enable Player‑to‑Player Teleport commands (/tp2p, /tpaccept, /tpdeny, /tp2pcost).

Teleport cost system

• TeleportCostEnabled — master on/off.

• TeleportCostMultiplier — global base multiplier (e.g., 1.0 = full cost, 0.1 ≈ 10% of normal).

Per‑command cost settings

• Back: BackTeleportFree, BackTeleportMultiplier

• Default home: DefaultHomeFree, DefaultHomeMultiplier

• Non‑default home: HomeTeleportMultiplier

• Spawn: SpawnTeleportFree, SpawnTeleportMultiplier

• TP2P: TP2PTeleportFree, TP2PTeleportMultiplier

Tip: If TeleportCostEnabled is true and the corresponding ...Free flag is false, the effective cost typically scales with:

TeleportCostMultiplier × <CommandSpecificMultiplier> × (distance-based factor)

Setting a command’s multiplier to 0 effectively makes that command free even if the global toggle is on.

TP2P settings

• EnableTP2P — master toggle for TP2P.

• TP2PTeleportFree — if true, accepting TP2P requests costs 0 walk credit.

• TP2PTeleportMultiplier — TP2P‑specific multiplier (used with TeleportCostMultiplier).

• TP2PRequestTimeoutSeconds — how long a TP2P request remains pending before expiring.

Limits

• MaxHomes — maximum homes a player can have.

  • 0 or negative → unlimited.

  • In single mode, the effective maximum is always 1.

• MaxWalkCredit — hard cap on accumulated walk credit.

Death & sampling behavior

• ResetWalkOnDeath — if true, walk credit resets to 0 on death.

• DeathWalkLossPercent — percent of current walk credit lost on death (if you’re using loss instead of full reset).

• SuppressRespawnTick — if true, ignore the first movement sample after respawn (prevents counting the teleport/respawn displacement).

• WalkSampleIntervalMs — how often to sample player movement. Enforced min 200 ms, max 60,000 ms. Lower values = smoother credit tracking but more server work.

• WalkSaveIntervalMs — how often to autosave walk credit to MHT_walkprogress.json. 0 disables periodic save (credits will be lost on server restart).

Example configuration (paste into MHT_config.json)

{
  "TeleportMode": "multi",
  "HomeCooldownSeconds": 0,
  "BackCooldownSeconds": 0,
  "SpawnCooldownSeconds": 0,

  "EnableSpawnCommands": true,
  "EnableBackCommand": true,

  "TeleportCostEnabled": true,
  "TeleportCostMultiplier": 0.5,

  "EnableTP2P": true,
  "TP2PTeleportFree": false,
  "TP2PTeleportMultiplier": 1,
  "TP2PRequestTimeoutSeconds": 60,

  "BackTeleportFree": true,
  "BackTeleportMultiplier": 1,
  "DefaultHomeFree": false,
  "DefaultHomeMultiplier": 1,
  "HomeTeleportMultiplier": 1,
  "SpawnTeleportFree": false,
  "SpawnTeleportMultiplier": 1,

  "MaxHomes": 0,
  "MaxWalkCredit": 65536,

  "ResetWalkOnDeath": false,
  "DeathWalkLossPercent": 90,
  "SuppressRespawnTick": true,
  "WalkSampleIntervalMs": 1000,
  "WalkSaveIntervalMs": 30000
}

---

Data & Save Files

All files are stored under the mod’s data folder (e.g. …/TeleportMod/):

• MHT_config.json — configuration (pretty‑printed JSON; saved atomically).

• MHT_playerHomes.json — players’ homes (by UID and home name).

• MHT_previousPositions.json — last pre‑teleport positions for /back.

• MHT_walkprogress.json — players’ accumulated walk credit.

• MHT_teleportmod.log — simple action log (teleports, deaths affecting credit, etc.).

---

Notes & Behavior Details

• Distance is computed in 3D (sqrt(dx^2 + dy^2 + dz^2)) and rounded to the nearest block.

• On /home and /tospawn, the mod records your previous position for /back. Other teleports outside this mod aren’t tracked.

• After a teleport, the mod updates the internal “last known position” so the teleport itself does not generate walk credit.

• In single mode:

  • Only default is valid for setting/using/deleting.

  • /renamehome is disabled.

  • On load, if multiple homes exist, they are collapsed to a single default entry (preferring an existing default, otherwise the first one found).

• Costs and available commands respect the free/toggle flags in the config even when the global cost system is enabled.

---

Compatibility

Do not use together with:

• “Simple Teleport to Spawn”

• “Simple Home Teleport”

Running multiple teleport mods that manage homes/back/spawn in parallel can lead to conflicts or inconsistent player positions/credits.

---

Changelog & Future Plans

 

1.0.9

• Added DeathWalkLossPercent and MaxWalkCredit, so players don’t lose all walk points; the maximum can be limited. Dont know where did it 

• Added TP2P commands so you can teleport to other players (new feature — please test). Delete the config to generate a new one, or modify your existing file using the example above.

 

Future plans

• Converting gears to teleport points.