# IDoTheBlacklist<\/p>\n
## Overview<\/p>\n
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.<\/p>\n
## The Blacklist System<\/p>\n
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:<\/p>\n
* **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.
\n* **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.
\n* **Minecraft Mod Integration:** The IDoTheBlacklist mod reads this blacklist data and denies entry to any player found on the list.<\/p>\n
### Transparency and Collaborative Management<\/p>\n
One of the key principles behind the IDoTheBlacklist system is transparency and collaborative management.<\/p>\n
* **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.
\n* **Authorized Users:** A specific set of Discord users is authorized to modify the blacklist. The list of authorized users is also transparent, providing accountability.
\n* **Community Review:** Any proposed changes to this mod, particularly those related to the blacklist functionality, must be reviewed and approved by `@IDoTheHax` on Discord before being implemented. This ensures that changes are carefully considered and aligned with community standards.<\/p>\n
## Features<\/p>\n
– **Automated Blacklist Checks:** Automatically checks connecting players against a centralized blacklist upon joining the server.
\n– **Centralized Ban Management:** Uses an external API to retrieve blacklist data, enabling a network-wide ban system.
\n– **Operator Notifications:** Notifies server operators about blacklist checks and any resulting actions.
\n– **Configuration:** API key can be set and stored securely to access the blacklist API.
\n– **Customizable Disconnect Message:** Displays a clear and informative disconnect message to blacklisted players, including the reason and timestamp.
\n– **Logging:** Logs blacklist checks, API responses, and any errors encountered for debugging purposes.<\/p>\n
## Setup<\/p>\n
### Prerequisites<\/p>\n
– A Minecraft server running Fabric.
\n– Fabric Loader installed.
\n– An API key from the IDoTheHax Discord server.<\/p>\n
### Installation<\/p>\n
1. **Download the Mod:** Obtain the latest release of IDoTheBlacklist from your distribution source (e.g., Modrinth, GitHub Releases).<\/p>\n
2. **Place the Mod:** Place the downloaded `.jar` file into the `mods` folder of your Minecraft server.<\/p>\n
* If you don’t have a `mods` folder, create one in the same directory as your `minecraft_server.jar` file.<\/p>\n
3. **Start the Server:** Start your Minecraft server. Fabric Loader will load the IDoTheBlacklist mod.<\/p>\n
## Usage<\/p>\n
### Setting the API Key<\/p>\n
The IDoTheBlacklist mod requires an API key to communicate with the blacklist API. To set the API key:<\/p>\n
1. **Log in as an Operator:** Join your Minecraft server as an operator. You must have permission level 4 to execute the `\/setapikey` command.<\/p>\n
2. **Use the Command:** Use the `\/setapikey` command followed by your API key:<\/p>\n
“` * Replace ` 3. **Confirmation:** The server will display a message confirming that the API key has been set successfully.<\/p>\n * The API key is stored in the `config\/idotheblacklist.json` file on the server.<\/p>\n ### Blacklist Checks<\/p>\n – Once the API key is set, the mod will automatically check players against the blacklist when they join the server. ## Configuration<\/p>\n The configuration file for IDoTheBlacklist is located at `config\/idotheblacklist.json`.<\/p>\n ### `idotheblacklist.json` ## Troubleshooting<\/p>\n ### API Key Not Set<\/p>\n – If the API key is not set, the mod will skip the blacklist check and allow players to join. ### API Connection Errors<\/p>\n – If the mod encounters an error while connecting to the blacklist API, it will skip the check and allow players to join. ### Invalid API Key<\/p>\n – 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. ### Blacklisted Players Still Joining<\/p>\n – 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. ## Support<\/p>\n For support, questions, or bug reports, please visit the IDoTheHax Discord server.<\/p>\n IDoTheHax Discord<\/p>\n ## License<\/p>\n All Rights Reserved \u00a9 IDoTheHax 2025<\/p>\n","protected":false},"excerpt":{"rendered":" The blacklist aims to ban troublesome players across networks that use this mod, Proudly uses IDoTheAPI<\/p>\n","protected":false},"featured_media":83646,"template":"","meta":{"_minecraft_slug":"idotheblacklist","_minecraft_project_id":"KwrF4Ziw","_minecraft_author":"IDoTheHax","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":610,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"idotheblacklist.zip","_minecraft_size_bytes":11124819,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T10:13:37.129987Z","_minecraft_date_created":"2025-03-08T03:40:43.450679Z","_minecraft_date_modified":"2025-03-08T10:16:18.679884Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/idotheblacklist","_minecraft_icon_attachment_id":83646,"_minecraft_imported_at":"2026-06-04T18:55:02+00:00","_minecraft_import_hash":"1af69dc641487507385232565dc83ace","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,97,126,127,867,129,92],"mod_loader":[130,99,132,134],"minecraft_version":[62,37,73,74,38],"class_list":["post-83645","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-fabric","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-fabric","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n \/setapikey
\n “`<\/p>\n
\n– If a player is blacklisted, they will be disconnected with a message indicating the reason and timestamp of the ban.
\n– Server operators will be notified of the blacklist check and any disconnects.<\/p>\n
\n– `api_key`: Your API key obtained from the IDoTheHax Discord server. Set this using the `\/setapikey` command or manually by editing the file. Keep this key secure!<\/p>\n
\n– Server operators will receive a warning message indicating that the API key is not set.
\n– Set the API key using the `\/setapikey` command as described in the Usage section.<\/p>\n
\n– Server operators will receive a warning message indicating that the blacklist check failed.
\n– 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.<\/p>\n
\n– Server operators will receive a warning message indicating that the API key is invalid.
\n– Verify that you have created an api key from the discord and entered the correct API key using the `\/setapikey` command.<\/p>\n
\n– Check the server logs for any errors or warnings related to the blacklist check.<\/p>\n