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 类别进行重新映射。
安装
不到一分钟。无需配置。
-
为 Minecraft 1.21.4 安装 Fabric Loader
→ 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 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 的人开发。
HomeGui
Thank you very much for Elfi for the project icon!
You Type /home Twenty Times Per Session. There's a Better Way.
Open any survival Minecraft stream right now. Watch the chat. You'll
see it: /home, /home base, /home farm, /home nether, /home shop, /home
base, /home farm again. Every few minutes. For hours. It's muscle
memory at this point and nobody questions it because "that's just how
you teleport home."
But it's slow. You have to stop what you're doing. Open chat. Type the
command. Sometimes you misspell it. Sometimes you forget the name. On
servers with 10+ homes, you end up tab-completing through a list that
scrolls off screen.
HomeGui replaces all of that with one keybind and one click.
Press H. See all your homes in a clean grid. Click the one you want.
You're there. Three seconds instead of ten. No chat spam. No typos.
No forgetting names. No stopping your flow.
How It Works
HomeGui is a client-side Fabric mod. It does not replace or modify your
server's home system — it reads from it. The server (EssentialsX, CMI,
or whatever home plugin it runs) stores your homes. HomeGui reads that
data and presents it in a graphical interface on your client.
That's the important thing: HomeGui is a VISUAL LAYER on top of your
existing home system. It doesn't create its own separate home database.
It doesn't conflict with the server's plugin. It doesn't send commands
differently than you would manually. When you click a home in the GUI,
it sends the same /home <name> command that you'd type in chat — it
just does it instantly, without you typing anything.
This means:
- Works on ANY server that uses a home command system
- No server installation required
- No permission changes needed
- No configuration for server admins to do
- Your homes are the same homes the server already knows about
Compatible Server Plugins
HomeGui detects and works with:
- EssentialsX — The most common home plugin. Full support.
- CMI — Another popular choice. Full support.
- Any plugin using standard /home commands — HomeGui monitors your
home list through the chat responses these plugins send. If a plugin
responds to /homelist or /homes with a formatted list, HomeGui parses
it.
Not sure if your server's plugin works? Install HomeGui and run
/homelist or /homes in chat. If the server responds with a list of
your homes, HomeGui can read it.
Features — Complete Breakdown
Visual Home Grid
When you press H, a clean grid interface opens showing every home you
have saved. Each home appears as an item in the grid with:
- The home name displayed below the item
- An icon (configurable — defaults to a compass or bed based on context)
- Visual indicators for favorites and recent homes
- Smooth hover animation when your cursor is over a home
The grid handles any number of homes. 5 homes? Fits in one page.
50 homes? Scrollable with smooth momentum. The layout auto-adjusts
to fill the available space cleanly.
One-Click Teleport
Click a home. You teleport. That's the entire interaction.
No confirmation dialog (unless you enable one in settings). No "are you
sure?" popup. No secondary menu. Click and go. The teleport command
fires instantly, the GUI closes, and you're at your destination.
If you want a confirmation step for expensive teleports (servers with
teleport cooldowns or costs), you can enable a confirmation toggle in
settings.
Favorites
Right-click any home to mark it as a favorite. Favorited homes appear
at the top of the grid with a gold star indicator. This is for the
homes you use constantly — your base, your farm, your shop.
One right-click. That's it. Right-click again to unfavorite.
Favorites persist across sessions. They're stored in the local config
file on your client.
History
The mod tracks which homes you've teleported to recently. A "History"
section at the top of the GUI shows your last 10 teleports in reverse
chronological order. Click to teleport to a recent home without
scrolling through your full list.
This is useful when you're bouncing between two or three homes during
a building session — base to farm, farm to base, base to shop. The
history section keeps them within one click at all times.
Keyboard Shortcuts
When the GUI is open, keys 1-9 map to the first 9 homes in your list.
Press 1 to teleport to the first home. Press 5 for the fifth. This
is for power users who've memorized their home order and want sub-
second teleportation.
The shortcuts map to the visual order in the GUI — favorites first,
then the rest. Reorder by adjusting favorites, and the shortcuts
follow.
Search
A search bar at the top of the GUI. Type to filter homes by name.
The list updates in real time as you type. Useful when you have dozens
of homes and need to find one fast.
Search clears when you close the GUI. Next time you open it, you see
everything again.
Themes
Five built-in color themes for the GUI:
- Purple — Deep purple with violet accents (default)
- Ocean — Blue tones with teal highlights
- Forest — Green with earthy brown borders
- Sunset — Warm orange and pink gradient
- Cherry — Soft pink with white accents
Switch themes in the config file or through the in-game settings
(coming soon). Themes change the background, borders, text colors,
and accent elements. Every theme is designed to look good on any
monitor and not clash with your resource pack.
Statistics
The mod tracks basic statistics locally:
- Total teleports performed through HomeGui
- Most teleported-to home
- Teleports per session
- Total sessions tracked
A stats panel in the GUI shows your numbers. Some players find it
interesting. Some ignore it entirely. It's there if you want it.
Stats are stored locally in the config file. They're yours — nothing
is sent anywhere.
Preferences Persistence
Everything you configure is saved automatically:
- Theme selection
- Favorite homes
- GUI position and scale
- Confirmation toggle
- History entries
- Keyboard shortcut mappings
- Stats data
All stored in a single JSON config file:
.minecraft/config/homegui.json
Delete this file to reset everything to defaults. Edit it manually if
you want (it's readable JSON). Back it up if you're switching machines
and want to keep your favorites.
Who Is This For?
Survival Multiplayer Players
If you play on an SMP server with a home system, you use /home dozens
of times per session. HomeGui makes every one of those teleports faster
and more pleasant. It adds up — over a two-hour session, you might save
a few minutes of cumulative chat typing and waiting. But more than the
time, it's the flow. You don't stop what you're doing to type a
command. You press H, click, and keep going.
Players With Many Homes
Some players have 5, 10, 20+ homes. A base, a farm for every crop, a
mob grinder, a nether hub, a shop district, builds in different biomes.
Managing all of those through chat commands is tedious. The search
function, favorites, and history make a large home list manageable.
Players Who Forget Home Names
You named it "base" six months ago. Or was it "main"? Or "home"? Or
"base1"? With HomeGui, you see all your homes visually. You recognize
them by context, position, and favorites. Name memory becomes
irrelevant.
Players Who Share Screens / Stream
Chat full of /home commands doesn't look great on stream. A clean GUI
overlay looks professional. Some streamers use HomeGui partly for the
visual cleanliness of their content.
Players on Servers With Teleport Costs
If your server charges for teleportation or has cooldowns, you want
each teleport to count. Clicking the right home instantly is less
error-prone than typing, especially when you're tired or distracted.
No more accidentally teleporting to the wrong home because you
misspelled it.
Performance & Architecture
HomeGui is designed to be invisible to your system.
Client-side only:
- Zero server impact
- Zero network packets sent (beyond the standard /home command)
- Zero server-side processing
- The server doesn't know HomeGui exists
Resource usage:
- The GUI renders only when open — no background rendering
- No tick loops, no scheduled tasks, no polling
- History and favorites stored in memory as a small list
- Config file is read once at startup, written on change
- FPS impact: zero when GUI is closed, negligible when open (standard
inventory-style screen rendering)
Compatibility with other mods:
- Does not modify Minecraft's rendering pipeline
- Does not inject into the chat system beyond reading responses
- Does not touch network packets
- Works alongside Sodium, Iris, OptiFine, and any client mod
- No known conflicts with any mod
Controls
| Action |
Default Key |
Notes |
| Open Home GUI |
H |
Remappable in Minecraft Controls |
| Teleport to home |
Left Click on home item |
Closes GUI and teleports |
| Favorite / Unfavorite |
Right Click on home item |
Star indicator toggles |
| Quick teleport (1-9) |
Number keys 1-9 |
Maps to first 9 homes in list |
| Search |
Type in search bar |
Real-time filtering |
| Close GUI |
Escape |
Standard behavior |
All keybinds are remappable through Minecraft's controls menu under the
HomeGui category.
Installation
Under one minute. No configuration needed.
-
Install Fabric Loader for Minecraft 1.21.4
→ fabricmc.net/use/installer
-
Install Fabric API
→ modrinth.com/mod/fabric-api
→ place in /mods/ folder
-
Download HomeGui.jar from this page
→ place in /mods/ folder
-
Launch Minecraft with the Fabric profile
-
Join a server with a home system (EssentialsX, CMI, etc.)
-
Press H to see your homes
First launch: the mod reads your home list from the server's chat
response when you join or when you open the GUI for the first time.
If no homes appear, type /homelist or /homes in chat once to let the
mod parse the server's response. After that, it works automatically.
Requirements
- Minecraft Java Edition 1.21.4
- Fabric Loader
- Fabric API
- A server with a home command system (EssentialsX, CMI, or compatible)
No server installation required. The mod runs entirely on your
client and interacts with the server's existing home commands.
Configuration
The config file at .minecraft/config/homegui.json controls:
{
"theme": "PURPLE",
"showConfirmDialog": false,
"showStatistics": true,
"showHistory": true,
"maxHistoryEntries": 10,
"guiScale": 1.0,
"keybindOpenGui": "H",
"favorites": ["base", "farm", "shop"],
"history": []
}
Every setting is self-explanatory. Edit the file directly or wait for
the in-game settings menu (roadmap). Changes take effect on next GUI
open — no restart needed.
FAQ
Does the server need to install HomeGui?
No. Never. 100% client-side. The server runs its home plugin
(EssentialsX, CMI, whatever). HomeGui reads the home list from chat
responses and sends /home commands when you click. The server doesn't
know HomeGui exists.
Will I get banned for using this?
HomeGui sends the same /home command you'd type manually. It doesn't
modify packets, inject into the server, or do anything a player
couldn't do with their keyboard. No anti-cheat will flag it because
the output is identical to normal gameplay. That said, check your
specific server's rules — some servers have blanket mod bans.
It's not detecting my homes. What do I do?
HomeGui reads homes from the server's chat responses. If your server
uses a non-standard home plugin that formats its /homelist response
differently, the parser might not catch it. Try typing /homelist or
/homes in chat and see what the server responds. If it shows a
formatted list but HomeGui doesn't pick it up, open a GitHub issue
with a screenshot of the chat response.
Can I use this on Hypixel / a server that doesn't have homes?
HomeGui requires a server-side home system. If the server doesn't have
a /home command, there's nothing for the mod to interface with. It
won't cause errors — it just won't have any homes to show.
Does it work with EssentialsX's /home <number> format?
Yes. EssentialsX supports both named homes and numbered homes. HomeGui
reads whatever format the server's /homelist response uses.
I have 100+ homes. Will the GUI lag?
No. The GUI renders a paginated grid. Only the visible homes are
rendered at any time. 100 homes loads and displays the same as 10
homes from a performance perspective.
Can I change the keybind from H?
Yes. Minecraft Controls menu → HomeGui category → rebind "Open Home
GUI" to whatever you want. Some players use G, some use N, some use a
mouse button.
Does this work on Bedrock / Geyser servers?
HomeGui is a Java Edition Fabric mod. It does not work on Bedrock
Edition. On a Geyser server, it works for Java clients connecting to
that server — Bedrock clients connected through Geyser cannot use
Fabric mods.
Can I use this in a modpack?
Yes. No restrictions.
Favorites disappeared after an update. What happened?
Occasionally, mod updates change the config file format. If your
favorites or settings reset after an update, check the config file —
the old data may still be there in a renamed backup file. If not,
re-set your favorites (right-click). This is rare and only happens on
major config format changes.
Why This Exists
I play on a survival server where I have 15+ homes. Farms, grinders,
builds in different biomes, shops, a nether hub — each one has a
home set. Every session I type /home at least 30-40 times. I've been
doing this for years and one day I realized: I'm spending more time
typing commands than actually playing the game.
I looked for a client-side mod that gave me a visual home interface.
Couldn't find one. There were server-side plugins that added GUIs, but
those require the server admin to install and configure them. On most
servers, you can't control what plugins the admin installs.
So I built a client-side solution. It reads the home data that the
server already provides through chat and wraps it in a GUI. No server
changes needed. No admin permission needed. You install it, press H,
and your homes are there.
The moment I first used it — pressed H, saw all my homes in a grid,
clicked "base," teleported instantly — I knew I couldn't go back to
typing. It's one of those things where once you try it, the old way
feels absurd.
Roadmap
- In-game settings menu (no manual JSON editing)
- Custom icons per home (choose an item to represent each home)
- Home groups / folders (organize farms, builds, etc.)
- Drag-to-reorder in the GUI
- Color labels for homes
- Quick-switch hotbar integration (assign homes to specific keys globally)
- Multi-account config sync
- Forge port (if demand exists)
Features ship when they work. No ETAs. GitHub issues drive priorities.
Support
- Bugs: GitHub Issues — include your Fabric version, HomeGui
version, server plugin type (EssentialsX/CMI/other), and a
screenshot of the issue
- Feature requests: GitHub Issues or Discord
- Reviews: If HomeGui saved you from typing /home ten thousand
times, leave a review. It's the single biggest thing that helps
other players find this mod.
Built by someone who got tired of typing /home.
评论 0
登录后参与评分
还没有评论,来抢沙发吧