Critworks

Critworks

为剑、斧和弓提供暴击几率与伤害倍率,并附带玩家暴击加成属性和一个附加组件API。

Critworks 为每把剑、斧和弓提供暴击几率与暴击伤害倍率。每次攻击都会针对其武器的暴击几率进行一次判定。暴击会乘算伤害。跳跃、下落以及满弓蓄力不再使攻击本身成为暴击。

AI 使用声明:本模组在 AI 代理辅助下开发,使用了此代理工作流。项目所有者在开发过程中审查了工作成果。

特性

  • 武器属性: 没有任何其他数值的武器拥有 15% 几率和 x2.00 伤害。整合包制作者可以为单个物品、某种斯巴达武器类型或所有武器更改这些数值。
  • 玩家加成: 四项加成属性可提升玩家的暴击(见下方暴击属性)。盔甲、物品、食物、套装加成和其他模组都可以为其增加数值。
  • 提示框: 武器会显示其暴击几率和伤害,例如 Crit: 15% | x2.00。按住 Shift 可查看当前加成下的几率和伤害,以及每项加成的来源。
  • 横扫和箭矢: 一次挥击对其横扫的每个目标各进行一次判定。箭矢会保留其发射时判定出的结果。
  • 音效: 暴击会播放原版暴击音效,若安装了 RLCombat 则播放 RLCombat 的暴击音效。
  • 检查命令: /critworks inspect(仅限管理员)显示手持武器每个数值的来源。
  • 附加 API: 其他模组可以设置武器数值、给予加成、授予必定暴击,并接入它们自己的攻击。

暴击属性

每把武器都有两项基础属性:

  • 暴击几率: 攻击成为暴击的频率,以百分比表示。15% 意味着大约 20 次攻击中有 3 次。
  • 暴击伤害: 暴击的倍率。x2.00 意味着双倍伤害。

玩家有四项加成属性。每项初始为 0,来自所有来源的加成会累加。

  • 提升暴击几率(critworks.increasedCritChance):按武器自身暴击几率的百分比提升。+100 使其翻倍。
  • 额外暴击几率(critworks.additionalCritChance):向暴击几率增加百分点。+10 增加 10%。
  • 提升暴击伤害(critworks.increasedCritDamage):按百分比提升倍率中的加成部分(x1.00 以上的部分)。+100 使加成部分翻倍。
  • 额外暴击伤害(critworks.additionalCritDamage):增加倍率。+0.5 增加 0.50。

提升类加成先应用,然后再加上额外类加成。

暴击几率为 15% 的武器上的示例:

  • 提升暴击几率 +100:15% x 2 = 30%。
  • 额外暴击几率 +10:15% + 10 = 25%。
  • 两者兼有:15% x 2 + 10 = 40%。

暴击伤害为 x2.00 的武器上的示例(加成部分为 1.00):

  • 提升暴击伤害 +100:加成部分翻倍至 2.00,因此为 x3.00。
  • 额外暴击伤害 +0.5:x2.00 + 0.50 = x2.50。
  • 两者兼有:x3.00 + 0.50 = x3.50。

提升类加成在基础数值高的武器上收益最大。额外类加成为每把武器提供相同的数值。使用斯巴达武器模组的匕首(30%,x1.50)和巨剑(10%,x2.50)的示例:

  • 提升暴击几率 +50:匕首从 30% 变为 45%,巨剑从 10% 变为 15%。
  • 额外暴击几率 +10:匕首从 30% 变为 40%,巨剑从 10% 变为 20%。
  • 提升暴击伤害 +100:匕首从 x1.50 变为 x2.00,巨剑从 x2.50 变为 x4.00。
  • 额外暴击伤害 +0.5:匕首从 x1.50 变为 x2.00,巨剑从 x2.50 变为 x3.00。

暴击几率为 0% 的武器在任何提升暴击几率下仍保持 0%;只有额外暴击几率可以提升它。暴击几率永不超过 100%。加成可以为负数。

配置

config/critworks.cfg 设置默认几率和伤害、攻击需要蓄力到何种程度才能暴击、伤害上限、对玩家的暴击以及暴击音效。config/critworks/weapons.json 为单个物品或斯巴达武器类型设置数值:

[
  { "item": "minecraft:iron_sword", "chance": 20, "damage": 2.5 },
  { "item": "minecraft:diamond_sword", "eligible": false },
  { "item": "minecraft:stick", "eligible": true, "chance": 50, "damage": 2.0 }
]

更改需要重启。面向整合包制作者的完整参考见整合包制作者指南。

