InvTweaks

InvTweaks

一个Minecraft的Fabric模组,让你精确控制拾取、转移和插入物品的数量。按住修饰键点击可留下一个、只取一个,并管理收纳袋。

游戏机制

InvTweaks

更好的 Minecraft 客户端物品栏管理(Fabric)

我制作这个模组是因为我厌倦了总是在容器里摆弄来摆弄去。它处理了游戏中最令人沮丧的部分(至少对我来说),并添加了一些新的生活质量功能。


它做什么?

InvTweaks 是一个客户端 Fabric 模组,为你提供用于物品栏操作的修饰键控制。按住一个键,点击一堆物品,即可移动除 1 个之外的所有物品或恰好 1 个物品。这个核心思想延伸到 Shift 点击、投掷、收纳袋和滚轮转移。我还加入了一个完整的剪贴板系统,用于复制和粘贴物品栏布局,并内置了剪贴板管理器。

它仅限客户端,可在原版服务器上使用。

值得注意的一点:由于 InvTweaks 移动物品的速度比人类可能达到的更快,如果你的服务器监控物品栏转移速度,你可能想提前告知管理员,以免他们以为你在使用作弊客户端。


入门

InvTweaks 开箱即用,具有合理的默认设置。以下是你可以从哪里开始:

  1. 打开你的物品栏并将鼠标悬停在一堆物品上
    • **按住左 Alt + 点击:**拿起除一个之外的所有物品
    • **按住左 Ctrl + 点击:**恰好拿起一个物品
  2. 打开一个箱子,然后对一堆物品尝试 Alt + Shift 点击。除一个之外的所有物品都会转移到另一侧
  3. 在箱子中的物品上向上或向下滚动以转移所有匹配的物品
  4. 在箱子中按 Ctrl+C 复制其布局。将这些物品取出,然后按 Ctrl+V 恢复它
  5. 按 K 打开配置屏幕并探索

默认修饰键:

Windows / Linux Mac 作用
左 Alt 左 Cmd AllBut1 — 移动除一个之外的所有物品
左 Ctrl 左 Ctrl Only1 — 恰好移动一个
右 Alt 左 Option Misc — 投掷一半、填充现有、滚动填充

所有按键都可以在配置屏幕(K)中完全重新绑定。


功能

修饰键调整

InvTweaks 主要使用按键绑定快捷方式工作。没有 GUI 按钮或需要不断点击的东西。在操作期间按住修饰键以改变物品的移动或拾取方式。

点击拾取: 按住 AllBut1(左 Alt / Mac 上的 Cmd)+ 点击一堆物品以拾取除一个之外的所有物品。按住 Only1(左 Ctrl)+ 点击以恰好拾取一个。

Shift+点击转移: 按住 AllBut1 + Shift 点击以将除 1 个之外的所有物品转移到另一侧。按住 Only1 + Shift 点击以恰好转移一个。

收纳袋操作

收纳袋取出: 右键点击收纳袋以取出物品:AllBut1 取出除一个之外的所有物品(一个留在收纳袋中),Only1 恰好取出一个。

收纳袋放入: 用物品左键点击收纳袋(或用收纳袋左键点击物品):AllBut1 放入除一个之外的所有物品,Only1 恰好放入一个。两个方向都有效:物品放入收纳袋和收纳袋放入物品。

投掷调整

投掷一半: 按住 Misc 键(右 Alt / Mac 上的 Option)+ Q 将半组物品丢给那个总是需要你一些食物的朋友。

投掷除 1 个之外的所有物品: 按住 AllBut1 + Q 丢弃除一个之外的所有物品。

两者在物品栏中和第一人称视角下(未打开 GUI)都有效。

滚轮转移

在容器中的物品上向上或向下滚动以将所有匹配的物品转移到另一侧。根据你按住哪些修饰键,有四种模式:

  • 裸滚动: 移动所有物品。
  • AllBut1 + 滚动: 留 1 模式。每堆物品留下一个。
  • Misc + 滚动: 填充现有模式。只补充目标侧的部分堆叠,不会填充空槽位。
  • AllBut1 + Misc + 滚动: 留 1 + 填充现有。我不知道你为什么需要这个,但也许你需要!

