Simple-Warp-Tpa-Home-Back

Simple Warp TPA Home Back

A lightweight Fabric mod featuring four core functions: TPA, Home, Warp, and Back. No pop-up windows, no required dependencies, fully localized translations! Install and play instantly!

Feature Overview

Feature Details

Teleport Countdown

• Off by default (teleportDelay: 0)
• When enabled, /tpay, /home, and /warp wait the specified number of seconds before teleporting
• Moving during the countdown cancels the teleport
• Countdown is displayed on the action bar

Teleport Particle Effects

• Off by default (teleportEffectsEnabled: false)
• When enabled, plays an Enderman-style teleport sound and purple particles on every teleport (including /back; /back support is new in 1.4)
• This is a server-wide setting: any player can toggle it via /swthbconfig teleportEffects true/false, and it affects everyone

TPA Teleport Request System

When Player A runs /tpa PlayerB:

• Player A receives: "Teleport request sent to [PlayerB], waiting for response…"
• Player B receives: "[PlayerA] requests to teleport to your location [Accept] [Deny]"
• The [Accept] and [Deny] buttons are clickable directly in chat
• Request timeout duration: 60 seconds
• Cross-dimension teleportation supported
• Players can use /tpaauto accept to auto-accept, /tpaauto deny to auto-deny, and /tpaauto off to return to manual confirmation (new in 1.4)
• Auto-handling settings are saved per player and persist across sessions (new in 1.4)
• With auto-deny enabled, use /tphere <player> to ask another player to teleport to you; they must accept before teleporting (always requires manual confirmation and is not affected by the auto-accept/auto-deny setting; whitelisted bots are the only exception; new in 1.4)
• OPs can use /tpaauto whitelist add <player> to whitelist bots/fake players; whitelisted players automatically accept incoming /tpa or /tphere requests without clicking (useful for bot mods; new in 1.4)

Player Home System

• Each player has a default limit of 5 homes (adjustable via /swthbconfig)
• Running /home with no name teleports to your first home (new in 1.4)
• Home names support Chinese characters (e.g. /sethome Industrial Zone)
• Re-setting a home with an identical name overwrites coordinates without consuming an extra home slot
• Home names in the /homes list are clickable for instant teleport

Public Warp Points

• Warps are global public teleport locations created exclusively by server OPs, accessible to all players
• Run /warps to view all public warps; each entry is clickable for one-click teleport
• Chinese names supported (e.g. /setwarp spawn)

Back Command

• Run /back to return to your position before the last teleport; if no teleport record exists, you will be sent to your last death location
• Supports cross-dimension return
• This feature is disabled by default; OPs can enable it via /swthbconfig backEnabled true
• Back points are automatically cleared when a player disconnects

Configuration File

All data is stored in saves/<save>/data/simple-warp-tpa-home-back/data.json:

{
  "maxHomes": 5,
  "maxWarps": 5,
  "teleportDelay": 0,
  "teleportEffectsEnabled": false,
  "backEnabled": false,
  "homes": {
    "PlayerUUID": [
      { "name": "home1", "world": "minecraft:overworld", "x": 100, "y": 64, "z": 200, "yaw": 0, "pitch": 0 }
    ]
  },
  "warps": {
    "spawn": { "world": "minecraft:overworld", "x": 0, "y": 70, "z": 0, "yaw": 0, "pitch": 0 }
  },
  "tpaModes": {
    "PlayerUUID": "ACCEPT"
  },
  "tpaWhitelist": [
    "BotName"
  ]
}

• Auto-save on edits: Changes made via /sethome, /delhome, /setwarp, /delwarp, and /swthbconfig are automatically written to the file
• Auto-save on server shutdown
• Auto-load on server startup

Multilingual Support

Built-in language files: Simplified Chinese, Traditional Chinese, English, Spanish, Hindi, Arabic, French, Japanese, and Russian.

• If the client has this mod installed: text displays according to the client's game language setting
• If the client does not have this mod installed: text defaults to Simplified Chinese

Contributions for additional translations are welcome.