FanTPA

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 等传送功能以及高级特性。


中文版本 | English

特性

核心特性

  • 异步区块加载 - 高级异步区块加载系统,确保传送流畅且不会造成服务器卡顿
  • 自定义语言支持 - 完整支持自定义翻译,内置 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 版本

安装

服务器安装

  1. 确保你的服务器已安装 Fabric Loader 和 Fabric API
  2. 将 FanTPA-x.x.x.jar 放入服务器的 mods 文件夹
  3. 启动服务器,模组将自动生成配置文件

客户端安装(可选)

  • 如果你想在单人游戏中使用,也请安装 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 启用/禁用特定命令

如何修改配置

  1. 停止服务器
  2. 编辑 config/fantpa/fantpa.conf 文件
  3. 保存并重启服务器

从源码构建

要求

  • Java 25 或更高版本
  • Git

构建步骤

  1. 克隆仓库
git clone https://github.com/yourusername/FanTPA.git
cd FanTPA
  1. 构建模组
# Windows
gradlew.bat build

# Linux/macOS
./gradlew build
  1. 获取输出 构建的 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 许可证

贡献

欢迎贡献!请随时提交问题和拉取请求。