HomeGui

模组

· 作者 maxlananass

别再每 30 秒输入一次 /home 了。HomeGui 为你的所有已保存家园提供了一个点击即传送的界面——支持收藏、搜索、历史记录、键盘快捷键以及 5 种颜色主题。兼容 EssentialsX、CMI 以及任何使用家园系统的服务器。

0 本站下载 0 关注 更新于 3 周前

需要前置:Fabric API

最新 4.2.1 · 26.3 · Fabric

一键开服(送7天)

HomeGui

非常感谢 Elfi 为本项目提供图标!

你每个游戏会话要打二十次 /home。现在有更好的方式了。

打开任何一个生存 Minecraft 直播,看看聊天频道。你会看到:/home、/home base、/home farm、/home nether、/home shop、/home base,再来一次 /home farm。每隔几分钟就输入一次,持续数小时。这已经成了肌肉记忆,而且没人质疑它,因为“回家传送本来就是这样操作的。”

但这样很慢。你必须停下手中的事,打开聊天栏,输入指令。有时候会拼错,有时候会忘记名字。在拥有 10 个以上家园的服务器上,你甚至不得不通过 Tab 补全浏览一个会滚出屏幕的列表。

HomeGui 用一次按键绑定和一次点击取代了所有这些操作。

按下 H。在一个整洁的网格中查看你的所有家园。点击你想去的那个。到达目的地。只需三秒,而不是十秒。没有刷屏,没有拼写错误,不会忘记名字,也不会打断你的节奏。


工作原理

HomeGui 是一个客户端 Fabric 模组。它不替换或修改服务器端的家园系统——它只是读取数据。服务器(EssentialsX、CMI 或其他运行家园插件)存储你的家园数据。HomeGui 读取这些数据并在客户端以图形界面展示。

这一点很重要:HomeGui 是你现有家园系统之上的可视化层。它不会创建自己独立的家园数据库。它不与服务器的插件冲突。发送指令的方式与你手动输入时完全一致。当你在 GUI 中点击某个家园时,它发送的也是同样的 /home <name> 指令——只不过它是瞬间完成的,无需你输入任何内容。

这意味着:

  • 适用于任何使用家园指令系统的服务器
  • 无需安装服务器端组件
  • 无需更改权限设置
  • 服务器管理员无需进行任何配置
  • 你的家园就是服务器原本已知的家园

兼容的服务器插件

HomeGui 检测并与以下插件配合工作:

  • EssentialsX —— 最常见的家园插件。完全支持。
  • CMI —— 另一个流行选择。完全支持。
  • 任何使用标准 /home 指令的插件 —— HomeGui 通过解析这些插件发送的聊天响应来监控你的家园列表。如果插件对 /homelist 或 /homes 返回格式化的列表,HomeGui 会对其进行解析。

不确定你的服务器插件是否兼容?安装 HomeGui 并在聊天中输入 /homelist 或 /homes。如果服务器回复了你的家园列表,HomeGui 就可以读取它。


功能详解

可视化家园网格

按下 H 后,会打开一个整洁的网格界面,显示你保存的所有家园。每个家园都以物品形式显示在网格中,包含:

  • 物品下方显示的家园名称
  • 图标(可配置——默认根据上下文使用指南针或床)
  • 收藏和最近家园的视觉指示器
  • 鼠标悬停时的平滑动画效果

该网格可以处理任意数量的家园。5 个家园?一页即可容纳。50 个家园?支持平滑动量滚动。布局会自动调整以干净地填充可用空间。

一键传送

点击一个家园。你便传送过去。这就是整个交互过程。

没有确认对话框(除非你在设置中启用)。没有“确定吗?”弹窗。没有二级菜单。点击即走。传送指令立即触发,GUI 关闭,你已到达目的地。

如果你希望为昂贵的传送(例如具有冷却时间或费用的服务器)增加确认步骤,可以在设置中启用确认开关。

收藏夹

右键单击任意家园将其标记为收藏。收藏的家园会出现在网格顶部,并带有金色星标指示器。这用于存放你频繁使用的家园——基地、农场、商店。