填充现有堆叠

按住 Misc + Shift 点击以将一堆物品分配到另一侧相同物品的现有部分堆叠中。

复制/粘贴/剪切

这是重头戏。我一直觉得 Minecraft 物品栏系统能够复制和粘贴会很有益,所以我加上了它。

复制(Ctrl+C): 快照你当前的物品栏或容器布局。记住每个物品、其槽位位置、附魔、药水效果、自定义名称等所有内容。

粘贴(Ctrl+V): 重新排列物品以匹配之前复制并选择的布局。物品按类型和组件匹配,移动到正确的槽位,堆叠会补满至最大。

剪切(Ctrl+X): 复制布局,然后将容器清空到你的物品栏中(或至少能放下的部分)。

撤销(Ctrl+Z): 做了不想要的粘贴或剪切?撤销会恢复之前的状态。

剪贴板系统

你复制的内容会放入一个持久的剪贴板历史记录中,退出游戏后仍然保留。

剪贴板历史浏览器(Shift+Tab): 全屏浏览器,显示你所有保存的布局及物品预览。

收藏: 为任何剪贴板条目加星标以收藏它。收藏受保护免于删除,在历史记录填满时永远不会被移除,并在浏览器中有自己的标签页。将它们用于你经常粘贴的布局,比如你的主存储箱设置、你常用的物品栏配置,随便什么。

死亡快照: 当你死亡时,你的物品栏会自动保存到剪贴板。重生后,找到并拾取你的死亡掉落物,然后你可以粘贴回你旧的布局。

容器支持

容器被分类为不同类别并得到适当处理:

标准容器(箱子、大箱子、潜影盒、末影箱、木桶) 完全复制/粘贴。潜影盒和末影箱有自己的剪贴板类别,因此你的末影箱布局不会覆盖你的大箱子布局。

小型容器(发射器、投掷器、工作台、合成器、漏斗、熔炉、高炉和烟熏炉) 每个都有自己的剪贴板类型。粘贴使用均匀分配而不是堆叠最大化。例如,如果你将 30 个圆石粘贴到发射器中,每个槽位获得大致相同的数量。 合成器是特殊的:锁定状态会被保留。复制一个带有锁定槽位的合成器,粘贴到其他地方,锁定槽位会自动重新锁定。

尺寸不匹配的粘贴:将单箱子布局粘贴到大箱子中(或反之)?有三种可配置模式:

  • 悬停位置: 用于从小到大的粘贴。将鼠标悬停在容器的上半部分或下半部分以粘贴到该侧。
  • 菜单选择: 弹出一个菜单以选择你想要哪一半。
  • 方向键: 使用方向键选择物品粘贴到哪一侧。

不兼容的容器: 村民交易、铁砧、附魔台、砂轮、织布机、制图台、信标、酿造台、切石机和锻造台无法复制/粘贴。


安装

  1. 安装 Fabric Loader
  2. 安装 Fabric API
  3. 从 Modrinth 下载 InvTweaks
  4. 将 .jar 放入你的 mods 文件夹
  5. 启动游戏

配置

按 K 打开配置屏幕。

配置屏幕有四个标签页:

All: 几乎所有设置都在一个可滚动列表中。

Tweaks: 单独打开或关闭各个功能。

Hotkeys: 设置你的全局修饰键、特定调整的按键覆盖和剪贴板按键绑定。有一个“高级选项”部分用于每个调整的按键覆盖,如果你想让某个特定调整拥有自己的按键绑定。

Debug: 切换调试日志记录并访问调试日志缓冲区。如果有什么看起来不对,启用调试日志记录,重现问题,然后点击“复制调试日志”以获取最后 200 条日志条目。对错误报告很有用。

配置文件

