生命体征

生命体征

一个提供有关玩家状态和事件的详细且对模组友好的信息的 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 联系我们。

相关链接