Metadata-Version: 2.1
Name: yggdrasil-mc
Version: 0.2.5
Summary: A simple Python lib to get player info and texture from Mojang and Yggdrasil APIs. / 一个简单的 Python 库，可从 Mojang 和 Yggdrasil APIs 获取玩家的信息和材质。
Home-page: https://github.com/SerinaNya/yggdrasil-mc
License: AGPL-3.0-or-later
Keywords: yggdrasil,mc,api,mcapi,mojang,minecraft,littleskin,blessing skin
Author: SerinaNya
Author-email: 34389622+SerinaNya@users.noreply.github.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Pydantic :: 2
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: httpx[http2,socks] (>=0.20.0)
Requires-Dist: pydantic (>=2)
Project-URL: Bug Tracker, https://github.com/SerinaNya/yggdrasil-mc/issues
Project-URL: Repository, https://github.com/SerinaNya/yggdrasil-mc
Description-Content-Type: text/markdown

<div align="center">

# yggdrasil-mc

_A simple Python lib to get player info and texture from Mojang and Yggdrasil APIs._

> 一个简单的 Python 库，可从 Mojang 和 Yggdrasil APIs 获取玩家的信息和材质。

</div>

<p align="center">

<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/SerinaNya/yggdrasil-mc?style=flat-square&link=https%3A%2F%2Fgithub.com%2FSerinaNya%2Fyggdrasil-mc">
<img src="https://img.shields.io/pypi/v/yggdrasil-mc?style=flat-square" alt="PyPI">
<img src="https://img.shields.io/pypi/pyversions/yggdrasil-mc?style=flat-square" alt="PyPI - Python Version">
<img src="https://img.shields.io/github/last-commit/SerinaNya/yggdrasil-mc/main?style=flat-square" alt="GitHub last commit (branch)">
<img src="https://img.shields.io/github/license/SerinaNya/yggdrasil-mc?style=flat-square" alt="GitHub">

</p>


## ⚠️ Attention

This package can be used with **Python 3.10+**.

## Usage

``` shell
pip3 install yggdrasil-mc
```

``` python
from yggdrasil_mc.client import YggdrasilMC

ygg = YggdrasilMC()
await ygg.by_name_async("SerinaNya")

# return PlayerProfile
PlayerProfile(
    id='8705a5560b7447e8ba869169c31fb5ef', 
    name='SerinaNya', 
    skin=PlayerSkin(
        url=Url('http://textures.minecraft.net/texture/7781fa8ed3e2aa907944ec0f1ec391ad05955eb9c6424d911d409b00a69ea516'), 
        metadata=PlayerSkin_MetaData(model='slim')), 
    cape=None)
```

