WarpGUI

WarpGUI 是一个 Minecraft 客户端 Fabric 模组，为 HAW（Home and Warp）服务端插件提供图形化传送点管理界面。

仅客户端，无需服务端安装。适配 Minecraft 1.21.4 / 1.21.8 / 1.21.11。

---

功能

• 一键打开 GUI：按 G 键呼出传送点列表界面
• 自动解析聊天：自动拦截 HAW 插件的列表输出，无需手动复制
• 搜索过滤：实时按名称或注释搜索传送点
• 点击传送：单击列表行选中，再次点击或按 Enter 直接传送
• 键盘导航：↑ / ↓ 移动选中，← / → 翻页，滚轮翻页，Enter 传送，Esc 关闭
• 共享点 / 个人点切换：支持 warp 和 home 双列表，可同时展示或单独查看
• 收藏（星标）：为常用传送点标星，始终置顶显示，跨会话持久保存
• 列表缓存：传送点列表保存到本地，重新登录后直接显示，无需再次刷新
• 增量刷新：后台静默检查新传送点，不影响正常游戏
• 自动刷新：可按小时配置自动刷新间隔
• 多服务器：支持配置多个服务器，自动识别当前连接并切换对应列表
• 自动服务器检测：登录时根据地址自动匹配配置，发送 /server 命令时同步切换
• 三套 UI 主题：明亮（light）/ 深色（dark）/ 风格化（stylized），可在配置界面一键切换
• 动态分页：根据屏幕高度自动调整每页显示行数

---

截图

（截图占位，可在此处插入实际游戏截图）

---

安装

前置要求：

• Minecraft 1.21.x（见下方版本对照表）
• Fabric Loader >=0.16.0
• Fabric API
• Java 21+

安装步骤：

1. 从 Releases 页面下载对应 Minecraft 版本的 .jar 文件
2. 将 .jar 放入 .minecraft/mods/ 目录
3. 确保已安装 Fabric API
4. 启动游戏

---

版本对照

Minecraft	文件名
1.21.4	warpgui-2.x.x-1.21.4.jar
1.21.8	warpgui-2.x.x-1.21.8.jar
1.21.11	warpgui-2.x.x-1.21.11.jar

---

使用方法

基本操作

操作	说明
G	打开 / 关闭传送点 GUI
点击列表行	选中传送点
双击 / Enter	传送到选中传送点
点击「传送」按钮	直接传送（无需先选中）
点击「★」按钮	切换收藏，收藏项置顶
↑ / ↓	移动选中项
← / → / 滚轮	翻页
↻ 刷新	重新抓取当前列表
⚙	打开配置界面

首次使用

1. 进入服务器后，按 G 打开 GUI
2. 点击 ↻ 刷新，模组会自动发送列表指令并解析返回内容
3. 列表加载完成后即可点击传送

列表会自动缓存到本地，下次登录后直接显示，无需重新刷新。

---

配置

按 ⚙ 进入配置界面，或直接编辑配置文件：

.minecraft/config/warpgui-config.json

指令配置

字段	默认值	说明
warpList	warp list {page}	获取共享传送点列表的指令
homeList	home list {page}	获取个人传送点列表的指令
warpTp	warp tp {name}	传送到共享传送点的指令
homeTp	home tp {name}	传送到个人传送点的指令
switchServer	server {id}	切换子服务器的指令
pageDelayTicks	10	翻页间隔（单位：tick，50ms），范围 1–100

服务器配置

可以在配置界面的「服务器管理」tab 添加多个服务器条目：

字段	说明
显示名称	在服务器标签栏中显示的名称
服务器 ID	/server {id} 中的 ID 参数
关键词	用于检测切服消息，逗号分隔多个关键词
自动刷新	传送点列表自动刷新间隔（小时，0=禁用）
warp / home	该服务器是否支持对应传送类型

持久化文件

文件	说明
warpgui-config.json	指令模板和服务器配置
warpgui-cache.json	各服务器的传送点列表缓存
warpgui-stars.json	各服务器的收藏记录

---

从源码构建

前置要求： Java 21、Gradle 9.4

# 克隆仓库
git clone https://github.com/yourname/WarpGUI.git
cd WarpGUI

# 构建（以 1.21.8 为例）
cd warp-gui-mod-1.21.8
.\gradlew.bat build

# 输出文件位于
# build/libs/warpgui-x.x.x.jar

---

兼容性说明

• 纯客户端模组：服务端无需安装任何内容
• HAW 插件：模组解析 HAW 标准格式的聊天输出（ID:N name comment YYYY-MM-DD HH:MM:SS）；如使用其他传送插件，可修改指令配置，但聊天格式需匹配
• 与其他模组：通过 Mixin 注入，对原版聊天处理影响最小，不影响其他聊天相关模组的正常运行

---

已知限制

• 翻页发包之间有最小延迟（默认 10 tick / 500ms），防止服务器将请求判定为刷屏
• 传送点列表格式需符合 HAW 插件的标准输出，自定义格式需自行调整正则（见 WarpListManager.java）

---

许可证

MIT License

---

致谢

• Fabric — Minecraft 模组加载器
• HAW — 提供传送点服务端支持