Skip to main content

Yggdrasil Scaffold for Authlib-injector

Project description

Yggdrasil Scaffold for Authlib-injector

基于 FastAPI 和 ADOFAI 的 Yggdrasil 身份验证协议实现脚手架。

Yggdrasil 是 Minecraft 中身份验证服务的实现名称。

使用方式

安装

pip install yggdrasil-scaffold

详细的文档还没有写。但是这里有些资料:

可用资源

  • test目录下有一些样例,模块内部有中文 docstring 和一些注释,暂时可供参考。

  • CONTRIBUTING.md 中有本项目的术语表

  • 关于 Yggdrasil API 的更多信息可参见 此文章

实现速查

如果你打算将本项目用于 Authlib-injector,那么下表列出了你需要实现的端点:

端点类型 客户端(原版) 服务端(原版)
用户 / /
会话 join hasJoined
查询 query_by_names query_by_names
材质管理 / /
元数据 全部 全部

注: Mojang 的身份认证库 Authlib 的一些早期版本包含对用户端点的调用,但最新版本中已移除。 我不确定用户端点是否在某些版本的游戏上有用,抑或是本就只在 Minecraft 启动器上可用。

游戏只会在”需要从玩家名获取 UUID“时才会访问查询端点。其它时候会从 usercache.json 或者类似的地方获取。

客户端进行多人游戏时,会访问元数据端点来验证材质签名。

如果你打算将本项目用于服务启动器,那么最好实现除hasJoined以外的全部端点,启动器很可能会用到它们。

警告

Yggdrasil Scaffold 并非被设计用于高并发或安全性要求高的用途,且未经严格测试。请谨慎在生产环境使用。

另请参阅

ADOFAI 是一组数据模型和配套工具,旨在简化自定义实现 Authlib-injector 的规范 Yggdrasil 服务端、客户端及其配套程序的过程。

Yggdrasil Client 是基于 ADOFAI 和 aiohttp 的 Minecraft Yggdrasil 协议兼容客户端,支持 Mojang 后端。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yggdrasil_scaffold-0.1.0.dev6.tar.gz (16.8 kB view details)

Uploaded Source

Built Distribution

yggdrasil_scaffold-0.1.0.dev6-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

Details for the file yggdrasil_scaffold-0.1.0.dev6.tar.gz.

File metadata

  • Download URL: yggdrasil_scaffold-0.1.0.dev6.tar.gz
  • Upload date:
  • Size: 16.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.7 Windows/10

File hashes

Hashes for yggdrasil_scaffold-0.1.0.dev6.tar.gz
Algorithm Hash digest
SHA256 a3b42692c589f3d23f5c8cc051f454e2e67bb42f35db5c70908ea5172e46caae
MD5 c5ab9c72ffa7ba322c9c81dae155de72
BLAKE2b-256 4cb04cee220aa66c04bf52723b401289a509bbcfc55b971afe2e67e57f97f3f5

See more details on using hashes here.

File details

Details for the file yggdrasil_scaffold-0.1.0.dev6-py3-none-any.whl.

File metadata

File hashes

Hashes for yggdrasil_scaffold-0.1.0.dev6-py3-none-any.whl
Algorithm Hash digest
SHA256 caf74b7205425bd80d42d16e1f21d50f735d351526819eae940566adbc6f4a97
MD5 adea455e060625a64bd2217cf1e368c0
BLAKE2b-256 cca95f772663f0260e5598089f9d650d8235ce4f6f11b3ba331bf34e55e14463

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page