CreateMasterKeyEvent

Fields

When it fires

Encryptor.loadOrCreateMasterKey(keyFile, eventBus) runs once, the first time AuthManager.init(...) is called for a given base directory. It checks whether keyFile (<baseDir>/master.key) already exists:

• If it exists, the existing AES key is loaded from disk and this event does not fire.
• If it doesn't exist (typically the very first time a user runs your launcher), this event fires right before a new 256-bit AES key is generated and written to keyFile.

In other words, you'll normally see this exactly once per user, ever (unless master.key is deleted or the auth directory changes). If it fires unexpectedly on every startup, something is deleting or relocating the key file between runs, and the session file won't be decryptable with a different key, so AuthManager.loginWithSavedSession() will silently fail and return null.

Listening

Subscribe on the EventBus the event is posted to, see Events for which bus that is.

eventBus.subscribe(CreateMasterKeyEvent.class, event -> {
    Path keyFile = event.keyFile();
});

eventBus.subscribe(CreateMasterKeyEvent::class.java) { event ->
    val keyFile = event.keyFile()
}

Posted by

• Encryptor Encryptor.java:38

API reference: com.dervarex.minified.auth.events.encryption.CreateMasterKeyEvent