SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Back to NxLabs

NxLabs / Vintage Story

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

MBy MasterDeeJay

Multi Home Teleport mod with cooldown timers and optional teleport cost

Description

<h1>Teleport Mod — Commands &amp; Configuration</h1> <blockquote> <p>&nbsp;</p> </blockquote> <p>&nbsp;</p> <p>A lightweight <strong>server‑side</strong> teleport system with <strong>homes</strong>, <strong>back</strong>, <strong>spawn</strong>, and <strong>TP2P</strong>. Optionally, teleports can <strong>cost “walk credit”</strong> that players earn automatically by moving around (walking/running/swimming). Costs scale with <strong>3D distance</strong> and configurable multipliers and can be combined with cooldowns.</p> <p>All persistent data is saved as JSON files in the mod’s data folder.</p> <hr> <h2>Commands</h2> <p>&nbsp;</p> <p><strong>If in the config "UseMhtCommandPrefix": true then all commands start with /mht (ex: /mht sethome)</strong></p> <h3><code>/sethome or</code> <code>/setfarm or</code> <code>/setindustry</code>&nbsp;<code>[name]</code></h3> <h3>&nbsp;</h3> <p>Save your current position as a home or farm or industry</p> <ul> <li> <p>Default name is <code>default</code> if omitted.</p> </li> <li> <p>Overwrites if a home/farm/industry with the same name already exists.</p> </li> <li> <p><strong>Single mode:</strong> only one home/farm/industry named <code>default</code> is allowed; any other name returns an error.</p> </li> </ul> <hr> <h3><code>/home or farm or industry [name]</code></h3> <p>Teleport to a saved home/farm/industry</p> <ul> <li> <p>Default name is <code>default</code> if omitted.</p> </li> <li> <p>Has a cooldown (<code>HomeCooldownSeconds</code>).</p> </li> <li> <p>If teleport costs are enabled and the target isn’t free, the cost is deducted from your walk credit (see <strong>Walk Credit &amp; Costs</strong>).</p> </li> <li> <p>Sets your previous position for <code>/back</code>.</p> </li> <li> <p>Distance is calculated in full 3D (X, Y, Z).</p> </li> </ul> <hr> <h3><code>/back</code></h3> <p>Return to your previous position (the spot you were at before your last <code>/home</code> or <code>/tospawn</code>).</p> <ul> <li> <p>Has its own cooldown (<code>BackCooldownSeconds</code>).</p> </li> <li> <p>May cost walk credit if configured (see <strong>Walk Credit &amp; Costs</strong>).</p> </li> <li> <p>Only available if <code>EnableBackCommand</code> is true.</p> </li> </ul> <hr> <h3><code>/listhomes /listfarms /listindustries</code></h3> <p>List all saved home/farm/industry names you own.</p> <hr> <h3><code>/homeinfo</code></h3> <p>Show the coordinates for all your saved homes.</p> <hr> <h3><code>/delhome or /delfarm&nbsp; or /delindustry&nbsp; &lt;name&gt;</code></h3> <p>Delete a specific home/farm/industry by name.</p> <ul> <li> <p><strong>Single mode:</strong> only the <code>default</code> home can be deleted.</p> </li> </ul> <hr> <h3><code>/delallhomes /dellallfarms /delallindustries</code></h3> <p>Delete <strong>all</strong> your home/farms/industries.</p> <hr> <h3><code>/renamehome &lt;oldName&gt; &lt;newName&gt;</code></h3> <p>Rename a saved home/farm/industry without moving it.</p> <ul> <li> <p><strong>Single mode:</strong> renaming is disabled.</p> </li> </ul> <hr> <h3><code>/tospawn</code>, <code>/tpspawn</code>, <code>/tptospawn</code></h3> <p>Teleport to the world’s default spawn position.</p> <ul> <li> <p>Has a cooldown (<code>SpawnCooldownSeconds</code>) if enabled.</p> </li> <li> <p>May cost walk credit if configured (see <strong>Walk Credit &amp; Costs</strong>).</p> </li> <li> <p>Sets your previous position for <code>/back</code>.</p> </li> <li> <p>Only available if <code>EnableSpawnCommands</code> is true.</p> </li> </ul> <hr> <h3><code>/walkcredit</code></h3> <p>Display your current walk credit and a summary of the cost settings (global toggle and multipliers).</p> <hr> <h3><code>/listhomescost</code></h3> <p>From your current position, list for each home:</p> <ul> <li> <p>Approximate 3D distance in blocks,</p> </li> <li> <p>Calculated teleport cost (given current multipliers),</p> </li> <li> <p>Whether your current walk credit is sufficient.</p> </li> </ul> <hr> <h2>Player‑to‑Player Teleport (TP2P) <em>(v1.0.9 and up)</em></h2> <blockquote> <p><strong>Availability:</strong> TP2P features are available only if <code>EnableTP2P</code> (<code>tp2pEnabled</code>) is true. TP2P may have its <strong>own cooldown</strong> and <strong>cost</strong> settings; distance is calculated in full 3D (X, Y, Z).</p> </blockquote> <h3><code>/tp2p &lt;player&gt;</code></h3> <p>Send a teleport request to the specified player.</p> <ul> <li> <p>The recipient must respond with <code>/tpaccept &lt;player&gt;</code> or <code>/tpdeny &lt;player&gt;</code>.</p> </li> </ul> <h3><code>/</code><code>tpaccept</code> <code>[player]</code></h3> <p>&nbsp;</p> <p>Accept a pending TP2P request from the specified sender <strong>and perform the teleport</strong>.</p> <ul> <li> <p>If teleport costs are enabled and this teleport isn’t free, the cost is deducted from your walk credit <strong>at acceptance time</strong> (see <strong>Walk Credit &amp; Costs</strong>).</p> </li> <li> <p><strong>Sets your previous position for <code>/back</code></strong> (so you can return to where you were before acceptance).</p> </li> </ul> <h3><code>/</code><code>tpdeny </code><code>[player]</code></h3> <h3>&nbsp;</h3> <p>Deny a pending TP2P request from the specified sender.</p> <h3><code>/tp2pcost [player]</code></h3> <p>Show the TP2P teleport cost to the specified player; if omitted, shows the cost to <strong>all online players</strong>.</p> <hr> <h2>Walk Credit &amp; Costs <em>(optional system, 1.0.7 and up)</em></h2> <ul> <li> <p><strong>Walk credit</strong> is earned automatically as the player physically moves around the world (measured every <code>WalkSampleIntervalMs</code>).</p> </li> <li> <p>Teleports can <strong>consume</strong> walk credit based on the <strong>3D distance</strong> between the current position and the destination.</p> </li> </ul> <p><strong>Master switch</strong></p> <ul> <li> <p><code>TeleportCostEnabled</code> <em>(true/false)</em> — enables the entire credit system.</p>

Download

No download link is available for this entry right now.

Ratings & reviews

No ratings yet

Sign in to leave a rating or comment.