TPATools
A mod that integrates the/tpa ,/home, and other command and functions for server.
Автор: kicobicn12,7 тыс.9обновлён 1 нояб. 2026 г.
ОбщениеТранспортУтилиты
Описание
TPATools
TPATools is a server utility mod for player interaction and navigation. It adds TPA, Home, Warps, Back, Grave, RTP, plus quality-of-life features like chat mentions and quick item sharing.
✨ GUI menus since v1.1.0 Run
/tpatoolsor/homewithout parameters to open the interactive GUI menu — no command memorization needed.
Quick commands: /tpa · /home · /warp · /back · /grave · /rtp
🚀 Key Features
- Teleportation suite: TPA request/accept/deny, Home set/tp/manage, Warp points.
- Social tools: Chat mentions, quick item sharing, home sharing and invitations.
- Utility commands:
/grave,/back,/rtp. - Admin-friendly config: Cooldowns, max homes, permissions, safe teleport, delayed teleport, and more.
- Multi-language support and optional MySQL storage (experimental, v1.1.1+).
🛠️ Commands
📡 TPA Commands
| Command | Permission | Description |
|---|---|---|
/tpa [player] | All players | Send a teleport request to a player. |
/tpaccept [player] | All players | Accept a request; without a player name, accept the latest request. |
/tpadeny [player] | All players | Deny a request; without a player name, deny the latest request. |
/tpahere [player] | All players | Request a player to teleport to you. |
/tpacancel [player] | All players | Cancel your outgoing request to a player. |
/tpatoggle | All players | Toggle incoming teleport requests (Do Not Disturb). |
/tpalock [player] | All players | Block requests from a specific player. |
/tpaunlock [player] | All players | Unblock requests from a specific player. |
🏠 Home Commands — Basic
| Command | Permission | Description |
|---|---|---|
/home set [name] | All players | Set your current location as a home. |
/home tp [name] | All players | Teleport to a saved home. |
/home list | All players | List all your homes. |
/home remove [name] | All players | Remove a saved home. |
/home rename [name] [new_name] | All players | Rename a saved home. |
🏠 Home Commands — Sharing & Invitations
| Command | Permission | Description |
|---|---|---|
/home share [name] [player] | All players | Share a home with a player. |
/home unshare [name] [player] | All players | Stop sharing a home; omit player to stop sharing with everyone. |
/home sharelist [in/out] | All players | View shared homes: in = shared with you, out = shared by you. |
/home invite [name] [player] | All players | Invite a player to your home. |
/home invite cancel [player] | All players | Cancel an invitation; omit player to cancel all invitations. |
/home invite accept [player] | All players | Accept an invitation; omit player to accept the latest one. |
/home invite deny [player] | All players | Deny an invitation; omit player to deny the latest one. |
🏠 Home Commands — Public Homes
| Command | Permission | Description |
|---|---|---|
/home public [name] | All players | Make a home publicly accessible. |
/home otherhome [player:home] | All players | Teleport to another player's public home. |
/home otherlist | All players | List all public homes. |
🌐 Warp & Utility Commands
| Command | Permission | Description |
|---|---|---|
/warp tp [name] | All players | Teleport to a warp point. |
/warp set [name] | OP only | Set a warp point at your current location. |
/warp remove [name] | OP only | Remove a warp point. |
/warp list | All players | List all warp points. |
/grave | All players | Teleport to your last death location. |
/back | All players | Return to your previous location before the last teleport. |
/rtp | All players | Randomly teleport within the configured radius. |
Permission for TPA / Home / Grave / Back / Warp / rtp can be adjusted with
/tpatools config needop.
✨ Extra Features
- Chat Mentions: Player names in chat are highlighted and notify the mentioned player.
- Quick Share: Press
&1to&9in chat to share the corresponding hotbar item.
⚙️ Configuration
Show admin configuration commands
| Command | Permission | Description |
|---|---|---|
/tpatools config setlanguage [language] | OP only | Change the mod language. |
/tpatools config setmaxhome [count] | OP only | Set the maximum homes per player. |
/tpatools config needop [tpa/home/grave/back/warp] | OP only | Toggle whether a command requires OP. |
/tpatools config tpawaittime [time] | OP only | Set TPA request timeout. |
/tpatools config tpacdtime [time] | OP only | Set TPA command cooldown. |
/tpatools config homeinviteovertime [time] | OP only | Set home invitation timeout in seconds. |
/tpatools config homeinvitecdtime [time] | OP only | Set home invitation cooldown in seconds. |
/tpatools config rtpscope [count] | OP only | Set the maximum RTP radius. |
/tpatools config rtpcdtime [count] | OP only | Set the RTP cooldown. |
/tpatools config setmaxwarpcount [count] | OP only | Set the maximum number of warp points. |
/tpatools config allowteleportrideentity [true/false] | OP only | Allow pets/mounts to teleport with you via TPA. |
/tpatools config safeteleport [true/false] | OP only | Enable safer teleport checks for /home, /grave, and /back (v1.1.3+). |
/tpatools config teleport_need_time [false/true] | OP only | Enable/disable delayed teleport (v1.2.0+). |
/tpatools config teleport_delay_time [time] | OP only | Set delayed teleport time (v1.2.0+). |
/tpatools debug [true/false] | OP only | Toggle debug logging (v1.0.6+). |
/tpatools about | All players | Show mod information and credits. |
🇨🇳 中文指令列表
📡 TPA 传送类
| 指令 | 权限 | 说明 |
|---|---|---|
/tpa [player] | 所有玩家 | 请求传送到指定玩家。 |
/tpaccept [player] | 所有玩家 | 接受请求；不填玩家名则接受最新请求。 |
/tpadeny [player] | 所有玩家 | 拒绝请求；不填玩家名则拒绝最新请求。 |
/tpahere [player] | 所有玩家 | 请求指定玩家传送到你身边。 |
/tpacancel [player] | 所有玩家 | 取消对指定玩家的传送请求。 |
/tpatoggle | 所有玩家 | 开启/关闭接收传送请求（免打扰模式）。 |
/tpalock [player] | 所有玩家 | 屏蔽指定玩家的传送请求。 |
/tpaunlock [player] | 所有玩家 | 解除屏蔽指定玩家的传送请求。 |
🏠 Home 基础类
| 指令 | 权限 | 说明 |
|---|---|---|
/home set [name] | 所有玩家 | 将当前位置设置为家。 |
/home tp [name] | 所有玩家 | 传送到指定的家。 |
/home list | 所有玩家 | 列出你所有的家。 |
/home remove [name] | 所有玩家 | 删除指定的家。 |
/home rename [name] [new_name] | 所有玩家 | 重命名指定的家。 |
🏠 Home 分享与邀请
| 指令 | 权限 | 说明 |
|---|---|---|
/home share [name] [player] | 所有玩家 | 将指定的家分享给指定玩家。 |
/home unshare [name] [player] | 所有玩家 | 取消分享；不填玩家则取消对所有人的分享。 |
/home sharelist [in/out] | 所有玩家 | 查看已分享的家：in = 别人分享给你的，out = 你分享给别人的。 |
/home invite [name] [player] | 所有玩家 | 邀请玩家前往你的家。 |
/home invite cancel [player] | 所有玩家 | 取消邀请；不填玩家则取消所有邀请。 |
/home invite accept [player] | 所有玩家 | 接受邀请；不填玩家则接受最新邀请。 |
/home invite deny [player] | 所有玩家 | 拒绝邀请；不填玩家则拒绝最新邀请。 |
🏠 Home 公开类
| 指令 | 权限 | 说明 |
|---|---|---|
/home public [name] | 所有玩家 | 公开你指定的家。 |
/home otherhome [player:home] | 所有玩家 | 传送到其他玩家已公开的家。 |
/home otherlist | 所有玩家 | 显示所有已公开的家。 |
🌐 Warp 与实用指令
| 指令 | 权限 | 说明 |
|---|---|---|
/warp tp [name] | 所有玩家 | 传送到指定领域。 |
/warp set [name] | 仅限 OP | 在当前地点设置领域。 |
/warp remove [name] | 仅限 OP | 移除指定领域。 |
/warp list | 所有玩家 | 列出所有领域。 |
/grave | 所有玩家 | 传送到上一个死亡地点。 |
/back | 所有玩家 | 传送到使用传送指令前的位置。 |
/rtp | 所有玩家 | 在设定范围内随机传送。 |
TPA / Home / Grave / Back / Warp / rtp 的权限可通过
/tpatools config needop调整。
✨ 其他特性
- 聊天高亮提醒：聊天中的玩家名字会被高亮，并提醒被提到的玩家。
- 快捷物品分享：在聊天框输入
&1到&9，分享快捷栏对应位置的物品。
⚙️ 管理配置
| 指令 | 权限 | 说明 |
|---|---|---|
/tpatools config setlanguage [language] | 仅限 OP | 更改模组语言。 |
/tpatools config setmaxhome [count] | 仅限 OP | 设置玩家最大可设置家的数量。 |
/tpatools config needop [tpa/home/grave/back/warp] | 仅限 OP | 设置指定指令是否需要 OP 权限。 |
/tpatools config tpawaittime [time] | 仅限 OP | 设置 TPA 请求超时时间。 |
/tpatools config tpacdtime [time] | 仅限 OP | 设置 TPA 指令冷却时间。 |
/tpatools config homeinviteovertime [time] | 仅限 OP | 设置家邀请超时时间（秒）。 |
/tpatools config homeinvitecdtime [time] | 仅限 OP | 设置家邀请冷却时间（秒）。 |
/tpatools config rtpscope [count] | 仅限 OP | 更改 RTP 最大传送半径。 |
/tpatools config rtpcdtime [count] | 仅限 OP | 更改 RTP 冷却时间。 |
/tpatools config setmaxwarpcount [count] | 仅限 OP | 设置最大领域数量。 |
/tpatools config allowteleportrideentity [true/false] | 仅限 OP | 允许/禁止骑乘生物随玩家一起通过 TPA 传送。 |
/tpatools config safeteleport [true/false] | 仅限 OP | 开启安全传送检测，防止 /home、/grave、/back 卡入方块 (v1.1.3+)。 |
/tpatools config teleport_need_time [false/true] | 仅限 OP | 开启/关闭延迟传送功能 (v1.2.0+)。 |
/tpatools config teleport_delay_time [time] | 仅限 OP | 设置延迟传送所需时间 (v1.2.0+)。 |
/tpatools debug [true/false] | 仅限 OP | 开启/关闭 Debug 日志 (v1.0.6+)。 |
/tpatools about | 所有玩家 | 显示模组信息及作者寄语。 |
💾 Database Support
⚠️ Experimental feature MySQL storage is supported since v1.1.1, but it is still in experimental testing. If you encounter issues, please report them via GitHub Issues.
🗺️ Future Plans
- Support for more Minecraft versions.
❤️ Support the Project
If you like this mod, recommending it to others is the greatest motivation to keep updating and improving it.
Happy teleporting! 😉
Последние версии
Все версии →release
TPATools 1.2.2+mc1.21.5-1.21.10
1.2.2+mc1.21.5-1.21.101 нояб. 2026 г.10Minecraft: 1.21.10, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9fabric
Что нового
<details>
<summary>English</summary>
## Fixes:
- In Spanish/Portuguese, the teleport countdown causes the server tick to throw an exception
- `/tpatools configs tpawaittime` (TPA timeout) has no effect
- `/tpatools configs teleportdelaytime` (without arguments) displays nothing
- `/grave` has no teleport delay check
- Some translation locations reference incorrect translation keys
- Added some keys that were not correctly added
- `/back` historical locations are not recorded long-term
## Optimizations:
- Optimized the display of some menus
- Changed all early translation keys from `.tpatool.` back to `.tpatools.`
- Optimized the excessively high performance cost of the `/rtp` command when searching for safe locations
- Possible leftover TPA requests and pending teleports after a player disconnects
### **Some MySQL storage residue issues have been optimized, but MySQL is still in the testing phase; enable this feature as appropriate**
</details>
<details>
<summary>中文</summary>
## 修复：
- 西班牙语/葡萄牙语下，传送倒计时会让服务器 tick 抛异常
- `/tpatools configs tpawaittime`（TPA 超时）无效
- `/tpatools configs teleportdelaytime`（无参）什么都不显示
- `/grave` 没有传送延迟判定
- 部分翻译处引用翻译键错误
- 补充部分未正确添加的键
- `/back` 的历史位置不被长期记录
## 优化：
- 优化了部分菜单的显示
- 早期翻译键全部从`.tpatool.`改回`.tpatools.`
- 优化`/rtp`指令查询安全位置的性能占用过高问题
- 玩家断线后可能残留 TPA 请求与待处理传送
### **已优化部分MySQL存储残留问题，但MySQL仍旧在测试阶段，酌情开启该功能**
</details>
release
TPATools 1.2.2+mc1.21.11
1.2.2+mc1.21.111 нояб. 2026 г.24Minecraft: 1.21.11fabric
Что нового
<details>
<summary>English</summary>
## Fixes:
- In Spanish/Portuguese, the teleport countdown causes the server tick to throw an exception
- `/tpatools configs tpawaittime` (TPA timeout) has no effect
- `/tpatools configs teleportdelaytime` (without arguments) displays nothing
- `/grave` has no teleport delay check
- Some translation locations reference incorrect translation keys
- Added some keys that were not correctly added
- `/back` historical locations are not recorded long-term
## Optimizations:
- Optimized the display of some menus
- Changed all early translation keys from `.tpatool.` back to `.tpatools.`
- Optimized the excessively high performance cost of the `/rtp` command when searching for safe locations
- Possible leftover TPA requests and pending teleports after a player disconnects
### **Some MySQL storage residue issues have been optimized, but MySQL is still in the testing phase; enable this feature as appropriate**
</details>
<details>
<summary>中文</summary>
## 修复：
- 西班牙语/葡萄牙语下，传送倒计时会让服务器 tick 抛异常
- `/tpatools configs tpawaittime`（TPA 超时）无效
- `/tpatools configs teleportdelaytime`（无参）什么都不显示
- `/grave` 没有传送延迟判定
- 部分翻译处引用翻译键错误
- 补充部分未正确添加的键
- `/back` 的历史位置不被长期记录
## 优化：
- 优化了部分菜单的显示
- 早期翻译键全部从`.tpatool.`改回`.tpatools.`
- 优化`/rtp`指令查询安全位置的性能占用过高问题
- 玩家断线后可能残留 TPA 请求与待处理传送
### **已优化部分MySQL存储残留问题，但MySQL仍旧在测试阶段，酌情开启该功能**
</details>
release
TPATools 1.2.2+mc26.2
1.2.2+mc26.21 нояб. 2026 г.24Minecraft: 26.2fabric
Что нового
<details>
<summary>English</summary>
## Fixes:
- In Spanish/Portuguese, the teleport countdown causes the server tick to throw an exception
- `/tpatools configs tpawaittime` (TPA timeout) has no effect
- `/tpatools configs teleportdelaytime` (without arguments) displays nothing
- `/grave` has no teleport delay check
- Some translation locations reference incorrect translation keys
- Added some keys that were not correctly added
- `/back` historical locations are not recorded long-term
## Optimizations:
- Optimized the display of some menus
- Changed all early translation keys from `.tpatool.` back to `.tpatools.`
- Optimized the excessively high performance cost of the `/rtp` command when searching for safe locations
- Possible leftover TPA requests and pending teleports after a player disconnects
### **Some MySQL storage residue issues have been optimized, but MySQL is still in the testing phase; enable this feature as appropriate**
</details>
<details>
<summary>中文</summary>
## 修复：
- 西班牙语/葡萄牙语下，传送倒计时会让服务器 tick 抛异常
- `/tpatools configs tpawaittime`（TPA 超时）无效
- `/tpatools configs teleportdelaytime`（无参）什么都不显示
- `/grave` 没有传送延迟判定
- 部分翻译处引用翻译键错误
- 补充部分未正确添加的键
- `/back` 的历史位置不被长期记录
## 优化：
- 优化了部分菜单的显示
- 早期翻译键全部从`.tpatool.`改回`.tpatools.`
- 优化`/rtp`指令查询安全位置的性能占用过高问题
- 玩家断线后可能残留 TPA 请求与待处理传送
### **已优化部分MySQL存储残留问题，但MySQL仍旧在测试阶段，酌情开启该功能**
</details>
release
TPATools 1.2.2+mc26.1
1.2.2+mc26.11 нояб. 2026 г.15Minecraft: 26.1, 26.1.1, 26.1.2fabric
Что нового
<details>
<summary>English</summary>
## Fixes:
- In Spanish/Portuguese, the teleport countdown causes the server tick to throw an exception
- `/tpatools configs tpawaittime` (TPA timeout) has no effect
- `/tpatools configs teleportdelaytime` (without arguments) displays nothing
- `/grave` has no teleport delay check
- Some translation locations reference incorrect translation keys
- Added some keys that were not correctly added
- `/back` historical locations are not recorded long-term
## Optimizations:
- Optimized the display of some menus
- Changed all early translation keys from `.tpatool.` back to `.tpatools.`
- Optimized the excessively high performance cost of the `/rtp` command when searching for safe locations
- Possible leftover TPA requests and pending teleports after a player disconnects
### **Some MySQL storage residue issues have been optimized, but MySQL is still in the testing phase; enable this feature as appropriate**
</details>
<details>
<summary>中文</summary>
## 修复：
- 西班牙语/葡萄牙语下，传送倒计时会让服务器 tick 抛异常
- `/tpatools configs tpawaittime`（TPA 超时）无效
- `/tpatools configs teleportdelaytime`（无参）什么都不显示
- `/grave` 没有传送延迟判定
- 部分翻译处引用翻译键错误
- 补充部分未正确添加的键
- `/back` 的历史位置不被长期记录
## 优化：
- 优化了部分菜单的显示
- 早期翻译键全部从`.tpatool.`改回`.tpatools.`
- 优化`/rtp`指令查询安全位置的性能占用过高问题
- 玩家断线后可能残留 TPA 请求与待处理传送
### **已优化部分MySQL存储残留问题，但MySQL仍旧在测试阶段，酌情开启该功能**
</details>
release
TPATools 1.2.2+mc1.20
1.2.2+mc1.2031 окт. 2026 г.58Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6forge
Что нового
## 为 forge 1.20.1 更新1.2.2版本QwQ
release
TPATools 1.2.2+mc26.3
1.2.2+mc26.322 окт. 2026 г.332Minecraft: 26.3fabric
Что нового
### 抽出时间改的，感谢大肥鱼给我报Bug（（（
~~（给我增加那么多工作量，大肥鱼你晚上别睡太死）~~
<details>
<summary>English</summary>
## Fixes:
- In Spanish/Portuguese, the teleport countdown causes the server tick to throw an exception
- `/tpatools configs tpawaittime` (TPA timeout) has no effect
- `/tpatools configs teleportdelaytime` (without arguments) displays nothing
- `/grave` has no teleport delay check
- Some translation locations reference incorrect translation keys
- Added some keys that were not correctly added
- `/back` historical locations are not recorded long-term
## Optimizations:
- Optimized the display of some menus
- Changed all early translation keys from `.tpatool.` back to `.tpatools.`
- Optimized the excessively high performance cost of the `/rtp` command when searching for safe locations
- Possible leftover TPA requests and pending teleports after a player disconnects
### **Some MySQL storage residue issues have been optimized, but MySQL is still in the testing phase; enable this feature as appropriate**
</details>
<details>
<summary>中文</summary>
## 修复：
- 西班牙语/葡萄牙语下，传送倒计时会让服务器 tick 抛异常
- `/tpatools configs tpawaittime`（TPA 超时）无效
- `/tpatools configs teleportdelaytime`（无参）什么都不显示
- `/grave` 没有传送延迟判定
- 部分翻译处引用翻译键错误
- 补充部分未正确添加的键
- `/back` 的历史位置不被长期记录
## 优化：
- 优化了部分菜单的显示
- 早期翻译键全部从`.tpatool.`改回`.tpatools.`
- 优化`/rtp`指令查询安全位置的性能占用过高问题
- 玩家断线后可能残留 TPA 请求与待处理传送
### **已优化部分MySQL存储残留问题，但MySQL仍旧在测试阶段，酌情开启该功能**
</details>
release
TPATools 1.2.1+26.3
1.2.1+26.310 окт. 2026 г.293Minecraft: 26.3fabric
Что нового
<details>
<summary>English</summary>
- Fixed a bug where the `/home otherhome` command might fail to teleport to other players' public homes.
- Added a new rule: players in Creative mode are not affected by teleport delay when the `teleportneedtime` config is enabled.
- Added delayed teleport support for `/tpa`.
</details>
<details>
<summary>中文</summary>
- 修复了`/home otherhome`指令可能无法传送其他玩家公开的家的bug
- 新添加了一个策略：创造模式下的玩家在`teleportneedtime`配置开启时不受延迟传送的影响
- 为`/tpa`适配了延迟传送
</details>
release
TPATools 1.2.1+1.21.2-1.21.4
1.2.1+1.21.2-1.21.410 окт. 2026 г.16Minecraft: 1.21.2, 1.21.3, 1.21.4fabric
Что нового
<details>
<summary>English</summary>
- Fixed a bug where the `/home otherhome` command might fail to teleport to other players' public homes.
- Added a new rule: players in Creative mode are not affected by teleport delay when the `teleportneedtime` config is enabled.
- Added delayed teleport support for `/tpa`.
</details>
<details>
<summary>中文</summary>
- 修复了`/home otherhome`指令可能无法传送其他玩家公开的家的bug
- 新添加了一个策略：创造模式下的玩家在`teleportneedtime`配置开启时不受延迟传送的影响
- 为`/tpa`适配了延迟传送
</details>
release
TPATools 1.2.1+1.21-1.21.1
1.2.1+1.21-1.21.17 окт. 2026 г.183Minecraft: 1.21, 1.21.1fabric
Что нового
<details>
<summary>English</summary>
- Fixed a bug where the `/home otherhome` command might fail to teleport to other players' public homes.
- Added a new rule: players in Creative mode are not affected by teleport delay when the `teleportneedtime` config is enabled.
- Added delayed teleport support for `/tpa`.
</details>
<details>
<summary>中文</summary>
- 修复了`/home otherhome`指令可能无法传送其他玩家公开的家的bug
- 新添加了一个策略：创造模式下的玩家在`teleportneedtime`配置开启时不受延迟传送的影响
- 为`/tpa`适配了延迟传送
</details>
release
TPATools 1.2.1+1.20
1.2.1+1.207 окт. 2026 г.79Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6fabric
Что нового
<details>
<summary>English</summary>
- Fixed a bug where the `/home otherhome` command might fail to teleport to other players' public homes.
- Added a new rule: players in Creative mode are not affected by teleport delay when the `teleportneedtime` config is enabled.
- Added delayed teleport support for `/tpa`.
</details>
<details>
<summary>中文</summary>
- 修复了`/home otherhome`指令可能无法传送其他玩家公开的家的bug
- 新添加了一个策略：创造模式下的玩家在`teleportneedtime`配置开启时不受延迟传送的影响
- 为`/tpa`适配了延迟传送
</details>