Skip to content

⚔️ RPG-style combat enhancement mod for Minecraft 1.12.2. Custom attributes, critical system, lifesteal, and battle balance.

Notifications You must be signed in to change notification settings

Roinflam/BattleCorrection

Repository files navigation

⚔️ BattleCorrection | 战斗修正

CurseForge Downloads MC Version Forge

GitHub Bilibili


🌏 Choose Your Language / 选择语言

🇺🇸 English (Click to expand/collapse)

📖 About

BattleCorrection is an RPG-style combat enhancement mod for Minecraft 1.20.1. It introduces a comprehensive attribute system, advanced critical hit mechanics, lifesteal abilities, and extensive battle balance options. Perfect for RPG modpacks and servers that want deeper combat customization.

✨ Features

  • 🎯 15+ Custom Attributes - Magic damage, arrow damage, lifesteal, dodge chance, and more
  • 💥 Advanced Critical System - Custom crit chance & damage with overflow conversion mechanic
  • 🩸 Lifesteal Mechanics - Melee lifesteal and universal lifesteal for all damage types
  • ⚖️ Battle Balance - Fine-tune PVP damage, attack cooldown, invulnerability frames
  • 🍖 Hunger System - Enhanced hunger regeneration and damage decay based on hunger level
  • 💍 Curios Support - Full integration with Curios accessory slots
  • 🛡️ Damage Reduction - Flat damage ignore and fall damage reduction
  • Speed Modifiers - Bow draw speed and item use speed adjustments
  • 🧰 Management Tools - Creative staffs for entity control, healing, and more
  • 🔧 Highly Configurable - In-game config GUI powered by Cloth Config
  • 🎮 1.9+ Combat - Toggle attack cooldown and combo correction systems

📥 Installation

  1. Download Minecraft Forge for 1.20.1 (latest version recommended)

  2. Download BattleCorrection from CurseForge

  3. Install required dependencies

  4. Install the mod

    • Place all .jar files into .minecraft/mods/ folder
    • Launch Minecraft with Forge profile
  5. Done! Open Mod Menu and configure BattleCorrection settings

🎯 Attribute System

⚔️ Damage Attributes
Attribute Description
Magic Damage Bonus damage for magic attacks (potions, modded magic)
Arrow Damage Bonus damage for bow and crossbow attacks
Projectile Damage Bonus damage for non-arrow projectiles
🛡️ Defense Attributes
Attribute Description
Immune Damage Chance to completely dodge incoming attacks
Ignore Damage Flat damage reduction from all sources
Reduced Fall Damage Flat fall damage reduction
❤️ Recovery Attributes
Attribute Description
Restore Heal Multiplier for all healing received
Bloodthirsty Lifesteal from melee attacks (requires full charge)
Almighty Bloodthirsty Lifesteal from ALL damage types
💨 Speed Attributes
Attribute Description
Bow Speed Increases bow draw speed
Preparation Speed Increases item use speed (food, potions, shields)
Jump Lift Increases jump height
💥 Critical System
Attribute Description
Vanilla Critical Damage Bonus damage for fall-attack crits
Custom Critical Chance Base chance for custom crits (supports overflow)
Custom Critical Damage Damage multiplier when crit occurs

Overflow Mechanic: When crit chance exceeds 100%, the overflow converts to bonus crit damage!

🧰 Management Tools

⚔️ Combat Staffs
Item Description
Enemy Staff Make two entities fight each other
Rebel Staff Make all nearby entities attack one target
Riot Staff Make an entity attack random nearby entities
Brawl Staff Make all nearby entities fight each other
Elimination Staff Make different species attack each other
❤️ Healing Staffs
Item Description
Healing Staff Fully restore one entity's health
Range Healing Staff Fully restore all nearby entities
Sacrificial Staff Instantly kill one entity
Range Sacrificial Staff Instantly kill all nearby non-players
Restoration Staff Remove all potion effects from an entity
⚔️ Example Swords
Item Attack Damage Durability
Base Sword 9 1,000
Advanced Sword 99 10,000
Master Sword 999 100,000

These swords demonstrate the mod's attribute system

⚙️ Configuration Options

