?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
DisconnectLogger

DisconnectLogger

Know exactly why every player leaves. Logs every disconnect with its reason, how far the connection got and which plugin caused it, flags scanner bots, and can post to Discord.

6downloads
0followers
6downloads
0followers

Compatibility

Minecraft: Java Edition

26.3

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed MIT
Published yesterday
Updated last week

Know exactly why every player leaves

DisconnectLogger records every disconnect on your Paper server with the reason, how far the connection got and which plugin caused it. It also spots scanner bots that connect and drop before ever joining, so they stop cluttering your console.

Features

• Reason for every disconnect: quit, kick, timeout, protocol error, denied login.

• Plugin blame: for kicks, the chain of plugins that triggered it (for example Essentials <- Vulcan). For denied logins, the plugins whose handlers decided the result.

• Bot / scanner detection: connections that drop before joining are tagged SUSPECT-BOT when the name looks generated (like FuzzyToad6891) or the same address keeps reconnecting.

• Clean, coloured console: one tagged line per event: [KICK], [DENIED], [TIMEOUT], [DROP], [BOT], [LEFT].

• Plain log file: plugins/DisconnectLogger/disconnects.log, one line per event, easy to grep.

• Optional Discord feed: posts kicks and denied logins to a channel through your existing DiscordSRV bot.

• In-game stats: /dclog recent, /dclog stats.

Install

Drop the jar into plugins/, restart, then edit plugins/DisconnectLogger/config.yml if you want the Discord feed or a different bot pattern. Use /dclog help in game or console.

Commands and permission

/dclog recent [n] shows the last disconnects (default 10, max 50). /dclog stats shows top reasons and addresses since startup. /dclog reload reloads the config. Permission: disconnectlogger.admin (default: op).

Requirements

Paper (or a Paper fork) 1.21 or newer, Java 21+. Optional: DiscordSRV for the Discord feed. Developed and tested on Paper 26.3; older versions should work but have not been tested.

Notes

Plugin blame is a best effort: it reads the call stack of a kick and the listener priorities of a denied login. If a plugin kicks players through raw packets (some anti-cheats do), the log says so instead of guessing. Connections that drop before the login event are detected by watching the server's own console line, so only the name, address and reason are known. No telemetry: the only network use is the optional Discord feed through your own DiscordSRV bot.

Made by FreakPlot. Play at freakplot.minecraft.best