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
| Category | Command | Permission | Description |
|---|---|---|---|
| Back | /back |
All Players | Return to your last death location or pre-teleport position (cross-dimension supported) |
| TPA | /tpa <player> |
All Players | Send a teleport request to the target player |
/tpay |
All Players | Accept an incoming teleport request | |
/tpan |
All Players | Decline an incoming teleport request | |
/tpaauto [accept|deny|off] |
All Players | Set auto-accept/auto-deny for TPA requests; run without arguments to view the current setting (new in 1.4) | |
/tpaauto whitelist <add|remove|list> |
OP Only | Manage the TPA whitelist; whitelisted players (e.g. bots) auto-accept /tpa / /tphere requests (new in 1.4) |
|
/tphere <player> |
All Players | Send a request asking the player to teleport to you; they must manually accept or deny, unaffected by auto-handling (useful when auto-deny is enabled; new in 1.4) | |
| Home | /sethome <name> |
All Players | Set a home at your current position |
/home [name] |
All Players | Teleport to the specified home; to the first home if no name is given (new in 1.4) | |
/homes |
All Players | List all your homes (clickable for instant teleport) | |
/delhome <name> |
All Players | Delete a specific home | |
| Warp | /warp <name> |
All Players | Teleport to the specified public warp |
/warps |
All Players | List all public warps (clickable for instant teleport) | |
/setwarp <name> |
OP Only | Create a global public warp point | |
/delwarp <name> |
OP Only | Delete a public warp point | |
| Config | /swthbconfig maxHomes <amount> |
OP Only | Adjust the maximum number of homes per player (default: 5) |
/swthbconfig maxWarps <amount> |
OP Only | Adjust the global maximum number of warps (default: 5) | |
/swthbconfig teleportDelay <seconds> |
OP Only | Change the teleport countdown (default: 0 seconds) | |
/swthbconfig backEnabled true/false |
OP Only | Enable/disable the Back feature (default: off) | |
/swthbconfig teleportEffects true/false |
All Players | Toggle teleport particle effects (default: off, server-wide) | |
/swthbconfig reload |
OP Only | Reload configuration data from disk | |
/swthbconfig save |
OP Only | Manually save all configuration to disk |
Feature Details
Teleport Countdown
- Off by default (
teleportDelay: 0) - When enabled,
/tpay,/home, and/warpwait 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;/backsupport 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 acceptto auto-accept,/tpaauto denyto auto-deny, and/tpaauto offto 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/tpaor/tphererequests 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
/homewith 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
/homeslist are clickable for instant teleport
Public Warp Points
- Warps are global public teleport locations created exclusively by server OPs, accessible to all players
- Run
/warpsto view all public warps; each entry is clickable for one-click teleport - Chinese names supported (e.g.
/setwarp spawn)
Back Command
- Run
/backto 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/swthbconfigare 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.

