OfflineAuth

OfflineAuth is a beta version authentication system for Minecraft running on the Forge platform. Please note that this is a test version and report any bugs, especially those related to security.

Demonstration

YouTube Video

Why was this mod created?

The development of the mod was prompted by Microsoft's mandatory migration from Mojang accounts and the introduction of the chat reporting system.

How it works?

The mod runs a small REST server (spark) alongside the main Minecraft process. The entire system operates directly on the server, allowing it to be used even on a local network without dependency on external authentication servers.

Getting Started

For server owners:

• Place the mod file in the mods folder and wait for configuration generation
• Your hosting must support opening additional ports. Select a port and specify it in the configuration (default: 4567). Minecraft and the REST server cannot operate on the same port
• Inform players about the port they need to specify for account registration
• Use the /fingerprint command to get the server's public key fingerprint and also inform players about it

For players:

• Install the mod in the mods folder
• Add the server in the multiplayer menu and go to the "Manage Authentication" menu
• If necessary, change the authentication port and register an account. After that, you will be able to join the server. During first registration, you will need to confirm the public key fingerprint and retry

Features

• Registration and deletion of accounts, password and display name changes
• Full implementation of skins and capes with the ability to change them directly in-game. Single-player support
• Registration restriction only for those with one-time tokens (generated with the /gentoken command)
• Parameter configuration through configuration file or server console
• End-to-end encryption of credentials
• Possibility of logging in using key pairs instead of passwords
• Addition of player avatars in the multiplayer menu
• Integration with Et Futurum Requiem mod capes (will require the next version of the mod, as the current version of Et Futurum breaks OfflineAuth's skin preview)
• Integration with Custom Main Menu - if a button or label has a name specified in the configuration, standard server authentication menu and connection action will be added to them
• Experimental integration with FTB Library and FTB utils (displaying skins in the friends menu). Will require a special version of FTB Library and GT:MEGA or GT:NH build for FTB Utils

Commands

• /changename <player> <display_name> - Changes the player's username (warning: resets user progress)
• /deleteplayer <identifier> - Deletes player account
• /listusers - Shows list of registered users
• /playerexists <identifier/display_name> - Displays username and display_name of user if registered
• /gentoken - Generates one-time token for account creation
• /fingerprint - Shows server's public key fingerprint
• /deleteskin <identifier> - Deletes user's skin
• /deletecape <identifier> - Deletes user's cape
• /oaconfig <list|help|get|set> [configuration_string] [value] - Changes specified configuration option, available only in server console

In Development