Metadata-Version: 2.1
Name: mc-authn
Version: 1.0.0
Summary: Python Authenticator for Minecraft with Microsoft
Home-page: https://github.com/hykilpikonna/mc-auth
Author: Azalea Gui
Author-email: me@hydev.org
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE

# mc-authn: Authenticator for Minecraft with Microsoft
 
### Installation

```sh
pip install mc-authn
```

### Usage

#### 1. Create Azure Token

(You can follow [this guide](https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app) for more details)

1. Sign in to the [Azure Portal](https://portal.azure.com/)
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`:

```yaml
ClientID: Paste the "Application (client) ID" here
ClientSecret: Paste the "Value" you copied here
```

#### 2. Login!

You can now run `mc-auth` 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 this line before the `java` command:

```shell
export auth_access_token=$(< ~/.config/mc-auth/mc-token.txt)
```

#### 3. Start Minecraft!

You can now start minecraft!


