Multi Home Teleport /sethome /home /back /listhomes /homeinfo /delhome /tospawn /tp2p toplayer and teleport cost

Teleport Mod — Commands & Configuration

 

 

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

 

If in the config "UseMhtCommandPrefix": true then all commands start with /mht (ex: /mht sethome)

/sethome or /setfarm or /setindustry [name]

 

Save your current position as a home or farm or industry

• Default name is default if omitted.

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

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

---

/home or farm or industry [name]

Teleport to a saved home/farm/industry

• 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 /listfarms /listindustries

List all saved home/farm/industry names you own.

---

/homeinfo

Show the coordinates for all your saved homes.

---

/delhome or /delfarm  or /delindustry  <name>

Delete a specific home/farm/industry by name.

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

---

/delallhomes /dellallfarms /delallindustries

Delete all your home/farms/industries.

---

/renamehome <oldName> <newName>

Rename a saved home/farm/industry 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