IDoTheBlacklist

插件

· 作者 IDoTheHax

黑名单旨在禁止使用此模组的所有网络中的麻烦玩家,自豪地使用 IDoTheAPI

0 本站下载 0 关注 更新于 1 年前

最新 v1.21.3-1.0.0 · 1.21.3 · Bukkit / Paper

一键开服(送7天)

IDoTheBlacklist

概述

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

黑名单系统

黑名单是维持与 IDoTheBot 相关的 Minecraft 社区积极和安全环境的关键工具。其工作原理如下:

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

透明性与协作管理

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

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

功能

  • 自动黑名单检查: 玩家加入服务器时,自动将其与集中式黑名单进行比对。
  • 集中式封禁管理: 使用外部 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 已存在于黑名单中。
  • 检查服务器日志,查找与黑名单检查相关的任何错误或警告信息。

支持

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

许可证

版权所有 © IDoTheHax 2025

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源