
FanTPA
一个功能强大的 Minecraft Fabric 传送模组,提供 TPA、Home、Back 等传送功能,具备高级特性。A powerful Minecraft Fabric teleportation mod that provides TPA, Home, Back and other teleportation features with advanced capabilities.
查看大图FanTPA
一个功能强大的 Minecraft Fabric 传送模组,提供 TPA、Home、Back 等传送功能以及高级特性。
特性
核心特性
- 异步区块加载 - 高级异步区块加载系统,确保传送流畅且不会造成服务器卡顿
- 自定义语言支持 - 完整支持自定义翻译,内置 17 种以上语言
- 高版本兼容性 - 支持 Minecraft 26.1+
TPA 传送系统
| 命令 | 描述 | 权限 |
|---|---|---|
/tpa <player> |
向其他玩家发送传送请求 | 所有玩家 |
/tpahere <player> |
请求其他玩家传送到你身边 | 所有玩家 |
/tpaccept <player> |
接受传送请求 | 所有玩家 |
/tpdeny <player> |
拒绝传送请求 | 所有玩家 |
Home 系统
| 命令 | 描述 | 权限 |
|---|---|---|
/home [name] |
传送到你的家(未指定名称则使用默认家) | 所有玩家 |
/sethome [name] |
将当前位置设为家(未指定名称则设为默认家) | 所有玩家 |
/delhome <name> |
删除指定的家 | 所有玩家 |
Back 功能
| 命令 | 描述 | 权限 |
|---|---|---|
/back |
返回上次死亡或传送的位置 | 所有玩家 |
管理员命令
| 命令 | 描述 | 权限 |
|---|---|---|
/tpall |
将所有在线玩家传送到你的位置 | 仅 OP |
高级特性
异步区块加载
FanTPA 实现了高级的异步区块加载机制,可以:
- 在后台加载目标区块,不阻塞主线程
- 即使在偏远位置也能提供流畅的传送体验
- 防止传送操作期间造成服务器卡顿
自定义语言支持
- 内置 17 种以上语言,覆盖完整翻译
- 简单易用的语言配置系统
- 支持添加自定义语言包
高版本兼容性
- 服务器版本要求:>= 26.1
- 定期更新以支持最新的 Minecraft 版本
安装
服务器安装
- 确保你的服务器已安装 Fabric Loader 和 Fabric API
- 将
FanTPA-x.x.x.jar放入服务器的mods文件夹 - 启动服务器,模组将自动生成配置文件
客户端安装(可选)
- 如果你想在单人游戏中使用,也请安装 Fabric Loader 和 Fabric API
- 将模组放入客户端的
mods文件夹
配置文件
模组首次运行时会自动在 config/fantpa/fantpa.conf 生成配置文件。
配置结构
fantpa {
teleport {
timeout = 30 # TPA request timeout in seconds
cooldown = 5 # Teleport cooldown in seconds
delay = 3 # Teleport delay in seconds
}
language {
default-language = "en_us" # Default language setting
}
commands {
tpa { enabled = true } # Enable /tpa command
tpahere { enabled = true } # Enable /tpahere command
back { enabled = true } # Enable /back command
home { enabled = true } # Enable /home command
sethome { enabled = true } # Enable /sethome command
delhome { enabled = true } # Enable /delhome command
}
}
配置选项
| 选项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
teleport.timeout |
int | 30 | TPA 请求超时时间,未响应则自动取消 |
teleport.cooldown |
int | 5 | 传送之间的冷却时间,用于防止刷屏 |
teleport.delay |
int | 3 | 传送前的延迟时间,允许取消 |
language.default-language |
string | "en_us" | 模组的默认语言 |
commands.*.enabled |
boolean | true | 启用/禁用特定命令 |
如何修改配置
- 停止服务器
- 编辑
config/fantpa/fantpa.conf文件 - 保存并重启服务器
从源码构建
要求
- Java 25 或更高版本
- Git
构建步骤
- 克隆仓库
git clone https://github.com/yourusername/FanTPA.git
cd FanTPA
- 构建模组
# Windows
gradlew.bat build
# Linux/macOS
./gradlew build
- 获取输出
构建的 jar 文件将位于
build/libs/FanTPA-1.0.0.jar
开发命令
| 命令 | 描述 |
|---|---|
gradlew runClient |
启动开发客户端 |
gradlew runServer |
启动开发服务器 |
gradlew build |
构建模组 |
gradlew sourcesJar |
生成源码 jar |
支持的语言
| 代码 | 语言 |
|---|---|
zh_cn |
简体中文 |
zh_tw |
繁体中文 |
en_us |
英语 |
de_de |
德语 |
es_es |
西班牙语 |
fr_fr |
法语 |
ja_jp |
日语 |
ko_kr |
韩语 |
lzh |
文言文 |
pt_br |
葡萄牙语(巴西) |
ru_ru |
俄语 |
it_it |
意大利语 |
pl_pl |
波兰语 |
tr_tr |
土耳其语 |
th_th |
泰语 |
vi_vn |
越南语 |
uk_ua |
乌克兰语 |
事件系统
模组提供了丰富的事件供其他模组监听:
TpaRequestEvent- 发送 TPA 请求时触发TpaHereRequestEvent- 发送 TPAHere 请求时触发TpaAcceptEvent- 接受传送请求时触发TpaDenyEvent- 拒绝传送请求时触发HomeSetEvent- 设置家时触发HomeTeleportEvent- 传送回家时触发BackEvent- 使用/back时触发TeleportEvent- 发生传送时触发
技术信息
- 模组 ID:
fantpa - 版本:1.0.0
- Minecraft 版本:1.20.1+
- 服务器版本要求:>= 26.1
- 依赖:Fabric API
许可证
MIT 许可证
贡献
欢迎贡献!请随时提交问题和拉取请求。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。