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 密钥。
安装步骤
-
下载模组: 从您的分发源(例如 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 已存在于黑名单中。
- 检查服务器日志,查找与黑名单检查相关的任何错误或警告信息。
支持
如需支持、提问或报告 bug,请访问 IDoTheHax Discord 服务器。
许可证
版权所有 © IDoTheHax 2025
IDoTheBlacklist
Overview
IDoTheBlacklist is a Minecraft server-side mod that enhances server security by integrating with a centralized blacklist API. This mod automatically checks connecting players against a list of known problematic users, preventing them from joining the server. It is part of a broader ecosystem managed by IDoTheBot and IDoTheAPI, which is used to manage and maintain community integrity across multiple Minecraft communities and related Discord servers.
The Blacklist System
The blacklist is a critical tool used to maintain a positive and secure environment across the Minecraft communities associated with IDoTheBot. Here's how it works:
- Centralized API: The blacklist data is stored and managed through a centralized API endpoint. This ensures that all participating servers have access to the most up-to-date information.
- IDoTheAPI Integration: IDoTheAPI is used to manage this blacklist. Authorized users can add or remove entries from the blacklist via specific commands within the Discord server.
- Minecraft Mod Integration: The IDoTheBlacklist mod reads this blacklist data and denies entry to any player found on the list.
Transparency and Collaborative Management
One of the key principles behind the IDoTheBlacklist system is transparency and collaborative management.
- Open Source Code: Because this code is open source, the workings of the blacklist system are visible to the public. This allows for scrutiny and improvement by the community.
- Authorized Users: A specific set of Discord users is authorized to modify the blacklist. The list of authorized users is also transparent, providing accountability.
- Community Review: Any proposed changes to this mod, particularly those related to the blacklist functionality, must be reviewed and approved by
@IDoTheHaxon Discord before being implemented. This ensures that changes are carefully considered and aligned with community standards.
Features
- Automated Blacklist Checks: Automatically checks connecting players against a centralized blacklist upon joining the server.
- Centralized Ban Management: Uses an external API to retrieve blacklist data, enabling a network-wide ban system.
- Operator Notifications: Notifies server operators about blacklist checks and any resulting actions.
- Configuration: API key can be set and stored securely to access the blacklist API.
- Customizable Disconnect Message: Displays a clear and informative disconnect message to blacklisted players, including the reason and timestamp.
- Logging: Logs blacklist checks, API responses, and any errors encountered for debugging purposes.
Setup
Prerequisites
- A Minecraft server running Fabric.
- Fabric Loader installed.
- An API key from the IDoTheHax Discord server.
Installation
-
Download the Mod: Obtain the latest release of IDoTheBlacklist from your distribution source (e.g., Modrinth, GitHub Releases).
-
Place the Mod: Place the downloaded
.jarfile into themodsfolder of your Minecraft server.- If you don't have a
modsfolder, create one in the same directory as yourminecraft_server.jarfile.
- If you don't have a
-
Start the Server: Start your Minecraft server. Fabric Loader will load the IDoTheBlacklist mod.
Usage
Setting the API Key
The IDoTheBlacklist mod requires an API key to communicate with the blacklist API. To set the API key:
-
Log in as an Operator: Join your Minecraft server as an operator. You must have permission level 4 to execute the
/setapikeycommand. -
Use the Command: Use the
/setapikeycommand followed by your API key:/setapikey <your_api_key>- Replace
<your_api_key>with the API key you obtained from the IDoTheHax Discord server.
- Replace
-
Confirmation: The server will display a message confirming that the API key has been set successfully.
- The API key is stored in the
config/idotheblacklist.jsonfile on the server.
- The API key is stored in the
Blacklist Checks
- Once the API key is set, the mod will automatically check players against the blacklist when they join the server.
- If a player is blacklisted, they will be disconnected with a message indicating the reason and timestamp of the ban.
- Server operators will be notified of the blacklist check and any disconnects.
Configuration
The configuration file for IDoTheBlacklist is located at config/idotheblacklist.json.
idotheblacklist.json
api_key: Your API key obtained from the IDoTheHax Discord server. Set this using the/setapikeycommand or manually by editing the file. Keep this key secure!
Troubleshooting
API Key Not Set
- If the API key is not set, the mod will skip the blacklist check and allow players to join.
- Server operators will receive a warning message indicating that the API key is not set.
- Set the API key using the
/setapikeycommand as described in the Usage section.
API Connection Errors
- If the mod encounters an error while connecting to the blacklist API, it will skip the check and allow players to join.
- Server operators will receive a warning message indicating that the blacklist check failed.
- Check the server logs for more information about the error. Ensure that the server can connect to the internet and that the API endpoint is accessible.
Invalid API Key
- If the API key is invalid, the API will reject the request, and the mod will skip the blacklist check and allow players to join.
- Server operators will receive a warning message indicating that the API key is invalid.
- Verify that you have created an api key from the discord and entered the correct API key using the
/setapikeycommand.
Blacklisted Players Still Joining
- If a player is blacklisted but is still able to join the server, ensure that the API is functioning correctly and that the player's UUID is present in the blacklist.
- Check the server logs for any errors or warnings related to the blacklist check.
Support
For support, questions, or bug reports, please visit the IDoTheHax Discord server.
License
All Rights Reserved © IDoTheHax 2025
下载 IDoTheBlacklist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IDoTheBlacklist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IDoTheBlacklist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IDoTheBlacklist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 IDoTheBlacklist
下载 IDoTheBlacklist
下载 IDoTheBlacklist
下载 IDoTheBlacklist
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