BattleCorrection(简称 BC)专为制作 RPG 地图、整合包和服务器的玩家设计,允许你自行设定战斗数值。它添加了 15 种适用于玩家和生物的属性(如暴击率、生命偷取和闪避),提供 PVP、生物生命值、无敌帧和环境伤害的全局乘数,并内置了一个用于编辑物品名称、描述、附魔、属性和原始 NBT 数据的游戏内编辑器。
NeoForge 1.21.1、Forge 1.20.1 和 1.12.2 · 客户端与服务器均需安装 · 无需其他模组支持
新增内容
- 15 种同时适用于玩家和生物的属性:带有溢出计算的暴击、两种类型的生命偷取、闪避几率、固定伤害减免、魔法伤害、箭矢和投射物伤害、弓速和使用速度、跳跃高度。
- 针对 PVP、各类伤害类型下玩家造成的伤害与受到的伤害、环境伤害、无敌帧、攻击冷却时间、生物生命值和饥饿值的全局设置。
- 任何单个物品都可以成为 Curios 或 Baubles 饰品,其属性仅在装备时生效。
- 为操作员(Operator)提供的物品编辑器:支持彩色名称和渐变色、描述、附魔、属性、NBT 树、SNBT 文本编辑器以及模板。它还支持编辑实体和方块实体的 NBT 数据。
物品编辑器
处于创造模式的操作员(权限等级 2)按下 I 键或执行 /battlecorrection edit 命令即可打开编辑器。编辑器默认作用于手持物品、鼠标悬停在任何打开的容器或箱子中的物品上;如果手持为空,则作用于你注视的实体或方块实体。O 直接打开 SNBT 页面,P 打开 NBT 树。服务器会在每次保存时再次检查权限、创造模式、目标对象和 NBT 大小,而 itemEditorEnabled = false 将完全禁用编辑器。
该编辑器由模组本身绘制:左侧为页面标签,中间为当前页面内容,右侧为实时工具提示预览,底部排列着复制指令、导入、NBT 大小、取消和保存按钮。截图来自 1.20.1 版本,1.21.1 版本界面相同;1.21.1 和 1.12.2 版本的不同之处列在本节末尾。
名称与描述
输入 & 颜色代码和 &#RRGGBB 十六进制颜色,或者点击色板和格式按钮在光标处插入它们。“清除”功能会从选区中移除颜色和格式代码,粘贴的 § 符号会自动变为 &。“插入”写入单一颜色;“渐变”会在选中文本上方逐字母混合两种颜色,或在未选中任何文本时应用于整行。

名称页面:一个渐变名称,右侧预览了最终的工具提示效果。
描述页面每行对应一行文字,支持上移/下移、删除和添加。Enter 在光标处拆分行,Backspace 在行首时将其与上一行合并,多行粘贴会填充多个行。Vanilla 样式切换于纯白色文本和原版紫色斜体之间。仅重绘你修改过的行:包含文本框无法显示的内容(点击事件、悬停文本、自定义字体)的行会被标记,只要你不去动它们,它们就会保持完整。

描述页面:每行一行,每行都支持移动、删除和实时预览。
调色板按钮打开一个颜色选择器,包含饱和度/亮度方格、色相条、RGB 滑块、十六进制输入框以及你最近使用的 16 种颜色。渐变支持 2 到 8 个颜色停止点,提供彩虹、火焰和海洋等十种预设,并显示整行的预览效果。

颜色调色板:一个五停止点的渐变,显示了整行的预览效果。
附魔与属性
物品的附魔位于左侧,每个附魔旁边都有其原版最大等级:左键单击可更改等级,右键单击可移除附魔。在右侧,可以搜索游戏中的所有附魔(包括其他模组的附魔),点击即可添加。诅咒以红色显示,悬停时会显示该附魔的效果。等级上限为 255(1.12.2 版本为 32767);即使超过原版最大等级或原版不允许在该物品上应用的附魔,依然有效。

附魔页面:左侧显示物品的附魔,右侧显示所有附魔。
属性的操作方式相同:所有已注册的属性(无论是原版的还是来自其他模组)都在一个可搜索的列表中,悬停时会显示描述。设置数量、操作方式和槽位;输入 20% 会切换到百分比模式。选择 Curios 槽位作为槽位,也允许将该物品佩戴在该位置。

属性页面:剑上的暴击几率、暴击伤害、生命偷取和魔法伤害。
标签与槽位
标签页面可设置不可破坏、附魔光泽、隐藏标志、耐久度、铁砧修复成本、数量(1 到 127,1.21.1 版本为 1 到 99)以及在 1.20.1 和 1.21.1 版本中的自定义模型数据。Curios 页面见下文“饰品标记”。
我的槽位(1.20.1 和 1.21.1 版本)用于测试饰品,并可更改你自己的 Curios 槽位。它会列出你拥有的每种槽位类型及其数量:更改数量(设为 0 即移除该类型),或输入 ID 以添加槽位,即使该槽位没有模组注册(只是没有图标)。Curios 只会给已经至少拥有某种槽位类型的玩家提供槽位,因此如果你没有任何槽位,此页面将无法进行任何更改。为了测试目的,devCurioSlots = true 会给每个玩家分配 Curios 内置的十个槽位各一个;正常游玩时请保持关闭。

我的槽位:自定义 Curios 槽位及其数量。
NBT 树与 SNBT
该树形结构展示了每个标签及其类型。搜索键和值(Ctrl+F),跳转到如 tag.display.Lore[0] 的路径,复制节点路径,就地编辑键和值,并添加、删除、复制、粘贴、重复或移动节点。

