模组检查器

模组检查器

一个在玩家加入时验证玩家模组的服务端模组。配置白名单或黑名单以完全控制允许的内容。

基础库

Mod Checker 是一个面向 Fabric/Quilt 的服务器端管理工具,让服主能够完全控制玩家可以使用哪些模组。它会根据可自定义的白名单或黑名单校验每位连接玩家的模组列表,帮助维护模组服务器的稳定性、安全性以及预期的游戏体验。

🛡️ 核心功能

  • 双管理模式:可在灵活的 whitelist 模式(仅允许列出的模组)或 banlist 模式(除列出的模组外全部允许)下运行。
  • 自动校验:自动检查所有连接玩家,无需手动执行命令。
  • 带清晰提示的踢出:持有未授权模组或缺少必需模组(如 Mod Checker 本身)的玩家将被断开连接,并收到信息明确、可自定义的提示。
  • 简单的基于文件的配置:所有规则通过服务器 config 文件夹中简洁的 modcheck.json 文件管理。
  • 玩家语言检测:踢出提示会根据玩家客户端语言自动以英语或俄语显示。

⚙️ 工作原理与配置

  1. 安装:将 modcheck.jar 放入服务器的 mods 文件夹(需要 Fabric/Quilt)。
  2. 配置:首次运行时,会在 config 文件夹中生成 modcheck.json 文件。编辑该文件以设置 mode("whitelist" 或 "banlist"),并在 "mods" 下列出模组 ID。
  3. 自动执行:配置完成后,模组会自动运行。未安装必需的 modcheck 客户端模组或持有被禁止模组的玩家将被拒绝加入。

最小 modcheck.json(白名单模式):

{
  "mode": "whitelist",
  "mods": [
    "fabric-api-base",
    "fabric-api-lookup-api-v1",
    "fabric-biome-api-v1",
    "fabric-block-api-v1",
    "fabric-blockrenderlayer-v1",
    "fabric-client-tags-api-v1",
    "fabric-command-api-v1",
    "fabric-command-api-v2",
    "fabric-commands-v0",
    "fabric-containers-v0",
    "fabric-content-registries-v0",
    "fabric-convention-tags-v1",
    "fabric-crash-report-info-v1",
    "fabric-data-generation-api-v1",
    "fabric-dimensions-v1",
    "fabric-entity-events-v1",
    "fabric-events-interaction-v0",
    "fabric-events-lifecycle-v0",
    "fabric-game-rule-api-v1",
    "fabric-item-api-v1",
    "fabric-item-group-api-v1",
    "fabric-key-binding-api-v1",
    "fabric-keybindings-v0",
    "fabric-lifecycle-events-v1",
    "fabric-loot-api-v2",
    "fabric-loot-tables-v1",
    "fabric-message-api-v1",
    "fabric-mining-level-api-v1",
    "fabric-model-loading-api-v1",
    "fabric-models-v0",
    "fabric-networking-api-v1",
    "fabric-networking-v0",
    "fabric-object-builder-api-v1",
    "fabric-particles-v1",
    "fabric-recipe-api-v1",
    "fabric-registry-sync-v0",
    "fabric-renderer-api-v1",
    "fabric-renderer-indigo",
    "fabric-renderer-registries-v1",
    "fabric-rendering-data-attachment-v1",
    "fabric-rendering-fluids-v1",
    "fabric-rendering-v0",
    "fabric-rendering-v1",
    "fabric-resource-conditions-api-v1",
    "fabric-resource-loader-v0",
    "fabric-screen-api-v1",
    "fabric-screen-handler-api-v1",
    "fabric-sound-api-v1",
    "fabric-transfer-api-v1",
    "fabric-transitive-access-wideners-v1",
    "mixinextras"
  ]
}

❓ 常见问题

  • 问:玩家需要安装这个模组吗?
    • 答:需要! 为使校验生效,模组必须同时安装在服务器和客户端上。未安装的玩家将被踢出。
  • 问:需要 Fabric API 吗?
    • 答:绝对需要。 本模组依赖 Fabric API。
  • 问:可以在 Quilt 上使用吗?
    • 答:可以,得益于 Fabric API 兼容层,它与 Quilt 兼容。
  • 问:如何找到模组的 ID 用于配置?
    • 答: 查看模组的 fabric.mod.json 文件或其文档。通常就是 "id" 字段(例如 xaerominimap)。

📜 技术与许可


使用 Mod Checker 维护公平稳定的模组环境——你服务器不可或缺的守门人。