What this mod does

vsTeleport adds a tiny, no-frills way to fast-travel: place two (or more) pads, give them the same label, and stepping onto one will teleport you to another pad with that label. That’s it—quick, reliable teleporting without extra menus or map pins.

Features

• Pad-to-pad teleporting by shared label

• No UI to learn: label with a chat command

• Anti-bounce cooldown (≈2 seconds) so you don’t ping-pong

• Placement safety checks (optional): encourage a 3×3 clear area

• Lightweight & server-side logic for stability

How to craft / get the pad

• Current state: the pad is creative-only (no recipe yet).

• Grab it from the Creative inventory: General → vsteleport:pad.
  (If you’ve added a recipe on your fork, mention it here instead.)

How to use

1. Place two pads in the world (ideally with a clear 3×3 around each).

2. Label them the same with the command:

    

   /vsteleport setlabel YourLabelHere

   • Look at the pad or hold it as required by your current build’s logic.

3. Step onto the pad. You’ll pop to another pad with the same label.

   • If there are multiple same-label pads, the system picks a destination that isn’t the same block you’re standing on.

Commands

• /vsteleport setlabel <text> – set the label for the pad you’re targeting/holding.

(No menus or config screens yet—intentionally simple.)

Best placement practices

• Put the pad in the center of a 3×3 clear area.

• Leave at least 2 blocks of headroom above the pad so players don’t suffocate.

• If your build uses the optional “glass ring,” placing a pad next to solid blocks may turn the 8 surrounding blocks into glass for visibility (and restore them when broken).

Known limitations / warnings

• No GUI/menu. All setup is via chat command(s).

• No pad list UI (can’t browse or rename from a screen—use the command again to relabel).

• Label collisions are intentional. Any pads sharing a label are linked.

• Cooldown: ~2s per entity to prevent instant re-trigger loops.

• Creative item by default. There’s no survival recipe in this release.

• Language strings: if you see Lang key not found: vsteleport:block-pad, add or adjust your lang/en.json.

• Mod conflicts: anything that intercepts player teleport calls or heavily modifies BlockEntity ticks might interfere.

Compatibility

• Designed for server-side logic with client awareness.

• Should work fine in single-player and multiplayer.

• Doesn’t alter worldgen or vanilla loot tables.

Installation

1. Drop the .zip into your Vintagestory/Mods folder (client and/or server).

2. Start the game/server.

3. Check the Creative inventory for Teleport Pad (code vsteleport:pad).

Uninstall

• Break/remove all pads (to allow any changed blocks to restore if you’re using the see-through ring feature).

• Remove the mod file and restart.

Roadmap / nice-to-haves

• Survival recipe and balance pass

• Simple /vsteleport list to show nearby pads & labels

• Config toggles (cooldown, glass ring, placement guard)

• Minimal GUI for labeling

Why it breaks NOT ALWAYS

Common culprits:

• Global static fields in your pad logic (e.g., a single currentPad or Dictionary<string, BlockPos> without handling multiple entries). The 2nd player overwrites the first.

• Non-unique labels: if both players use the same label (“Home”), your code may “find the first” (or the wrong) pad or even find itself and do nothing.

• No per-world registry: using statics without scoping to the world will conflict on reload or across threads.

• No deregistration on break/unload → the registry points to dead pads, so teleport lookup fails.  

DOES SEEM TO WORK IF PLAYERS KEEP TO SOME NAMING CONVENTION!!