HomeGui

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

你每次游戏要输入二十次/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 <名称>指令——只是瞬间完成，无需你输入任何内容。

这意味着：

适用于任何使用家指令系统的服务器
无需安装服务器端
无需修改权限
服务器管理员无需配置
你的家就是服务器已经知道的那些家

兼容的服务器插件

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类别下的选项重新映射。

安装

一分钟内完成。无需配置。

安装 Fabric Loader（适用于Minecraft 1.21.4） → fabricmc.net/use/installer
安装 Fabric API → modrinth.com/mod/fabric-api → 放入 /mods/ 文件夹
从本页面下载 HomeGui.jar → 放入 /mods/ 文件夹
使用Fabric配置文件启动Minecraft
加入一个拥有家系统的服务器（EssentialsX、CMI等）
按 H 查看你的家

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

系统要求

Minecraft Java版 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上提交一个issue，并附上聊天响应的截图。

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

它适用于EssentialsX的/home <数字>格式吗？ 是的。EssentialsX同时支持命名家和数字编号的家。HomeGui读取服务器/homelist响应所使用的任何格式。

我有100多个家。GUI会卡吗？ 不会。GUI渲染分页网格。任何时候只有可见的家被渲染。从性能角度看，100个家和10个家的加载与显示方式相同。

我能更改H键的绑定吗？ 可以。Minecraft控制菜单 → HomeGui类别 → 将"打开家GUI"重新绑定为你想要的任何按键。有些玩家用G，有些用N，有些用鼠标按钮。

这适用于基岩版/Geyser服务器吗？ HomeGui是一个Java版Fabric模组。它不适用于基岩版。在Geyser服务器上，它适用于连接到该服务器的Java客户端——通过Geyser连接的基岩版客户端无法使用Fabric模组。

我能在整合包中使用这个吗？ 可以。无限制。

更新后收藏夹消失了。发生了什么？ 偶尔，模组更新会更改配置文件格式。如果更新后你的收藏夹或设置重置了，检查配置文件——旧数据可能仍以重命名的备份文件形式存在。如果没有，重新设置你的收藏夹（右键点击）。这种情况很少见，且仅发生在主要配置格式变更时。

为什么存在

我在一个生存服务器上游玩，有15个以上的家。农场、刷怪塔、不同生物群系的建筑、商店、下界枢纽——每个都设置了一个家。每次游戏我至少输入30-40次/home。我已经这样做了很多年，有一天我意识到：我花在输入指令上的时间比实际玩游戏的时间还多。

我寻找一个能提供可视化家界面的客户端模组。没找到。有些服务器端插件添加了GUI，但需要服务器管理员安装和配置。在大多数服务器上，你无法控制管理员安装什么插件。

所以我构建了一个客户端解决方案。它读取服务器已经通过聊天提供的家数据，并将其包装在GUI中。无需更改服务器。无需管理员权限。你安装它，按H，你的家就在那里。

我第一次使用它的时候——按下H，看到所有家在一个网格中，点击"base"，瞬间传送——我知道我再也回不去手动输入了。这是一件一旦尝试，旧方法就显得荒谬的事情。

开发路线图

游戏内设置菜单（无需手动编辑JSON）
每个家自定义图标（选择一个物品代表每个家）
家分组/文件夹（整理农场、建筑等）
GUI中拖拽重新排序
家颜色标签
快捷切换快捷栏集成（全局将家分配给特定按键）
多账户配置同步
Forge移植（如有需求）

功能在可用时发布。无具体时间表。GitHub的issue驱动优先事项。

支持

Bug报告：GitHub Issues——请注明你的Fabric版本、HomeGui版本、服务器插件类型（EssentialsX/CMI/其他），并附上问题的截图
功能请求：GitHub Issues或Discord
评价：如果HomeGui让你免于输入一万次/home，请留下评价。这是帮助其他玩家找到这个模组的最大推动力。

由一个厌倦了输入/home的人打造。