增益效果

增益效果

一个状态效果引擎:对玩家和NPC施加限时或永久增益与减益。模组通过它施加效果;它负责计时、叠加和治愈。/bfx命令、编辑器窗口,以及服务器所有者设定的上限。MIT。

实用

BuffEffects

面向 Hytale 服务器的状态效果引擎。 为玩家和 NPC 提供限时或永久增益与减益:加速或减速移动、提高或降低伤害、抗性、持续治疗、持续伤害、无法跳跃、无法攻击、半透明幽灵外观等。其他模组通过 BuffEffects 施加效果,由它管理计时、堆叠、驱散与移除,任何模组都无需自行维护这些机制。

管理员可使用 /bfx 命令,以及通过 /bfx 打开的编辑窗口,浏览所有已加载效果、创建新效果、对自身进行测试,并查看谁携带了哪些效果。

需要 Mod Settings Manager 和 CommandDeck 1.2.0 或更高版本。与 SpellCrafter 1.0 和 CommandDeck 1.2.0 同步发布。

特性

  • 所有效果只有一个所有者。 模组通过 BuffEffects 施加、移除和驱散效果。它负责计时、堆叠规则以及记录谁施加了什么,并在效果结束时通知来源模组。
  • 限时或永久。 效果持续指定时间或直到被移除。玩家离线期间效果暂停,服务器重启后仍保留;每个效果可指定死亡时的处理方式:清除、保留剩余时间或重新开始。
  • 效果可以做什么: 改变某项属性的最大值(生命、耐力、法力)、单次治疗或恢复、持续恢复(除非效果另有说明,否则受到伤害会打断)、持续伤害、穿透抗性的单次打击、对某种伤害类型的抗性或弱点、提高或降低造成的伤害、速度、锁定移动(全部、跳跃或冲刺)、禁用动作(攻击、技能、使用等)、受到的击退、无敌、无形(可穿过生物、不被 NPC 察觉且无法攻击),以及携带者周围的彩色光。除游戏自带伤害类型外,还有七种伤害类型:暗影、神圣、奥术、心灵、音波、疾病和混乱,每种都有自己的伤害颜色。此外,效果开始、消退、被驱散或持续期间可发送聊天消息。
  • 使用游戏内视觉: 色调、粒子、模型效果、屏幕覆盖、图标、音效、动画和模型变化,以及幽灵的半透明外观(最高 90%)。
  • 也支持游戏自带效果。 Hytale 的效果(例如 Burn)可通过其自身 id 施加,窗口会像描述其他效果一样描述它们。
  • 堆叠与刷新。 每个效果可指定再次施加时的行为:刷新、延长、堆叠或忽略。堆叠类别可防止例如两个速度效果叠加。
  • 驱散。 驱散所有有害效果、带有诸如 poison 标签的效果,或按名称驱散某个效果。
  • 服务器所有者设置的上限。 每种伤害类型的抗性(默认 90%)、无敌、眩晕和定身的最长持续时间,重复眩晕和定身的递减收益,以及恢复。每次拒绝都会说明触及的上限。通过 id 施加的游戏自带效果保留其自身数值。
  • 强度评级,可见。 每个效果都以强度分级表示,显示在窗口和 /bfx info 中。在 1.0 中,评级仅供参考;不会因评级而禁用任何内容。
  • 日志记录。 每次施加、移除和命令都会记录,包括操作者和请求的模组。

编辑窗口

