Bukkit

Note: This documentation is for version 1.0 which is outdated. The current version of Simple Skins and Capes is 2.0.

Requires

SpoutPlugin - Required to work.
SpoutCraft - Only users with Spoutcraft will be able to see skins and capes.
Standard minecraft and bukkit have no way to display custom player skins or capes.

Commands

/playerskin <playername> <Skin URL or Minecraft player name>
/playercape <playername> <Cape URL or Minecraft player name>
/groupskin <skingroupname> <Skin URL or Minecraft player name>
/groupcape <capegroupname> <Cape URL or Minecraft player name>

Command Usage

All of the commands above work as follows.
/playerskin
Resets your skin to your default minecraft skin.
/playerskin putURLhere
Sets your own skin to the URL.
/playerskin Torklar
Resets player Torklar's skin to his minecraft default skin.
/playerskin Torklar Garanel
Assigns player Garanel's default minecraft skin to player Torklar.
/playerskin help
Will show a small help section on command usage.

Permissions

simpleskins.*
simpleskins.playerskin.self
simpleskins.playerskin.any
simpleskins.playercape.self
simpleskins.playercape.any
simpleskins.groupskin.self
simpleskins.groupskin.any
simpleskins.groupcape.self
simpleskins.groupcape.any

Explanation of Permissions

All permissions work as follows.
simpleskins.playerskin.self
Can only change their own skin.
simpleskins.playerskin.any
Can change any player's skin.
simpleskins.groupskin.self
Can only change their own group's skin.
simpleskins.groupskin.any
Can change any group's skin.

How to Set Group Skins

Essentially, you can save a skin or cape to a particular permissions node, which you can use over and over again. Add the following permission to the player or group, and then use the /groupskin or /groupcape commands with the group name you added to the end of the permissions:
simpleskins.groupskin.<custom skin group name>
simpleskins.groupcape.<custom cape group name>

For more details and a tutorial on group skins, have a look at the FAQ + Tutorials page.

Configuration Files

There are two configuration files, capes.yml and skins.yml. You never have to change anything in them as they simply store information on player's skins and capes.

In the skins.yml you will find a setting called "AppearanceRefreshSeconds". This is how often the server will quietly update all player's skins and capes so that they always persist. While this is normally not taxing on a Server, if you were to have 200+ of players or 100+ groups it might be wise to increase this to 5 or 10 seconds. For a server with 30-50 players and 10-20 groups, you may be able to lower it to 1 - 2 seconds if 3 seconds is not fast enough for your needs.

Upcoming Features

- Citizens support. Allow you to customize Citizens.
- Ability to save URLs as a name and use this name in commands.
- Source code availability.

"Blue wizard needs food, badly!"
Like this plugin? Think about donating one dollar! My goal is to buy a sandwich someday.