How to link and receive alerts

Full tutorial in 3 parts: configure the Minecraft server, install the mod on the client, and link your Discord account to receive alerts in your DM.

Need the short version? Run /tutorial in the InfinixMC Discord server.

Part 1 · Configure the server (admin)

This part is done by the Minecraft server admin once. If you're not the admin, skip to Part 3.

1.1 · Get your serverToken

Go to /dashboard/servers/new, give the server a name and click "Create and generate token". A field will appear with the token (shown only once).

1.2 · Download the mod JAR

Download the latest build from CurseForge — look for the Files button and pick the Forge 1.20.1 build:

Download ProtectionBlocks on CurseForge ↗

You can also install it through any CurseForge-compatible launcher (CurseForge App, Modrinth, Prism Launcher, etc.) by searching for "Protection Blocks".

1.3 · Install the JAR on the server

Copy protectionblocks-1.0.5.jar (or whatever version you have) into the mods/ folder of the Minecraft server. If you use a panel like Pterodactyl, upload it from the File Manager.

Requirements: Forge 47.4.8+ (1.20.1) and Java 17.

1.4 · Paste the serverToken into the config

Start the server once so the mod creates its config. Then stop it and edit config/protectionblocks/protectionblocks-server.toml:

[bot]
enableBotNotifications = true
botEndpoint = "https://protectionblocks.infinixmc.es"
serverToken = "EL_TOKEN_QUE_OBTUVISTE_EN_1_1"

1.5 · Restart the server

Start it again. In the logs you should see "Protection Blocks Mod loaded successfully". From now on every protection event will be sent to the bot.

1.6 · Invite the bot to your Discord

For your players to receive DMs, the bot must be on a Discord server they share with it (this is a Discord limitation for direct messages). The easiest path: invite it to your community Discord server — the /link, /unlink, /status and /tutorial slash commands will appear there automatically:

Invite bot to my Discord ↗

Alternative: if you don't have your own Discord or prefer not to invite it, your players can join the official InfinixMC Discord and receive the DMs from there.

Part 2 · Install the mod on the client (player)

Every player who wants to play on the server needs the same mod in their Minecraft. If you only join the server to manage but not play, you still need it for the GUI to appear when right-clicking protection blocks.

2.1 · Install Minecraft Forge 1.20.1

Download the official installer from files.minecraftforge.net (1.20.1) and run it choosing "Install client". After installing, open the Minecraft launcher and you'll see a new profile forge 1.20.1-47.4.8 (or whichever version you chose).

Alternative: if you use MultiMC, Prism Launcher or CurseForge, create a 1.20.1 instance with the matching Forge loader.

2.2 · Download and install the mod

Quick option (recommended): use the CurseForge App, search "Protection Blocks" in your 1.20.1 profile and click Install. The app handles everything.

Manual option: download the JAR from the CurseForge page and copy it to your mods/ folder:

Paths by operating system:

Windows: %appdata%\.minecraft\mods\
macOS: ~/Library/Application Support/minecraft/mods/
Linux: ~/.minecraft/mods/
MultiMC / Prism Launcher: Edit Instance → Mods.

Important: the client mod version must exactly match the server one.

2.3 · Launch Minecraft with the Forge profile

Pick the forge 1.20.1 profile in the launcher and hit Play. If everything is fine, the main menu will show "Mods" and clicking it will list "ProtectionBlocks".

Part 3 · Link your Discord account (player)

This is done by every player who wants to receive alerts. Without linking, protections still work but no DMs arrive.

3.1 · Generate a code in-game

Join the Minecraft server and, in chat, run:

/protection link

You'll get a message with a 6-character uppercase code (e.g. ABC123). It expires in 5 minutes; if you take longer, generate a new one.

3.2 · Confirm the link in Discord

Go to the InfinixMC Discord server where the InfinixMC ProtectionBlocks bot lives. In any channel where you can write, run:

/link ABC123

The bot will reply privately with "✅ Account linked as <your_MC_name>". If not, redo step 3.1 (the code probably expired).

3.3 · Verify the link

In Discord, run:

/status

It will show you privately every server you're linked to, with the server name, your Minecraft name and the link date.

And now… what alerts do I get?

The bot will DM you when, inside any of YOUR protected zones:

🚷 An unauthorized player enters.
🛡️ Someone tries to break or place a block (BUILD / BREAK).
🛡️ Someone tries to open a chest, door or interact in any way (INTERACT).
⚠️ A piston, explosion (TNT/creeper) or fluid touches your blocks without permission.

Free plan: 10-minute cooldown between alerts of the same type. Premium: real-time, no extra cooldown. /dashboard/upgrade.

Alerts not arriving?

Check in this order:

In Discord run /status — if you don't appear linked, redo Part 3.
Make sure your Discord allows DMs from server members: Discord Settings → Privacy & Safety → "Allow direct messages from server members". If it's off, the bot can't write to you.
Check you haven't blocked the bot. If you ever did, find it in your friends list and unblock it.
Ask the admin to check config/protectionblocks/audit.log and the bot logs to see whether the alert was fired and delivered.
If nothing works, email contact@infinixmc.es with your Discord ID and the server name.

My servers Premium plan