Tpa-Tinmoli

11.04.2026 Mods Tinmoli 0 comments 3 min 157 views

A Minecraft server-side mod that adds various teleportation-related commands, such as /home, /tpa, and /back.

# tpa

> 中文文档 | Click here for Chinese documentation

A Minecraft server-side mod that adds various teleportation-related commands, including /home, /tpa, /back, /rtp, and more.

Project URL: https://github.com/Tinmoli/tpa

Changelog

Supported Platforms

| Platform | Supported Version |

|———-|——————-|

| Fabric | 26.1 |

> Note: Starting from v1.0.3, the project has transitioned to a Fabric-only mod. NeoForge and Quilt support has been removed.

Dependencies

Fabric Loader >= 0.16.10
Minecraft 26.1
Java 25

Available Commands

/tpals – Display all available commands
/spawn [] – Teleport to the Overworld spawn point. Use true to skip safety checks
/back [] – Teleport to your last death location. Use true to skip safety checks
/sethome – Set a home location
/home [] – Teleport to a home. Omit name to go to the default home
/delhome – Delete a home
/renamehome – Rename a home
/defaulthome – Set the default home
/homes – View all homes (opens GUI)
/warp – Teleport to a public warp
/warps – View all public warps (opens GUI)
/setwarp – Set a public warp (requires operator permissions)
/delwarp – Delete a public warp (requires operator permissions)
/renamewarp – Rename a public warp (requires operator permissions)
/tpa – Send a teleport request to a player
/tpahere – Request a player to teleport to you
/tpaaccept – Accept a teleport request
/tpadeny – Deny a teleport request
/rtp [] – Random teleportation. Can specify a dimension

Configuration

Configuration file is located at config/tpa/config.yml. Each option includes comments for easy customization:

# TPA Plugin Configuration File
# Changes require server restart to take effect

# Language setting, options: zh_cn, en_us
language: en_us
# /back command configuration
back:
  # Whether to enable this command
  enabled: true
  # Whether to delete death location record after teleport
  deleteAfterTeleport: false
# /home command configuration
home:
  enabled: true
  # Maximum number of homes per player
  playerMaximum: 20
  # Whether to auto-delete invalid locations (when world doesn't exist)
  deleteInvalid: false
  # Teleport delay in seconds, 0 for instant teleport
  delay: 0
# /tpa command configuration
tpa:
  enabled: true
  delay: 3
  # Whether moving cancels pending teleport
  cancelOnMove: true
# /warp command configuration
warp:
  enabled: true
  deleteInvalid: false
# /spawn command configuration
spawn:
  enabled: true
  # World ID for spawn point, defaults to Overworld
  world_id: minecraft:overworld
# /rtp command configuration
rtp:
  enabled: true
  # Minimum random teleport range (blocks)
  minRange: 1000
  # Maximum random teleport range (blocks)
  maxRange: 2000

Language Files

Language files are located in config/tpa/lang/. zh_cn.json and en_us.json are auto-generated on first startup.

You can edit these files to customize translations, or create new files and specify the language code in the config.

Data Storage

Config file: config/tpa/config.yml
Language files: config/tpa/lang/
Player data: config/tpa/storage.json


If you encounter any issues, please submit an [Issue](https://github.com/Tinmoli/tpa/issues)

<br>

## Credits

- [TeleportCommands](https://github.com/MrSn0wy/TeleportCommands) — Inspiration and reference implementation
- [Dalict](https://github.com/Dalict) — Contributions and support