输入 /bfx(管理员)。有四个标签页:

  • Effects(效果): 所有已加载效果,按模组分组,支持搜索和筛选。游戏自带效果归入“Hytale”组。选择一项即可查看其作用、持续时间和评级。
  • Editor(编辑器): 创建或修改效果:名称、持续时间和堆叠方式、组成部分,以及在 Hytale 中的外观(色调为 #RRGGBB,粒子、模型效果、音效和模型从游戏的实时列表中选择)。“Wrap in new effect(包装为新效果)”可从游戏自带效果开始创建。保存会将其写入服务器本地的 default 模组,或作为其他模组效果的覆盖。Test on me(对我测试) 会将其施加到你身上。
  • Active(活动): 当前谁携带了什么,包括剩余时间、堆叠数和来源,以及一个移除按钮。
  • Test(测试): 对自身或指定玩家施加任何已加载效果,或执行试运行,说明会发生什么以及为何会被拒绝,而不实际施加任何内容。

安装

  1. 安装 Mod Settings Manager 和 CommandDeck 1.2.0 或更高版本。
  2. 将 BuffEffects-1.0.0.jar 放入服务器的 mods 文件夹(单人游戏:%APPDATA%\Hytale\UserData\Mods\)。
  3. 输入 /bfx。

BuffEffects 本身不附带任何效果:单独使用时,它提供游戏自带效果以及你在窗口中创建的效果。使用它的模组会自带自己的效果。

命令与权限

一个根命令,/bfx(也写作 /buffeffects)。

命令 作用
/bfx 或 /bfx editor 打开窗口
`/bfx list [\ tag:\
/bfx info <effect> 效果的作用、持续时间、适用游戏和强度评级
/bfx show [player] 你或另一名玩家身上的效果,含剩余时间和来源
/bfx apply <player> <effect> [seconds] [strength] 施加效果
`/bfx remove <effect\ all>`
`/bfx cure [harmful\ tag:\
/bfx check <player> <effect> [seconds] [strength] 试运行:说明 apply 会做什么,以及为何会拒绝
/bfx help 显示命令

效果通过完整 id <mod id>/<id> 命名,或在无歧义时使用短 id。游戏自带效果为 hytale:<id>,例如 hytale:Burn。

权限: 所有人均可对自己使用 /bfx list、/bfx info 和 /bfx show。buffeffects.show.others 允许玩家查看他人的效果。buffeffects.editor 打开窗口,buffeffects.apply 施加和试运行,buffeffects.remove 移除,buffeffects.cure 驱散;管理员拥有全部权限。每个效果也有自己的权限节点,默认为 buffeffects.apply.<mod id>.<id>,在玩家施加时也会检查,因此服务器可允许所有人对自己施加无害的装扮效果。

设置

BuffEffects 的设置位于 Mod Settings Manager(/modsettings):

  • 上限: 玩家和 NPC 每种伤害类型的抗性、是否受区域原版上限约束、无敌持续时间及之后的免疫时间、最长眩晕和定身、递减收益、评级上限,以及低于区域来袭伤害时的恢复。
  • 消息: 效果是否可以发送消息、无专属消息效果的通用消退提示(“Spooked has worn off.”),以及向附近玩家发送消息的半径。
  • 日志: 日志保留天数。

上限仅对服务器所有者及其指定人员可见和可修改。

兼容性

  • Hytale 服务器 0.7.6。
  • 专用服务器和单人游戏。
  • 需要 Mod Settings Manager 和 CommandDeck 1.2.0 或更高版本。

已知问题

  • 状态图标的计时器在重载或重生后,或当效果以其默认时长以外的时长施加时,可能显示为满格或比例错误。时间本身保存正确;/bfx show 可查看。
  • 浅色调几乎不可见,例如幽灵外观上的蓝白色。请使用饱和颜色。
  • 漂浮姿态会让脚接触地面:效果目前还无法抬高身体。
  • **游戏自带的“清除效果”**会使效果姿态卡住(这是游戏自身行为)。通过 BuffEffects 移除该效果可结束姿态。
  • 光照远强于其半径所示: 光照部件照亮范围远超其半径。目前请使用小半径(2 到 4);该比例会在后续版本中修复。

致模组作者

你的模组在 jar 中的附属文件里定义效果:Effects/<Group>_<Name>.effects.json,并通过 BuffEffects 的 Java API 施加它们。每个效果是一组游戏中立的部件,外加一个在 Hytale 中定义外观的绑定。

例如,一个效果 spooked,名称为 Spooked,有害,类别为 Halloween,持续 30 秒,再次施加时刷新。其部件包括 0.8 的速度倍率、施加时的消息(“You feel watched.”)和消退时的消息(“The feeling passes.”)。其 Hytale 绑定在持续期间赋予蓝色色调。

  • **附属文件是纯数据,**在加载时校验。错误只会拒绝该效果,并给出指明文件、效果和字段的消息,绝不会停止服务器或其他模组的效果。
  • **将 BuffEffects 列为可选依赖,**绝不要列为必需依赖。未安装 BuffEffects 时,不会读取附属文件,你的模组应继续正常工作。
  • API(buffeffects.api)可施加、移除和驱散效果,查询目标携带的效果,执行试运行,描述效果,并在效果被施加、拒绝或结束时发送事件。调用方可为单次施加改写效果消息,因此法术或任务奖励可给同一效果使用自己的措辞。每个效果还会以稳定名称 BFX_<mod id>_<id> 注册为 Hytale 效果,以便 NPC 角色引用。
  • **管理员可在不编辑你的模组的情况下更改你的效果,**通过服务器覆盖来替换或禁用一个效果。

许可证

MIT,版权所有 (c) 2026 Hledjolf。

问题和错误报告:本页面的评论。