Introduction

IpLogger is a server-side mod for Fabric.
It's main purpose is storing all IP addresses that players use to log on from. The data is stored on the server under config/iplogger/IpLoggerData.json. Commands are only available for OPs on the server.
Examples of use-cases could be to identify players that try to log in as other players (for offline servers, note that piracy is not acceptable), or finding players with multiple accounts as these will share the same IP.

Remember that a simple VPN would result in storing the incorrect IP of a player. This mod makes no attempt to check if a player uses a VPN or to tunnel back to their home-IP - it only stores the IP available in the console logs.

All IPs are by default available in the server console logs, but reading through them to find necessary information (for whatever usecase you might have) is tedious. This mod will make this process simple.
In other words: this mod does not give a server administrator any information they don't already have access to, it just makes it more easily accessible.

Declaration from developer

This mod can in theory be used by the developer to collect public IPs. It is the declaration of the developer that the mod does not send your server's playernames or IPs outside to external sources without your explicit actions (such as by invoking the /iplogger geolocate command)

Installation

Put on server in \mods folder. No client side mod is necessary.

Commands

• /iplogger buildFromPastLogs - Recommended to run the first time you install the mod. Will read through all past logs file on the server to extract all users' IPs and add them to the database. If this command is not run, only users and IPs from the point of installation forward will be available. After running once, there is no need to run this command ever again.
• /iplogger getIPs [username] - Gives all the IPs that the given username has used to log in to the server from.
• /iplogger getUsers [IP] - Gives all the users that have ever logged in to the server using this IP.
• /iplogger removeIpFromUser [username] [IP] - Removes the IP address from the user.
• /iplogger getDuplicateIPs - Will give a list of all players that have signed in using the same IP address. Typical reasons for sharing an IP is either living in the same household or being alt-accounts of the same person.
• /iplogger geolocate [IP] - Uses the iplocation.net free API to give the country in which the given IP resides.
• /iplogger toggleDebugMode - Turns on more verbose logging in server console. Mostly useful for the mod dev to troubleshoot... Always sets back to debugMode=false on server startup/restart.