跳到正文

TPATools

作者:kicobicn

A mod that integrates the/tpa ,/home, and other command and functions for server.

收藏

介绍

中文介绍正在准备中,下面暂时显示原文。

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 /tpatools or /home without 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 &1 to &9 in 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! 😉

常见问题

TPATools 支持哪些 Minecraft 版本?

TPATools 支持 Minecraft Java 版 1.20–26.3,共 24 个版本,可用的加载器:Fabric / Forge / NeoForge / Quilt。下载时注意选择和你游戏版本一致的文件。

TPATools 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / Forge / NeoForge / Quilt,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅服务端。

评论

登录后评论和评分