Simple Skins and Capes
A lightweight Skin and Cape changer for Spout. Includes support for groups and Citizens 1.2 - 2.0. The goal of this plugin is to be the easiest to use, most reliant and bug free skin and cape changer for Spoutcraft. I will gladly fix any bugs you find within 48 hours.
I wrote this plugin because I was tired of dealing with buggy, hard to use, and overly complex Skin and Cape plugins with poor documentation. Changing a skin shouldn't require arcane runes carefully entered on the first full moon of summer in order to work.
Features - Current Version 2.3
- Persistent Skins and Capes. Your custom skin and cape will never disappear!
- HD Skins and Capes support.
- Citizens 2.0 and Citizens 1.2 Support. Skin all your NPCs!
- (New in 2.2!) Import all of your skins and capes from CitizenSkins!
- Group support with permission based skins and capes. Skin an entire army in one command.
- The ability to save URLs as unique names and use them in all commands. No more bulky URLs!
- Lightweight and designed with speed and simplicity in mind.
- Long term support. If you do find any bugs, I will fix them within 48 hours.
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, or saved skin name>
/playercape <playername> <Cape URL, or Minecraft player name, or saved cape name>
/saveskin <uniquename> <Skin URL, or Minecraft player name>
/savecape <unqiuename> <Cape URL, or Minecraft player name>
/npcskin <npc ID> <Skin URL, or Minecraft player name, or saved skin name>
/npccape <npc ID> <Cape URL, or Minecraft player name, or saved cape name>
/ssimport citizenskins
This will import all skins and capes from CitizenSkins.
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 Torklar DwarvenGhost
Assigns the player the saved URL by the unique name of DwarvenGhost.
/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.saveskin.self
simpleskins.saveskin.any
simpleskins.saveskin.<saved-skin-name>
simpleskins.savecape.self
simpleskins.savecape.any
simpleskins.savecape.<saved-cape-name>
simpleskins.npcskin
simpleskins.npccape
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.
simpleskins.npcskin
Can change any NPC skin.
How to Set Up Group and Permission Skins
1) Save your skin or cape and give it a unique name.
/saveskin DwarvenGhost <Skin URL or Minecraft player name goes here>
/savecape EvilCape <Cape URL or Minecraft player name goes here>
2) Give the player or permissions group the corresponding permission:
simpleskins.skin.dwarvenghost
simpleskins.cape.evilcape
Done! All players with those permissions will automatically have their skin and cape updated with the saved skins and capes. For more examples and a more detailed look at configuring the permissions of groups, 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 8 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
- Automatically importing your iSkin, SpoutPlayers, CitizenSkins config files.
- Citizen npc ownership permissions. (.self, .any)
- MySQL support.
- Source code availability.
"Blue wizard needs food, badly!"
Like this plugin? Think about donating one dollar! My goal is to buy a sandwich someday.
@Tavenfuz
Thank you.
Version 2.0 is now available! All documentation has been updated.
@Supersam645: I've just now changed the license to "All Rights Reserved" until I make the source code available to prevent any confusion.
@Iaintee
I am aware of the upcoming features list. However, if you can't abide by the basic principles of a license, you really shouldn't be using it.
@Supersam654
Read upcoming features
I couldn't help but notice that you licensed this GPLv3 yet the source code is unavailable.
The MySQL support shall be nice.
The past few days I've been working on the new version of Simple Skins and Capes, and with any luck tomorrow night I'll be uploading it here!
The features of this new version will include:
- Citizens 1.1, 1.2, and 2.0 Support. Skin all the NPCs!
- 100% performance gain in refreshing skins and capes.
- The ability to save URLs and use them in commands.
- New, easier to read group permissions.
- Several permission bug fixes.
- Even tighter, faster overall performance.
- Improved logging for admins to see what players are setting.
(If you are having trouble with your permissions, wait until this new version is released tomorrow night and try again, as I've made a few fixes and tweaks.)
I am also terrible at permissions so any help will be amazing!
When type /playercape http://www.minecraftcapes.com/userskins/Minecon_Blue_by_dermonolith.png it says "set and saved player njordswolf cape" but i cant see my cape HELP!
dude it wont work for me!
I think I'm seeing the same issue as predawnia, only users with OP permission can use the /playerskin commands, even though the users have the indicated permissions through permissionsBukkit. I also have Vault installed. Otherwise, applying skins with an OP account is working just fine.
I follow everything the tutorial says, and I could not get the cape working. I am using permissionsBukkit. Does this work with permissionsBukkit? I am running on CB#2222 with SpoutPlugin 1244 and SpoutCraft 1548
simply beautiful plugin; it's clean fast, and works great. I was using Iskin for a while, but it would mess up if the player teleported; however, this plugin doesn't do that. The one request that I would have for this plugin is mysql support.
I'll be adding in Citizens support within the next few days. :)
How does one go about using this with Citizens? Awesome plugins by the way.
Sweet! I'm adding this to my server ASAP.
@Ricowan: Yes. I've tested it with a 512x256 skin and cape which is 8 times larger than a standard Minecraft Skin. HD Skins, Textures, and Capes work natively with Spout.
Will this allow HD skins/capes?
Oh? It's already a feature, ok then, awesome, this is going to be awesome.
Thanks,
@Kannt: The download should be available soon, it's waiting approval by the mods now.
@SimonWhitePDX: Good news! If I understand you correctly, the plugin already has what you are looking for. To do this, you would do the following:
1) First, you would add this permission to the player or group:
simpleskins.groupskin.orcs
2) Then you would use the command:
/groupskin orcs <YourURLHere>
Now all players with the permission "simpleskins.groupskin.orcs" would have the Orc skin.
Capes are done identically, as follows:
1) First you need to add the cape permission:
simpleskins.groupcape.orcs
2) Then you would use the cape command:
/groupcape orcs <YourURLHere>
The reason group capes and group skins have different permissions is so that you can mix and match. Say you have five armies of various races. You would obviously want different skins for these races or groups. But perhaps they all fight on the same side as an Alliance - you could give them all the same groupcape permission and all races would instantly have the same cape.
I've added this question to the new Simple Skins FAQ page.
Let me know if that fits what you are looking for. :)