BattleCorrection

中文版本

新增

• 新增物品编辑器：OP 2 级且处于创造模式的玩家用 /battlecorrection edit 或 I 键打开，可以编辑主手物品、物品栏和箱子里鼠标指着的物品，空手对着实体（玩家除外）或箱子、刷怪笼这类带方块实体的方块时还能编辑它们的 NBT。
• 编辑器有名字、Lore、标签、附魔、属性、饰品栏、NBT 树、SNBT、模板、玩家饰品栏十页，名字、Lore、标签等页面右侧实时预览物品提示框，饰品栏和玩家饰品栏两页需要安装 Curios。
• 名字和 Lore 支持 & 颜色代码和 &#RRGGBB 十六进制颜色，调色盘可以取色，也可以做 2～8 个色标的渐变（自带 10 种预设），并记住最近用过的 16 种颜色。
• 附魔页和属性页可以搜索游戏里的全部附魔和属性（包括其他模组添加的），NBT 树可以搜索、按路径跳转和复制粘贴节点，SNBT 页带语法高亮、行号、查找和一键格式化，O 键和 P 键分别直接打开 SNBT 页和 NBT 树。
• 编辑器支持 F4 更换物品种类（NBT 和数量保留）、Ctrl+Z / Ctrl+Y 撤销重做、Ctrl+S 保存、从剪贴板导入 /give 命令或 SNBT、把物品复制为 /give 命令，常用的物品可以存成模板套用到别的物品上。
• 新增饰品栏标记（需要 Curios）：手持物品输入 /battlecorrection curio add <饰品栏|any> 就能把这一件物品戴进指定饰品栏，用 curio attr add 给它附加只在佩戴时生效的属性，也可以在编辑器的饰品栏页直接勾选。
• 标记过的物品只当饰品用：自身的属性（盔甲值、攻击伤害、NBT 里的属性）只在饰品栏里生效，标记过的盔甲不能再穿进盔甲栏，可以 Shift 点击或手持右键直接戴上，提示框按饰品栏列出佩戴时获得的属性。
• 新增第三方魔法识别：Iron's Spells 'n Spellbooks、Goety、Ars Nouveau、Sweet Magic、Geomancy Plus 的法术默认算作魔法伤害，吃魔法伤害属性和魔法倍率，配置里可以增删命名空间、填写白名单和黑名单，也可以整体关闭。
• 新增玩家承受环境伤害倍率：总倍率加摔落、火焰、溺水、冰冻、爆炸五类，在盔甲减伤之后结算，填 0 即免疫（虚空和 /kill 不受影响），另有按最大生命值比例或固定值的环境伤害下限（默认关闭）；坠落的方块砸中玩家也改按环境伤害计算，不再使用「承受近战伤害倍率」。
• 新增配置「吸血吃治疗加成」（lifestealAffectedByHealBonus，默认开启），关闭后吸血和全能吸血固定回复「伤害 × 吸血比例」，不再乘治疗加成。

改动

• 魔法伤害改为叠加在近战、箭矢、弹射物倍率之上，例如玩家放出的法术火球同时乘弹射物倍率和魔法倍率，2.0.2 中法术只吃魔法倍率；弹射物伤害属性现在也对魔法弹射物生效。
• 箭矢、弹射物、魔法伤害的固定加成改为先加再算暴击，魔法伤害加成只对有攻击者的魔法伤害生效，本身不造成伤害的命中（雪球、鸡蛋）不再被加成。
• 饰品上的属性改为戴上时生效、摘下时移除，饰品多时拉弓、进食的性能开销更小；带暴动、群殴、消灭效果的生物丢了目标时改为约每秒重找一次（2.0.2 每刻都搜一遍 64 格），大量生物带着效果时更省性能。

修复

