AutoSwitch - AutoSwitch 自动切换

[](https://modrinth.com/mod/fabric-api "Download Fabric API")

AutoSwitch

AutoSwitch 是一个 Minecraft 模组（适用于 Fabric / NeoForge），会根据你即将进行的操作自动切换手持物品——例如挖掘、攻击、交互，或当特定统计信息发生变化时，并结合你快捷栏中可用的物品来决定切换目标。

（例如：你用拳头敲击石头方块时，它会自动切换到镐子。）

它基于规则驱动，并可通过 HOCON 配置文件 autoswitch.conf 进行高度自定义，

该文件位于 config 文件夹中，而这个文件夹与资源包文件夹处于同一级目录。

快速前往该位置的方法是进入 Options > Resource Packs > navigate up one folder。

你可以在游戏中按下 R 动态切换此模组的开/关状态。

配置

> 本节仅适用于 AutoSwitch 12+。更早版本使用的是不同的配置格式。

配置文件中共有四个部分——其中三个用于定义在各种操作发生时使用的选择器和目标，

另一个用于通用功能配置：

• attack-action - 攻击（实体或方块）时使用的规则。
• interact-action - 交互（类似右键操作）时使用的规则。
• stat-change-action - 由统计事件触发的规则（例如使用不死图腾）。
• feature-config - 控制该模组的整体行为。

每条规则包含：

• priority - 整数；当多个目标匹配时，较高的值优先。
• target - 该规则所匹配的内容（类型：BLOCK、ENTITY、STAT，或可组合其他目标的 EXPRESSION）。

目标可以引用标签或明确的具体 ID（如 minecraft:enderchest、sugarcane）。

• tools - 按顺序排列的候选切换目标数组。每个元素必须是一个 ITEM 或由多个 ITEM 组成的 EXPRESSION，

也可以是空列表（用于禁用该目标的自动切换）。

EXPRESSION 可以包含任意数量的元素，也可以嵌套任意深度，因此能提供极高的控制能力。

默认配置覆盖了大量常见情况，非常适合作为进一步扩展的基础。

工具和目标都可以带有可选的 data 字段，用于控制诸如附魔或方块状态之类的匹配条件。

实时编辑

在游戏中只需重新保存配置文件，它就会自动重新加载。

详细说明

表达式

表达式可以按你需要嵌套到任意深度。

表达式支持以下操作：

• OR - 匹配其任意一个子项
• AND - 匹配其所有子项
• NOT - 不匹配其任意子项
• XOR - 仅匹配其其中一个子项

Data

当前支持以下数据类型：

• BlockState - 要匹配的方块状态
• Component - 目前仅支持物品上的 POTION_CONTENTS
• Enchantment - 物品所具有的附魔
• EntityEquipment - 实体所穿戴的装备，例如装有鞍的猪

选择优先级

判定顺序（最先出现差异的一项获胜）：

• Target Priority - 优先选择 priority 更高的规则。
• Target Rating（多级） - 从等级 0 到配置的最大等级逐级比较。

在每一级中，按以下顺序比较：

• isGroup（优先非组）
• hasData（优先带有数据的）
• typeRating（数值越高越优先，例如武器 DPS 或挖掘等级）
• dataRating（数值越高越优先，例如归一化后的附魔等级）
• Tool Priority - 优先选择本身具有更高内在优先级的工具。
• Tool Rating（多级） - 与 Target Rating 相同的多级比较逻辑（isGroup → hasData → typeRating → dataRating）。
• 当前是否已选中该槽位？ - 如果前面都相同，则优先当前手持槽位。
• 最小槽位索引 - 最终平局判定：选择索引最小（最左侧）的物品栏槽位。

基于文本的流程图

START: 候选物品栏槽位（所有匹配某个选择器的槽位）
|
v
比较 Target Priority
|-- 如果不同 --> 选择最高的 Target Priority --> END
|
v（相同）
比较 Target Rating（等级 0..N）
对于每一级：
- 比较：isGroup?（优先非组）
- 比较：hasData?（优先有数据的）
- 比较：typeRating（更高者胜）
- 比较：dataRating（更高者胜）
|-- 如果发现差异 --> 选择胜者 --> END
|
v（无差异）
比较 Tool Priority
|-- 如果不同 --> 选择最高的 Tool Priority --> END
|
v（相同）
比较 Tool Rating（等级 0..N）
（每一级规则与 Target Rating 相同）
|-- 如果发现差异 --> 选择胜者 --> END
|
v（仍然相同）
优先当前选中的槽位？
|-- 是 --> 选择当前选中的槽位 --> END
|-- 否 --> 选择最小（最左侧）的槽位 --> END