终极快捷栏

UltimateHotbars

UltimateHotbars 是一个 Minecraft Forge 模组（1.20.1 / Forge），为你提供几乎无限的自定义快捷栏和页面。可轻松在游戏内或任意物品栏界面之间切换，保存和恢复布局，让你的工具、装备和资源井然有序！

不再必要，因为 V2 现在会在世界文件夹中创建新的 hotbars.dat 文件，不再全局共享。 这是模组的全新版本 2。版本 1 将不再维护或更新，因此请切换到 V2 分支/版本。 如果你是从 V1.x.x 升级而来，请在配置菜单中点击 Purge Data Files 按钮，因为快捷栏数据文件不兼容，否则会一片混乱。 （抱歉，你的快捷栏只能重新开始设置。）

V2.1.x 在物品栏/容器界面中新增快捷栏叠加层。 支持从创造模式物品栏或 JEI 拖放。

---

🌟 功能特性

• 虚拟快捷栏与页面 每页最多可创建 100 个快捷栏（可配置），页面数量不限。
• 快捷栏弹出预览 按住 ALT（默认，可更改）可弹出当前页面的快捷栏列表。你可以点击槽位切换到该快捷栏、通过页面列表切换页面，并支持拖放。
• 快捷栏叠加层 物品栏、箱子、铁砧等界面……你可以在这些界面中直接与快捷栏交互。
• 无缝切换 在 GUI 和容器内通过按键绑定切换快捷栏或页面。
• 持久存储 你的布局会在会话之间自动保存和加载。
• 快速清空 按一个键即可立即清空当前快捷栏。
• 可配置音效与 HUD 可选的点击音效、屏幕页面标签、调试叠加层和颜色主题。

---

🎮 默认按键绑定

操作	按键
打开/关闭快捷栏 GUI	h
下一个快捷栏	=
上一个快捷栏	-
下一页（Ctrl + =）	Ctrl + =
上一页（Ctrl + -）	Ctrl + -
清空当前快捷栏	Delete
快捷栏弹出	Alt

提示： 你可以在控制菜单中重新绑定所有这些按键。

---

⚙️ 配置选项

可通过快捷栏 GUI 中的游戏内 Config 按钮访问，或编辑 config/ultimatehotbar-client.toml。

选项	默认值	描述
enableSounds	true	切换快捷栏或页面时播放点击/鼓声音效。
maxHotbarsPerPage	20	每页可容纳的快捷栏数量（1–100）。
showDebugOverlay	false	绘制额外调试信息（用于排查问题）。
showHudLabel	true	在 HUD 上显示“Pg 1/3”样式的标签。
showHudLabelBackground	true	为 HUD 标签文字启用背景。
highlightColor	[1,1,0,0.8]	GUI 中选中快捷栏高亮的 RGBA 颜色。
hudLabelBackgroundColor	[0,0,0,0.5]	HUD 标签背景的 RGBA 颜色。
hudLabelTextColor	[1,1,1,1]	HUD 标签文字的 RGBA 颜色。
hoverBorderColor	[1,1,1,1]	GUI 中槽位悬停边框的 RGBA 颜色。
scrollThrottleMs	50	滚动/按键重复之间的延迟（10–150 毫秒），以避免重复。

• 滚动节流 可调整的延迟，用于防止快速滚动时出现重复/覆盖。如果你真的想，可以降低延迟，但可能会弄乱你的快捷栏。 如果你的快捷栏出现相互复制覆盖的情况，请调高此数值，但默认值对大多数系统应该没问题——加入此选项只是为了以防你的滚动速度超过系统的 I/O 速度。

---

💡 使用方法

1. 打开快捷栏 GUI，使用你配置的按键（默认 h）。
2. 通过左侧的按钮 添加/移除页面 或 快捷栏。
3. 在 GUI 中 拖放 物品以重新排列。
4. 鼠标滚轮 或使用（默认 -、=）或 ⬆️/⬇️ 键 切换快捷栏。
5. 在页面列表上 鼠标滚轮 或 Ctrl + -/= 翻页。
6. Delete 键立即清空当前快捷栏。
7. 按 Esc 键 关闭 GUI。
8. 快捷栏弹出 按 ALT 快速查看快捷栏并与之交互。

许可证

本项目采用 MIT 许可证——详情请参阅 LICENSE。