NBT 树:带类型的节点、带有跳转功能的路径框以及底部的节点按钮。
SNBT 页面以文本形式编辑整个物品,支持行号、高亮显示和实时错误标记;无法解析的文本不会被应用。它具备查找功能(Ctrl+F)、跳转到指定行(Ctrl+G)、缩进、重复行、移动行、格式化、压缩以及 & / § 转换功能。

SNBT 页面:Ctrl+Enter 将文本应用于物品。
模板、导入及更改物品
模板在本地计算机上以名称存储物品的完整 NBT 数据和数量。你可以整体应用,或者仅勾选你需要的部分(名称、描述、附魔、属性、Curios 标记等)并保留其余部分,例如给多把武器赋予相同的附魔和属性。

模板页面:仅应用已保存模板中的附魔和属性。
“导入”功能从剪贴板读取 /give 命令、带有 NBT 的物品 ID 或物品 SNBT,并替换当前物品。“复制命令”将物品导出为 /give 命令;由于聊天窗口无法发送超过 256 个字符的命令,因此这类命令需通过命令方块或函数运行。F4 或点击标题栏中的物品图标可更改物品类型,同时保留其 NBT 数据和数量。可按名称或 ID 搜索,或输入 @ 和模组 ID(如 @battlecorrection)来列出特定模组的物品。

更改物品(F4):@battlecorrection 仅列出此模组的物品。
实体与区块实体
在手部为空的情况下,按 I 可编辑准星下的实体(玩家除外)或具有区块实体的方块,如箱子、熔炉或刷怪笼。实体和区块实体编辑器拥有 NBT 树和 SNBT 页面,其操作方式与物品编辑器相同。

实体 NBT 编辑器:搜索村民的 NBT 以查看其职业。
撤销与保存
Ctrl+Z / Ctrl+Y 用于撤销和重做,在一秒内连续按键计为一步。Ctrl+Tab 切换到下一页,Ctrl+1 到 9 可直接跳转到对应页。关闭时若有未保存的更改,会列出具体更改内容并先进行确认。

关闭时若存在未保存的更改,会在丢弃任何内容前先列出这些更改。
Ctrl+S 或 “Save” 会将物品发送至服务器。单个物品的 NBT 大小受 itemEditorMaxNbtKb 限制(1.20.1 和 1.21.1 默认为 1 MB,1.12.2 默认为 256 KB),超出限制的物品不会被保存。当物品数据超过约 2 MB 时,原版客户端将无法读取该物品,持有该物品的玩家会被断开连接。F1 可列出所有快捷键。

键盘快捷键(F1)。
关于 1.21.1
Minecraft 1.21.1 将物品数据存储为组件(components)而非 NBT 标签,这导致编辑器中的一些操作发生变化:
- NBT 树、SNBT 页面、导入、复制命令和模板均使用 1.21.1 格式:根节点为
{id, count, components},命令示例如 diamond_sword[custom_name='"Name"']。为 1.20.1 编写的命令、SNBT 和模板在粘贴或加载时会自动转换。
- 堆叠上限提升至 99,描述行数上限提升至 256 行。
- 在 NBT 树中,
components 下的所有内容必须是有效的组件,自定义数据需放入 minecraft:custom_data。在编辑结果有效之前,它会保留在树中并标记为“尚未应用”,且无法切换页面或保存。
- 隐藏“不可破坏”、“可破坏方块”、“可放置于方块”、染料颜色或盔甲纹饰的前提是物品必须具备相应的组件,否则开关将呈灰色不可用状态。
- 属性槽列表新增了“双手”、“护甲”和“身体”。
- 保存时,服务器会根据游戏自身的规则检查整个物品,并报告无效项。
关于 1.12.2
编辑器本身并无不同,差异仅在于该游戏版本所允许的功能。1.12.2 不支持十六进制颜色,因此调色板仅提供 16 种原版颜色(无颜色方块或 RGB 滑块),渐变吸附至最接近的颜色,并记住最近使用的 8 种颜色。属性列表包含原版、Forge 和本模组的属性,以及玩家拥有的其他属性,也可以手动输入其他名称。“Tags”页面没有 CustomModelData,“Curios”页面变为 Baubles 页面,且没有“我的槽位”页面。
属性
所有 15 种属性均存在于所有活体实体上。可通过编辑器、/give 命令、数据包或任何写入属性修饰符的工具将其添加到装备上;在 1.20.1 和 1.21.1 中,/attribute 命令也可用于它们。每种属性在配置文件中还有一个全局值,适用于所有实体,包括怪物。
以下 ID 适用于 1.20.1 和 1.21.1,格式为 battlecorrection:<id>。在 1.12.2 中,相同的名称以驼峰式命名法写在点之后:battlecorrection.magicDamage、battlecorrection.vanillaCriticalHitDamage 等。示例中使用的是运算 0(加法,在 1.21.1 中称为 add_value),适用于全部 15 种属性。
| 属性 |
ID |
效果(运算方式 0) |
| 魔法伤害 |
magic_damage |
对由攻击者造成的魔法命中施加额外伤害 |
| 箭矢伤害 |
arrow_damage |
对箭矢命中(在 1.20.1 和 1.21.1 中三叉戟也计入)施加额外伤害 |
| 投射物伤害 |
projectile_damage |
对其他投射物(如火球和法术投射物)施加额外伤害 |
| 伤害免疫 |
immune_damage |
完全忽略一次命中的几率:+0.25 = 25% |
| 无视伤害 |
ignore_damage |
从每次命中中减去固定数值;等于或低于该值的命中将被取消 |
| 减少摔落伤害 |
reduced_fall_damage |
同上,但仅针对摔落伤害 |
| 治疗恢复 |
restore_heal |
治疗倍率:+0.5 = 150% 治疗量 |
| 吸血 |
bloodthirsty |
根据 Melee 近战伤害的一部分进行治疗(玩家需蓄力满):+0.1 = 10% |
| 全能吸血 |
almighty_bloodthirsty |
适用于所有类型的伤害 |
| 弓速 |
bow_speed |
拉弓速度(在 1.20.1 和 1.21.1 中也包括弩):+1.0 = 速度快两倍 |
| 使用速度 |
preparation_speed |
食物、药水及其他手持物品的使用速度:+1.0 = 速度快两倍 |
| 跳跃提升 |
jump_lift |
额外跳跃高度:1.0 约等于一个方块的高度 |
| 原版暴击伤害 |
vanilla_critical_hit_damage |
叠加至原版的跳跃攻击暴击:+0.5 将 150% 变为 200% |
| 暴击几率 |
custom_critical_chance |
本模组在近战和投射物命中时的自定义暴击几率:0.3 = 30% |
| 暴击伤害 |
custom_critical_damage |
添加至暴击倍率(默认为 2.0):+1.0 = 造成 3 倍伤害 |
超过 100% 的暴击几率不会被浪费:超出部分将添加到倍率中。使用默认设置时,1.5 的几率会使每次命中都成为暴击,并造成 2.5 倍伤害。近战命中和投射物各进行一次判定,而穿透箭矢会保留一次判定用于其所有目标。
运算方式与 /give 命令示例
初始值为 0 的属性(三种伤害加成、无视伤害、减少摔落伤害、跳跃提升、暴击几率和暴击伤害)在 1.20.1 和 1.21.1 中仅对运算方式 0 作出反应。初始值为 1.0 的属性则计算超出 1.0 的部分,因此单独使用 0.25 的值时,运算方式 0 或 1 提供的加成相同。在 1.12.2 中,魔法、箭矢和投射物伤害的运算方式 1 和 2 会对命中进行缩放(0.5 = +50%)。
在 1.20.1 中带有 +5 箭矢伤害的弓(编辑器的“复制”命令按钮会自动生成如下命令):
/give @p bow{AttributeModifiers:[{AttributeName:"battlecorrection:arrow_damage",Name:"bonus",Amount:5.0d,Operation:0,UUID:[I;1,2,3,4],Slot:"mainhand"}]}

