Paper and Purpur setup
BackendInstall the connector on backend servers for heartbeats, confirmed bans, and login confirmation.
#When to install on Paper
Behind a proxy the Velocity connector already handles hostname attribution and sessions. Adding the Paper connector gives you per server health, confirmed cheat bans, and login confirmation for cracked players.
Without a proxy, the Paper connector does everything on its own.
#Deployment modes
| Mode | Use it when | What it sends |
|---|---|---|
| auto | You are not sure | Detects proxy forwarding and picks backend or standalone |
| backend | The server sits behind a Velocity proxy | Heartbeats, confirmed bans, and login hooks |
| standalone | Players join this server directly | Sessions and hostnames as well as the above |
#Configuration reference
The config file is plugins/MCAnalytics/config.yml.
api-url: "https://analytics.mcanalytics.net"
# Leave the placeholder and run: mca pair <code>
api-token: "mca_live_CHANGE_ME_TO_YOUR_TOKEN"
server-name: "paper-server"
deployment-mode: "auto" # auto | backend | standalone
heartbeat-interval-seconds: 10
connect-timeout-seconds: 5
request-timeout-seconds: 10
drain-timeout-seconds: 5
spool-file: "spool.db"
credential-file: "credential.json"
spool-size-limit-mb: 50
spool-queue-capacity: 5000
max-retries: 10
batch-size: 50
# Off by default. When on, the API stores only a keyed hash.
track-ip-address: false
debug: false#Login plugin hook
On a network that runs nLogin for its cracked players, the connector waits for a confirmed login before it stamps a session as authenticated. A session that stalls at the password prompt is never counted as a return.
Premium Java and Bedrock players are authenticated by the platform at join, so their sessions carry the confirmation already.