Skip to main content

mc-authn: Authenticator for Minecraft with Microsoft

Installation

pip install mc-authn

Usage

1. Create Azure Token

(You can follow this guide for more details)

  1. Sign in to the Azure Portal
  2. Click "Azure Active Directory" (the icon should look like Ramiel from EVA 🤔)
  3. Click "App registrations" on the left navigation menu
  4. Click "New registration" on top left
  5. Give it a name
  6. For "Supported account types," select "Personal MS accounts only"
  7. For "Redirect URI", select "Web" and type "http://localhost:18275"
  8. Now you should be in the overview page of your app!
  9. You should see a field "Application (client) ID", copy that somewhere
  10. Click "Certificates & secrets" on the left navbar
  11. In the "Client secrets" tab, click "New client secret"
  12. Give it a description
  13. For "Expires" select "24 months"
  14. Click "Add"
  15. There should be "Value" and "Secret ID", copy "Value"
  16. Write this in ~/.config/mc-auth/auth_config.yml:
ClientID: Paste the "Application (client) ID" here
ClientSecret: Paste the "Value" you copied here

2. Login!

You can now run mc-authn to login! After logging in, it will create a text file ~/.config/mc-auth/mc-token.txt containing your minecraft token.

In your start script for minecraft, add the --accessToken argument to the java line used to start minecraft:

mc-authn

export name=$(< ~/.config/mc-auth/mc-name.txt)
export uuid=$(< ~/.config/mc-auth/mc-uuid.txt)
export auth=$(< ~/.config/mc-auth/mc-token.txt)

java ... net.minecraft.client.main.Main ... \
    --accessToken ${auth} \
    --uuid ${uuid} \
    --username ${name}

3. Start Minecraft!

You can now start minecraft!

Release files for mc-authn 1.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mc-authn 1.0.5
File Size Uploaded
mc-authn-1.0.5.tar.gz 5.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mc-authn 1.0.5
File Interpreter ABI Platform
mc_authn-1.0.5-py3-none-any.whl Python 3 none any Details

Total release size: 10.6 kB

Release files / mc-authn-1.0.5.tar.gz

Download URL mc-authn-1.0.5.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f36d6116b1543b0de786c7a55c286c0c0769c9ab52d860d8a2af7da353f1fe7e
BLAKE2b-256 checksum
How to use checksums
3fc2497e2c33beee42f0fb70443ab6aaa3d44a30be7de5a43ae211440b15f7bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.12

Release files / mc_authn-1.0.5-py3-none-any.whl

Download URL mc_authn-1.0.5-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e22447f27ce4279f52d5b8f67e54a8857ff8b06259d039459444e36c39e55b57
BLAKE2b-256 checksum
How to use checksums
09b8d9c820e4cc9eb85b19827a99fbc1db4ff434f5254013e30db50eb95d16d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.12

Release history Release notifications | RSS feed

This release

1.0.5 This release

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page