Skip to content

Installation

You need a server on Minecraft 1.13 to 26.2 running Paper, Purpur or a Spigot-compatible fork, Java 17 or newer, and outbound internet access. Nothing else. Everything the plugin depends on is bundled, and you do not need to open any ports. Players can connect from 1.8 upward, through ViaVersion or its siblings where the server itself is newer.

1. Put the jar in your plugins folder

Drop RealAC.jar into plugins/ and start the server once. It will create a plugins/RealAC/ folder with four configuration files, then stop and tell you it is not protecting the server. That is expected: it does not have your licence yet.

2. Add your licence key

Open plugins/RealAC/loader.yml:

license-key: "YOUR_LICENSE_KEY_HERE"
server-name: "YOUR_SERVER_NAME"
channel: "latest"

Put your key in license-key, and the server name your licence is registered to in server-name. The two have to match what we issued, so copy them exactly.

Leave channel alone unless we ask you to change it. stable is the recommended rung and latest is the newest build.

3. Restart

On start-up you should see RealAC report that it is active. If it says it is not protecting the server, the line tells you why. The troubleshooting page has every reason and its fix.

4. Give your staff alerts

Grant your staff the permission realac.alerts, then have them run:

/realac alerts

They will start seeing flags in chat. Do this before anything else. The first week is for watching.

Careful with wildcards. Granting realac.* to staff also grants realac.exempt, which means those staff are skipped by every check. If you want staff checked like everyone else, grant the nodes you actually want, or set exempt-permission: false in config.yml.

5. Decide when it acts

RealAC ships in monitor mode, which means it alerts and never bans. Leave it there for a week. Watch what it flags, spectate a few of them, and get a feel for what your server looks like.

When you are ready, open plugins/RealAC/RealScore.yml and set:

mode: enforce

Then run /realac reload, or restart.