Skillslots插件

SkillSlots 扩展模组

SkillSlots 扩展模组是 SkillSlots 的一个 Forge 1.20.1 扩展模组。它将技能轮扩展至最多支持 8 个槽位，增加了可配置的布局和右键行为，并提供了可选的 KubeJS 客户端 GUI 事件。

功能特性

最多 8 个技能槽位

• 将 SkillSlots 的最大槽位数从 4 个提升至 8 个。
• 配置新玩家解锁的槽位数量。
• 保留所有已配置槽位的槽位数据、同步、命令和被动技能扫描功能。

可配置的技能轮布局

• AUTO（自动）：1-4 个槽位使用原始菱形布局，5-8 个槽位使用双行布局。
• DIAMOND（菱形）：尽可能保持原始布局。
• HORIZONTAL（水平）：1-4 个槽位使用居中单行，5-8 个槽位使用双行。
• 可选择隐藏未解锁槽位并自动紧凑排列布局。
• 可选择在悬停技能槽位时显示物品提示。

右键触发开关

可独立启用或禁用以下 SkillSlots 动作：

• 方块右键
• 实体右键
• 物品右键

当方块或实体动作被禁用时，若物品右键处于启用状态，则正常的物品使用后备逻辑仍然可用。

KubeJS 客户端集成

当安装了 KubeJS 时，该扩展模组会提供 SkillSlotsEvents 客户端事件组：

• useGuiOpened（使用 GUI 打开）
• useGuiClosed（使用 GUI 关闭）
• placeGuiOpened（放置 GUI 打开）
• placeGuiClosed（放置 GUI 关闭）

客户端脚本也可以使用 SkillSlotsGui.open()、SkillSlotsGui.close() 和 SkillSlotsGui.isOpen() 来控制技能轮。

GUI 专用按键绑定

该扩展模组为槽位 1-8 注册了独立的 GUI 专用按键绑定。它们仅在 SkillSlots 技能轮打开时响应，不会替代 SkillSlots 自有的全局技能使用按键绑定。

配置

首次启动后，将生成以下文件：

• config/skillslots_addon-common.toml
  • maxSlots（最大槽位数）：1-8，默认 8
  • beginnerSlots（新手槽位数）：0-8，默认 0
  • enableBlockRightClick（启用方块右键）：默认 true
  • enableEntityRightClick（启用实体右键）：默认 true
  • enableItemRightClick（启用物品右键）：默认 true
• config/skillslots_addon-client.toml
  • layoutMode（布局模式）：AUTO、DIAMOND 或 HORIZONTAL
  • hideLockedSlots（隐藏未解锁槽位）：默认 false
  • showItemTooltips（显示物品提示）：默认 true
  • enableClosedWheelShortcuts（启用关闭技能轮时的快捷键）：默认 false

对 maxSlots 和 beginnerSlots 的更改需要重启世界。对于多人游戏，请保持公共配置与服务器一致。

前置要求

• Minecraft 1.20.1
• Forge 47.x
• SkillSlots 2.1.1+forge
• Kiwi（SkillSlots 的前置模组）
• KubeJS 2001.6 或更高版本（KubeJS 集成功能可选）

安装方法

1. 安装 Forge 1.20.1。
2. 安装 SkillSlots 及其必要依赖 Kiwi。
3. 将 SkillSlots 扩展模组的 JAR 文件放入 mods 文件夹。
4. 仅当需要可选的客户端事件或绑定时，才安装 KubeJS。

SkillSlots 是必需的第三方依赖，未捆绑在此扩展模组中。

兼容性

此扩展模组针对 Forge 版 SkillSlots 2.1.1。其 Mixin 依赖于 SkillSlots 的内部实现，因此 SkillSlots 版本变更可能需要更新此扩展模组。

SkillSlots 扩展模组是 QLNPLUS 开发的一个独立的非官方项目，与 Snownee 无关联，也未获得其背书。

许可证

SkillSlots 扩展模组根据 保留所有权利（ARR） 许可证分发。请参阅仓库中的 LICENSE 文件。SkillSlots 是独立项目，拥有自己的许可证和分发条款。