生命偷取

生命偷取

一个实现了可定制版LifeSteal SMP的Fabric模组

工具

LifeSteal

LifeSteal SMP 的 Fabric 服务端实现

更新至 v2.0.0 的注意事项

自 v1.2.0 以来已有大量改动,因此配置差异很大(我主要只是添加了内容)

另外,如果你想在玩家生命值降为 0 时禁用封禁,请查看配置中的 punishment 部分,它已被移动到这里

必需模组

本模组依赖 BFAPI

命令

本模组添加了一个命令,可用于修改和获取玩家损失的生命值,其大致结构如下:

/alias [get [uuid/name]]/[set [uuid/name] value]

这允许在不进行漫长的服务器重启的情况下管理玩家的生命值

配置

配置文件位于配置目录下的 lifesteal.json

{
  "comment-maxHealth": "可以获得的*总*生命值上限,如果小于 0 则会被忽略",
  "maxHealth": -1.0,
  "comment-minHealth": "某人可以达到的*总*生命值下限,当达到此值时,他们无法被用来获取生命值",
  "minHealth": 0.0,
  "comment-healthToLooseOnDeath": "玩家死亡时损失的生命值数量",
  "healthToLooseOnDeath": 2.0,
  "comment-looseHealthOnlyOnPlayerRelatedDeath": "此开关决定玩家是否会因非玩家造成的死亡而损失生命值,如果为 true 则不会",
  "looseHealthOnlyOnPlayerRelatedDeath": false,
  "punishment": {
    "banWhenHealthReachesZero": true,
    "banReason": {
      "text": "You have been banned due to your health reaching 0!"
    }
  },
  "comment-notEnoughHeartsMessage": "当你击杀一个没有足够生命值可供击杀你的玩家时显示的消息",
  "notEnoughHeartsMessage": {
    "text": "The player did not have any hearts you could steal"
  },
  "command": {
    "comment-enableCommands": "是否应注册命令",
    "enableCommands": true,
    "comment-aliases": "命令将注册的别名",
    "aliases": [
      "lifesteal",
      "ls"
    ],
    "comment-permission": "修改玩家生命值所需的权限*如果你没有权限数据库,等级可以设置为所需的操作员等级*",
    "permission": {
      "node": "lifesteal.modify",
      "level": "op_3"
    },
    "comment-successMessage": "当玩家设置另一名玩家的生命值时发送给该玩家的文本",
    "successMessage": {
      "color": "green",
      "text": "Done!"
    },
    "comment-successMessageFile": "当玩家设置另一名玩家的生命值但对方不在线时发送给该玩家的文本,此时会将其存储起来,待该玩家加入时应用",
    "successMessageFile": {
      "color": "green",
      "text": "Done! (to file)"
    },
    "comment-broadcastToOps": "设置玩家生命值是否应向所有操作员广播",
    "broadcastToOps": true
  },
  "recipe": {
    "comment-allowCraftingOfHealth": "如果在 lifesteal:health 下未找到自定义配方,是否应注册默认配方",
    "allowCraftingOfHealth": true,
    "comment-registerRequirements": "除非遇到冲突错误,否则不要禁用此项,其他模组的配方可能依赖它",
    "registerRequirements": true,
    "comment-registerResults": "除非遇到冲突错误,否则不要禁用此项,其他模组的配方可能依赖它",
    "registerResults": true
  },
  "marks": {
    "comment-enableMarks": "是否应监听 marks,生命值物品需要此项",
    "enableMarks": true,
    "comment-marks": "将被监听的 marks 列表,如果你移除/修改其中任何一项,请确保更新合成配方的 mark",
    "marks": [
      "lifesteal",
      "health"
    ],
    "comment-limiter": "玩家在被阻止前可以消耗生命值的最大次数,如果 <1 则会被忽略",
    "limiter": -1,
    "output": {
      "comment-markOutputSuccess": "当实体成功消耗带标记的物品时发送给该实体",
      "markOutputSuccess": {
        "text": "You consumed some health"
      },
      "comment-markOutputFailed": "当实体因未通过限制器检查而未能消耗带标记的物品时发送给该实体",
      "markOutputFailed": {
        "color": "red",
        "text": "You have already consumed your fill of health"
      },
      "comment-broadcastToOpsMarks": "当玩家消耗带标记的物品时是否应告知操作员",
      "broadcastToOps": true
    }
  }
}

链接

API 使用

本模组添加了一个(简单接口)[https://github.com/BradBot1/LifeSteal/blob/master/src/main/java/com/bb1/fabric/lifesteal/LifeStealable.java] 以将其用作 API,即 LifeStealable

LifeStealable 允许模组获取玩家损失的生命值并按需修改,同时也允许在自定义实体上实现它,以便这些实体可在死亡时被用来获取生命值

任何 LifeStealable 实现都应在生命值变化时始终调用 setLostHealth

对 BFAPI 的补充

Marks

LifeSteal 添加了一组可自定义的 marks(各 mark 请查看子项 marks),默认值为 lifesteal 和 health

当这些 marks 被应用到 ItemStack 上,且该 ItemStack 被使用时,会向用户发送相应的消息:

如果用户获得的生命值多于限制器所允许的数量,则会发送 markOutputFailed,否则发送 markOutputSuccess

配方

LifeSteal 现在添加了几个配方需求/结果

需求

LifeSteal 为自定义配方添加了 3 个新需求,它们是:

需求 ID 描述 期望类型
losthealth> 确保合成者至少损失了给定数量的生命值 整数
losthealth< 确保合成者损失的生命值少于给定数量 整数
losthealth= 确保合成者损失了给定数量的生命值 整数

这些可用于将配方锁定到特定生命值水平,例如将 losthealth< 设为 -2 将只允许已获得一颗心的玩家合成

结果

LifeSteal 为自定义配方添加了 3 个新结果,它们是:

结果 ID 描述 期望类型
gainhealth 给予玩家给定数量的生命值 整数
loosehealth 从玩家处扣除给定数量的生命值 整数
sethealth 将玩家损失的生命值设置为给定数量 整数