Skip to content

Commit 6d77259

Browse files
committed
docs: enhance skins management documentation with detailed commands and examples
1 parent ed910cc commit 6d77259

File tree

1 file changed

+112
-0
lines changed

1 file changed

+112
-0
lines changed

content/docs/characters/manage/skins.mdx

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,115 @@
22
title: Skins
33
description: Manage skins for your player characters.
44
---
5+
6+
You can customize character skins in a few different ways using the `/character skin` command.
7+
8+
## Changing a Character's Skin
9+
10+
To change a character's skin, you can use the command
11+
`/character skin set <character> [player|file|url] <value> [slim]`.
12+
13+
<Callout type="info">
14+
The `slim` option is used to apply a slim skin model, which is typically used for characters with
15+
a slimmer build. Omitting this option will apply the default (classic) skin model.
16+
</Callout>
17+
18+
## Applying a Player Skin
19+
20+
To change a character's skin to an existing player's skin,
21+
you can use the command `/character skin set <character> player <player> [slim]`.
22+
23+
<Callout type="warning" title="Skin Not Found">
24+
Mojang is ratelimiting the use of player skins. If a skin is not found, it may be due to this
25+
ratelimiting. In this case just try again later. If the skin is still not found, it may be due to
26+
the player not having a skin set or the player not existing. You can also try using a different
27+
method to set the skin, such as using a file or URL.
28+
</Callout>
29+
30+
### Example [!toc]
31+
32+
Classic skins can be applied using the following command:
33+
34+
```
35+
/character skin set MyCharacter player Notch
36+
```
37+
38+
To apply a slim skin, just append the `slim` option:
39+
40+
```
41+
/character skin set MyCharacter player Notch slim
42+
```
43+
44+
## Applying a Skin from File
45+
46+
You can change a character's skin using a file with the command
47+
`/character skin set <character> file <file> [slim]`.
48+
49+
<Callout type="info" title="File Requirements" id="file-requirements">
50+
Skin files must be in **PNG format** and be of **64x64 pixels**.
51+
52+
The file can be located anywhere on the system, but you must provide the full path to the file.
53+
If the file is located in the server's main directory, you can use a relative path.
54+
55+
</Callout>
56+
57+
### Example [!toc]
58+
59+
To change a character's skin using a file, you can use the following command:
60+
61+
```
62+
/character skin set MyCharacter file "/home/skins/my_skin.png"
63+
```
64+
65+
## Applying a Skin from URL
66+
67+
You can change a character's skin using a URL with the command
68+
`/character skin set <character> url <url> [slim]`.
69+
70+
<Callout type="info" title="URL Requirements" id="url-requirements">
71+
The URL must be a direct link to a PNG image file that conforms with the [Skin File
72+
Requirements](#file-requirements).
73+
</Callout>
74+
75+
### Example [!toc]
76+
77+
To change a character's skin using a URL, you can use the following command:
78+
79+
```
80+
/character skin set MyCharacter url "https://example.com/skin.png"
81+
```
82+
83+
## Resetting a Skin
84+
85+
To reset a character's skin to default, you can use the following command:
86+
87+
```
88+
/character skin reset MyCharacter
89+
```
90+
91+
<Callout type="info">This will only reset the skin, not the skin layers.</Callout>
92+
93+
## Skin Layers
94+
95+
To customize a character's skin layers, you can use the command
96+
`/character skin layer [hide|show] <layer> <character>`.
97+
98+
By default, all layers are shown. You can hide or show each layer individually.
99+
100+
### Example [!toc]
101+
102+
To hide a character's cape layer, you can use the following command:
103+
104+
```
105+
/character skin layer hide cape MyCharacter
106+
```
107+
108+
### Available Skin Layers
109+
110+
- cape
111+
- hat
112+
- jacket
113+
- left_pants_leg
114+
- left_sleeve
115+
- right_pants_leg
116+
- right_sleeve

0 commit comments

Comments
 (0)