
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。
正在加载版本记录…


正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。