IDoTheBlacklist

IDoTheBlacklist

该黑名单旨在封禁使用此模组的各个网络中的麻烦玩家,自豪地使用IDoTheAPI

IDoTheBlacklist

概述

IDoTheBlacklist 是一个 Minecraft 服务端模组,通过集成集中式黑名单 API 来增强服务器安全性。该模组会自动将连接的玩家与已知问题用户列表进行比对,阻止他们加入服务器。它是由 IDoTheBot 和 IDoTheAPI 管理的更广泛生态系统的一部分,用于在多个 Minecraft 社区及相关 Discord 服务器中管理和维护社区诚信。

黑名单系统

黑名单是用于在与 IDoTheBot 关联的 Minecraft 社区中维护积极和安全环境的关键工具。其工作方式如下:

  • 集中式 API: 黑名单数据通过集中式 API 端点存储和管理。这确保所有参与的服务器都能访问最新信息。
  • IDoTheAPI 集成: IDoTheAPI 用于管理此黑名单。授权用户可以通过 Discord 服务器内的特定命令添加或移除黑名单条目。
  • Minecraft 模组集成: IDoTheBlacklist 模组读取此黑名单数据,并拒绝任何在黑名单上的玩家进入。

透明度与协作管理

IDoTheBlacklist 系统背后的关键原则之一是透明度和协作管理。

  • 开源代码: 由于此代码是开源的,黑名单系统的运作对公众可见。这允许社区进行审查和改进。
  • 授权用户: 一组特定的 Discord 用户被授权修改黑名单。授权用户列表也是透明的,提供了问责机制。
  • 社区审查: 对此模组的任何拟议更改,特别是与黑名单功能相关的更改,必须在实施前由 Discord 上的 @IDoTheHax 审查和批准。这确保更改经过仔细考虑并符合社区标准。

功能

  • 自动黑名单检查: 玩家加入服务器时,自动将连接的玩家与集中式黑名单进行比对。
  • 集中式封禁管理: 使用外部 API 检索黑名单数据,实现网络范围的封禁系统。
  • 管理员通知: 向服务器管理员通知黑名单检查及任何由此产生的操作。
  • 配置: 可以安全地设置和存储 API 密钥以访问黑名单 API。
  • 可自定义的断开连接消息: 向被列入黑名单的玩家显示清晰且信息丰富的断开连接消息,包括原因和时间戳。
  • 日志记录: 记录黑名单检查、API 响应以及遇到的任何错误,用于调试目的。

设置

前提条件

  • 运行 Fabric 的 Minecraft 服务器。
  • 已安装 Fabric Loader。
  • 来自 IDoTheHax Discord 服务器的 API 密钥。

安装

  1. 下载模组: 从您的分发来源(例如 Modrinth、GitHub Releases)获取 IDoTheBlacklist 的最新版本。

  2. 放置模组: 将下载的 .jar 文件放入 Minecraft 服务器的 mods 文件夹中。

    • 如果您没有 mods 文件夹,请在 minecraft_server.jar 文件所在的同一目录中创建一个。
  3. 启动服务器: 启动您的 Minecraft 服务器。Fabric Loader 将加载 IDoTheBlacklist 模组。

使用

设置 API 密钥

IDoTheBlacklist 模组需要 API 密钥才能与黑名单 API 通信。要设置 API 密钥:

  1. 以管理员身份登录: 以管理员身份加入您的 Minecraft 服务器。您必须拥有权限等级 4 才能执行 /setapikey 命令。

  2. 使用命令: 使用 /setapikey 命令后跟您的 API 密钥:

    /setapikey <your_api_key>
    
    • 将 <your_api_key> 替换为您从 IDoTheHax Discord 服务器获取的 API 密钥。
  3. 确认: 服务器将显示一条消息,确认 API 密钥已成功设置。

    • API 密钥存储在服务器上的 config/idotheblacklist.json 文件中。

黑名单检查

  • 设置 API 密钥后,模组将在玩家加入服务器时自动将玩家与黑名单进行比对。
  • 如果玩家被列入黑名单,他们将被断开连接,并显示一条包含封禁原因和时间戳的消息。
  • 服务器管理员将收到黑名单检查及任何断开连接的通知。

配置

IDoTheBlacklist 的配置文件位于 config/idotheblacklist.json。

idotheblacklist.json

  • api_key:您从 IDoTheHax Discord 服务器获取的 API 密钥。使用 /setapikey 命令或手动编辑文件来设置。请妥善保管此密钥!

故障排除

API 密钥未设置

  • 如果 API 密钥未设置,模组将跳过黑名单检查并允许玩家加入。
  • 服务器管理员将收到一条警告消息,指示 API 密钥未设置。
  • 按照“使用”部分所述,使用 /setapikey 命令设置 API 密钥。

API 连接错误

  • 如果模组在连接黑名单 API 时遇到错误,它将跳过检查并允许玩家加入。
  • 服务器管理员将收到一条警告消息,指示黑名单检查失败。
  • 检查服务器日志以获取有关错误的更多信息。确保服务器可以连接到互联网并且 API 端点可访问。

无效的 API 密钥

  • 如果 API 密钥无效,API 将拒绝请求,模组将跳过黑名单检查并允许玩家加入。
  • 服务器管理员将收到一条警告消息,指示 API 密钥无效。
  • 验证您是否已从 Discord 创建 API 密钥,并使用 /setapikey 命令输入了正确的 API 密钥。

被列入黑名单的玩家仍然加入

  • 如果玩家被列入黑名单但仍能加入服务器,请确保 API 正常运行,并且玩家的 UUID 存在于黑名单中。
  • 检查服务器日志中与黑名单检查相关的任何错误或警告。

支持

如需支持、提问或报告错误,请访问 IDoTheHax Discord 服务器。

IDoTheHax Discord

许可证

All Rights Reserved © IDoTheHax 2025