🎮 Battle Settings
Option Description
PVP Damage Multiplier for player vs player damage
Self Damage Multiplier for self-inflicted damage
Combo Correction Uncharged attacks deal reduced damage
Attack Cooldown Enable/disable 1.9+ attack cooldown
Hurt Time Adjust invulnerability frames for entities/players
Hunger Decay Damage reduction based on hunger level
📊 Damage Multipliers
Option Description
Player Melee/Arrow/Projectile/Magic Attack Output damage multipliers
Player Suffers Melee/Arrow/Projectile/Magic Incoming damage multipliers
Entity Max Health Health multiplier for non-player entities
🍖 Hunger System
Option Description
Saturation Healing (Flat) Extra HP per tick from saturation
Saturation Healing (Percent) Extra HP% per tick from saturation
Hunger Healing (Flat) Extra HP per tick when hunger ≥ 18
Hunger Healing (Percent) Extra HP% per tick when hunger ≥ 18
Hunger Damage Decay Damage reduction per missing hunger point
Hunger Decay Limit Maximum damage reduction cap

🔧 Requirements

Component Version
Minecraft 1.20.1
Forge 47.3.0 or higher
Java 17 or higher
Dependencies Cloth Config (Required)
Optional Curios API (Recommended)

🤝 Compatibility

  • Curios API - Full accessory slot attribute support
  • Most weapon mods - Attributes work with any damage source
  • RPG modpacks - Designed for integration
  • Multiplayer - Full server/client synchronization

📚 Documentation

❓ FAQ

How do I add attributes to items?

Use data packs, NBT editing tools, or mods like KubeJS/CraftTweaker to add attribute modifiers to items. The attributes will be automatically recognized. For Curios accessories, the attributes work automatically when worn.

Does lifesteal work with bows?

Yes! "Almighty Bloodthirsty" works with ALL damage types including arrows, projectiles, and magic.

What is the overflow mechanic?

When your critical chance exceeds 100%, the excess is converted to bonus critical damage. For example, 150% crit chance = 100% crit + 0.5× bonus crit damage (configurable conversion rate).

Can I disable attack cooldown?

Yes! Set "Attack Cooldown" to false in the config to get 1.8-style combat with no cooldown.

How do I configure the mod?

Open the Mods menu (Mod List), find BattleCorrection, and click the config button. You can also edit the config files directly in config/battlecorrection-battle.toml and config/battlecorrection-attribute.toml.

📜 License

Custom License:

  • ✅ Free for personal use and modification
  • ✅ Free to include in modpacks
  • ❌ No commercial use without permission
  • ⚠️ Modified redistributions must credit the original author

👤 Credits

Developer: Roinflam
Special Thanks: 建议重开 (for support and assistance)


🇨🇳 中文 (点击展开/折叠)

📖 关于模组

战斗修正是一个为 Minecraft 1.20.1 制作的 RPG 风格战斗增强模组。它引入了全面的属性系统、高级暴击机制、吸血能力和丰富的战斗平衡选项。非常适合需要深度战斗自定义的 RPG 整合包和服务器。

✨ 特色功能

  • 🎯 15+ 自定义属性 - 魔法伤害、箭矢伤害、吸血、闪避几率等
  • 💥 高级暴击系统 - 自定义暴击率和暴击伤害,支持溢出转化机制
  • 🩸 吸血机制 - 近战吸血和全能吸血(对所有伤害类型有效)
  • ⚖️ 战斗平衡 - 精细调整 PVP 伤害、攻击冷却、无敌帧
  • 🍖 饥饿系统 - 增强的饥饿恢复和基于饥饿值的伤害衰减
  • 💍 Curios 支持 - 完整的饰品栏属性联动
  • 🛡️ 伤害减免 - 固定伤害忽略和摔落伤害减免
  • 速度调整 - 拉弓速度和物品使用速度
  • 🧰 管理工具 - 创造模式权杖,用于实体控制、治疗等
  • 🔧 高度可配置 - 游戏内配置界面,由 Cloth Config 驱动
  • 🎮 1.9+ 战斗 - 可切换攻击冷却和连击修正系统

📥 安装方法

  1. 下载 Minecraft Forge 1.20.1 版本(推荐最新版)

  2. 下载战斗修正从 CurseForge

  3. 安装必需前置

  4. 安装模组

    • 将所有 .jar 文件放入 .minecraft/mods/ 文件夹
    • 使用 Forge 启动游戏
  5. **完成!**打开模组菜单,配置战斗修正设置

🎯 属性系统

⚔️ 伤害属性
属性 描述
魔法伤害 魔法攻击的额外伤害(药水、模组魔法)
箭矢伤害 弓和弩攻击的额外伤害
弹射物伤害 非箭矢弹射物的额外伤害
🛡️ 防御属性
属性 描述
免疫伤害 完全闪避攻击的几率
忽略伤害 所有来源的固定伤害减免
减少摔落伤害 固定摔落伤害减免
❤️ 恢复属性
属性 描述
治疗恢复 受到的所有治疗的倍率
吸血 近战攻击的生命偷取(需要完全蓄力)
全能吸血 所有伤害类型的生命偷取
💨 速度属性
属性 描述
拉弓速度 提高弓的蓄力速度
使用速度 提高物品使用速度(食物、药水、盾牌)
跳跃提升 增加跳跃高度
💥 暴击系统
属性 描述
原版暴击伤害 下坠暴击的额外伤害
自定义暴击率 自定义暴击的基础几率(支持溢出)
自定义暴击伤害 暴击触发时的伤害倍率

