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

Posts Quoted:
Reply
Clear All Quotes