Usage
----Usage---
previous updates:
[spoiler]
SpoutPlayers 1.7.1
- fixed error with loading and saving to the config file
- sorry about that, it was setting all null values to '*', which in turn converted to the player username.
- Thanks for your patience!
1.7gravity+walkSpeed+airSpeed+swimSpeed+viewDistance+jumpHeight+canFly?
- improved code efficiency
- added a bunch of new <type>s:
- grav: changes how quickly you will fall. will still take fall damage. will get kicked if floating for too long.
- walk: how fast you walk
- swim: how fast you swim
- air: how fast you fly
- sight: how far the player can see. reduce lag or increase visibility.
- jump: how high you can jump
- fly: true or false
use them in commands eg:
/set @grav low 0.1
/set nil0bject grav low
1.6 @<type> - saving group data
- new modifier "@<type>", where <type> is skin, cape, grav or name.
- usage: /set @<type> <name> <value>
- example:
/set @cape group1 http://www.minecraftwiki.net/images/4/47/Creeper_cape.png
/set @cape group2 http://www.minecraftwiki.net/images/7/79/JulianClark.png
/set nicquehen cape group1
/set nil0bject cape group2
/set @skin group1 http://www.minecraft.net/skin/Notch.png
/set @skin group2 http://www.minecraft.net/skin/nil0bject.png
/set nicquehen skin group1
/set nil0bject skin group2
1.5 Gravity
- new modifier "grav". controls how much gravity a player experiences. 1 is normal. 0 is none. you can use negative numbers and decimals. 0.5 is good. watch out for fall damage.
- skins, capes, grav and names are refreshed on all players more regularly. this is controlled via the preferences: updateFreq: setting in the config file.
[/spoiler]
---config---
preferences
[spoiler]
preferences: updateFreq: 400 debug: true mysql: false
- updateFreq is how often all player appearances are refreshed. Lower values mean higher CPU usage.
- debug is for showing extra information in the console. Useful for helping me fix problems.
- mysql is true if you want to use a mysql server to save your data.
[/spoiler]
mySQL
[spoiler]
if mysql is true, you need to fill in these values. the database must already exist.
mysql: port: '3306' address: 'localhost' user: 'root' database: 'Bukkit' pass: 'mySQLpassword'
[/spoiler]
The skins, capes and players are defined in SpoutPlayers/config.yml or using mySQL. Here is a config example(the mysql setup basically mimics the config):
players
[spoiler]
players: nil0bject: skin: http://minecraft.net/skin/Xephos.png cape: modGroup name: '(mod)*' '@global': cape: 1M skin: guests name: guests mob: creeper
@global - players will inherit the values defined for @global. These are overridden when the player is defined separately.
- - a '*' is replace with the username of the player.
url - URL's must be valid direct links to png files.
'' - sometimes values need to be inside two quote marks, eg @global='@global'
[/spoiler]
skins, capes and names, etc
[spoiler]
mobs: creeper: 50 skins: guests: http://minecraft.net/skin/Notch.png capes: 1M: http://www.minecraftwiki.net/images/f/f7/1MCape.png modGroup: http://www.minecraftwiki.net/images/4/47/Creeper_cape.png names: guests: '(guest)*'
[/spoiler]
----permissions---
[spoiler]
permissions: sp.*: description: Allows a player to change any other player skin and cloak children: sp.name.*: true sp.skin.*: true sp.cape.*: true ... sp.<type>.*: description: Allows a player to change names children: sp.<type>.save: true sp.<type>.changeOwn: true sp.<type>.changeAll: true sp.<type>.un<type>: true sp.<type>.save: description: Allows a player to save changes to the name sp.<type>.changeOwn: description: Allows a player to change their own name sp.<type>.changeAll: description: Allows a player to change all player name sp.<type>.un<type>: description: Allows a player to remove a custom name from a player they have permission for
[/spoiler]
----commands---
[spoiler]
/set is the base command - it currently does nothing
/set <playerName> - shows you information about that player. replace <playerName> with a currently connected username.
/set @<type> <groupName> <value> - create a new group
/set <playerName> <type> <value or groupName> - set a players <type> to <value>
<type>s are:
- grav: changes how quickly you will fall. will still take fall damage. will get kicked if floating for too long.
- walk: how fast you walk
- swim: how fast you swim
- air: how fast you fly
- sight: how far the player can see. reduce lag or increase visibility.
- jump: how high you can jump
- fly: true or false
- pm: send an achievement notification to a player with your name and message
- mob: ID number of minecraft entity. The vanilla ones are listed below:
entity, ID
"Creeper", 50
"Skeleton", 51
"Spider", 52
"Giant", 53
"Zombie", 54
"Slime", 55
"Ghast", 56
"PigZombie", 57
"Enderman", 58
"CaveSpider", 59
"Silverfish", 60
"Pig", 90
"Sheep", 91
"Cow", 92
"Chicken", 93
"Squid", 94
"Wolf", 95
/set @cape group1 http://www.minecraftwiki.net/images/4/47/Creeper_cape.png
/set @cape group2 http://www.minecraftwiki.net/images/7/79/JulianClark.png
/set nicquehen cape group1
/set nil0bject cape group2
/set flosscones cape group2
/set @global cape group1
/set @skin group1 http://www.minecraft.net/skin/Notch.png
/set @skin group2 http://www.minecraft.net/skin/nil0bject.png
/set nicquehen skin group1
/set flossconesskin group1
/set nil0bject skin group2
/set @global name lolcats
/set @global grav 0.5
/set <playerName> name- removes the players temporary skin
/set <playerName> name <name> - sets the players name to the <name>. If you have permission, it will also be saved.
/set <playerName> cape- removes the players temporary cape
/set <playerName> cape <url> - sets the players cape to the <url>. If you have permission, it will also be saved.
/set <playerName> skin - removes the players temporary skin
/set <playerName> skin <url> - sets the players skin to the <url>. If you have permission, it will also be saved.
/set <playerName> grav - removes the players temporary gravity
/set <playerName> grav <number> - sets the players gravity to the <number>. If you have permission, it will also be saved.
[/spoiler]
----skins and capes---
these are some of the sites you can upload and use images for skins and capes:
[spoiler]
http://www.minecraftwiki.net/wiki/Skin#Cloaks
http://www.minecraftwb.com/index.php/skins
http://www.minecraftskins.info/
[/spoiler]
1.4 Download
- fixed PLAYER_JOIN bug
- commands now work properly again.
- sorry for those bugs. i had to rewrite heaps of stuff to get it working again. Thanks for being patient!
1.3
- added primary keys for all tables (will update automatically)
- fixed player names without using *
1.2 http://ubuntuone.com/1zlPBEFDUIfQLbtrzxaFMW
- saving to config now works correctly, again
- fixed null error on PLAYER_JOIN
- you can use * in the name. this will be replaced by the real name
1.1 http://ubuntuone.com/7mPpq5iSBalTkdTJCHGTXQ
- /set USERNAME name hahahahalulz
- a few optimizations
1.0 http://ubuntuone.com/6WIbNfO8Rxmwx8HELlCM5x
- completely rewrite of spoutPlayerSkins
- thanks to everyone for your support
[spoiler]
Quote from Boelens, post: 615529:This can be very usefull for some RPG servers, nicely done.
wow, thanks. It's my first bukkit plugin, so glad you think it has potential.
Any suggestions for future features?
[/spoiler]
Comments