**溢出机制:**当暴击率超过 100% 时,溢出部分会转化为额外暴击伤害!

🧰 管理工具

⚔️ 战斗权杖
物品 描述
敌对权杖 使两个生物互相攻击
叛军权杖 使周围所有生物攻击一个目标
暴动权杖 使生物攻击附近随机生物
群殴权杖 使附近所有生物互相攻击
消灭权杖 使不同种类的生物互相攻击
❤️ 治疗权杖
物品 描述
治疗权杖 完全恢复一个生物的生命
范围治疗权杖 完全恢复附近所有生物的生命
献祭权杖 立即杀死一个生物
范围献祭权杖 立即杀死附近所有非玩家生物
恢复权杖 移除生物的所有药水效果
⚔️ 示例武器
物品 攻击伤害 耐久
基础之剑 9 1,000
进阶之剑 99 10,000
大师之剑 999 100,000

这些剑用于演示模组的属性系统

⚙️ 配置选项

🎮 战斗设置
选项 描述
PVP 伤害 玩家对玩家伤害倍率
自伤 自我伤害倍率
连击修正 未蓄力攻击伤害降低
攻击冷却 启用/禁用 1.9+ 攻击冷却
无敌时间 调整实体/玩家的无敌帧
饥饿衰减 基于饥饿值的伤害减少
📊 伤害倍率
选项 描述
玩家近战/箭矢/弹射物/魔法攻击 输出伤害倍率
玩家承受近战/箭矢/弹射物/魔法 受到伤害倍率
实体最大生命 非玩家实体的生命值倍率
🍖 饥饿系统
选项 描述
饱和度固定恢复 饱和度恢复时每刻额外生命值
饱和度百分比恢复 饱和度恢复时每刻额外生命百分比
饥饿值固定恢复 饥饿值≥18时每刻额外生命值
饥饿值百分比恢复 饥饿值≥18时每刻额外生命百分比
饥饿伤害衰减 每少1点饥饿值的伤害减少
饥饿衰减上限 最大伤害减少百分比

🔧 运行需求

组件 版本
Minecraft 1.20.1
Forge 47.3.0 或更高
Java 17 或更高
前置模组 Cloth Config(必需)
可选前置 Curios API(推荐)

🤝 兼容性

  • Curios API - 完整的饰品栏属性支持
  • 大多数武器模组 - 属性适用于任何伤害来源
  • RPG 整合包 - 专为整合设计
  • 多人游戏 - 完整的服务端/客户端同步

📚 文档资料

❓ 常见问题

如何为物品添加属性?

使用数据包、NBT 编辑工具或模组如 KubeJS/CraftTweaker 为物品添加属性修改器。属性会被自动识别。对于 Curios 饰品,佩戴后属性会自动生效。

吸血对弓箭有效吗?

有效!"全能吸血"对所有伤害类型都有效,包括箭矢、弹射物和魔法。

什么是溢出机制?

当暴击率超过 100% 时,超出部分会转化为额外暴击伤害。例如,150% 暴击率 = 100% 暴击 + 0.5 倍额外暴击伤害(转化比例可配置)。

可以禁用攻击冷却吗?

可以!在配置中将"攻击冷却"设为 false,即可获得 1.8 风格的无冷却战斗。

如何配置模组?

打开模组菜单(模组列表),找到战斗修正,点击配置按钮。你也可以直接编辑配置文件:config/battlecorrection-battle.tomlconfig/battlecorrection-attribute.toml

📜 许可证

自定义许可证:

  • ✅ 可自由用于个人使用和修改
  • ✅ 可自由加入整合包
  • ❌ 未经许可禁止商业使用
  • ⚠️ 修改后重新发布必须注明原作者

👤 制作人员

开发者: Roinflam
特别鸣谢: 建议重开(提供支持和帮助)


Made with ❤️ by Roinflam

"Change the way and difficulty in battle, more suitable for RPG games!"

GitHub Stars

About

⚔️ RPG-style combat enhancement mod for Minecraft 1.12.2. Custom attributes, critical system, lifesteal, and battle balance.

Topics

Resources

Stars

Watchers

Forks

Languages