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

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 [<disableSafetyCheck>] - Teleport to the Overworld spawn point. Use true to skip safety checks
• /back [<disableSafetyCheck>] - Teleport to your last death location. Use true to skip safety checks
• /sethome <name> - Set a home location
• /home [<name>] - Teleport to a home. Omit name to go to the default home
• /delhome <name> - Delete a home
• /renamehome <name> <newName> - Rename a home
• /defaulthome <name> - Set the default home
• /homes - View all homes (opens GUI)
• /warp <name> - Teleport to a public warp
• /warps - View all public warps (opens GUI)
• /setwarp <name> - Set a public warp (requires operator permissions)
• /delwarp <name> - Delete a public warp (requires operator permissions)
• /renamewarp <name> <newName> - Rename a public warp (requires operator permissions)
• /tpa <player> - Send a teleport request to a player
• /tpahere <player> - Request a player to teleport to you
• /tpaaccept <player> - Accept a teleport request
• /tpadeny <player> - Deny a teleport request
• /rtp [<dimension>] - 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-blocked: 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