在 1.21.1 中相同的命令:
/give @p bow[attribute_modifiers={modifiers:[{type:"battlecorrection:arrow_damage",id:"battlecorrection:bonus",amount:5.0,operation:"add_value",slot:"mainhand"}]}]
在 1.12.2 中相同的命令:
/give @p minecraft:bow 1 0 {AttributeModifiers:[{AttributeName:"battlecorrection.arrowDamage",Name:"bonus",Amount:5.0d,Operation:0,UUIDMost:1L,UUIDLeast:1L,Slot:"mainhand"}]}
战斗调整
全局设置,通过 Forge 的伤害和治疗事件应用,因此其他模组的武器和伤害也被涵盖。在默认设置下,原版战斗保持不变。
- PVP 和自我伤害倍率,分别设置;设为 0 即关闭其中任意一项。
- 玩家造成和受到的伤害,按类型分类:近战、箭矢、投射物和魔法。魔法叠加在其他三种之上,因此玩家的火球会使用投射物倍率乘以魔法倍率。
- 玩家受到的环境伤害(没有活体攻击者的伤害):一个通用倍率加上摔落、火焰、溺水、冰冻和爆炸,在护甲之后应用;设为 0 使玩家免疫。可选的下限使每次环境命中至少造成最大生命值的一部分或固定数值。虚空伤害和
/kill 指令永远不会被更改。1.12.2 没有冰冻类别。
- 受到命中后的无敌时间,针对玩家和其他实体:0 保持原版,-0.5 减半,1.0 翻倍。
- 攻击冷却开启或关闭(关闭则提供 1.8 风格的战斗),以及连击修正,根据攻击蓄力缩放未蓄力的挥击,最低不低于 50%。
- 每个非玩家生物的最大生命值:1.0 使其翻倍。
- 饥饿:来自饱和度和高饥饿条的额外再生(固定值或最大生命值的一部分),以及玩家每缺失一点饥饿值所减少的伤害输出,带有可选上限(0 表示无上限)。
- 其他模组的法术被视为魔法伤害。在 1.20.1 和 1.21.1 中,Iron's Spells 'n Spellbooks、Ars Nouveau、Goety、Sweet Magic 和 Geomancy Plus 已通过模组命名空间直接识别,同时支持
forge:is_magic 伤害类型标签(在 1.21.1 中为 neoforge:is_magic 和 c:is_magic)、白名单和黑名单。在 1.12.2 中,你需要列出伤害类型前缀。召唤物和宠物造成的近战命中永远不被视为魔法。
- 吸血是否受治疗加成增强(默认开启)。

1.20.1 中的游戏内配置界面(Mods → BattleCorrection → Config)。
饰品标记
安装 Curios(1.20.1 和 1.21.1)或 Baubles(1.12.2)后,操作员可以标记单个物品,使其适配所选的饰品槽位:例如作为饰品佩戴的剑,或作为戒指佩戴的头盔。标记存储在物品的数据中(在 1.21.1 中为自定义数据),因此复制和交易都会保留此标记。
- 带有标记的物品仅作为饰品使用。其自身的属性(护甲、攻击伤害、
AttributeModifiers 或 attribute_modifiers、其他模组提供的加成)仅在饰品栏位中生效,且带有标记的盔甲不再能穿戴在普通盔甲栏位中。
- 可以附加仅在穿戴时生效的额外属性,可选地限定为某一类栏位。
- 右键可将带有标记的物品装备到空闲栏位;在 1.20.1 中,Shift+右键在 Curios 界面中也有效。
- 工具提示按每个栏位分节列出属性。
- 对于没有标记的饰品,通过配置选项决定哪些原版格式的属性在穿戴时生效:
ALL(默认)、MOD_ONLY 或 OFF。

