Grim Anticheat - 高性能开源反作弊

GrimAC 是一款免费开源的 Minecraft 反作弊插件，旨在支持最新的 Minecraft 版本。目前支持 1.8 至 1.21 版本，并完全豁免 Geyser（基岩版）玩家。

💡项目状态

此项目在 2.0（开源）分支上被视为功能完整。如果您希望修复错误或增强功能但无法赞助开发工作，欢迎提交 Pull Request。计划推出高级版本，将提供基于订阅的付费检测功能，例如启发式分析。

🎮下载链接

以下是唯一的官方下载链接

• Modrinth: Modrinth
• Hangar: Hangar
• SpigotMC: SpigotMC
• 开发构建版（前沿）: 使用 Github artifacts

🔧安装与要求

• 现在需要 Java 17 或更高版本。
• 目前支持 Paper、Spigot 和 Folia 服务端。
• 如果您使用 Geyser，请将 Floodgate 安装在后端服务器上，以便 Grim 能豁免基岩版玩家。如果 Floodgate 安装在代理端，Grim 将无法访问其 API。
• 如果您使用 ViaVersion，它也应安装在后端服务器上，因为移动检测高度依赖于客户端版本。

❓支持与资源

• 支持与讨论: Discord
• 问题反馈: Issues
• Wiki 与示例: Wiki

⭐开发者信息

• 源代码: Github
• API 源码与信息: GrimAPI

✨Grim 的优势

是什么让 Grim 在其他反作弊插件中脱颖而出？

移动模拟引擎

• 我们拥有与玩家可能移动轨迹 1:1 复现 的模拟引擎。
• 覆盖了从基础行走、游泳、击退、蜘蛛网到气泡柱的所有情况。
• 甚至涵盖了骑乘实体，包括船、猪和炽足兽。
• 构建于覆盖各种边缘情况以确保准确性。
• 全面支持版本差异：1.13+ 客户端在 1.13+ 服务器、1.12- 客户端在 1.13+ 服务器、1.13+ 客户端在 1.12- 服务器，以及 1.12- 客户端在 1.12- 服务器，无论这些版本之间存在多大的技术变更。
• 碰撞顺序取决于客户端版本，且模拟正确。
• 考虑版本间细微的碰撞箱差异，例如：
• 单片玻璃板对 1.7-1.8 玩家呈 + 形，对 1.9+ 玩家呈 * 形。
• 1.13+ 客户端在 1.8 服务器上通过 ViaVersion 看到的玻璃板碰撞箱为 + 形。
• 许多其他方块也拥有这种极致的细节关注。
• 对于 1.12 或更低版本的玩家，含水方块不存在。
• 客户端版本中不存在的方块会使用 ViaVersion 的替换方块。
• 无法转换到旧版本的方块数据会被正确替换。
• 已实现所有原版碰撞箱。

完全异步与多线程设计

• 所有移动检测和绝大多数监听器都在 Netty 线程上运行。
• 反作弊可扩展至数百甚至更多玩家。
• 仔细考虑了线程安全性。
• 下一代核心支持此设计。

完整的世界复现

• 反作弊为每位玩家维护一个世界副本。
• 副本通过监听区块数据包、方块放置和方块变化来创建。
• 在所有版本中，区块使用调色板技术压缩至每区块 16-64 KB。
• 利用此缓存，反作弊可以安全地访问世界状态。
• 按玩家划分的缓存支持多线程设计。
• 通过数据包向玩家发送虚假方块是安全的，不会导致误判。
• 为每位玩家重建世界以实现延迟补偿。
• 客户端侧方块不会与基于数据包的方块产生冲突。方块透视漏洞不会导致反作弊误判。

延迟补偿

• 世界变化会排队，直到到达玩家。
• 这意味着在玩家下方破坏方块不会导致反作弊误判。
• 从飞行状态到移动速度，一切都会进行延迟补偿。

物品栏补偿

• 追踪玩家的物品栏状态，以防止在高延迟下产生幽灵方块和其他错误。

安全设计，而非隐蔽

• 所有系统都设计为高度安全，在数学上无法被绕过。
• 例如，预测引擎知晓所有可能的移动轨迹，因此无法被绕过。

