- 版权类型
- 原创
- 插件中文名称
- 投影打印机拦截
- 插件英文名称
- PrinterGuard
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
PrinterGuard 是一款面向 Minecraft 系服务端的投影打印行为防护插件。直接在服务端分析玩家的方块放置与挖掘行为，在发现疑似投影打印特征时自动取消相关操作。
经过本人服务器的深度测试与运行。完美拦截 原版 二改 三改 四改的任意版本的投影打印机模组 制作这款插件的原因也是因为魔改版本能刷物品
插件采用纯服务端实现，一份 JAR 即可运行于 Paper、Folia、Purpur、Leaves 与 Spigot，适合需要限制 Litematica Printer 及其改版打印功能的生存服、建筑服和群组子服。
核心技术亮点
1. 多维行为组合检测
插件不会只依赖单一的“放置速度”判定，而是综合检测单刻多次操作、缺少正常挥手、视线偏离目标、短时间高速放置以及机械式等间隔操作。多项规则可独立启用并调整阈值，在拦截效果与误判率之间自由取舍。
2. 独立的异常挖掘识别
除方块放置外，PrinterGuard 还提供专门的挖掘检测。插件会结合固定向下的破坏面与缺少普通挥手动作等行为特征进行判断，不会仅因玩家挖掘速度较快就直接拦截，尽量避免影响创造模式与合法秒破操作。
3. Bukkit 与 Folia 多核心兼容
插件只调用 Bukkit/Spigot 公共运行接口，并声明支持 Folia。玩家检测状态使用并发容器保存，每名玩家的检测器独立串行处理，可兼容 Paper、Folia、Purpur、Leaves 与 Spigot，无需分别下载不同版本。
4. 轻量级事件处理
所有检测均由服务端事件实时触发，不创建高频轮询任务。事件处理期间不会访问磁盘、数据库或网络，也不会遍历全服玩家、实体、区块或世界；热路径仅进行哈希表与短队列运算，玩家退出后会立即释放对应状态。
5. 完整的生命周期与配置迁移
插件支持标准的启用、禁用、卸载与重新加载流程。禁用时会释放事件监听器和玩家检测状态；旧版配置可自动迁移并补齐新配置项，无需手动重建配置文件。
核心功能
投影放置拦截：检测方块放置以及水桶、岩浆桶等产生方块变化的操作。
五类放置规则：支持单刻多次操作、缺少挥手、视线偏离、高速放置和机械节奏检测。
异常挖掘检测：通过破坏面与挥手行为组合识别已知打印机改版的挖掘特征。
检测锁定机制：玩家触发检测后，可在指定时间内持续取消其放置或挖掘操作，也可设置为锁定至重载、重置或重启。
白名单系统： 支持玩家名与完整 UUID，名称匹配不区分大小写，可通过指令实时添加或移除。
权限绕过：可通过权限插件向指定玩家授予 `printerguard.bypass`，使其绕过全部检测。
灵活处置方式： 支持取消可疑操作、向玩家发送提示、在控制台记录判定原因与坐标，以及首次触发时可选踢出玩家。
状态查询： 管理员可查看插件总状态、检测记录数量、白名单数量，以及指定在线玩家的放置与挖掘检测状态。
热重载配置：修改阈值、开关、提示消息或处置方式后，可通过指令即时重载，无需重启服务器。
## 插件指令
`/pg status [玩家]` - 查看插件运行状态，或查询指定在线玩家的检测状态
`/pg reload` - 热重载配置文件并清空当前检测状态
`/pg allow <玩家名或UUID>` - 将玩家加入检测白名单
`/pg deny <玩家名或UUID>` - 将玩家移出检测白名单
`/pg reset <在线玩家>` - 清除指定玩家的检测状态并解除当前锁定
完整指令名称为 `/printerguard`，可使用 `/pg` 作为别名；指令参数支持 Tab 补全。
插件权限
`printerguard.admin` - 使用全部管理指令，默认授予 OP
`printerguard.bypass` - 绕过全部放置与挖掘检测，默认不授予任何玩家
> 注意：OP 不会自动获得 `printerguard.bypass`。需要绕过检测时，请通过权限插件明确授予。
经过本人服务器的深度测试与运行。完美拦截 原版 二改 三改 四改的任意版本的投影打印机模组 制作这款插件的原因也是因为魔改版本能刷物品
插件采用纯服务端实现，一份 JAR 即可运行于 Paper、Folia、Purpur、Leaves 与 Spigot，适合需要限制 Litematica Printer 及其改版打印功能的生存服、建筑服和群组子服。
核心技术亮点
1. 多维行为组合检测
插件不会只依赖单一的“放置速度”判定，而是综合检测单刻多次操作、缺少正常挥手、视线偏离目标、短时间高速放置以及机械式等间隔操作。多项规则可独立启用并调整阈值，在拦截效果与误判率之间自由取舍。
2. 独立的异常挖掘识别
除方块放置外，PrinterGuard 还提供专门的挖掘检测。插件会结合固定向下的破坏面与缺少普通挥手动作等行为特征进行判断，不会仅因玩家挖掘速度较快就直接拦截，尽量避免影响创造模式与合法秒破操作。
3. Bukkit 与 Folia 多核心兼容
插件只调用 Bukkit/Spigot 公共运行接口，并声明支持 Folia。玩家检测状态使用并发容器保存，每名玩家的检测器独立串行处理，可兼容 Paper、Folia、Purpur、Leaves 与 Spigot，无需分别下载不同版本。
4. 轻量级事件处理
所有检测均由服务端事件实时触发，不创建高频轮询任务。事件处理期间不会访问磁盘、数据库或网络，也不会遍历全服玩家、实体、区块或世界；热路径仅进行哈希表与短队列运算，玩家退出后会立即释放对应状态。
5. 完整的生命周期与配置迁移
插件支持标准的启用、禁用、卸载与重新加载流程。禁用时会释放事件监听器和玩家检测状态；旧版配置可自动迁移并补齐新配置项，无需手动重建配置文件。
核心功能
投影放置拦截：检测方块放置以及水桶、岩浆桶等产生方块变化的操作。
五类放置规则：支持单刻多次操作、缺少挥手、视线偏离、高速放置和机械节奏检测。
异常挖掘检测：通过破坏面与挥手行为组合识别已知打印机改版的挖掘特征。
检测锁定机制：玩家触发检测后，可在指定时间内持续取消其放置或挖掘操作，也可设置为锁定至重载、重置或重启。
白名单系统： 支持玩家名与完整 UUID，名称匹配不区分大小写，可通过指令实时添加或移除。
权限绕过：可通过权限插件向指定玩家授予 `printerguard.bypass`，使其绕过全部检测。
灵活处置方式： 支持取消可疑操作、向玩家发送提示、在控制台记录判定原因与坐标，以及首次触发时可选踢出玩家。
状态查询： 管理员可查看插件总状态、检测记录数量、白名单数量，以及指定在线玩家的放置与挖掘检测状态。
热重载配置：修改阈值、开关、提示消息或处置方式后，可通过指令即时重载，无需重启服务器。
## 插件指令
`/pg status [玩家]` - 查看插件运行状态，或查询指定在线玩家的检测状态
`/pg reload` - 热重载配置文件并清空当前检测状态
`/pg allow <玩家名或UUID>` - 将玩家加入检测白名单
`/pg deny <玩家名或UUID>` - 将玩家移出检测白名单
`/pg reset <在线玩家>` - 清除指定玩家的检测状态并解除当前锁定
完整指令名称为 `/printerguard`，可使用 `/pg` 作为别名；指令参数支持 Tab 补全。
插件权限
`printerguard.admin` - 使用全部管理指令，默认授予 OP
`printerguard.bypass` - 绕过全部放置与挖掘检测，默认不授予任何玩家
> 注意：OP 不会自动获得 `printerguard.bypass`。需要绕过检测时，请通过权限插件明确授予。