Curios 页面(1.20.1):这把剑现在可以佩戴在背部和手部栏位,预览区按栏位列出其属性。
管理法杖与测试之剑
专为地图制作者和测试准备的十种法杖。它们没有合成配方,仅来自 Battle Correction 创造模式标签页或通过 /give 指令获取,但任何手持者均可使用,生存模式亦然。范围类法杖的作用范围为 64 格,所有法杖均有一秒冷却时间。
All staffs and swords
| Item |
Use |
| Enemy Staff |
点击两个生物:它们互相攻击 |
| Rebel Staff |
点击一个生物:64 格内的所有生物都会攻击它 |
| Riot Staff |
点击一个生物:它会随机攻击附近的生物,持续 10 分钟 |
| Brawl Staff |
在空中使用:64 格内的所有生物互相战斗 10 分钟 |
| Elimination Staff |
在空中使用:生物会攻击其他物种的生物,持续 10 分钟 |
| Healing Staff |
点击任意活体实体:恢复满血 |
| Range Healing Staff |
目标周围 64 格内的所有活体实体(包括玩家)恢复满血 |
| Sacrificial Staff |
杀死被点击的实体,包括玩家 |
| Range Sacrificial Staff |
杀死目标周围 64 格内的所有非玩家实体 |
| Restoration Staff |
移除被点击实体身上的所有效果 |
| Base / Advanced / Master Sword |
攻击力 10 / 100 / 1,000,耐久度 1,000 / 10,000 / 100,000 |
命令与配置
Commands, keys and config files
Commands and keys
| Command or key |
What it does |
/battlecorrection edit |
打开所持物品的编辑器;添加 snbt 或 nbt 可打开对应页面 |
/battlecorrection curio add <slot> |
允许所持物品进入 Curios 栏位类型(any = 所有栏位);remove <slot>、clear 和 list 用于管理标记 |
/battlecorrection curio attr add <attribute> <amount> |
附加仅在穿戴时生效的属性,后可跟操作符(add、multiply_base 或 multiply_total)和栏位;attr remove <attribute> [slot] 和 attr clear 用于移除它们 |
/battlecorrection bauble ... |
1.12.2:适用于 Baubles 栏位的相同子命令(amulet、ring、belt、head、body、charm、any);curio 可作为别名使用 |
| I / O / P |
打开编辑器 / SNBT 页面 / NBT 树;当容器打开时,它们作用于鼠标所在的栏位 |
| K |
仅限 1.12.2:打开模组列表 |
所有命令需要权限等级 2;edit 还需要创造模式。按键可在 Options → Controls → Key Binds → Battle Correction(1.12.2 为 Options → Controls)中更改。在 1.20.1 和 1.21.1 中,P 也是原版“社交互动”界面的默认快捷键,在服务器上该界面会优先打开,因此请重新绑定其中之一的按键。
Configuration
在 1.20.1 和 1.21.1 中有两个配置文件。config/battlecorrection-battle.toml 包含上述战斗调整,config/battlecorrection-attribute.toml 包含全局属性值、生命偷取选项、饰品标记和物品编辑器。大多数选项也可在游戏内屏幕中修改(Mods → BattleCorrection → Config);curioNbtAttributes、itemEditorEnabled 和 itemEditorMaxNbtKb 仅存在于配置文件中。Bow Draw Speed 和 Item Use Speed 会在客户端和服务器端同时读取,因此请确保客户端和服务器的这两个值保持一致。
在 1.12.2 中所有内容都在 config/battlecorrection.cfg 中,分为 Battle Configuration、Attribute Configuration、Baubles Mark 和 Item Editor 类别,均可在游戏内编辑(Mods → Battle Correction → Config;K 打开模组列表)。
编辑器对单个物品、实体或方块实体的 NBT 大小限制在 1.20.1 和 1.21.1 中默认为 1024 KB,在 1.12.2 中为 256 KB,可通过 itemEditorMaxNbtKb 更改。
Requirements
| Minecraft |
Loader |
Optional |
| 1.21.1 |
NeoForge 21.1.265 或更高版本,Java 21 |
Curios API 9.5.1 或更高版本 |
| 1.20.1 |
Forge 47.x,Java 17 |
Curios API 5.14.1 或更高版本 |
| 1.12.2 |
Forge 14.23.5.2855 或更高版本,Java 8 |
Baubles |
请在客户端和服务端安装相同版本。1.21.1 和 1.20.1 的 jar 包已包含 Cloth Config API (Jar-in-Jar) 以支持配置界面,因此无需下载其他内容。如果没有安装 Curios 或 Baubles,饰品功能将保持关闭状态。在 1.21.1 上 Curios 必须为 9.5.1 或更高版本,在 1.20.1 上必须为 5.14.1 或更高版本,否则游戏将无法启动。
FAQ
普通玩家可以使用物品编辑器吗? 不可以。它需要权限等级 2 和创造模式,并且服务器在每次保存时都会再次检查这两项条件。设置 itemEditorEnabled 为 false 可完全关闭它。
为什么在服务器上 P 键会打开社交界面? 在 1.20.1 和 1.21.1 中,原版也使用 P 键打开其“社交互动”界面,而在服务器上该界面会在 NBT 树之前打开。请在 Options → Controls → Key Binds 中重新绑定其中一个按键。
配置更改需要重启吗? 大多数选项在保存后立即生效,尽管 1.12.2 的配置界面标记它们需要重启。攻击冷却时间和怪物最大生命值会在实体再次加入世界时应用,饰品属性选项会在物品重新穿戴时应用。
法杖和剑在哪里获取? 在战斗修正创造模式标签页中,或使用 /give 命令。没有合成配方。
更新前需要注意什么? 请先备份你的配置文件夹。更改日志选项卡列出了每个版本的变更内容以及你可能需要调整的项目。
源代码 · 问题反馈 · MC百科 (中文)
本模组采用 CC BY-NC-SA 4.0 许可证授权。1.21.1 和 1.20.1 的 jar 包包含了未修改的 Cloth Config API(LGPL-3.0)。
中文简介
战斗修正(BattleCorrection,简称 BC)为 NeoForge 和 Forge 加入 15 种战斗属性(暴击、吸血、闪避、魔法和弹射物伤害等,玩家和怪物都能带)、全局战斗数值调整(PVP、按伤害类型的倍率、环境伤害、无敌时间、攻击冷却、生物生命值、饥饿),以及给管理员用的游戏内物品和 NBT 编辑器(按 I 打开,需要 2 级权限和创造模式)。
1.21.1 版需要 NeoForge 21.1.265 及以上和 Java 21(可选 Curios API 9.5.1 及以上,已内置 Cloth Config API),1.20.1 版需要 Forge 47.x 和 Java 17(可选 Curios API 5.14.1 及以上(版本更低时游戏无法启动),已内置 Cloth Config API),1.12.2 版需要 Forge 14.23.5.2855 及以上和 Java 8(可选 Baubles)。客户端和服务端要装同一个版本。
完整中文介绍、属性表和配置说明见 MC百科。
BattleCorrection (BC) is for people who build RPG maps, modpacks and servers and want to set the combat numbers themselves. It adds 15 attributes such as critical chance, lifesteal and dodge that work on players and mobs, global multipliers for PVP, mob health, invulnerability frames and environmental damage, and an in-game editor for item names, lore, enchantments, attributes and raw NBT.
NeoForge 1.21.1, Forge 1.20.1 and 1.12.2 · install on both client and server · no other mods needed
What it adds
- 15 attributes that work on players and mobs alike: critical hits with overflow, two kinds of lifesteal, dodge chance, flat damage reduction, magic, arrow and projectile damage, bow and use speed, jump height.
- Global settings for PVP, damage dealt and taken by players per damage type, environmental damage, invulnerability frames, attack cooldown, mob health and hunger.
- Any single item can become a Curios or Baubles accessory, with attributes that only count while it is worn.
- An item editor for operators: coloured names and gradients, lore, enchantments, attributes, an NBT tree, an SNBT text editor and templates. It also edits entity and block entity NBT.
Item editor
Operators (permission level 2) in creative mode press I or run /battlecorrection edit. The editor opens on the held item, on the item under the mouse in any open inventory or chest, or, with an empty hand, on the entity or block entity you are looking at. O opens the SNBT page directly and P the NBT tree. The server checks permission, creative mode, the target and the NBT size again on every save, and itemEditorEnabled = false turns the editor off completely.
The editor is drawn by the mod itself: page tabs on the left, the current page in the middle, a live tooltip preview on the right, and Copy command, Import, the NBT size, Cancel and Save along the bottom. The screenshots are from 1.20.1, and 1.21.1 looks the same; what differs on 1.21.1 and 1.12.2 is listed at the end of this section.
Name and lore
Type & colour codes and &#RRGGBB hex colours, or click the swatches and format buttons to insert them at the cursor. Clear strips colour and format codes from the selection, and pasted § signs become &. Insert writes one colour; Gradient blends two colours letter by letter across the selected text, or the whole line when nothing is selected.

