swrpgservauth

Swrpgservauth is a Minecraft server authentication mod that restricts player access based on a predefined username allowlist. The mod prevents unauthorized players from joining by checking their username against a configuration file (allowed_players.json). If a player is not listed, they are disconnected upon joining, ensuring tight control over server access.

Administrators can manage the allowlist through commands:

User Management Commands /addUser Adds a user to the allowed list with no IP restrictions. By default, their verifyIp flag is set to the current global setting.

/removeUser Removes a user entirely from the allowed list.

/listUsers Displays all allowed users along with their verifyIp status and registered IPs.

IP Management Commands /addIp Adds an IP address to an existing user’s allowed IP list.

/removeIp Removes an IP address from a user’s allowed IP list.

/addIPUser Adds an IP to a user and refreshes the configuration immediately.

IP Verification Settings /toggleUserIp Toggles a user’s individual verifyIp flag (true/false). When enabled, their IP must match a registered IP.

/toggleGlobalIp Toggles the global IP validation flag (requireIpValidation). When enabled, all users who have verifyIp=true must pass an IP check.

Configuration Management /refreshConfig Reloads the JSON configuration file, applying any changes made externally.

The mod features automated logging for connection attempts, notifying administrators when unauthorized players try to join. It also ensures players are fully removed from the server if they are disconnected due to authentication failure, preventing ghosting issues.

Single-Sentence Summary: Swrpgservauth enhances Minecraft server security by enforcing username-based authentication, disconnecting unauthorized players, and providing admin commands for managing access.

Added optional IP verification. – global / or per user.