summer / mojang Goto Github PK

33.0 2.0 6.0 20 KB

A wrapper for the Mojang API and Minecraft website

License: MIT License

Python 100.00%

mojang mojangapi python python-library mojang-api pypi api-wrapper api api-client

mojang's Introduction

Mojang is a Python package for accessing Mojang's services. This library can be used to convert UUIDs, get a profile's information, change your Minecraft username or skin, and much more.

There are 2 components to this package, which are imported in different ways:

Public API - Used to parse information about Minecraft profiles and more. Authentication is not required.
Client API - Used to login to a Mojang account and access it.

At the moment, the Client API only supports authenticating to a Minecraft account via Microsoft's authentication scheme, so your Minecraft account must already be migrated. Alternatively, you may authenticate to a Mojang account directly with a Bearer token.

Installation

Python 3.7 or higher is required.

The easiest way to install the library is using pip. Just run the following console command:

python -m pip install mojang

Public API Quickstart

from mojang import API

# Create a Public API instance
api = API()

uuid = api.get_uuid("Notch")

if not uuid:
    print("Notch is not a taken username.")
else:
    print(f"Notch's UUID is {uuid}")

    profile = api.get_profile(uuid)
    print(f"Notch's skin URL is {profile.skin_url}")
    print(f"Notch's skin variant is {profile.skin_variant}")
    print(f"Notch's cape URL is {profile.cape_url}")

Full Public API documentation

Client API Quickstart

To log into a Mojang account, the account must already be migrated to Microsoft. This means that you will be using your Microsoft credentials to login.

from mojang import Client

client = Client("YOUR_MICROSOFT_EMAIL", "YOUR_PASSWORD")

# Get the account's profile information
profile = client.get_profile()

print(profile.id)
print(profile.name)

for skin in profile.skins:
    print(skin.id)
    print(skin.enabled)
    print(skin.url)
    print(skin.variant)

Alternatively, supply a Bearer token and skip the Microsoft authentication process.

client = Client(bearer_token="MOJANG_BEARER_TOKEN_HERE")

If authentication fails, such as due to an incorrect email or password, a LoginFailure exception will occur.

Full Client API documentation

mojang's People

Contributors

Stargazers

Watchers

Forkers

twnku takipsizad tomd53 survivalkahngserver ja7den sleepthegod

mojang's Issues

please contact me

kWAY#1701

TypeError: API.get_uuid() missing 1 required positional argument: 'username'

I have inputted a username but this error still occurs. How can I fix this?

"get_drop_timestamp" always returns ValueError

The get_drop_timestamp() function always returns a ValueError, as it attempts to convert the username to a UUID, however since drop timestamps only work on names that aren't currently set to any profile, this makes it impossible to work.

Example:

drop_timestamp = MojangAPI.get_drop_timestamp(mazurr)
print(drop_timestamp)

Returns:

ValueError: Username is invalid. Failed to convert username to UUID

        try:
            client1 = Client("EMAIL", "PASS")
        except errors.LoginFailure:
            QtWidgets.QMessageBox.about(self, "Error", "Invalid main account")
            return

        try:
            client2 = Client(bearer_token = "TOKEN")
        
        except errors.LoginFailure:
            QtWidgets.QMessageBox.about(self, "Error", "Invalid second account")
            return

It should be a valid token. Its 435 characters long and contains a dot.

problem with `get_name_history`

  name_data_dict["name"] = data["name"]
TypeError: string indices must be integers

getting this error anytime i call the MojangAPI.get_name_history(uuid)

json.decoder.JSONDecodeError when querying a uuid that isnt a player

When you query a profile:

profile = MojangAPI.get_profile("20e21989-5521-49df-9750-a4ef8bd5441b")

, expected output is None if the profile doesn't exist or UserProfile if it does, however, if you put a valid UUID, but one that isn't a player, the method throws json.decoder.JSONDecodeError

profile = MojangAPI.get_profile("20e21989-5521-49df-9750-a4ef8bd5441a") # This will error out!

Grrr

It's me dancers, you should add my new account. (I got terminated 😢)