
生命体征
一个提供有关玩家状态和事件的详细且对模组友好的信息的 Minecraft 模组。
Vital Signals
[ English | 简体中文 ]
一个为 Minecraft 模组提供详细玩家状态信息和事件系统的库。该库提供了对模组友好的 API,使其他模组能够接收并处理关于玩家重要状态变化(如生命值、饥饿值、氧气水平等)的事件。
简介
Vital Signals 是一个专为 Minecraft 模组开发者设计的事件库。它利用 Fabric API 提供底层事件钩子和网络同步,使模组能够精确追踪各种玩家属性变化。
- 🎯 详细数据捕获:捕获伤害计算过程的每一个阶段。
- 🔧 对模组友好的 API:简单易用的事件注册系统。
- 📡 自动网络同步:服务端自动将数据同步至客户端。
- 🛡️ 完整的减伤信息:记录所有减伤来源(护甲、盾牌、魔法等)。
特性
已完成特性
伤害事件 ✅
一个全面的伤害计算追踪系统,在玩家受到伤害时记录所有详细信息。
计划中的特性
- 🔜 死亡事件 [v0.2.0]:玩家死亡时的完整信息。
- 🔜 饥饿事件 [v0.3.0]:饥饿值和饱和度水平的变化。
- 🔜 氧气事件 [v0.4.0]:水下氧气水平的变化。
快速开始
添加依赖
将此库添加到你的 build.gradle 中:
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
dependencies {
modImplementation 'com.github.Rainy-day-y:Vital-Signals:v0.1.2'
}
伤害事件数据结构 (DamageData)
通过网络发送的伤害事件数据结构,使用 NBT 格式:
| 字段 | 类型 | 描述 |
|---|---|---|
gameVersion |
String |
Minecraft 游戏版本 |
version |
Int |
数据格式版本号 |
isDirect |
Boolean |
是否为直接伤害 |
typeId |
Int |
伤害类型 ID |
phase |
String |
当前伤害计算阶段 |
isCancelled |
Boolean |
伤害是否被取消 |
damageAmount |
Float |
最终伤害值(对生命值的实际影响) |
rawDamageAmount |
Float |
原始伤害值 |
difficultyReduced |
Float |
难度减免量 |
shieldBlocked |
Float |
盾牌格挡量 |
iceReduced |
Float |
冰霜行者靴子减免 |
helmetReduced |
Float |
海龟壳 / 雪地靴减免 |
armorReduced |
Float |
护甲减免量 |
effectAndEnchantmentReduced |
Float |
魔法效果和附魔减免 |
absorbed |
Float |
伤害吸收量 |
otherReduced |
Float |
其他减免(计算差值) |
数据包示例
{
gameVersion: "1.21.1",
version: 1,
isDirect: true,
typeId: 0,
phase: "FINAL",
isCancelled: false,
damageAmount: 5.0,
rawDamageAmount: 10.0,
difficultyReduced: 0.0,
shieldBlocked: 0.0,
iceReduced: 0.0,
helmetReduced: 0.0,
armorReduced: 2.0,
effectAndEnchantmentReduced: 0.5,
absorbed: 2.5,
otherReduced: 0.0
}
路线图
v0.1.2(当前版本)- 伤害事件
- 伤害事件基础设施
- 完整的减伤信息捕获
- 网络同步至客户端
- 对模组友好的 API
v0.2.0(计划中)- 死亡事件
- 玩家死亡事件触发
- 详细的死亡原因信息
- 物品掉落前钩子
- 经验值掉落信息
v0.3.0(计划中)- 饥饿事件
- 饥饿值变化事件
- 饱和度变化事件
- 饥饿状态变化
v0.4.0(计划中)- 氧气事件
- 氧气水平变化事件
- 溺水状态追踪
- 水下呼吸效果检测
v1.0.0(计划中)- 正式发布
- 所有核心事件完善
- API 稳定性保证
- 完整的文档和示例
- 性能优化
许可证
本项目采用 MIT 许可证。
贡献
欢迎提交 Issue 和 Pull Request!如有建议或问题,请通过 GitHub Issues 联系我们。
相关链接
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。