扩展快捷栏

扩展快捷栏

一个 Hytale 服务器插件，扩展了快捷栏系统，支持多个可切换的快捷栏并带有自定义命名功能。

Hytale Update 3 (v0.3.17) 更新版本

---

概述

扩展快捷栏为玩家提供最多 9 个可切换的快捷栏（共 81 个格子！），支持自定义命名和图形界面，便于管理。非常适合按不同游戏风格整理物品，例如战斗、建筑、挖矿等。

核心功能

✓ 多快捷栏 - 每位玩家最多 9 个可切换快捷栏 ✓ 自定义命名 - 使用如"战斗"、"建筑"、"挖矿"等名称进行分类 ✓ 图形界面 - 易于使用的可视化快捷栏管理器 ✓ 持久化存储 - 所有快捷栏数据自动按玩家保存 ✓ 服务端可配置 - 管理员可控制快捷栏数量和格子限制 ✓ 权限支持 - 精细的指令访问控制

---

快速开始

1. 将 JAR 文件放入服务器的 mods/ 目录
2. 重启服务器（配置文件会自动生成）
3. 玩家使用 /hbm 打开快捷栏管理器
4. 点击快捷栏进行切换，按需重命名

---

指令

/hotbar - 主快捷栏指令

指令	描述
/hotbar	显示当前快捷栏状态
/hotbar --number {1-9}	切换到指定编号的快捷栏
/hotbar --name {名称}	切换到指定自定义名称的快捷栏
/hotbar --setname {名称}	重命名当前快捷栏

示例:

/hotbar --number 2

/hotbar --name Combat

/hotbar --setname "Base Building"

---

/hotbarmenu 或 /hbm - 图形界面

打开快捷栏管理器界面，提供可视化控制：

• 查看所有快捷栏概览（当前显示名称和索引）
• 点击即可在快捷栏之间即时切换
• 重命名快捷栏，使用内置输入字段
• 清除快捷栏名称（需要时）

GUI 大改版，新增物品显示 (v0.3.15)

---

安装

1. 下载插件 JAR 文件
2. 将其放入服务器的 mods/ 目录
3. 重启或启动服务器
4. 配置文件在首次运行时自动生成

---

配置

配置文件位置

mods/Ghraken_ExtendedHotbar/config.json

默认配置

{
  "MaxSlotsPerHotbar": 9,
  "MaxHotbarCount": 9,
  "DefaultSlotsPerHotbar": 9,
  "DefaultHotbarCount": 9
}

配置项说明

配置项	默认值	范围	描述
MaxSlotsPerHotbar	9	1-9	每个快捷栏的最大格子数
MaxHotbarCount	9	1-9	每位玩家拥有的最大快捷栏数量
DefaultSlotsPerHotbar	9	1-9	新玩家的默认格子数
DefaultHotbarCount	9	1-9	新玩家的默认快捷栏数量

推荐设置

注意: 未来版本将扩展游戏界面以支持更多格子。目前：

• 保持 MaxSlotsPerHotbar 为 9（与默认界面匹配）
• 根据偏好调整 MaxHotbarCount 在 1-9 之间

---

权限

可用权限

权限	默认	描述
extendedhotbar.command.hotbar	✓ 允许	访问 /hotbar 指令
extendedhotbar.command.hotbarmenu	✓ 允许	访问 /hotbarmenu 和 /hbm 指令

管理权限

所有权限默认对所有玩家允许。

撤销访问权限:

/perm user remove {uuid} -extendedhotbar.command.hotbar

/perm user remove {uuid} -extendedhotbar.command.hotbarmenu

恢复访问权限:

/perm user add {uuid} -extendedhotbar.command.hotbar

/perm user add {uuid} -extendedhotbar.command.hotbarmenu

---

工作原理

快捷栏同步

• 你的游戏内快捷栏始终与当前激活的扩展快捷栏保持同步
• 切换快捷栏时，会保存当前物品并加载新快捷栏的内容
• 游戏管理当前激活的快捷栏；本插件提供多快捷栏支持

数据持久化

• 切换时自动保存
• 保留空槽位以支持稀疏排列的快捷栏
• 所有数据以 JSON 格式按玩家存储

命名规范

下划线: 使用下划线表示多词名称 示例：Combat_Gear 显示为 "Combat_Gear"

空格: 在指令中使用引号支持 示例：/hotbar --setname "Base Building"

注意：通过 /hotbarmenu 或 /hbm 重命名时，界面会自动处理空格

---

玩家数据存储

存储位置

本地实例 - 数据将存储在世界 mods 中

UserData\Saves\{world}\mods\Ghraken_ExtendedHotbar\playerdata\{uuid}.json

专用服务器 - 数据将保存在服务器 mods 中

\mods\Ghraken_ExtendedHotbar\playerdata\{uuid}.json

存储数据

每个玩家的 JSON 文件包含：

• 快捷栏内容 - 所有非活跃快捷栏的物品 ID 和数量
• 自定义名称 - 所有快捷栏的名称分配
• 当前选择 - 当前选中的快捷栏编号

版本发布

• 0.1.20 - 初始聊天指令版本 - 使用斜杠指令管理快捷栏
• 0.2.12 - 新增 GUI /hotbarmenu - 快捷栏管理界面和附加指令
• 0.2.39 - 重大 GUI 改版 - 重构为使用 Pages，并引入基础游戏的样式
• 0.3.15 - 在 GUI 中添加物品显示 - 现在可以在界面中看到每个快捷栏上的物品
• 0.3.17 - 解决服务器版本目标警告 - Update 3 兼容性修复