Name page: a gradient name, with the finished tooltip previewed on the right.
The Lore page has one row per line, with move up / down, delete and add. Enter splits a line at the cursor, Backspace at the start of a line joins it to the one above, and a multi-line paste fills several rows. Vanilla style switches between plain white text and vanilla's purple italic. Only the lines you change are rebuilt: lines holding things a text box cannot show (click events, hover text, custom fonts) are marked, and stay intact as long as you leave them alone.

Lore page: one row per line, each with move, delete and a live preview.
The palette button opens a colour picker with a saturation / brightness square, hue bar, RGB sliders, hex input and your 16 most recent colours. Gradients take 2 to 8 colour stops, with ten presets such as rainbow, fire and ocean, and a preview of the whole line.

Colour palette: a five-stop gradient with a preview of the whole line.
Enchantments and attributes
The item's enchantments are on the left, each next to its vanilla maximum level: left-click changes the level, right-click removes it. On the right, search every enchantment in the game, other mods' included, and click one to add it. Curses are shown in red, and hovering shows what an enchantment does. Levels go up to 255 (32767 on 1.12.2); levels above the vanilla maximum and enchantments vanilla would not allow on the item still apply.

Enchantments page: the item's enchantments on the left, every enchantment on the right.
Attributes work the same way: every registered attribute, vanilla or from any mod, in one searchable list, with a description on hover. Set the amount, operation and slot; typing 20% switches to a percentage. Choosing a Curios slot as the slot also lets the item be worn there.

