|
2 | 2 | title: Skins |
3 | 3 | description: Manage skins for your player characters. |
4 | 4 | --- |
| 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