PLUGIN DOCS

CyDeathpenalty

死亡惩罚：按配置扣除经验、金币、物品，执行指令，或扣蟠桃血量。

简介

CyDeathpenalty 在玩家死亡时按配置执行惩罚。所有惩罚默认关闭，需要逐项启用。

支持的惩罚

• 经验扣除：固定等级或按当前等级比例
• 金币扣除：固定金额或按余额比例；可把扣款转给击杀者当赏金
• 物品掉落：固定件数或按比例；可保护快捷栏、装备栏和带指定 lore 的物品
• 指令惩罚：可配置多条，支持任意数量
• 蟠桃血量扣除：按 PeachHP 血量门槛阶梯扣除

支持环境

安装

1. 把 CyDeathpenalty-2.0.2.jar 放进 plugins/。
2. 重启服务器，生成 config.yml。
3. 在 punishments 下把要启用的项改成 enabled: true。
4. 配置免罚权限、免罚世界和日志。
5. 测试死亡流程；建议先在测试服验证。

使用方式

插件没有玩家命令，死亡时自动触发。

• 拥有 settings.bypass-all 的玩家不触发任何惩罚。
• 在 settings.exempt-worlds 里的世界死亡不触发惩罚。
• 每类惩罚有独立 bypass 权限，可单独跳过。

权限

节点名可以在配置里改，以实际配置为准。

配置

主配置在 plugins/CyDeathpenalty/config.yml。

全局

settings:
  bypass-all: "deathpenalty.bypass.all"
  message-prefix: "&8[&c死亡惩罚&8]: "
  debug: false
  exempt-worlds: []

经验

punishments:
  exp:
    enabled: false
    bypass-permission: "deathpenalty.bypass.exp"
    mode: FIXED        # FIXED / RATIO
    amount: 50.0
    message: "&c你的经验被扣除了 &r{amount} &c级"

FIXED 扣固定等级，RATIO 按当前等级百分比扣。

金币

money:
  enabled: false
  bypass-permission: "deathpenalty.bypass.money"
  mode: FIXED
  amount: 100.0
  message: "&c你的金币被扣除了 &r{amount}"

可选的击杀赏金：

killer-reward:
  enabled: true
  ratio: 100.0
  message: "&a你击杀了 {player}, 获得赏金 {amount} 金币"

物品掉落

drop:
  enabled: false
  bypass-permission: "deathpenalty.bypass.drop"
  mode: FIXED
  amount: 3.0
  protection:
    inventory-permission: "deathpenalty.protection.inventory"
    equipment-permission: "deathpenalty.protection.equipment"
    protected-lore:
      - "灵魂绑定"
      - "Soulbound"

protected-lore 命中名称或 lore 的物品不会掉落。

指令惩罚

commands:
  - enabled: false
    bypass-permission: "deathpenalty.bypass.command.1"
    commands:
      - "eco take %player% 100"
    message: "&c你被罚款 &r100 &c金币"

可以复制多段，序号对应 bypass 权限。

蟠桃血量

peach:
  enabled: false
  bypass-permission: "deathpenalty.bypass.peach"
  tiers:
    - threshold: 100.0
      amount: 2.0
    - threshold: 500.0
      amount: 5.0
    - threshold: 1000.0
      amount: 10.0

命中满足条件的最高一档；未达到任何门槛不扣。

日志

logs:
  enabled: true
  retention-days: 7
  clean-time: "00:00"

日志在 plugins/CyDeathpenalty/logs/年-月-日.log。

变量与 API

CyDeathpenalty 当前版本没有公开 API，也没有注册独立的 PlaceholderAPI 变量。

许可证验证

本插件启用前会校验许可证：插件把 license.yml 里的许可证号发送到授权服务器，服务器用私钥签名，插件用内置公钥验证签名。校验不通过时插件不会启用。

首次启动

• 必须联网：第一次启动没有缓存，联网校验失败会直接停止加载。
• 首次启动会在插件目录生成 license.yml。
• 控制台出现「许可证验证通过」表示正常。

license.yml

# 插件目录下的 license.yml
license:
  key: "CYP-XXXX-XXXX-XXXX"

许可证号在网站 用户中心 查看，一个账号只有一个许可证，所有插件共用。

免费插件与付费插件

心跳与缓存

• 运行期间每小时向服务器发一次心跳。
• 服务器临时无法连接时，有 7 天宽限期，期间插件继续可用。
• 服务器明确返回「许可证无效 / 已被禁用」时，立即停止，没有宽限。
• 插件被禁用后，需要到网站解绑或联系作者处理。

常见问题

控制台提示「无法连接验签服务器」

检查服务器能否访问 https://license.mc33.top，以及是否只启用了 IPv6（授权站仅支持 IPv4）。

提示「当前许可证未开通本插件」

到网站 兑换码 页面输入兑换码开通，或确认购买的是这个插件。

提示「IP 数量已达上限」

每个插件最多绑定 2 个 IP，到用户中心解绑旧服务器后再启动。

更换服务器后无法启动

旧 IP 仍占用名额，先在网站解绑，再在新服务器启动。

常见问题

死了没有扣钱？

检查 punishments.money.enabled、Vault/经济插件、玩家余额和 bypass 权限。

物品没有掉？

检查 drop.enabled、drop.mode、保护权限和 protected-lore；灵魂绑定物品默认受保护。

怎么只在某些世界生效？

用 settings.exempt-worlds 排除安全世界；列表为空表示所有世界都生效。

调试为什么没触发？

把 settings.debug 设为 true，控制台会打印每条惩罚的执行/跳过原因。

更新日志

按时间倒序，最新的在最上面。当前版本是 2.0.0。

2.0.0（2026-10-08 · 当前版本）

• 当前版本；项目此前没有独立更新日志，先记录当前版本。
• 支持经验、金币、物品、指令和蟠桃血量五类惩罚。
• 支持分类 bypass、免罚世界和日志。

1.0.0

• 初版死亡惩罚框架。