Attributes page: critical chance, critical damage, lifesteal and magic damage on a sword.
Tags and slots
The Tags page sets Unbreakable, enchantment glint, hide flags, damage, anvil repair cost, count (1 to 127, or 1 to 99 on 1.21.1) and, on 1.20.1 and 1.21.1, CustomModelData. The Curios page is covered under Accessory marks below.
My Slots (1.20.1 and 1.21.1) is for testing accessories and changes your own Curios slots. It lists every slot type you have with its count: change a count (0 removes that type), or type an id to add a slot, even one no mod has registered (it just has no icon). Curios only gives slots to players who already have at least one slot type, so with none this page cannot change anything. For testing, devCurioSlots = true gives every player one of each of Curios' ten built-in slots; keep it off in normal play.

My Slots: your own Curios slots and their counts.
NBT tree and SNBT
The tree shows every tag with its type. Search keys and values (Ctrl+F), jump to a path such as tag.display.Lore[0], copy a node's path, edit keys and values in place, and add, delete, copy, paste, duplicate or move nodes.

NBT tree: typed nodes, a path box with jump, and the node buttons along the bottom.
The SNBT page edits the whole item as text, with line numbers, highlighting and live error marking; text that does not parse is never applied. It has find (Ctrl+F), go to line (Ctrl+G), indent, duplicate and move line, Format, Compact and & / § conversion.

SNBT page: Ctrl+Enter applies the text to the item.
Templates, import and changing the item
A template stores an item's full NBT and count under a name, on your own computer. Apply it whole, or tick only the parts you want (name, lore, enchantments, attributes, curio marks and so on) and keep the rest, for example to give several weapons the same enchantments and attributes.

Templates page: applying only the enchantments and attributes of a saved template.
Import reads a /give command, an item id with NBT, or item SNBT from the clipboard and replaces the current item. Copy command exports the item as a /give command; commands longer than 256 characters cannot be sent from chat, so run those from a command block or function. F4 or a click on the item icon in the title bar changes the item type and keeps its NBT and count. Search by name or id, or type @ and a mod id (such as @battlecorrection) to list one mod's items.

Change item (F4): @battlecorrection lists only this mod's items.
Entities and block entities
With an empty hand, I edits the entity under the crosshair (players excluded) or a block with a block entity, such as a chest, furnace or spawner. The entity and block entity editors have the NBT tree and SNBT pages and work just like they do for items.

Entity NBT editor: searching a villager's NBT for its profession.
Undo and saving
Ctrl+Z / Ctrl+Y undo and redo, and typing within one second counts as one step. Ctrl+Tab moves to the next page and Ctrl+1 to 9 jump straight to one. Closing with unsaved changes lists what changed and asks first.

Closing with unsaved changes lists them before anything is discarded.
Ctrl+S or Save sends the item to the server. The NBT size of one item is capped by itemEditorMaxNbtKb (1 MB on 1.20.1 and 1.21.1, 256 KB on 1.12.2 by default), and larger items are not saved. Past about 2 MB the vanilla client cannot read an item at all, and players holding one get disconnected. F1 lists every shortcut.

