CYCyLicenseLICENSE CENTER
获取插件

PLUGIN DOCS

CyScavenger

村民违规附魔清理：检测村民交易中的非法附魔，删除交易或移除村民。

免费 v2.0.2 Paper 1.21.11

简介

CyScavenger 用于清理村民身上的违规附魔交易，主要是修复旧版 ExcellentEnchants 留在村民交易里的附魔。

处理方式

  • REPLACE：只删除违规交易，保留村民和其他正常交易（推荐）
  • KILL：取消交互并移除整个村民，无掉落、无经验

触发方式

  • 玩家右键村民时检测
  • 只检测主手交互，忽略被取消的事件
  • 没有违规附魔时不处理、不提示

支持环境

项目要求
服务端Paper 1.21.11
JavaJava 21
软依赖ExcellentEnchants（清理对象，非硬依赖）
硬依赖无

安装

  1. 把 CyScavenger-2.0.2.jar 放进 plugins/。
  2. 重启服务器，生成 config.yml 和 logs/。
  3. 确认 enabled: true。
  4. 选择 mode: REPLACE 或 mode: KILL。
  5. 按需维护 illegal-enchants 黑名单。

命令

命令作用
/cyscavenger help / /csc help查看帮助
/cyscavenger info查看插件详情
/cyscavenger reload重载配置

旧命令 /scavenger、/sc 在 2.0.0 已移除。

权限

权限默认说明
cyscavenger.infoOP查看详情
cyscavenger.reloadOP重载配置

配置

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

prefix: "&8[ &bCyScavenger &8] &r "
message: "&7当前村民产出违规附魔,已被系统清除"
enabled: true
mode: REPLACE
check-ingredients: false

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

illegal-enchants:
  - auto_reel
  - bane_of_netherspawn
  - blast_mining
  - curse_of_breaking
  - veinminer
字段说明
modeREPLACE 删除违规交易；KILL 移除村民
check-ingredients是否连收购物品一起检查
illegal-enchants违规附魔 ID 黑名单
log.enabled是否写日志文件
log.retention-days日志保留天数
log.clean-time每日清理时刻

黑名单匹配规则：

  • 带命名空间（namespace:id）：比较完整键。
  • 不带命名空间：只比较附魔名，兼容 EE 开关命名空间的情况。

日志

日志在 plugins/CyScavenger/logs/年-月-日.log，每条包含：

  • 时间
  • 玩家
  • 处理模式
  • 村民职业
  • 村民坐标（世界 + XYZ）
  • 被清理的附魔键

控制台输出始终保留，不受 log.enabled 影响。

变量与 API

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

常见问题

右键村民没反应？

确认 enabled: true、玩家主手交互、村民交易里确实有 illegal-enchants 中的附魔。没有违规时不会提示。

为什么村民被整个删了？

mode: KILL 会移除村民；只想删违规交易请改成 REPLACE。

附魔 ID 怎么写？

带 : 比全键，不带 : 只比附魔名。建议先用 /cyscavenger info 或日志确认实际键名。

旧版 /scavenger 还能用吗？

2.0.0 已移除，使用 /cyscavenger 或 /csc。

更新日志

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

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

  • 插件更名 Scavenger → CyScavenger，数据目录迁移到 plugins/CyScavenger/。
  • 主命令改为 /cyscavenger，别名 /csc；旧 /scavenger、/sc 移除。
  • 新增 help / info / reload 三个命令和权限过滤。
  • 配置补齐改为文本级原位插入，不覆盖已有内容。
  • 日志按天分文件，支持保留天数和定时清理。

1.0.0（2026-10-01 · 首发）

  • 右键村民检测违规附魔交易。
  • REPLACE / KILL 两种处理模式。
  • 附魔黑名单支持命名空间匹配。
获取插件 全部文档