齿轮观测仪

齿轮观测仪

一个经典RPG角色界面紧挨着你的物品栏:你的英雄站在基座上,饰品环绕其周围,所有属性集中显示在实时更新的卷轴上。

Gearscope

🛡️ 一眼看全你的英雄。 Gearscope 在原版物品栏旁添加了一个经典 RPG 角色界面:你的角色站在底座上,盔甲和饰品放置在它们该在的位置,完整的物品栏与合成界面,以及你拥有的每一项属性——整齐地分组在一卷羊皮纸上,并在你更换装备时实时更新。

🔎 概览

参数 规格
🎮 Minecraft 1.21.1
⚙️ Modloader NeoForge
🖥️ Side 客户端与服务端(两端均需安装)

🤝 兼容 Accessories(包括通过 Accessories Compatibility Layer 的 Curios)、Accessorify、Apothic Attributes、Better Party、JEI、Polymorph、Quark、Sophisticated Backpacks、Mouse Tweaks、Inventory Sorter——均为可选


⚔️ 角色界面

通过其专属按键绑定打开(默认未绑定,见 控制 → Gearscope);再次按下同一按键即可关闭。E 键打开的原版物品栏保持原样——Gearscope 是替代方案,而非取代。想让 Gearscope 使用 E 键?将原版物品栏移到另一个按键(例如 Shift+E),并开启 closeContainersWithKey,这样 E 仍能关闭箱子和其他容器。

  • 你的真实角色站在中央的底座上,并跟随你的鼠标。你穿戴的一切都会立即显示在模型上。
  • 盔甲和副手位于左侧的雕花木条中,背部槽位(例如背包)就在其正下方。
  • 饰品放置在角色周围它们所属的位置,分为两列,各四行,位于壁龛两侧——项链和披风在肩部,戒指和手套在手部,腰带和护符在腰部,鞋子和脚镯在脚部。有两个槽位的槽位类型在每侧各有一个位置。右侧的第二个条带放置帽子、面部和手腕槽位。
  • 其他所有内容进入物品栏旁的分组标签页(工具、信息、存储、箭矢……)——使用鼠标滚轮在标签页间滚动。来自其他模组的未知槽位会进入"其他"标签页,因此不会丢失任何东西。
  • 仅显示你能使用的槽位——与 Accessories 自己的界面一样,你背包中没有任何物品能放入的槽位类型会被隐藏(Accessories 的"显示未使用槽位"开关可将它们恢复)。持有物品的槽位始终显示。
  • 完整物品栏、快捷栏和 2×2 合成——自由移动物品、Shift 点击、双击、快捷栏按键,一切如常。
  • 外观模式——一个按钮将所有饰品槽位(以及外观盔甲)切换为外观变体。外观槽位带有紫色边框,以便你随时知道自己处于哪种模式。
  • 在角色上显示或隐藏——每个饰品槽位的右上角都有来自 Accessories 界面的小开关:隐藏那顶帽子而无需将其取下。

📜 卷轴上的属性

  • 你拥有的每一项属性,分为 进攻、远程、防御、魔法、移动、实用 和 其他。现成的分组覆盖原版、Apothic Attributes、Artifacts、Spell Engine / Spell Power、More RPG Classes、L_Ender's Cataclysm 等。
  • 实时数值——装备一枚戒指,观察数字变化。优于基础值为绿色,更差为红色(即使对于越低越好的属性也是如此)。
  • 可折叠分组和 "隐藏未变化" 复选框——两者都会被记住。
  • 属性图标会自动从资源包中读取(与 Apothic Attributes 相同的图标路径)。
  • 安装 Apothic Attributes 后,悬停某一行会显示熟悉的详细提示:描述、基础值/最小值/最大值、每个修饰符及其来源以及完整公式。在 Apothic 配置中隐藏的属性在 Gearscope 中也会保持隐藏。

✨ 激活效果

你的药水和增益效果也在这里——图标、名称及等级和剩余时间(无限效果显示 ∞),有益效果为绿色,有害效果为红色,如果资源包提供描述,还会显示效果描述的提示。在客户端配置中选择它们的显示方式:

  • 标签页(默认)——卷轴顶部的"属性"和"效果"标签页,带有激活效果的小计数器。
  • 分组——属性列表顶部的"效果"分组,可像其他分组一样折叠。
  • 顶部——Gearscope 框架上方的一行效果方块(如果框架上方空间不足,会自动切换到标签页)。
  • 关闭——不显示效果。

