CYCyLicenseLICENSE CENTER
获取插件

PLUGIN DOCS

CyAnvilPunishReset

铁砧惩罚重置：手持“过于昂贵”的物品，付费清除铁砧惩罚等级。

免费 v2.0.2 Paper 1.21.11

简介

CyAnvilPunishReset 用来清除物品的铁砧惩罚（“过于昂贵”）。玩家手持带有惩罚的物品，执行 /apr reset 发起重置，再输入 /apr confirm 确认并扣除金币。

核心功能

  • 只处理主手物品
  • 先发起、再确认，避免误扣款
  • 金币不足、物品无惩罚、主手为空都有明确提示
  • 管理员可远程重置指定玩家主手物品
  • 配置热重载

支持环境

项目要求
服务端Paper 1.21.11
JavaJava 21
软依赖Vault + 经济插件（收费时需要）
硬依赖无

安装

  1. 把 CyAnvilPunishReset-2.0.2.jar 放进 plugins/。
  2. 重启服务器，生成 config.yml。
  3. 设置 settings.reset-cost 和 confirm-timeout。
  4. 给玩家 cyanvilpunishreset.reset 权限。
  5. 手持带有铁砧惩罚的物品，执行 /apr reset。

玩家命令

命令作用
/apr help / /cyanvilpunishreset help查看帮助
/apr info查看手持物品的铁砧惩罚信息
/apr reset发起重置（需主手持有物品）
/apr confirm确认重置并扣除花费

confirm-timeout 内不确认会失效，需要重新发起。

管理命令

命令作用
/apr reload重载配置
/apr admin reset <玩家>为指定在线玩家重置主手物品

权限

权限默认说明
cyanvilpunishreset.reset所有人发起/确认重置
cyanvilpunishreset.info所有人查看物品信息
cyanvilpunishreset.reloadOP重载配置
cyanvilpunishreset.adminOP为其他玩家重置

配置

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

settings:
  message-prefix: "&8[ &b铁砧重置 &8] &r "
  reset-cost: 1000.0
  confirm-timeout: 60
  debug: false

messages:
  reset-prompt: "&7输入 &f/apr confirm &7确认重置，将花费 &f{cost} &7金币"
  reset-confirm: "&7已重置手持物品的铁砧惩罚，花费 &f{cost} &7金币"
  reset-no-money: "&7金币不足，需要 &f{cost} &7金币"
  no-item: "&7主手没有持有物品"
  no-penalty: "&7该物品没有铁砧惩罚"
字段说明
reset-cost每次重置花费金币
confirm-timeout确认有效期（秒）
debug控制台输出执行/失败原因
messages所有提示文案

变量与 API

CyAnvilPunishReset 当前版本没有公开 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 仍占用名额，先在网站解绑，再在新服务器启动。

常见问题

提示“主手没有持有物品”？

重置只处理主手物品；把要重置的物品拿在主手再执行。

提示“该物品没有铁砧惩罚”？

物品没有“过于昂贵”惩罚，或惩罚已经被清除。可以先用 /apr info 查看。

扣款失败怎么办？

检查 Vault 和经济插件是否正常、玩家余额是否足够；扣款失败时重置会取消。

确认超时了？

默认 60 秒内输入 /apr confirm；超时需要重新 /apr reset。

更新日志

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

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

  • 当前版本；项目此前没有独立更新日志，先记录当前版本。
  • 支持 /apr reset / confirm、管理员远程重置和配置重载。
  • 支持金币收费、确认超时和详细提示。

1.0.0

  • 初版铁砧惩罚重置。
获取插件 全部文档