只需右键单击一次。再次右键单击即可取消收藏。

收藏夹跨会话持久保存。它们存储在客户端的本地配置文件中。

历史记录

模组会追踪你最近传送到的家园。GUI 顶部的“历史”部分按时间倒序显示你最近的 10 次传送记录。点击即可快速传送至近期家园,无需浏览完整列表。

这在建造期间在两个或三个家园之间来回切换时非常有用——基地到农场,农场到基地,基地到商店。历史部分确保它们始终只需一次点击即可访问。

键盘快捷键

当 GUI 打开时,按键 1-9 映射到你列表中的前 9 个家园。按 1 传送到第一个家园。按 5 传送到第五个。这是为那些已经记住家园顺序并希望实现亚秒级传送的高级用户准备的。

快捷键映射到 GUI 中的视觉顺序——首先是收藏项,然后是其余项。通过调整收藏项的顺序,快捷键也会随之跟随。

搜索

GUI 顶部有一个搜索栏。输入文字可按名称筛选家园。列表会随着你的输入实时更新。当你拥有数十个家园且需要快速查找其中一个时,这非常有用。

关闭 GUI 时搜索内容会清除。下次打开时,你会看到所有家园。

主题

五种内置的 GUI 颜色主题:

  • 紫色 —— 深紫色搭配紫罗兰色点缀(默认)
  • 海洋 —— 蓝色调搭配青绿色高亮
  • 森林 —— 绿色搭配土褐色边框
  • 日落 —— 温暖的橙色与粉色渐变
  • 樱花 —— 柔和粉色搭配白色点缀

通过配置文件或游戏内设置(即将推出)切换主题。主题会改变背景、边框、文本颜色和装饰元素。每个主题都经过设计,确保在任何显示器上看起来都不错,且不会与你的资源包冲突。

统计数据

模组会在本地追踪基本统计数据:

  • 通过 HomeGui 执行的总传送次数
  • 最常传送到的家园
  • 每次会话的传送次数
  • 追踪的总会话数

GUI 中的统计面板会显示你的数据。有些玩家觉得有趣,有些则完全忽略。如果你想看,它就在那里。

统计数据存储在本地配置文件中。它们属于你——没有任何数据发送到外部。

偏好设置持久化

你所配置的所有内容都会自动保存:

  • 主题选择
  • 收藏的家
  • GUI 位置与缩放
  • 确认开关
  • 历史记录条目
  • 键盘快捷键映射
  • 统计数据

所有设置存储在一个单独的 JSON 配置文件中:

.minecraft/config/homegui.json

删除此文件可将所有内容重置为默认值。如果你想的话可以手动编辑它(它是可读的 JSON)。如果你更换电脑并想保留收藏列表,请备份该文件。


适用人群

生存多人游戏玩家 如果你在有家园系统的 SMP 服务器上游玩,你每次会话会使用 /home 命令数十次。HomeGui 让每一次传送都更快、更愉快。积少成多——在两个小时的会话中,你可能会节省几分钟累积的聊天打字和等待时间。但更重要的是流畅的体验。你不需要停下来输入命令。只需按下 H,点击,然后继续你的操作。

拥有大量家的玩家 有些玩家拥有 5、10、20+ 个家。一个主基地,每种作物的农场,一个刷怪塔,一个下界枢纽,一个商店区,不同生物群系中的建筑。通过聊天命令管理所有这些家非常繁琐。搜索功能、收藏夹和历史记录使庞大的家列表变得易于管理。

忘记家名称的玩家 你六个月前把它命名为“base”。或者是“main”?还是“home”?或是“base1”?使用 HomeGui,你可以直观地看到所有的家。你通过上下文、位置和收藏夹来识别它们。名字记忆变得无关紧要。

共享屏幕/直播的玩家 充满 /home 命令的聊天在直播中看起来并不美观。干净的 GUI 覆盖层看起来更专业。一些主播部分使用 HomeGui 是为了保持内容的视觉整洁。

