创造者快捷栏

概述

CreatorHotbar 是一款快捷栏管理工具，同时支持创造模式和生存/冒险模式。使用滚轮或拾取热键可以快速在大量预设行或物品栏行之间切换，即取即用。

所有快捷键都可在游戏内的按键绑定设置中自定义。在创造模式下按下 H 键可打开设置面板。

---

创造模式

多页面预设系统

• 支持多个页面，每页独立存储 9 行 × 9 格物品预设
• 页面数量无上限——可添加、删除或清空页面，删除和清空操作有二次确认
• 每页可拥有独立的有效行数（1-9 行）。行数较少时靠下排列，上方行自动禁用

三种写入策略

• 完全替换 (REPLACE_ALL)：用预设内容完全覆盖快捷栏
• 跳过空预设 (NON_EMPTY_ONLY)：仅覆盖预设非空的快捷栏格子
• 插入空槽位 (EMPTY_ONLY)：仅写入快捷栏中的空格子

Tab 拾取模式

按住 Tab 可释放鼠标光标，在 HUD 上自由移动；悬停的行/槽位自动高亮。松开 Tab 即可切换到该行并选定该槽位。该键可在按键绑定中自定义。

键盘与滚轮操作

操作	按键	说明
切换选中行	modifier + 滚轮	在当前页面有效行中循环切换，立即生效
切换写入策略	modifier + 小键盘 0	在三种策略间循环切换
翻页	Ctrl + 滚轮	切换预设页面
选中行上移/下移	小键盘 - / +	在有效行中上/下移动选中行（无需 modifier 键）
打开设置	H	打开设置面板

预设配置面板

在创造模式物品栏右侧显示一个 9×9 的预设编辑面板：

• 悬停物品可显示提示信息
• 左键点击可拿取/放置，右键点击可拆分，中键点击可复制面板内的物品
• Shift + 左键点击 直接删除预设槽位中的物品（无需将其拖出）
• 点击面板上方的标签栏可切换页面；“+ ”标签用于添加页面
• 面板右侧的 ↑↓ 按钮可调整页面顺序；+- 按钮调整行数；C 清空页面；X 删除页面
• Ctrl + 点击 C / X 可跳过确认弹窗直接执行
• 点击底部按钮栏最左侧的 ⇳ 按钮，然后按住并拖动可在屏幕上重新定位面板
  • 设置页面中的“重置面板位置”按钮可一键将面板恢复至默认位置
• 点击底部按钮栏的 S 按钮可打开预设保存/加载界面：
  • 左侧：文件名输入框 + 保存按钮 + 9×9 网格预览 + ← → 导航按钮
  • 右侧：本地文件列表（支持滚动、R 重命名、X 删除）+ 选中文件预览 +“追加为新页面”按钮
  • 文件存储在 creatorhotbar/presets/ 目录下

HUD 显示

• 支持四种位置：右下、快捷栏右侧、居中、快捷栏上方
• 支持“极简风格”外观：使用半透明黑色矩形代替原生快捷栏纹理，槽位间距自然形成网格线
• 支持 4 种显示模式：
  • 始终显示 (ALWAYS_ON)：始终完全不透明
  • 自动隐藏 (AUTO_HIDE)：不按住 modifier 键时隐藏，按住时完全可见
  • 显示半透明 (SHOW_SEMI)：不按住 modifier 键时隐藏，按住时半透明（40%）
  • 半透明 (SEMI_TRANSPARENT)：始终可见，不按住 modifier 键时半透明（40%），按住时完全可见
• 支持缩放（自动 / 1x / 2x / 3x / 4x）
• 选择框可设置为“始终显示”或“仅按住 modifier 键时显示”
• 在面板/HUD 中，绿色框表示当前选中的行，黄色框表示正在交换的行

视觉同步

一种特殊模式。启用后，HUD 和面板中当前选中的行不再显示预设物品，而是实时反映当前的快捷栏内容。切换行时，会自动将当前快捷栏保存到原预设行，然后加载目标行。面板中的该行会覆盖一层浅灰色，表示处于同步状态。新安装时此模式默认启用。

---

生存/冒险模式

物品栏行交换

基于物品栏的 4 行（3 行物品栏 + 1 行快捷栏）。按住 modifier 键 + 滚轮可切换目标行，松开即可完成交换。按下小键盘上的 1 可立即切回主快捷栏。

HUD 显示

• 显示 4 行（物品栏行 1-3 + 快捷栏）。HUD 在切换过程中保持静态
• 自动检测重叠区域，并在重叠时上移以避免遮挡

---

通用

• 所有快捷键都可在按键绑定设置中自定义
• 支持 JEI 列表自动避开面板区域
• 支持中文和英文语言