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.
update on 1.3.1 please
Where do I need to save my skin files in order to use them for my NPCs?
Also, what would be an example of the command to use them?
I try something along the lines of "/npcskin 0 skinname.png" and it doesn't work.
Thanks for the help!
Hello, I got an error when I try to run this plugin and modifyworld (from PEX). I'm using Bukkit 3.1.1 R2.0. Does anyone else have these?
It looks like it's because Dynmap, but only with Modifyworld enabled, these errors will be spit out...
I wonder if the tekkit server and client are already pre-installed with the requirements to run this...
@Tavenfuz
get this error when i try to skin or add a cape to an npc, running citizens 2 dev.
2012-08-02 20:23:06 [SEVERE] null org.bukkit.command.CommandException: Unhandled exception executing command 'npccape' in plugin SimpleSkins v2.3 Caused by: java.lang.NoSuchMethodError: net.citizensnpcs.api.npc.NPCRegistry.getById(I)Lnet/citizensnpcs/api/npc/NPC; 2012-08-02 20:23:29 [INFO] /74.208.45
What about making an easy to use GUI for changing of skins & capes like does iSkin?
I have found a few bugs in version 2.2. I will be uploading version 2.3 with these fixes shortly.
@MrProtagonist, @remdul: I have a feeling you both might be using the wrong cape template. For example, if you are trying to use the capes off of the minecraft wiki, you'll find they will stretch and deform completely. That is because they've cropped them and eliminated the needed blank space there. If a cape is the correct proportions, it will work in this plugin.
Here is a cape template that will not stretch:
http://s3.amazonaws.com/MinecraftCloaks/Notch.png
That's Notch's official cape. Using the command:
/playercape <yourname> Notch
Will set your cape to this exact .png file.
If your cape is not stretched when using this command, then it is most certainty an issue with the cape .png you are using. Hope this helps and let me know if this fixes it!
@smallfaceapek: While I am not familiar with Hereos, if Hereos supports the use of granting permissions, this plugin will work with it.
@remdul
Same problem. Stretches every cape I try drastically.
Is it possible to support heroes plugin for classes group skin
Awesome plugin! For some reason, the capes are only showing the top left corner though. Is there something I need to do to fix that? Enable HD support or something? Thank you!
Version 2.2 is now available
- Added an Import Utility for CitizenSkins!
Use /ssimport citizenskins to import all npc skins and capes from CitizenSkins.
(More plugin import support to come!)
- SimpleSkins should now always detect and load Citizens 1.2 and 2.0 support.
- Fixed several bugs and one null pointer exception case.
Those having any Citizen issues should try the new version.
Why thank you! If one day I can buy a single sandwich earned entirely from my plugin work, I will be a very happy wizard indeed. And what did you have in mind by ECON (I'm assuming economy) support?
ECON support please?
If "- Long term support. If you do find any bugs, I will fix them within 48 hours." is a fact than "Blue wizard deserves food, badly!"
@GOHpsycho: I'd be happy to help! When you start your server, is Citizens loading before or after SimpleSkins? SimpleSkins *should* load after Citizens. If it is not, that would be strange indeed (as Bukkit should), but I still might be able to fix it.
I'm getting a strange bug. I'm sure it's on my end but maybe you help me figure it out...
I selected an NPC(ID2), typed /npcskin 2 http://urlurlurlurl.png <not the real url>, and I get an error:
You don't have Citizens installed.
I have Citizens 1.2 installed, I am also using an HDskin url (working fine)
I also have the '*' permission for this plugin, so I don't think it's a perms issue.
Love this plugin for sure, I'm just not sure what is causing the error...
EDIT: Problem fixed.... - After installing Citizens2, I just had to replace all the NPC's to fit the new format.
Am still getting a small bug, however. - After restarting the server, skins and capes do not show on the NPCs until I use /npc move...
Nothing worth worrying about unless you have a ton of them to move. lol
looks better then spout-essentials!
@Ricowan: Thanks! That happens because if a URL is not valid, it assumes it must be a Minecraft player name instead. I will add a minecraft name validation check to fix that and throw the correct error message in version 2.0.2.
If there's an issue with the URL used in the command, or presumably an issue with the image itself, the error message says "you don't have permission to change that player's skin", instead of something along the lines of "invalid URL" or "cannot find a valid image at that URL". Otherwise, everything's working great now! :)