在传送有费用的服务器上的玩家 如果你的服务器对传送收费或设有冷却时间,你希望每次传送都算数。点击正确的家以瞬间传送比打字更少出错,尤其是当你疲惫或分心时。不再因为拼写错误而意外传送到错误的家。


性能与架构

HomeGui 设计为对你的系统不可见。

仅客户端:

  • 零服务器影响
  • 不发送任何网络数据包(除了标准的 /home 命令)
  • 零服务器端处理
  • 服务器根本不知道 HomeGui 的存在

资源占用:

  • GUI 仅在打开时渲染——无后台渲染
  • 无刻度循环,无计划任务,无轮询
  • 历史记录和收藏夹作为小型列表存储在内存中
  • 配置文件在启动时读取一次,更改时写入
  • FPS 影响:GUI 关闭时为零,打开时可忽略不计(标准物品栏风格屏幕渲染)

与其他模组的兼容性:

  • 不修改 Minecraft 的渲染管线
  • 除了读取响应外,不注入聊天系统
  • 不触碰网络数据包
  • 可与 Sodium、Iris、OptiFine 以及任何客户端模组共存
  • 已知无任何模组冲突

控制

操作 默认按键 备注
打开家园 GUI H 可在 Minecraft 控制设置中重新映射
传送至家园 左键点击家园项目 关闭 GUI 并传送
收藏 / 取消收藏 右键点击家园项目 星标指示器切换
快速传送 (1-9) 数字键 1-9 映射到列表中的前 9 个家
搜索 在搜索栏中输入 实时过滤
关闭 GUI Escape 标准行为

所有按键绑定均可通过 Minecraft 控制菜单下的 HomeGui 类别进行重新映射。


安装

不到一分钟。无需配置。

  1. 为 Minecraft 1.21.4 安装 Fabric Loader → fabricmc.net/use/installer

  2. 安装 Fabric API → modrinth.com/mod/fabric-api → 放入 /mods/ 文件夹

  3. 从此页面下载 HomeGui.jar → 放入 /mods/ 文件夹

  4. 使用 Fabric 配置文件启动 Minecraft

  5. 加入具有家园系统的服务器(EssentialsX、CMI 等)

  6. 按 H 查看你的家

首次启动:模组会在你加入服务器或首次打开 GUI 时从服务器的聊天响应中读取你的家列表。如果没有显示任何家,请在聊天中键入一次 /homelist 或 /homes 以让模组解析服务器的响应。之后,它将自动工作。


要求

  • Minecraft Java Edition 1.21.4
  • Fabric Loader
  • Fabric API
  • 具有家园命令系统的服务器(EssentialsX、CMI 或兼容插件)

无需服务器安装。 模组完全在你的客户端上运行,并与服务器现有的家园命令交互。


配置

位于 .minecraft/config/homegui.json 的配置文件控制:

{
  "theme": "PURPLE",
  "showConfirmDialog": false,
  "showStatistics": true,
  "showHistory": true,
  "maxHistoryEntries": 10,
  "guiScale": 1.0,
  "keybindOpenGui": "H",
  "favorites": ["base", "farm", "shop"],
  "history": []
}

每个设置都一目了然。直接编辑文件或等待游戏内设置菜单(路线图)。更改在下一次打开 GUI 时生效——无需重启。


常见问题

服务器需要安装 HomeGui 吗? 不需要。绝对不需要。100% 纯客户端。服务器运行其家园插件(EssentialsX、CMI 等)。HomeGui 从聊天响应中读取家列表,并在你点击时发送 /home 命令。服务器根本不知道 HomeGui 的存在。

我会因为使用这个而被封禁吗? HomeGui 发送与你手动输入的相同的 /home 命令。它不修改数据包,不注入服务器,也不做玩家无法用键盘完成的事情。没有任何反作弊会标记它,因为输出与普通游戏玩法完全相同。话虽如此,请检查你特定服务器的规则——一些服务器有全面的模组禁令。

