Attribute PVP Helper

战斗助手 Mod

适用于 Minecraft 1.21.11（Fabric）的 PvP 战斗辅助模组

功能特性

造成伤害追踪器

在快捷栏中实时显示对敌人造成的伤害。当你击中实体时，会以红色和黄色显示造成的具体伤害数值。

• 格式：伤害：5.2
• 追踪距离最远可达 30 格
• 每次命中后显示 3 秒

受到伤害指示器

显示被敌人击中时所受到的伤害。帮助你了解在战斗中承受的伤害量。

• 格式：受到伤害：3.5
• 每次受到攻击后显示 3 秒
• 有助于评估威胁等级

长矛战斗助手

提供长矛突刺条件的实时反馈。模组会精确显示成功发动突刺攻击所需的条件。

状态提示：

• 蓄力长矛... — 全力充能你的攻击
• 向前移动以突刺！ — 你需要向前的动力
• 突刺就绪（绿色）— 已满足最佳条件

突刺要求：

• 蓄力攻击充能至最大（90% 或更高）
• 向前移动
• 处于空中或下落状态（跳跃有助于触发）
• 不在水中

武器切换检测

通过通知消息可视化属性切换过程。显示你从哪种武器切换到了哪种武器。

• 格式：切换：铁剑 → 钻石剑
• 检测到切换时以绿色显示
• 即时确认装备变更

锤子射程助手

手持锤子时显示最近实体的距离。帮助你判断目标是否处于有效攻击范围内。

• 格式：锤子射程：4.2 格
• 显示最近实体距离
• 实时更新

安装方法

1. 从发布页面下载 modid-1.0.0.jar
2. 将其放入你的 .minecraft/mods/ 文件夹中
3. 启动已安装 Fabric Loader 的 Minecraft
4. 所有功能将自动启用

用户使用方法

下载模组。打开 Minecraft 所在的文件夹，将其放入 mods 文件夹中。

开发者使用方法

在单人模式下测试模组：

gradlew runClient

从源代码构建模组：

gradlew build

编译生成的 JAR 文件位于：build/libs/modid-1.0.0.jar

PvP 战斗指南

属性切换

使用快捷栏数字键（1-9）在武器间快速切换。模组会以通知消息确认每次切换，显示你切换到了哪种武器。

• 按下快捷栏按键即可立即切换
• 留意切换确认消息

长矛突刺技巧

要稳定实施长矛突刺：

1. 先跳跃以确保处于空中
2. 按住攻击键为攻击充能
3. 在攻击充能时向前移动
4. 观察绿色“突刺就绪”消息
5. 松开按键执行突刺

解读伤害数值

同时观察造成的伤害和受到的伤害，以调整你的战术：

• 高输出伤害：你的攻击正在有效命中
• 高承受伤害：你可能需要更好的护甲或治疗
• 记录数据模式以理解对战形势

锤子战斗

使用锤子时：

• 攻击前先检查射程指示器
• 锤子比剑有更好的攻击距离
• 在中近距离内效果最佳

技术细节

语言：Java 21 Minecraft 版本：1.21.11 Fabric Loader：0.18.2 或更高版本 Fabric API：0.139.4 或更高版本

主要组件：

• CombatAssistant.java — 主要逻辑处理和事件监听器
• SpearHelper.java — 长矛突刺条件检测
• DamageDealtTracker.java — 实体伤害追踪
• DamageIndicator.java — 伤害显示系统
• SpearOptimizationMixin.java — 服务端优化 Mixin

兼容性

支持多人游戏服务器（无需在服务器安装模组） 支持单人游戏世界 兼容其他 Fabric 模组 多人游戏服务器中可能因延迟优化而出现错误

从源代码构建（面向开发者）

环境要求：

• Java 21 或更高版本
• Gradle

构建：

gradlew build

运行客户端：

gradlew runClient

该模组使用 Fabric Loom 进行开发，使用 Mixin 进行字节码修改。

许可证

本模组在 CC0 许可证（公有领域）下发布。