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 storageno 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 locationno 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

Enhance your server setup! Check out my other server-side mods over at : Fabric Server Essentials

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 setupjust drop in and go.