Getting Started

micartey

PLEASE READ THIS PAGE IN ITS ENTIRETY

Any questionts, that appear to provide a lack of knowledge that has been provided in this documentation, will be ignored or pointed to the documentation.

Go through this page step-by-step!

Download Cardinal

anticheat-loader.jar

Alternative, you can use wget to download the plugin on your server.

wget https://cdn.micartey.dev/api/v1/download/blob/anticheat-loader.jar

You have to update this binary rarely, as this is only a loader for the actual anticheat. That means, that the newest version will always be used.

Disable packet limit

If you are familiar with e.g. opencode, you can use the following snippet to let agents make the changes which will reduce the likelyhood that you miss something.

opencode run \ 
    "Disable the packet limit of viaversion, paper, spigot, ... It is usually called 'max-pps' where pps means packets per second, 'pps-tracking-period', 'max-packet-rate' etc... You need to change the value to -1. They appear only in yml/yaml files"

(Note that you need to have opencode installed to be able to use the snippet - the free models are sufficient)

Cardinal sends a lot of transaction packets to confirm chunks, block placements, entity movements, etc. These packets can - especially on join - exceed the limit. Therefore, you need to disable the packet limiter.

ViaVersion

In case you are using ViaVersion, you need to disable the following two options:

max-pps
pps-tracking-period

By setting both fields to -1

Paper Servers

Navigate to your server root
Navigate into config
Open paper-global.yml
Set max-packet-rate to -1 (2-times)

tpcdump Capabilities

tcpdump is used to detect blink and other network based cheats. It works by checking the SYN/ACK packages on layer 3 before they are processed by the server and therefore allow the anticheat to determin if a packetloss is faked or not. However, it only works on non-proxied servers. The proxy creates a new TCP connection which is local and does not have any packet loss.

sudo groupadd pcap
sudo usermod -aG pcap <your-username>
sudo chgrp pcap $(which tcpdump)
sudo chmod 750 $(which tcpdump)
sudo setcap cap_net_raw,cap_net_admin=eip $(which tcpdump)

(This step is optional)