Keyboard shortcuts (F1).
On 1.21.1
Minecraft 1.21.1 stores item data as components instead of NBT tags, which changes a few things in the editor:
- The NBT tree, the SNBT page, Import, Copy command and templates use the 1.21.1 format: an
{id, count, components} root and commands like diamond_sword[custom_name='"Name"']. Commands, SNBT and templates written for 1.20.1 are converted automatically when pasted or loaded.
- Count goes up to 99 and lore up to 256 lines.
- In the NBT tree, everything under
components must be a valid component, and your own data goes into minecraft:custom_data. Until an edit is valid it stays in the tree, marked as not applied yet, and pages cannot be switched or saved.
- Hiding Unbreakable, Can Break, Can Place On, dye colour or armour trim needs the item to have that component, otherwise the switch is greyed out.
- The attribute slot list adds Both Hands, Armor and Body.
- When saving, the server checks the whole item against the game's own rules and reports what is invalid.
On 1.12.2
The editor is the same apart from what that game version allows. 1.12.2 has no hex colours, so the palette offers the 16 vanilla colours (no colour square or RGB sliders), gradients snap to the nearest of them and it remembers 8 recent colours. The attribute list holds vanilla, Forge and this mod's attributes plus any your player has, and other names can be typed in. The Tags page has no CustomModelData, the Curios page is a Baubles page, and there is no My Slots page.
Attributes
All 15 attributes exist on every living entity. Put them on gear with the editor, /give, a data pack or any tool that writes attribute modifiers; on 1.20.1 and 1.21.1 the /attribute command works on them too. Each attribute also has a global value in the config that applies to every entity, mobs included.
Ids below are for 1.20.1 and 1.21.1, as battlecorrection:<id>. On 1.12.2 the same names are written in camelCase after a dot: battlecorrection.magicDamage, battlecorrection.vanillaCriticalHitDamage and so on. The examples use Operation 0 (addition, called add_value on 1.21.1), which suits all 15.
| Attribute |
Id |
Effect (Operation 0) |
| Magic Damage |
magic_damage |
Extra damage on magic hits that have an attacker |
| Arrow Damage |
arrow_damage |
Extra damage on arrow hits (tridents count on 1.20.1 and 1.21.1) |
| Projectile Damage |
projectile_damage |
Extra damage on other projectiles, such as fireballs and spell projectiles |
| Damage Immunity |
immune_damage |
Chance to ignore a hit completely: +0.25 = 25% |
| Ignore Damage |
ignore_damage |
Subtracts a flat amount from every hit; hits at or below it are cancelled |
| Reduced Fall Damage |
reduced_fall_damage |
The same, for fall damage only |
| Healing Restoration |
restore_heal |
Healing multiplier: +0.5 = 150% healing |
| Lifesteal |
bloodthirsty |
Heals a share of melee damage dealt (players need a full charge): +0.1 = 10% |
| Almighty Lifesteal |
almighty_bloodthirsty |
The same for every damage type |
| Bow Speed |
bow_speed |
Bow draw speed (crossbows too on 1.20.1 and 1.21.1): +1.0 = twice as fast |
| Use Speed |
preparation_speed |
Use speed of food, potions and other held items: +1.0 = twice as fast |
| Jump Boost |
jump_lift |
Extra jump height: 1.0 is about one block |
| Vanilla Critical Damage |
vanilla_critical_hit_damage |
Adds to the vanilla jump-attack critical: +0.5 turns 150% into 200% |
| Critical Chance |
custom_critical_chance |
Chance of this mod's own critical hit on melee and projectile hits: 0.3 = 30% |
| Critical Damage |
custom_critical_damage |
Added to the critical multiplier, which is 2.0 by default: +1.0 = 3× damage |
Critical chance above 100% is not wasted: the excess is added to the multiplier. With the default settings a chance of 1.5 makes every hit critical for 2.5× damage. Melee hits and projectiles roll once each, and a piercing arrow keeps one roll for all its targets.
Operations and /give examples
Attributes that start at 0 (the three damage bonuses, Ignore Damage, Reduced Fall Damage, Jump Boost, Critical Chance and Critical Damage) only react to Operation 0 on 1.20.1 and 1.21.1. Attributes that start at 1.0 count what is above 1.0, so an amount of 0.25 on its own gives the same bonus with Operation 0 or 1. On 1.12.2, Operation 1 and 2 on Magic, Arrow and Projectile Damage scale the hit instead (0.5 = +50%).
A bow with +5 Arrow Damage on 1.20.1 (the editor's Copy command button writes commands like this for you):
/give @p bow{AttributeModifiers:[{AttributeName:"battlecorrection:arrow_damage",Name:"bonus",Amount:5.0d,Operation:0,UUID:[I;1,2,3,4],Slot:"mainhand"}]}

The same on 1.21.1:
/give @p bow[attribute_modifiers={modifiers:[{type:"battlecorrection:arrow_damage",id:"battlecorrection:bonus",amount:5.0,operation:"add_value",slot:"mainhand"}]}]
The same on 1.12.2:
/give @p minecraft:bow 1 0 {AttributeModifiers:[{AttributeName:"battlecorrection.arrowDamage",Name:"bonus",Amount:5.0d,Operation:0,UUIDMost:1L,UUIDLeast:1L,Slot:"mainhand"}]}
Combat tuning
Global settings, applied through Forge's damage and healing events, so weapons and damage from other mods are covered too. At their defaults they leave vanilla combat unchanged.
- PVP and self-damage multipliers, set separately; 0 turns either one off.
- Damage dealt and taken by players, per type: melee, arrow, projectile and magic. Magic stacks on top of the other three, so a player's fireball uses the projectile multiplier times the magic multiplier.
- Environmental damage taken by players (damage without a living attacker): a general multiplier plus fall, fire, drowning, freezing and explosion, applied after armor; 0 makes players immune. An optional floor makes each environmental hit deal at least a share of max health or a flat amount. Void damage and
/kill are never changed. 1.12.2 has no freezing category.
- Invulnerability time after a hit, for players and for other entities: 0 keeps vanilla, -0.5 halves it, 1.0 doubles it.
- Attack cooldown on or off (off gives 1.8-style combat), and combo correction, which scales uncharged swings by the attack charge, never below 50%.
- Max health of every non-player mob: 1.0 doubles it.
- Hunger: extra regeneration from saturation and from a high hunger bar (flat or a share of max health), and less damage dealt by players per missing hunger point, with an optional cap (0 means no cap).
- Spells from other mods count as magic damage. On 1.20.1 and 1.21.1, Iron's Spells 'n Spellbooks, Ars Nouveau, Goety, Sweet Magic and Geomancy Plus are recognised out of the box by mod namespace, together with the
forge:is_magic damage type tag (neoforge:is_magic and c:is_magic on 1.21.1), a whitelist and a blacklist. On 1.12.2 you list damage type prefixes. Melee hits by summons and pets never count as magic.
- Whether lifesteal is boosted by healing bonuses (on by default).

The in-game config screen on 1.20.1 (Mods → BattleCorrection → Config).
Accessory marks
With Curios (1.20.1 and 1.21.1) or Baubles (1.12.2) installed, an operator can mark one single item so it fits chosen accessory slots: a sword worn as a charm, a helmet worn as a ring. The mark is stored in the item's data (custom data on 1.21.1), so copies and trades keep it.
- A marked item is accessory-only. Its own attributes (armor, attack damage,
AttributeModifiers or attribute_modifiers, bonuses from other mods) apply only in the accessory slot, and marked armor can no longer be worn in armor slots.
- Extra attributes that count only while worn can be attached, optionally for one slot type.
- Right-click equips a marked item into a free slot; on 1.20.1 shift-click works in the Curios screen too.
- The tooltip lists the attributes in one section per slot.
- For accessories without a mark, a config option decides which vanilla-format attributes apply while worn:
ALL (default), MOD_ONLY or OFF.

Curios page on 1.20.1: this sword can now be worn in the Back and Hands slots, and its attributes are listed per slot in the preview.
Management staffs and test swords
Ten staffs for map makers and testing. They have no recipes and come only from the Battle Correction creative tab or /give, but anyone holding one can use it, in survival too. The area staffs work within 64 blocks, and every staff has a one-second cooldown.
All staffs and swords
| Item |
Use |
| Enemy Staff |
Click two mobs: they attack each other |
| Rebel Staff |
Click a mob: every mob within 64 blocks attacks it |
| Riot Staff |
Click a mob: it attacks random mobs nearby for 10 minutes |
| Brawl Staff |
Use in the air: all mobs within 64 blocks fight each other for 10 minutes |
| Elimination Staff |
Use in the air: mobs attack mobs of other species for 10 minutes |
| Healing Staff |
Click any living entity: full health |
| Range Healing Staff |
Full health for every living entity within 64 blocks of the target, players included |
| Sacrificial Staff |
Kills the clicked entity, players included |
| Range Sacrificial Staff |
Kills every non-player entity within 64 blocks of the target |
| Restoration Staff |
Removes all effects from the clicked entity |
| Base / Advanced / Master Sword |
10 / 100 / 1,000 attack damage, 1,000 / 10,000 / 100,000 durability |
Commands and configuration
Commands, keys and config files
Commands and keys
| Command or key |
What it does |
/battlecorrection edit |
Opens the editor on the held item; add snbt or nbt to open that page |
/battlecorrection curio add <slot> |
Lets the held item go into a Curios slot type (any = every slot); remove <slot>, clear and list manage the marks |
/battlecorrection curio attr add <attribute> <amount> |
Attaches an attribute that counts only while worn, optionally followed by an operation (add, multiply_base or multiply_total) and a slot; attr remove <attribute> [slot] and attr clear remove them |
/battlecorrection bauble ... |
1.12.2: the same subcommands for Baubles slots (amulet, ring, belt, head, body, charm, any); curio works as an alias |
| I / O / P |
Open the editor / SNBT page / NBT tree; with a container open they act on the slot under the mouse |
| K |
1.12.2 only: opens the mod list |
All commands need permission level 2; edit also needs creative mode. The keys can be changed under Options → Controls → Key Binds → Battle Correction (Options → Controls on 1.12.2). On 1.20.1 and 1.21.1, P is also vanilla's default Social Interactions Screen key, and on a server that screen opens first, so rebind one of the two.
Configuration
On 1.20.1 and 1.21.1 there are two files. config/battlecorrection-battle.toml holds the combat tuning above, and config/battlecorrection-attribute.toml holds the global attribute values, the lifesteal option, accessory marks and the item editor. Most options are also in the in-game screen (Mods → BattleCorrection → Config); curioNbtAttributes, itemEditorEnabled and itemEditorMaxNbtKb are only in the file. Bow Draw Speed and Item Use Speed are read on both sides, so keep those two values the same in the client and server files.
On 1.12.2 everything is in config/battlecorrection.cfg, with Battle Configuration, Attribute Configuration, Bauble Mark and Item Editor categories, all editable in game (Mods → Battle Correction → Config; K opens the mod list).
The editor's NBT size limit for one item, entity or block entity defaults to 1024 KB on 1.20.1 and 1.21.1 and 256 KB on 1.12.2 and can be changed with itemEditorMaxNbtKb.
Requirements
| Minecraft |
Loader |
Optional |
| 1.21.1 |
NeoForge 21.1.265 or newer, Java 21 |
Curios API 9.5.1 or newer |
| 1.20.1 |
Forge 47.x, Java 17 |
Curios API 5.14.1 or newer |
| 1.12.2 |
Forge 14.23.5.2855 or newer, Java 8 |
Baubles |
Install the same version on the client and the server. The 1.21.1 and 1.20.1 jars already contain Cloth Config API (Jar-in-Jar) for the config screen, so there is nothing else to download. Without Curios or Baubles the accessory features stay off. Curios must be 9.5.1 or newer on 1.21.1 and 5.14.1 or newer on 1.20.1, otherwise the game will not start.
FAQ
Can ordinary players use the item editor? No. It needs permission level 2 and creative mode, and the server checks both again on every save. Set itemEditorEnabled to false to turn it off completely.
Why does P open the social screen on a server? On 1.20.1 and 1.21.1 vanilla also uses P for its Social Interactions Screen, and on a server that screen opens before the NBT tree. Rebind one of the two under Options → Controls → Key Binds.
Do config changes need a restart? Most options apply as soon as they are saved, even though the 1.12.2 config screen marks them as needing a restart. Attack cooldown and mob max health apply when an entity joins the world again, and the accessory attribute option when the item is put on again.
Where do I get the staffs and swords? From the Battle Correction creative tab or with /give. There are no crafting recipes.
Anything to know before updating? Back up your config folder first. The changelog tab lists what each version changed and anything you may want to adjust.
Source code · Issues · MC百科 (中文)
Licensed under CC BY-NC-SA 4.0. The 1.21.1 and 1.20.1 jars include Cloth Config API (LGPL-3.0), unmodified.
中文简介
战斗修正(BattleCorrection,简称 BC)为 NeoForge 和 Forge 加入 15 种战斗属性(暴击、吸血、闪避、魔法和弹射物伤害等,玩家和怪物都能带)、全局战斗数值调整(PVP、按伤害类型的倍率、环境伤害、无敌时间、攻击冷却、生物生命值、饥饿),以及给管理员用的游戏内物品和 NBT 编辑器(按 I 打开,需要 2 级权限和创造模式)。
1.21.1 版需要 NeoForge 21.1.265 及以上和 Java 21(可选 Curios API 9.5.1 及以上,已内置 Cloth Config API),1.20.1 版需要 Forge 47.x 和 Java 17(可选 Curios API 5.14.1 及以上(版本更低时游戏无法启动),已内置 Cloth Config API),1.12.2 版需要 Forge 14.23.5.2855 及以上和 Java 8(可选 Baubles)。客户端和服务端要装同一个版本。
完整中文介绍、属性表和配置说明见 MC百科。
评论 0
登录后参与评分
还没有评论,来抢沙发吧