Install McGuardian on your Minecraft server.

01 / SETUP

Connect with Bukkit (Paper/Spigot)

1. 01

   Register your server with McGuardian

   Sign in to your account, open Servers, and add the server with a unique ID, such as survival-1. Create a credential for that server and select only the permissions you plan to use.

2. 02

   Install the plugin file

   Stop Paper or Spigot, place the McGuardian .jar file in the plugins/ folder, then start the server again. The current download is a release candidate compatible with Paper 1.21.x and Java 21.

   Descargas

   McGuardian v2.0.0-rc.1

   Candidata

   Selecciona la plataforma y la versión de tu servidor.

   PlataformaPaper / SpigotFabricQuiltForgeNeoForgeVelocityBungeeCordPlugin BukkitVersiónMinecraft 26.3Minecraft 26.2Minecraft 26.1.2Minecraft 26.1.1Minecraft 26.1Minecraft 1.21.11Minecraft 1.21.10Minecraft 1.21.9Minecraft 1.21.8Minecraft 1.21.7Minecraft 1.21.6Minecraft 1.21.5Minecraft 1.21.4Minecraft 1.21.3Minecraft 1.21.2Minecraft 1.21.1Minecraft 1.21Minecraft 1.20.6Minecraft 1.20.5Minecraft 1.20.4Minecraft 1.20.3Minecraft 1.20.2Minecraft 1.20.1Minecraft 1.20Minecraft 1.19.4Minecraft 1.19.3Minecraft 1.19.2Minecraft 1.19.1Minecraft 1.19Minecraft 1.18.2Minecraft 1.18.1Minecraft 1.18Minecraft 1.17.1Minecraft 1.17Minecraft 1.16.5

   Java 25+Un único JAR Bukkit cubre esta versión.

   Descargar Paper / Spigot SHA-256
3. 03

   Save the configuration and credential

   In the McGuardian setup wizard, copy the generated configuration to plugins/McGuardian/config.yml. Check that server-id matches the registered server and that server-credential contains that server's key. The full key is shown only once, so store it as a secret.

   api-url: "https://api.mcguardian.win/api/sanctions/analyze"
   server-credential: "cgs_…"
   server-id: "survival-1"

   Use the values shown in your setup wizard. Do not reuse a credential across servers.

4. 04

   Restart and confirm the connection

   Restart Paper or Spigot to load the changes. Run /mcguardian status in the console or in-game with permission, then check under Servers that the connection is online.

02 / PLUGIN PERMISSIONS

Enable only the features you need

The credential limits what each server can send or receive:

• analysis:writeSend messages for moderation analysis.
• sanctions:receiveReceive sanctions approved by your team in the dashboard.
• presence:writeUpdate player sessions and profiles.
• reports:writeReceive reports submitted from the server.
• replays:writeSend compatible activity and replay data.

For a network with a lobby, survival, or other modes, register each server separately and create a different credential for each one.

03 / CONTROL AND PRIVACY

Review sanctions and data before enabling everything

AI helps review chat; your staff decides which sanctions to apply. If sanction enforcement is enabled, approved actions are sent to the plugin. Check enforcement.commands in config.yml to make sure the commands match your sanctions plugin.

Chat context can send recent messages to the AI provider. Disable it by setting enabled: false in the context section. Profiles can also send a player's IP address; to disable this, set send-ip: false in profiles. Let your community know what data the server records.

04 / UPDATING

Update the plugin

The plugin does not update automatically. When a new version is available, download it here, stop Paper, back up plugins/McGuardian/config.yml, replace the old JAR, and start the server again. Check the release notes for configuration changes and confirm the connection with /mcguardian status. The dashboard will show the connected version.

The current download is marked as a release candidate (RC); check the version label before installing it in production.

05 / PLATFORMS AND VERSIONS

Download the file for your server

Choose a platform and version in the selector. The matching JAR and its SHA-256 checksum will appear below.

Fabric, Quilt, Forge, and NeoForge create their configuration at config/mcguardian/mcguardian.properties. Bukkit uses plugins/McGuardian/config.yml.

Fabric, Quilt, Forge, and NeoForge adapters provide chat moderation. Reports, presence, sanctions, and replays are handled by the Bukkit adapter.

06 / TROUBLESHOOTING

Quick checks

• Paper or Spigot is running, and the plugin appears as loaded in the console.
• The ID and credential belong to the same registered server.
• The credential still has the permissions required by each enabled feature.
• Your host allows outbound HTTPS/WSS connections over port 443; no inbound ports need to be opened.

Check /mcguardian status and the console messages to see the plugin status.