82 lines
1.4 KiB
Markdown
82 lines
1.4 KiB
Markdown
# MCUUID
|
|
Getting Minecraft Player Information from Mojang API.
|
|
|
|
## Usage
|
|
1. `pip install mcuuid`
|
|
2. Use the module like this:
|
|
|
|
### API
|
|
```
|
|
from mcuuid.api import GetPlayerData
|
|
|
|
player = GetPlayerData(identifier)
|
|
|
|
if player.valid is True:
|
|
uuid = player.uuid
|
|
name = player.username
|
|
```
|
|
|
|
Identifier can be a username or a UUID.
|
|
|
|
When `identifier = "gronkh"`:
|
|
`uuid` will be `"a2080281c2784181b961d99ed2f3347c"`
|
|
and `name` will be `"Gronkh"`
|
|
|
|
|
|
```
|
|
player = GetPlayerData(identifier, timestamp)
|
|
```
|
|
|
|
Some names are time-sensitive. (When they are changed)
|
|
So you can choose a special time.
|
|
|
|
It even works with UUIDs. They respond the username at the given time.
|
|
|
|
### Tools
|
|
Syntax check of username
|
|
```
|
|
from mcuuid.tools import is_valid_minecraft_username
|
|
|
|
if is_valid_minecraft_username('gronkh'):
|
|
print('Valid')
|
|
```
|
|
|
|
Syntaxcheck of UUID
|
|
```
|
|
from mcuuid.tools import is_valid_mojang_uuid
|
|
|
|
if is_valid_mojang_uuid('a2080281c2784181b961d99ed2f3347c'):
|
|
print('Valid')
|
|
```
|
|
|
|
## Test file
|
|
Usage
|
|
```
|
|
$ python test.py gronkh
|
|
```
|
|
or
|
|
```
|
|
$ python test.py a2080281c2784181b961d99ed2f3347c
|
|
```
|
|
or
|
|
```
|
|
$ python test.py
|
|
Please enter a username or UUID:
|
|
gronkh
|
|
```
|
|
or
|
|
```
|
|
$ python test.py
|
|
Please enter a username or UUID:
|
|
a2080281c2784181b961d99ed2f3347c
|
|
```
|
|
|
|
Response:
|
|
```
|
|
UUID: a2080281c2784181b961d99ed2f3347c
|
|
correct name: Gronkh
|
|
```
|
|
|
|
## License
|
|
This software is licensed under the MIT license. Feel free to use it however you like.
|