AutoTools

AutoTools

AutoTools 会检查你的整个物品栏，找出最适合挖掘方块或攻击生物的工具。工具的选择依据包括挖掘速度、挖掘等级、附魔效果和每秒伤害（DPS）。该模组提供丰富的自定义选项。如果某些方块优先使用精准采集，请查看 silk_touch.json；如果优先使用时运，请查看 fortune.json。对于 shears.json 中的方块，则始终优先使用剪刀。

所有配置选项都可以通过 ClothConfig 界面便捷地编辑：

• 选择配置 [默认]：

  • toggle [false]: AutoTools 将始终处于激活状态，并尝试为你选择最合适的工具。可使用 set 键切换此选项。
  • disableCreative [true]: 如果启用了 toggle，则在创造模式下禁用 AutoTools。
  • keepSlot [false]: 切换到新工具时保留当前选中的栏位，而不使用原版机制。
  • hotbarOnly [false]: AutoTools 只会从快捷栏中选择工具
  • preserveDurability [true]: 如果没有找到合适的工具，AutoTools 会切换到不会损耗耐久度的物品
  • hotbarOnly [false]: AutoTools 只会从快捷栏中选择工具
  • preferHotBarTool [true]: 如果多个工具的挖掘速度相同，AutoTools 会优先选择快捷栏中已有的工具，不考虑其耐久度。
  • preferLowDurability [false]: 如果工具的挖掘速度和附魔相同，AutoTools 会优先选择耐久度较低的工具，而不是较高的工具。
  • preserveDurability [true]: 如果没有找到合适的工具，AutoTools 会切换到不会损耗耐久度的物品
  • switchBack [false]: 破坏方块后，AutoTools 会切换回你破坏方块前手持的物品
  • showDPS [true]: 将鼠标悬停在武器上时，以提示框显示其伤害
  • changeForEntities [true]: 注视实体时，AutoTools 会切换到每秒伤害最高的工具
  • keepAxe [false]: 手持斧头时，AutoTools 不会切换到更好的武器（例如剑）
  • enabled [always]:
    • always：AutoTools 始终处于激活状态
    • tool：仅在手持工具时激活 AutoTools
    • no_tool：仅在未手持工具时激活 AutoTools
  • ignoredSlots [[]]: 如果当前选中的是这些栏位之一，AutoTools 将不会执行任何操作
  • targetSlots [[1,2,3,4,5,6,7,8,9]]: AutoTools 只会将工具放入这些栏位
  • ignoredInventorySlots [[]]: AutoTools 不会从物品栏中的这些栏位选择工具。参见 物品栏栏位
  • minDurability [0.0]: 如果小于 1，则视为百分比：耐久度低于 minDurability 的工具不会被选中
    否则，视为耐久度数值：工具会一直被选用，直到耐久度达到 minDurability（例如设为 1 可确保工具永不损坏）
  • durabilityCheck [true]: 防止工具耐久度低于 minDurability 时继续挖掘
  • experimentalBreakDelay [false]: 如果启用了 toggle，在切换工具后破坏方块前会增加 1 Tick（50 毫秒）的实验性延迟。如果即时挖掘时遇到不同步问题（例如幽灵方块），请启用此选项。

• #### 方块行为：

  • onlySwitchIfNecessary [false]: AutoTools 仅在需要破坏方块时才尝试切换到新工具
  • alwaysPreferFortune [false]: AutoTools 会对沙砾和树叶使用时运
  • preferSilkTouch [except_ores]:
    • always:
      AutoTools 还会对以下方块使用精准采集：草方块、石头、矿石、树叶、雪
    • ores:
      AutoTools 还会对矿石使用精准采集
    • except_ores:
      AutoTools 还会对以下方块使用精准采集：草方块、石头、树叶、雪
    • never: AutoTools 仅在挖掘方块必须使用精准采集时才会使用它。
  • customTools
    • 以 JSON 格式添加自定义工具配置（例如 customTools={“minecraft:block_id”:”minecraft:tool_id”}
      或 customBlocks={“minecraft:block_id”:[“minecraft:tool_id_1”, “minecraft:tool_id_2”]}）
    • 注意：在 Forge 和 NeoForge 上，需要使用 customTools=”{\”minecraft:block_id\”:\”minecraft:
      tool_id\”}”
    • 添加多个工具时，第一个工具的优先级最高
      工具组还有预定义列表：autotools:pickaxe、autotools:axe、autotools:shovel、
      autotools:hoe、autotools:sword
    • 若要完全禁用某个方块的 AutoTools，请使用：”autotools:disabled”
    • 此功能适用于方块和实体（例如 “minecraft:stone” 或 “minecraft:sheep”）

兼容性

提供适用于 Forge、NeoForge 和 Fabric 模组加载器的版本（使用 Fabric 版本时可集成模组菜单）
AutoTools 需要 ClothConfig。

AutoTools 完全在客户端运行，可在服务器上使用，并兼容许多第三方模组。

AutoTools 也兼容 Controllable

开发者须知：

物品兼容性：

工具：应实现 Item.isCorrectToolForDrops(BlockState) 和 Item.getDestroySpeed(Item, BlockState)。此外，
方块应正确实现 requiresCorrectToolForDrops（Mojmap 映射）

武器：物品需要将攻击伤害（和攻击速度）存储为 AttributeModifiers

模组集成：

如果想在自己的项目中依赖 AutoTools，请使用以下任一配置。可用软件包列表见：

https://maven.zelythia.net/#/releases/net/zelythia/autotools-common 或 https://github.com/zelythia/AutoTools/packages/2683389/versions

repositories {
    maven {
        name = "Zelythia Releases"
        url = uri("https://maven.zelythia.net/releases")
    }
}

根据 GitHub 文档：

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/zelythia/AutoTools")
        credentials {
            username = project.findProperty("gpr.user") ?: System.getenv("USERNAME")
            password = project.findProperty("gpr.key") ?: System.getenv("TOKEN")
        }
   }
}