🌐 Teleport Commands 🚀

Teleport Commands is a high-performance, Server-Side ONLY teleportation suite for Minecraft 1.21.x, 26.1.x, and 26.2.x. It provides a complete set of player-friendly teleport commands with safety checks, configurable delays, and persistent data storage—no client mods required. 🔌✨

Supported Versions

Version	Java	Status
1.21.x	21	✅ Full support
26.1.x	25	✅ Full support
26.2.x	25	✅ Full support

---

🛠️ Purpose & Function

The core mission of this project is to give server administrators and players a complete, drop-in teleportation system with safety guarantees. 🌌

• Move Freely: Instead of fumbling with raw /tp coordinates, players get intuitive commands like /tpa, /home, /warp, /back, and /spawn with clickable chat prompts and auto-complete suggestions. 🧹
• Safety First: Every teleport validates the destination is in a safe, solid location—no falling into lava, suffocating in walls, or spawning mid-air. Safety checks are enabled by default and fully configurable. 💨🔥

---

✨ Key Features

Command	Description	Default
🏠 /sethome <name>	Set personal homes with names	Unlimited
🏠 /home <name>	Teleport to your homes	—
🗑️ /delhome <name>	Delete a home	—
📋 /homes	List all homes with clickable teleport	—
⭐ /defaulthome <name>	Set your default home for /home	—
🌍 /setwarp <name>	Create warps (OPs make global, players make personal)	Unlimited
🗑️ /delwarp <name>	Delete a warp (OPs can delete any)	—
🌍 /warp <name>	Teleport to warps	—
✏️ /renamewarp <old> <new>	Rename a warp (OPs can rename any)	—
🔄 /tpa <player>	Request to teleport to a player	—
🔄 /tpahere <player>	Request a player to teleport to you	—
✅ /tpaaccept	Accept a teleport request	—
❌ /tpadeny	Deny a teleport request	—
↩️ /back	Return to your last death location	—
🌄 /spawn	Teleport to your bed or world spawn	—
🌐 /worldspawn	Teleport to the world's spawn point	—
🎲 /rtp	Random teleport in the current world (safe mode)	—
🎲 /wild	Random teleport with extended range (wild mode)	—

• 🛡️ Safety Validation — Every destination is checked for solid ground, breathable air, and no hazards (lava, fire, fluids) before teleportation
• ⏱️ Configurable Teleport Delays — Set per-command delays to prevent combat-logic teleport abuse
• 📡 100% Server-Side — No client mods required. Vanilla players can use every feature. 🍦
• 💾 Persistent Storage — Homes, warps, and back locations survive server restarts via JSON files
• 🧠 Smart Fallback — If a saved location is unsafe, the mod searches outward for the nearest safe spot
• ⚖️ Ultra-Lightweight — Pure Fabric with zero unnecessary dependencies. Near-zero CPU footprint.
• 🎨 Clickable Chat UI — Teleport requests show Accept/Deny buttons, home/warp lists have clickable entries with hover tooltips
• 🌎 Cross-Dimension — Teleport between dimensions seamlessly (e.g., /warp or /home across any world)
• 🧹 Chunk Preloading — Optional preload-chunks setting prevents landing in unloaded terrain
• 🔄 Cooldown System — Configurable per-command cooldowns to prevent spam

---

🎮 How to Use

• Step 1: Drop the mod JAR into your server's mods folder and restart. 💬
• Step 2: Type /sethome home to set your first home, then /home to return. 📦
• Step 3: Use /tpa Bob to send a teleport request — Bob sees clickable Accept/Deny buttons in chat. ❌

/sethome base          — Set a home named "base"
/home base             — Teleport to it
/delhome base          — Delete a home
/homes                 — List all homes (click to teleport)
/defaulthome base      — Make "base" your default home
/setwarp shop          — Create a warp (OPs create global warps)
/delwarp shop          — Delete a warp
/renamewarp old new    — Rename a warp
/warp shop             — Teleport to it
/tpa Alice             — Request to teleport to Alice
/tpaccept              — Accept the pending request
/back                  — Return to your last death location
/spawn                 — Go to your bed or world spawn
/rtp                   — Random safe teleport (configurable radius)
/wild                  — Random wild teleport (extended range, includes water)

---

⚙️ Configuration

Config file: config/teleport_commands.json (auto-generated on first run)

{
  "global": {
    "global_cooldown_seconds": 0
  },
  "commands": {
    "worldspawn": { "teleport_delay_seconds": 0, "default_safety_check": true },
    "back": { "teleport_delay_seconds": 0, "default_safety_check": true },
    "home": { "teleport_delay_seconds": 0, "default_safety_check": true },
    "warp": { "teleport_delay_seconds": 0, "default_safety_check": true },
    "rtp": {
      "teleport_delay_seconds": 0,
      "default_safety_check": true,
      "min_distance": 1000,
      "max_distance": 5000,
      "preload_chunks": true,
      "safe_mode": true
    },
    "wild": {
      "teleport_delay_seconds": 0,
      "default_safety_check": true,
      "min_distance": 2000,
      "max_distance": 10000,
      "preload_chunks": true,
      "safe_mode": false
    },
    "spawn": { "teleport_delay_seconds": 0, "default_safety_check": true },
    "tpa": { "teleport_delay_seconds": 0, "default_safety_check": true }
  }
}

Key Settings

Setting	Description
global_cooldown_seconds	Global cooldown applied to all teleport commands
teleport_delay_seconds	Delay before teleport executes (per command)
default_safety_check	Enable/disable safety validation for destination
min_distance / max_distance	RTP/Wild search radius from spawn (blocks)
preload_chunks	Pre-load chunks at destination to avoid loading lag
safe_mode (rtp/wild)	true = finds solid non-water/lava ground (safe). false = uses surface heightmap (includes oceans)

• RTP (safe_mode: true) — Scans top-down, finds first non-air, non-lava, non-water block → teleports to Y+1. Safe solid ground only.
• Wild (safe_mode: false) — Uses MOTION_BLOCKING heightmap → teleports to surface+1 (includes water surface, faster for wild exploration).

---

Built for server administrators and players who want a complete, safe, and intuitive teleportation system. No client mods, no complicated setup—just drop in and go. 🌍💎