
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 密钥。
安装
下载模组: 从您的分发来源(例如 Modrinth、GitHub Releases)获取 IDoTheBlacklist 的最新版本。
放置模组: 将下载的
.jar文件放入 Minecraft 服务器的mods文件夹中。- 如果您没有
mods文件夹,请在minecraft_server.jar文件所在的同一目录中创建一个。
- 如果您没有
启动服务器: 启动您的 Minecraft 服务器。Fabric Loader 将加载 IDoTheBlacklist 模组。
使用
设置 API 密钥
IDoTheBlacklist 模组需要 API 密钥才能与黑名单 API 通信。要设置 API 密钥:
以管理员身份登录: 以管理员身份加入您的 Minecraft 服务器。您必须拥有权限等级 4 才能执行
/setapikey命令。使用命令: 使用
/setapikey命令后跟您的 API 密钥:/setapikey <your_api_key>- 将
<your_api_key>替换为您从 IDoTheHax Discord 服务器获取的 API 密钥。
- 将
确认: 服务器将显示一条消息,确认 API 密钥已成功设置。
- API 密钥存储在服务器上的
config/idotheblacklist.json文件中。
- API 密钥存储在服务器上的
黑名单检查
- 设置 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 服务器。
许可证
All Rights Reserved © IDoTheHax 2025
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。