• 修复「实体无敌时间倍率」和「玩家无敌时间倍率」保持默认 0 时把所有生物和玩家的受击无敌时间清零的问题，现在 0 就是原版，其他值按「原版 10 刻 ×（1 + 倍率）」计算。
• 修复开启「连击修正」后每次近战都只剩一半伤害、吸血和全能吸血判断满蓄力不准的问题，现在都按挥砍那一刻的蓄力计算，满蓄力不打折，吸血的回复量按所有倍率结算后的最终伤害计算。
• 修复「PVP 伤害倍率」设为 0 时连玩家的自伤也被挡掉，以及「饥饿伤害衰减上限」为 0（不设上限）时饥饿伤害衰减完全不起作用的问题。
• 修复戴两件属性相同的饰品只算一件、跳跃提升不算饰品加成的问题。
• 修复关闭「攻击冷却」时往玩家存档写入永久攻速加成的问题，现在改为不存档的临时加成，2.0.2 及更早版本留下的那条会在玩家进入世界时清除。
• 修复配置界面里「拉弓速度倍率」和「物品使用速度倍率」点重置会变成 0（无法拉弓、无法使用物品）的问题，以及敌对权杖连点同一只生物会让它以自己为目标的问题。

升级须知

• 客户端和服务端都要更新到 3.0.0，两边版本不一致时无法进入服务器。
• Cloth Config 已打包在模组里，不需要另外安装；Curios 仍可不装，装了的话需要 5.14.1 或更高版本，装的是更旧的版本时游戏无法启动。
• 默认配置下所有生物和玩家恢复原版的受击无敌时间，短时间内连续受到的伤害会比 2.0.2 少；想保留 2.0.2 的效果，把两项无敌时间倍率都设为 -0.99。在 2.0.2 里改过这两项的，新值要比旧值小 1（最低 -0.99）才和 2.0.2 一样，例如旧的 1.0 现在填 0。
• 没标记的饰品上原版格式的属性（例如 NBT 里写的最大生命值）现在默认生效，想和 2.0.2 一样只算本模组的属性，把 curioNbtAttributes 设为 MOD_ONLY。
• 在 2.0.2 里把「饥饿伤害衰减」设得大于 0、上限留着 0 的，更新后衰减才真正生效。
• 调过魔法倍率的整合包要重新核对法术伤害：Iron's Spells 'n Spellbooks 等模组的法术现在默认算魔法，魔法倍率也改为叠乘在近战、箭矢、弹射物倍率之上。
• 新加的 I、O、P 三个键在「选项 → 按键控制 → 按键绑定」的「战斗修正」分类里，其中 P 和原版「社交屏幕」的默认键相同，在服务器上按 P 会先打开社交屏幕，需要改掉其中一个。
• 物品编辑器默认开启，OP 2 级的创造模式玩家都能用它修改物品、实体和方块实体，不想开放的服务器把 battlecorrection-attribute.toml 里的 itemEditorEnabled 设为 false。
• 许可协议改为 CC BY-NC-SA 4.0，之前发布的版本仍按原来的协议。

English Version

Added

• New item editor: players with OP level 2 in creative mode open it with /battlecorrection edit or the I key to edit the main-hand item or the item under the mouse in an inventory or chest, and with an empty hand also the NBT of the entity (players excluded) or block entity, such as a chest or spawner, under the crosshair.
• The editor has ten pages (Name, Lore, Tags, Enchantments, Attributes, Curios, NBT Tree, SNBT, Templates and My Slots); Name, Lore, Tags and similar pages show a live tooltip preview on the right, and the Curios and My Slots pages need Curios installed.
• Names and lore support & colour codes and &#RRGGBB hex colours, and the colour palette picks colours or builds gradients with 2 to 8 stops (10 presets included) and remembers the 16 most recent colours.
• The Enchantments and Attributes pages search every enchantment and attribute in the game, including those from other mods; the NBT Tree can search, jump to a path and copy or paste nodes, the SNBT page has syntax highlighting, line numbers, find and one-click formatting, and the O and P keys open the SNBT page and the NBT Tree directly.
• The editor supports F4 to change the item type (NBT and count kept), Ctrl+Z / Ctrl+Y to undo and redo, Ctrl+S to save, importing a /give command or SNBT from the clipboard and copying the item as a /give command, and frequently used items can be saved as templates and applied to other items.
• New Curio Mark (requires Curios): hold an item and run /battlecorrection curio add <slot|any> to let that single item be worn in the given curio slot, use curio attr add to give it attributes that only apply while worn, or tick the slots on the editor's Curios page.
• Marked items become curio-only: their own attributes (armor, attack damage, NBT attributes) apply only in a curio slot, marked armor can no longer be worn in the armor slots, they can be shift-clicked or right-clicked straight into a curio slot, and their tooltip lists the attributes gained in each slot.
• New Third-party Magic Recognition: spells from Iron's Spells 'n Spellbooks, Goety, Ars Nouveau, Sweet Magic and Geomancy Plus count as magic damage by default and receive the Magic Damage attribute and magic multipliers; the namespaces, a whitelist and a blacklist can be edited in the config, or the feature can be turned off.
• New player environmental damage multipliers: a general one plus Fall, Fire, Drowning, Freezing and Explosion, applied after armor, with 0 meaning immunity (void and /kill are never affected), plus an optional environmental damage floor as a share of max health or a flat amount (off by default); falling blocks hitting a player now also count as environmental damage instead of using Melee Damage Resistance.
• New config Lifesteal Uses Healing Bonus (lifestealAffectedByHealBonus, on by default): when off, Lifesteal and Almighty Lifesteal always heal exactly damage × lifesteal ratio, without the healing bonus.

