🌐 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

🛠️ 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

• 🛡️ 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

• 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. 🌍💎