Minestom wiki
Search…
Thread Architecture
Feature
Expansion
Storage
Player skin
There are three ways of defining a player skin:
- Setting your player UUID (see here) to their Mojang UUID, clients by default retrieve skin based on this value
- Changing it in the
PlayerSkinInitEventevent - Using the method
Player#setSkin(PlayerSkin)
How to retrieve skin data from Mojang
Using PlayerSkin methods
PlayerSkin offers some utils methods to retrieve a skin using simple information such as a Mojang UUID or a Minecraft username1
PlayerSkin skinFromUUID = PlayerSkin.fromUuid(MOJANG_UUID_AS_STRING);
2
​
3
PlayerSkin skinFromUsername = PlayerSkin.fromUsername("Notch");
Copied!
Those methods make direct requests to the Mojang API, it is recommended to cache the values.
Retrieve texture value & signature manually
You firstly need to get your Mojang UUID, which can be done by a request based on your username:
1
GET https://api.mojang.com/users/profiles/minecraft/<username>
Copied!
Then, after getting your UUID:
1
GET https://sessionserver.mojang.com/session/minecraft/profile/<uuid>?unsigned=false
Copied!
You'll get here both the texture value and the signature. Those values are used to create a
PlayerSkin.PlayerSkinInitEvent
The event is called at the player connection and is used to define the skin to send to the player the first time. It is as simple as
1
player.addEventCallback(PlayerSkinInitEvent.class, event -> {
2
PlayerSkin skin = new PlayerSkin(textureValue, signature);
3
event.setSkin(skin);
4
});
Copied!
Player#setSkin
1
PlayerSkin skin = new PlayerSkin(textureValue, signature);
2
player.setSkin(skin);
Copied!
Last modified 29d ago