Changed

• Magic damage now stacks on top of the melee, arrow and projectile multipliers, so a player's spell fireball takes both the projectile and the magic multiplier where in 2.0.2 spells got only the magic multiplier, and the Projectile Damage attribute now also applies to magic projectiles.
• The flat Arrow, Projectile and Magic damage bonuses are now added before critical hits are calculated, the Magic Damage bonus only applies to magic damage that has an attacker, and hits that deal no damage (snowballs, eggs) are no longer boosted.
• Curio attributes now take effect when an item is put on and are removed when it is taken off, which lowers the performance cost of drawing a bow or eating with many curios, and mobs under Riot, Brawl or Elimination that have lost their target now look for a new one about once a second instead of searching 64 blocks every tick as in 2.0.2, which is lighter with many affected mobs.

Fixed

• Fixed Entity Invulnerability Time and Player Invulnerability Time at the default 0 wiping out the hit invulnerability of all mobs and players; 0 is now vanilla and other values give vanilla 10 ticks × (1 + value).
• Fixed Combo Correction cutting every melee hit to half damage and Lifesteal / Almighty Lifesteal misjudging a full charge; both now use the charge at the moment of the swing, fully charged hits are not reduced, and lifesteal heals from the final damage after all multipliers.
• Fixed a PVP Damage Multiplier of 0 also blocking a player's self-damage, and Hunger Damage Decay doing nothing when Hunger Damage Decay Limit was 0 (no limit).
• Fixed two curios with identical attributes counting as one, and Jump Boost ignoring curio bonuses.
• Fixed disabling Attack Cooldown writing a permanent attack speed bonus into player data; it is now a temporary bonus, and the one left by 2.0.2 and earlier is removed when the player joins a world.
• Fixed the reset button for Bow Draw Speed and Item Use Speed in the config screen setting them to 0 (bows and items unusable), and the Enemy Staff making a mob target itself when that mob was clicked twice.

Upgrade Notes

• Client and server must both be updated to 3.0.0; a client cannot join a server running a different version.
• Cloth Config is bundled in the mod and needs no separate install; Curios is still optional, but must be 5.14.1 or newer when installed, otherwise the game will not start.
• With default settings all mobs and players have vanilla hit invulnerability again, so rapid repeated hits deal less damage than in 2.0.2; set both invulnerability multipliers to -0.99 to keep the 2.0.2 behaviour. If you had changed them in 2.0.2, subtract 1 from your old values (minimum -0.99) to keep the same timing; an old 1.0 is now 0.
• Vanilla-format attributes on unmarked curios (for example max health written in NBT) now apply by default; set curioNbtAttributes to MOD_ONLY to count only this mod's attributes as in 2.0.2.
• If you set Hunger Damage Decay above 0 in 2.0.2 and left its limit at 0, the decay now actually applies.
• Packs that tuned the magic multipliers should recheck spell damage: spells from Iron's Spells 'n Spellbooks and the other listed mods now count as magic, and magic now stacks on the melee, arrow and projectile multipliers.
• The new I, O and P keys are under Options → Controls → Key Binds → Battle Correction; P is also vanilla's default Social Interactions Screen key, and on a server that screen opens first, so rebind one of the two.
• The item editor is on by default and lets any OP level 2 player in creative mode modify items, entities and block entities; servers that do not want this can set itemEditorEnabled to false in battlecorrection-attribute.toml.
• The license is now CC BY-NC-SA 4.0; files released earlier keep their original license.