Statusworks

Statusworks

一个用于在玩家和生物上自定义状态、池、标记和冷却时间的库,可在API或CraftTweaker中定义。

Statusworks 是一个用于追踪玩家和生物自定义状态的库:带层数的状态、资源池、两个实体之间的标记,以及冷却。整合包作者通过 CraftTweaker 脚本定义它们,模组作者则通过 Java API 定义。Statusworks 本身不添加任何内容或玩法效果。在客户端,它会在自己的 HUD 上显示你的药水效果,取代原版的显示,除非你关掉这个功能。

AI 使用免责声明:本模组在开发过程中使用了 此 agent 工作流 的 AI agent 辅助。项目所有者在开发期间审查了相关工作。


它能做什么

整合包或模组可以用 Statusworks 构建的一些东西:

  • 怒气: 每次命中给予一层,最多 5 层;每层增加攻击伤害,当你停止战斗时层数会一层一层地衰减。
  • 护盾: 一个缓慢填充的资源池,在你的生命值之前吸收伤害。
  • 连击: 为每个攻击者分别保存的层数,因此同一个玩家的连续第五次命中会造成双倍伤害。
  • 狩猎: 从玩家到其最后命中的生物的一个标记,只有该玩家能看见粒子,并在狩猎持续期间获得护甲。
  • 冲刺: 两个物品共享的一个冷却。
  • 流血、中毒或诅咒 等效果,每次施加都保留一个计时器;会消耗并回复的法力或体力;两个玩家之间的束缚,当他们分开时暂停。

面向玩家

  • 右上角的 HUD 会显示每个条目的图标、层数、时间,以及资源池的进度条。你自己的药水效果也会显示在那里,因此一个地方就能看到所有信息。
  • 在物品栏中,指向某个条目会解释它:它的作用、确切时间,以及它来自谁。
  • 某些条目会在生物和玩家身上显示粒子,只对整合包指定的玩家可见。
  • 你在 config/statusworks-client.cfg 中的设置:可将 HUD 移动到九个屏幕位置中的任意一个,更改其大小和顺序,显示名称而非图标,隐藏单个条目,关闭粒子,或保留原版的药水显示。这些设置不会改变游戏中的任何内容。

面向整合包作者

安装 CraftTweaker 后,脚本可以定义状态、从任何事件中更改它,并在它变化时运行代码:

import mods.statusworks.Statuses;
import mods.statusworks.Presentation;
import crafttweaker.event.EntityLivingHurtEvent;
import crafttweaker.player.IPlayer;

Statuses.define("mypack:rage")
    .limit(5)
    .expiration("gradual")
    .defaultDuration(100)
    .contributeAttribute("generic.attackDamage", "add", "per_stack", 1.0)
    .presentation(Presentation.create().name("Rage").iconItem("minecraft:blaze_powder", 0))
    .register();

events.onEntityLivingHurt(function(event as EntityLivingHurtEvent) {
    val attacker = event.damageSource.trueSource;
    if (!isNull(attacker) && attacker instanceof IPlayer && !event.entityLivingBase.world.remote) {
        Statuses.add(attacker, "mypack:rage", 1);
    }
});
  • 状态、资源池、标记和冷却各有自己的选项:共享的、逐层衰减的或每次施加独立运行的计时器;每个来源的层数;会填充、消耗或转移到目标身上的资源池;带目标上限和距离的标记;死亡规则。
  • 它们可以添加属性加成,例如攻击伤害、最大生命值、速度或护甲,这些加成会跟随层数或资源池的填充程度。
  • 回调会在状态被施加、变化、填满、清空、结束或按间隔运行时执行。
  • /statusworks 可检查并更改任何实体上的状态,列出每个定义及其脚本文件,并为测试记录每次更改。
  • 使用默认的脚本加载器;不支持位于 #loader preinit 下的脚本。

指南:编写 Statusworks 脚本。五个可直接复制的完整脚本:示例。

面向模组作者

com.mahghuuuls.statusworks.api 中的 Java API 为你的模组提供同样的四种状态,适用于任何生物,并为你处理保存、客户端同步、HUD 条目、粒子和属性加成:

  • 在启动期间用构建器注册定义,然后从你的代码中添加、移除和查询状态。
  • 注册你自己的贡献类型,让状态和资源池驱动你自己的数值,例如法力回复。
  • 在状态变化时以 lambda 形式获取回调。
  • 在客户端读取玩家的可见条目,以绘制你自己的视觉效果。

Statusworks 不需要其他库;CraftTweaker 是可选的。

指南:从 Java 模组使用 Statusworks。示例:JavaExample.java。

安装

在服务端和每个客户端上都安装 Statusworks。

源代码:github.com/mahghuuuls/statusworks