欢迎使用 Minecraft 插件文档。本页面提供了插件的核心信息，包括功能、命令、权限及常见问题。如需更详细的指南、配置说明或更新日志，请访问我们的 Wiki 获取完整文档。

💡重要须知

• 本插件需要 Spigot 1.16.5 或更高版本的服务器。
• 首次使用前，请确保已正确配置 config.yml。
• 定期备份您的世界和数据文件。

🎮核心功能

本插件旨在增强服务器的游戏体验与管理效率，主要功能包括：

经济与商店

• 集成 Vault 经济系统，支持玩家间交易与商店购买。
• 创建和管理多种类型的商店（如收购店、出售店）。
• 支持物品、经验、游戏币等多种交易货币。

家园与传送

• 玩家可设置个人家园，并使用命令快速传送。
• 支持设置多个家园位置，并为其设置独立名称。
• 管理员可管理所有玩家的家园，并提供跨世界传送支持。

领地保护

• 允许玩家创建私人领地，保护建筑与物品。
• 支持设置领地权限（如建造、使用容器、PVP）。
• 提供可视化领地边界，方便管理。

玩家管理

• 查看在线玩家的详细状态与信息。
• 管理玩家背包、经验、生命值与游戏模式。
• 提供禁言、踢出、封禁等基础管理功能。

🔧命令列表

以下是插件的主要命令及其用法。所有命令均需以 / 开头。

基础命令

• /help - 显示此命令列表。
• /info - 查看插件版本与作者信息。
• /reload - 重载插件配置（建议重启服务器代替）。

经济与商店命令

• /shop create - 在您查看的容器上创建一个商店。
• /shop remove - 移除您正在查看的商店。
• /balance [玩家] - 查看自己或指定玩家的余额。
• /pay - 向其他玩家转账。

家园与传送命令

• /sethome - 在当前位置设置一个家园。
• /home - 传送到指定名称的家园。
• /delhome - 删除一个家园。
• /tpa - 请求传送到某玩家处。
• /tpaccept - 接受一个传送请求。

领地命令

• /claim - 以您手持的木棍为工具，开始创建领地。
• /claim info - 查看您所在位置的领地信息。
• /trust - 允许某玩家在您的领地内建造。
• /abandon - 删除您所在的领地。

管理员命令

• /invsee - 查看并编辑指定玩家的背包。
• /fly [玩家] - 为自己或指定玩家启用/禁用飞行。
• /gamemode [玩家] - 更改游戏模式。
• /kick [原因] - 将玩家踢出服务器。

✨权限节点

权限需通过权限管理插件（如 LuckPerms）进行分配。

玩家基础权限

• plugin.use - 允许使用所有基础玩家命令。
• plugin.shop.create - 允许创建商店。
• plugin.home.set - 允许设置家园（数量受配置限制）。
• plugin.claim.land - 允许创建领地。

管理员权限

• plugin.admin - 授予所有管理员权限。
• plugin.reload - 允许使用重载命令。
• plugin.manage.players - 允许管理其他玩家（如踢出、禁言）。
• plugin.bypass.claims - 无视所有领地保护。

❓常见问题 (FAQ)

安装与配置

• 问：安装后插件未启用，怎么办？
• 请检查服务器版本是否符合要求。
• 查看服务器日志中是否有错误信息。
• 确保已安装所有必需的依赖插件（如 Vault）。
• 问：如何配置经济系统？
• 确保已安装 Vault 及一个兼容的经济插件（如 EssentialsX）。
• 在 config.yml 中设置 economy.enable: true。
• 重启服务器后，使用 /balance 命令测试。

功能使用

• 问：玩家无法创建商店？
• 检查玩家是否拥有 plugin.shop.create 权限。
• 确认玩家正在查看一个有效的容器（如箱子）。
• 检查该区域是否被领地保护，且玩家是否有建造权限。
• 问：家园传送失败，提示“世界未加载”？
• 该家园所在的世界可能未启用或已被卸载。
• 管理员需确保目标世界在 worlds.yml 配置中被允许传送。
• 玩家可尝试重新设置家园。
• 问：领地保护不生效？
• 确认领地插件已正确加载且无冲突。
• 检查其他插件（如世界保护）是否覆盖了领地权限。
• 使用 /claim info 确认您正处于正确的领地内。

故障排除

• 问：遇到错误“NoClassDefFoundError”或类似异常？
• 这通常表示依...