它没有检测到我的家。我该怎么办? HomeGui 从服务器的聊天响应中读取家信息。如果你的服务器使用非标准家园插件,其 /homelist 响应格式不同,解析器可能无法捕获它。尝试在聊天中输入 /homelist 或 /homes,看看服务器的响应是什么。如果它显示了格式化列表但 HomeGui 没有识别出来,请在 GitHub 上提交一个问题,并附上聊天响应的截图。

我可以在 Hypixel 或没有家园系统的服务器上使用该模组吗? HomeGui 需要一个服务端的家系统。如果服务器没有 /home 命令,该模组就没有可以交互的内容。它不会导致错误——只是不会显示任何家。

它支持 EssentialsX 的 /home <数字> 格式吗? 是的。EssentialsX 同时支持命名家园和编号家园。HomeGui 会根据服务器 /homelist 命令返回的格式自动适配。

我有超过 100 个家园,GUI 会卡顿吗? 不会。该 GUI 采用分页网格渲染。任何时刻仅渲染可见范围内的家园。从性能角度来看,加载和显示 100 个家园与 10 个家园无异。

我能把按键从 H 改成别的吗? 可以。在 Minecraft 控制菜单 → HomeGui 分类 → 重新绑定“打开 Home GUI”为任意你喜欢的按键即可。有些玩家使用 G,有些使用 N,还有些使用鼠标按键。

这在基岩版 / Geyser 服务器上能用吗? HomeGui 是一个 Java 版 Fabric 模组。它不支持基岩版。在 Geyser 服务器上,Java 客户端连接该服务器时可以正常使用 —— 通过 Geyser 连接的基岩版客户端无法使用 Fabric 模组。

我能在整合包中使用这个模组吗? 可以。没有任何限制。

更新后收藏夹消失了。这是怎么回事? 偶尔,模组更新会更改配置文件格式。如果您的收藏夹或设置在更新后重置,请检查配置文件——旧数据可能仍然存在于重命名的备份文件中。如果没有,请重新设置您的收藏夹(右键单击)。这种情况很少见,仅发生在配置文件格式发生重大变更时。


为什么存在此功能

我在一个生存服务器上玩,拥有 15 多个家园。农场、磨矿机、不同生物群系中的建筑、商店、下界枢纽——每个地方都设有一个家园。每次游戏会话中,我至少会输入 30-40 次 /home 命令。这样做已经好几年了,直到有一天我意识到:我花在输入指令上的时间比实际玩游戏的时间还要多。

我一直在寻找一款能提供可视化家园界面的客户端模组。但没找到。虽然有一些服务端插件可以添加图形用户界面(GUI),但这些需要服务器管理员安装和配置它们。在大多数服务器上,你无法控制管理员安装了哪些插件。

于是我自己开发了一个客户端解决方案。它读取服务器通过聊天信息提供的现有家园数据,并将其封装成一个 GUI。无需更改服务器端设置,也无需管理员权限。只需安装模组,按下 H 键,你的所有家园就会显示出来。

第一次使用它的那一刻——按下 H,看到以网格形式排列的所有家园,点击“基地”后瞬间传送——我就知道再也回不去手动打字的日子了。这是一种一旦尝试过就无法回头的体验,用过之后,老方法显得荒谬至极。


路线图

  • 游戏内设置菜单(无需手动编辑 JSON)
  • 为每个家园自定义图标(选择物品来代表每个家园)
  • 家园分组/文件夹(整理农场、建筑等)
  • GUI 中支持拖拽排序
  • 家园彩色标签
  • 快捷切换热键栏集成(全局分配家园到特定按键)
  • 多账号配置同步
  • Forge 移植版(如果有需求的话)

功能在可用时发布。没有预计完成时间(ETA)。GitHub 问题决定优先级。


支持

  • Bug 反馈:通过 GitHub Issues 提交——请附上你的 Fabric 版本、HomeGui 版本、服务端插件类型(EssentialsX / CMI / 其他),以及问题的截图
  • 功能建议:通过 GitHub Issues 或 Discord 提交
  • 评价:如果 HomeGui 帮你避免了成千上万次输入 /home,请留下一个评价。这是帮助其他玩家发现本模组最重要的方式。

由一位厌倦了反复输入 /home 的人开发。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源