🤝 模组兼容性

  • Accessories——所有槽位类型在运行时读取,因此可与所有 Accessorify 槽位模式以及通过 Accessories Compatibility Layer 的 Curios 槽位配合使用。界面打开时槽位数量可能变化(例如添加戒指槽位的物品)——Gearscope 会重建自身而不会丢失光标上的物品。
  • JEI——点击合成箭头查看合成配方,并使用 + 按钮将 2×2 配方直接放入网格。
  • Polymorph——配方选择按钮出现在合成结果旁。
  • Sophisticated Backpacks——在任何 Gearscope 槽位中右键点击背包(或使用其按键),包括背部槽位,即可打开它;关闭背包后会直接回到 Gearscope。
  • Mouse Tweaks——拖拽功能有效,滚轮功能在 Gearscope 中被关闭(它与饰品槽位配合不佳)。
  • Inventory Sorter——中键点击可整理物品栏;盔甲、副手、合成和饰品槽位不受影响。
  • Quark——扩展物品交互在 Gearscope 中同样有效:交换盔甲、将物品放入潜影盒,以及右键点击物品栏或快捷栏中的潜影盒直接打开它(Quark 的配置开关和"反转点击"均适用)。关闭后会回到 Gearscope。
  • Accessorify——右键点击潜影盒槽位中的潜影盒或已装备的末影箱即可打开它,就像 Accessorify 自己的选择控件一样。左键仍可将其取出;关闭后会回到 Gearscope。
  • Better Party——队伍按钮位于外观按钮旁(它遵循 Better Party 的"物品栏按钮"设置和图标),并打开队伍界面;关闭后会回到 Gearscope。

🎨 为整合包打造

一切都是数据驱动的,可通过资源包更改——无需代码:

  • assets/gearscope/gearscope/layout.json——每个区域、槽位和按钮的位置。
  • assets/gearscope/gearscope/slot_places.json——哪个饰品槽位类型对应角色周围的哪个位置。一些位置留给你自己的槽位类型(外侧肩部位置、右侧条带中的三个位置)。所有位置名称列在 布局文档 中。
  • assets/<namespace>/gearscope/attribute_groups.json——哪个属性属于哪个分组。所有包中的文件会被合并,因此你只需添加自己的条目。
  • 背景、槽位边框和图标可像任何其他纹理一样替换。

📐 小窗口

Gearscope 需要 480×270 的 GUI 区域。如果在你的 GUI 缩放下放不下(例如 1080p 窗口下 GUI 缩放为 4),它会在界面打开时临时降低 GUI 缩放,并在之后恢复。可在配置中关闭。

📌 须知

  • 客户端和服务端均需安装。 Gearscope 是一个真正的容器界面,因此服务端也需要它。
  • 外观盔甲使用了不属于 Accessories 官方 API 的类。如果未来的 Accessories 更新更改了它们,Gearscope 会关闭外观盔甲并记录一次日志——你的游戏会继续运行。
  • Quark: Quark 的排序按钮不会添加到 Gearscope 中(请改用 Inventory Sorter)。
  • 通配符物品: 一些模组将物品标记为可放入每一个饰品槽位(例如标记为 curios:curio 的 Curios 物品)。在 Accessories 自己的界面中,这会使每个槽位类型都被视为已使用;Gearscope 默认在此检查中忽略此类物品,因此像脚镯这样的空槽位类型会保持隐藏。物品本身仍可放入每个可见槽位。

⚙️ 配置

  • config/gearscope-client.toml:效果显示模式、自动 GUI 缩放、使用 Gearscope 按键关闭其他容器、隐藏属性(支持 namespace:* 和 ! 例外——无论是否安装 Apothic Attributes 均可使用)、"隐藏未变化"和折叠的分组。
  • config/gearscope-common.toml:ignoreWildcardItemsForUsedSlots(默认开启)——关闭它以精确显示 Accessories 自己界面显示的槽位。

🙏 致谢

  • 属性提示和数值颜色改编自 Shadows_of_Fire 的 Apothic Attributes(MIT)。
  • 基于 Wispforest 的 Accessories API(MIT)构建;外观槽位处理遵循 Accessories 自己的槽位。
  • 灵感来自 CappleApple 的 Character Not Container(仅创意,未使用代码)。
  • 安装 Better Party 时,其队伍按钮使用 Better Party 自己的纹理,在运行时从 Better Party 加载——Gearscope 不附带任何这些纹理。
  • 改编代码的许可证文本包含在模组 jar 中(THIRD_PARTY_NOTICES.md)。
  • Gearscope 是一个非官方伴侣,与这些模组均无关联。
  • 源代码在 GitHub 上,采用 MIT 许可证。欢迎在 问题追踪器 或评论中提交错误报告和建议。