安装

在服务器和每个客户端上安装 Critworks。

集成

每个集成在其模组安装后会自动启用,且均可在配置中关闭。

RLCombat

  • 主手和副手攻击使用 Critworks 暴击,各自使用其所在手中的武器。
  • RLCombat 自身的暴击判定和跳跃暴击不再适用。Critworks 暴击会播放 RLCombat 的暴击音效。

斯巴达武器

  • 每把斯巴达近战武器和长弓都可以暴击。
  • 每种武器类型都有其内置数值。轻型武器暴击更频繁但伤害较低;重型武器暴击较不频繁但伤害较高。
  • 匕首、拳套: 30%,x1.50
  • 刺剑: 25%,x1.60
  • 招架匕首、军刀、武士刀、长棍: 20%,x1.75
  • 长剑、长矛、钉头锤、棍棒: 15%,x2.00
  • 戟、长柄刀、骑枪: 12%,x2.25
  • 巨剑、战斧、锤、战锤、镰刀、长枪、长弓: 10%,x2.50
  • weapons.json 可以更改整个武器类型的数值。这也涵盖来自斯巴达武器附属模组的武器。
  • 弩和投掷武器不会暴击。

Just Another Food System

面向整合包制作者:创建在其生效期间提供暴击加成的 JAFS 食物。Critworks 添加了两个 JAFS 属性:

  • critworks:crit_chance: flat 增加暴击几率百分点。percent 按暴击几率的百分比提升它。
  • critworks:crit_damage: flat 增加伤害倍率,例如 0.5 将 x2.00 变为 x2.50。percent 提升倍率中的加成部分(x1.00 以上的部分)。

config/jafs/foods.json 中的示例食物:

[
  {
    "id": "mypack_hunters_stew",
    "match": [ { "item": "minecraft:rabbit_stew" } ],
    "fullDuration": 600,
    "modifiers": [
      { "property": "critworks:crit_chance", "operation": "flat", "amount": 10 },
      { "property": "critworks:crit_damage", "operation": "percent", "amount": 50 }
    ]
  }
]

当此炖菜生效时,铁剑拥有 25% 暴击几率(15 + 10)和 x2.50 暴击伤害(1.00 的加成部分提升 50%)。该加成计入玩家的每次攻击,并在食物过期时结束。

Quality Tools

面向整合包制作者:使用四项 Critworks 属性创建提供暴击加成的品质(名称见上方暴击属性)。使用操作 0;其他操作在这些属性上不起作用。

config/qualitytools/Quailities/ 中的剑的示例品质文件(Quality Tools 就是这样拼写该文件夹的):

{
  "slot": "mainhand",
  "whitelist": [ { "class": "ItemSword" } ],
  "blacklist": [],
  "qualities": [
    {
      "name": "quality.sharp.name",
      "color": "aqua",
      "weight": 100,
      "attributes": [
        { "name": "critworks.additionalCritChance", "amount": 10, "operation": 0 }
      ]
    }
  ]
}

拥有此品质时,默认 15% 暴击几率的剑拥有 25%。武器上的品质仅计入使用该武器的攻击。盔甲上的品质计入穿戴该盔甲玩家的每次攻击。

Setworks

面向整合包制作者:使用四项 Critworks 属性创建其套装加成提供暴击加成的盔甲套装(名称见上方暴击属性)。使用 add;multiply_base 和 multiply_total 在这些属性上不起作用。Critworks 无需为此做额外设置。

scripts 文件夹中的示例 Setworks 脚本(需要 CraftTweaker):

#loader setworks
import mods.setworks.Setworks;

Setworks.armorSet("mypack:iron_armor", "Iron Armor",
    <minecraft:iron_helmet>, <minecraft:iron_chestplate>, <minecraft:iron_leggings>, <minecraft:iron_boots>);
Setworks.fullSetBonus("mypack:iron_focus", "mypack:iron_armor", "Iron Focus: +10 additional crit chance")
    .attribute("critworks.additionalCritChance", 10, "add");

穿戴全套铁盔甲时,玩家的每次攻击获得 +10 暴击几率百分点。当一件盔甲被取下时加成结束。

Quark 和 Quark: RotN Edition

  • 开启 Visual Stat Display 时,暴击几率和伤害在武器提示框中显示为一行图标。

限制

  • 弩、投掷武器以及来自生物或发射器的箭矢不会获得 Critworks 暴击。
  • 添加自身暴击的其他模组不会被关闭。它们的暴击可以与 Critworks 暴击叠加。

源代码

GitHub