设置存储在 .minecraft/config/invtweaks.json 中。剪贴板历史记录单独存储在 invtweaks-clipboard.json 中。


模组兼容性

我自己使用了很多物品栏生活质量模组,所以我尽量让 InvTweaks 与尽可能多的模组良好配合。据我的测试显示,没有重大问题,但有几件事需要注意。如果你遇到兼容性问题,请打开一个问题,我会看看我能做什么。

Mouse Tweaks

通常兼容,但有一点需要注意:Mouse Tweaks 使用滚动进行自己的物品栏操作。如果两个模组都启用了滚动功能,滚动行为会冲突。你可能需要禁用其中一个,取决于你更喜欢哪个。

Tweakeroo

Tweakeroo 有自己的滚轮功能,可能会与 InvTweaks 的滚动转移冲突。同样的情况,你可能需要禁用其中一个。

Mod Menu

完全兼容。

创造模式

InvTweaks 在创造模式下没有完全兼容。创造模式物品栏使用完全不同的屏幕处理器,绕过了标准的槽位交互系统。


给 macOS 用户的说明

macOS 用户应安装 macOS Input Fixes 以获得最佳兼容性。InvTweaks 内置了对 macOS Cmd+Shift+点击批量移动行为的处理,并同时响应 Ctrl 和 Cmd 进行复制/粘贴/剪切操作。

我还建议创建一个自定义键盘快捷键以避免意外退出 Minecraft。Cmd+Q 会退出应用程序,如果你将 Cmd 设置为投掷操作的修饰键,这可能会发生。要修复此问题:

  1. 前往 系统设置 → 键盘 → 键盘快捷键 → 应用快捷键
  2. 添加一个名称完全为 “Quit java” 的新快捷键
  3. 将快捷键设置为你不会意外按到的组合

这会专门覆盖 Minecraft 的标准 macOS 退出快捷键。


常见问题 / 故障排除

问:我安装了模组,但按住修饰键时什么也没发生。 答:确保你安装了 Fabric API。还要检查你没有其他模组覆盖相同的按键事件。

问:滚动转移不起作用。 答:如果你安装了另一个带有滚动操作的模组,它的滚动功能可能会先拦截事件。尝试在一个模组或另一个模组中禁用滚动功能。

问:我的粘贴把物品放到了错误的槽位。 答:粘贴按类型和组件数据(附魔、药水、自定义名称等)匹配物品。如果你没有完全相同的可用物品,粘贴会尽力利用现有物品。

问:覆盖层消息很烦人。 答:你可以关闭它们!打开配置屏幕(K)→ Tweaks 标签页 → “显示覆盖层消息” → 禁用。

问:我可以在服务器上使用这个吗? 答:可以。InvTweaks 完全是客户端侧的,可在原版服务器、Fabric 服务器和任何允许客户端模组的服务器上使用。无需服务器端安装。如果你的服务器有严格的反作弊监控,考虑让你的管理员知道你正在使用物品栏管理模组。

问:有东西坏了。我如何报告错误? 答:在配置屏幕(Debug 标签页)中启用调试日志记录,重现问题,然后点击“复制调试日志”以获取最近的日志条目。在 GitHub 上打开一个问题,附上调试日志和对发生情况的描述。截图也有帮助。

问:这能在 Minecraft 版本 X 上运行吗? 答:InvTweaks 目前针对 Fabric 上的 Minecraft 1.21.11。未来可能会支持其他版本。查看 Modrinth 了解最新支持的版本。


关于名称的说明

你可能认得 InvTweaks 这个模组名称:在较旧的 Minecraft 版本中有一个同名模组(最后一次官方更新大约在 1.10 左右,社区更新一直到 1.20)。这个模组不是那些模组,也与它们没有任何关系。这是一个完全不同的、独立的模组,只是碰巧同名。


许可证

InvTweaks 根据自定义源代码可用许可证发布。源代码在 GitHub 上可用,以保持透明度和社区信任,但再分发、修改和衍生作品受到限制。完整条款请参阅 LICENSE.md 文件。