S86 Powers
Introduction
Minecraft is a great game on its own, but chances are if you're here and you're a server admin then you're looking for more to offer your clients. As you may know by now, when it comes to the extras every player wants something unique. Some want new mechanics, others want better weapons. Some want to help their friends, others want to dominate them. The problem is most plugins often offer a blanket solution. While it may fulfill the needs of a few, the remaining may not want to participate. Sure you can mess with permissions to exclude some people, but why not just cut to the chase and give every player EXACTLY what they want?
For the server that wants its players to each have individual benefits and abilities, S86 Powers is the plugin for you.
How It Works
S86 Powers is a plugin that allows users to have powers assigned to them. The core plugin comes with internal powers, but is also capable of importing powers made by others (more info to come).
To get started, simply place the S86Powers.jar file where you put your other plugins. Note that ProtocolLib is required for S86 Powers to function. On first run, several configuration files are created with default values. It is recommended that you not edit these files directly unless the server is off, as entered values may be overwritten the next time the server shuts down or restarts.
Next, you'll want to review permissions and configuration options. Operators by default get permission to everything, otherwise assigning the permission s86powers.admin will accomplish the same thing. To view configuration options, use the command /p config list [page#] (for example, /p config list 2 shows you page 2). For more information on what an option does, use the command /p config info [config], and to change config options use the command /p config set [config] [value].
Finally, for players to use powers they must first have them assigned, and before they can do that they'll want to know what's available. Use the command /p power list to get a list of loaded powers, then /p power [power] for more info on a specific power. If you don't like how a power is setup, you can check and set its configurable options with /p power [power] option. Note that changes to power options affect all users, and may require a server reload/restart for changes to take effect.
Players can be assigned powers in several ways, the two most prominent being admin-assigned or self-assigned. Admin-assigned requires a user with the s86powers.manage.user permission to use the command /p user [player] add [power]. Note that the above permission allows the user to set anyone's powers and shouldn't be given to most players. Self-assigned requires a user to have the s86powers.manage.self permission, and use the command /p add [power]. This method is safer, as the user can only modify their own powers.
What Are Powers?
Most powers come in three categories: offensive, defensive, and passive. Offensive and defensive powers operate similarly: the player does something with a specified item, and it causes an effect. Offensive powers usually do something that causes damage to others, while defensive powers usually do something to protect the player in some way. Passive powers tend to work automatically and provide some kind of bonus that neither hurts others nor protects the player (though there are exceptions).
An example of an offensive power is Laser. In its default configuration, left-clicking while holding a dispenser will fire a laser in the direction that the player is looking. This laser steadily does damage to anything it hits but uses redstone dust as fuel. The laser turns off when either the player left-clicks while holding a dispenser again, or when the player runs out of redstone dust. After using Laser, the player has to wait for a 10 second cooldown before using it again.
An example of a defensive power is Celestial Pillars. Left-clicking the ground while holding a sea lantern will create pillars of light around you. While these pillars stand, nothing can pass between the pillars except for the player. Pillars last for 45 seconds, however the player can't create new ones until the old ones expire.
An example of a passive power is Lumberjack. With Lumberjack assigned, breaking one log block of a tree with an axe will cause all adjacent tree blocks to break as well, essentially harvesting the entire tree at once. By default, a threshold is put in place so players can't level entire jungles.
Some powers have additional effects when they're used a lot. For example, after creating 60 pillars with the Celestial Pillars power, you gain the ability to create a second set of pillars by left-clicking the same block with a sea lantern again.
By default, players can only have one of each of the above power types assigned to them, though this limit can be removed with config options.
The last power type is utility. Utility powers can be used by anyone, including players with no assigned powers. Neutralizer Grenade allows players to throw lapis lazuli like a grenade, temporarily disabling the powers of any players nearby when it hits. Neutralizer Beacon allows players to create a block that constantly disables the powers of players who go near it.
Commands / Permissions
All commands can be viewed by simply using the /powers help command. You can view additional pages using /powers help [page], or view help on specific topics like /powers help player.
Donate
Creating and maintaining a plugin this size can be a full-time job on its own. I enjoy working on this plugin and don't mind doing it for free, but the fact remains that I must commit a majority of my free time to do this. If you like my work and would like to support it, please consider donating.
Need support? Have an idea for a power? Join my Discord server!
@RandomSomething98
Heh oops, no that's not supposed to happen... I didn't add a check to make sure the player is barehanded XD I'll fix this in the next version, thanks for bringing it to my attention!
Was it intended that right clicking a mob with a compass still attaches the tracker on it? The description says that it should only work for barehanded.
@RandomSomething98
Probably not. Currently, too much of the plugin revolves around assuming all powers have a single type, and to be honest to me and many others it makes sense:
Passive - Mostly powers which don't need to be manually activated, or rarely.
Offense - Powers which must be manually activated with intent to harm another entity in some way.
Defense - Powers which must be manually activated but do not directly (or intentionally) harm other entities.
Dou you think you will eventually make powers that are more than 1 type? Like maybe a power that is both offensive and passive?
@RandomSomething98
Yes, all that and more, good stuff...
With barfer, can it be possible to make the water stream slower, to make it seem more gross? Also, it would be hilarious to see other people barf when they are within distance to the original barfer for a certain amount of time afterwards. But their barf won't be special. :P
@RandomSomething98
Update - I uploaded v3.2.2 yesterday, BukkitDev has to approve it, then it'll be available for download.
Barfer - Lol that's gross yet intuitive, how can I say no?
I had another idea for a power.
Barfer- An offensive power, the player can "barf" at random times. Barfing can basically be a water stream with slime balls coming out of the player. It gives hunger effect, and various potion effects to the player and others around him. It poisons any other players that touch the barf. As the player barfs, he loses hunger points. This ability can be forced by eating rotten flesh. This ability also repels mobs, but unfortunately attracts and has no effect on undead mobs. Also, if the player had used a potion and then barfed, he loses some of the time from it, but players touching the barf when this occurs get that effect slightly.
Do you have a date for when we should expect 3.2.2?
@RandomSomething98
They should. I tested them using Multiverse. Version 3.2.2 fixes an error where it'd try to get the player's distance from beacons in another world, but other than that seems to work fine.
Would beacons and such support Multi-World?
@BurnGuy
Make sure you're in survival mode; powers don't work in creative. You can also type "/powers player jelly" to confirm the power is assigned.
Also ThunderBow now only works with fully charged shots unless you changed it in the pConfig.yml file.
My name on the server is Jelly..I'm typing /powers player jelly thunderbow and still not getting any type of power ...Help :D
@BurnGuy
Yeah don't see why not. If you still have any trouble let me know.
Thanks SIRRUS! so all the players on my servers are mods cause they're my friends..we should be all set?
@TheSymmes
Yeah it's probably possible. I'll see what I can do.
@BurnGuy
The s86powers.enable node must be true for powers to work. Fortunately, from v3.0.2 on, I've set this permission to true by default so permission setup isn't necessary. In its basic form, the console and all server operators have all powers permissions by default, while other players can only view players and powers in their respective databases. If you're looking for more than this I can help you set it up.
I'm very new and Have no idea how to work permissions. I downloaded PermissionsEX but don't know what to do from there. When you say, "The player must have the permission node s86powers.enable set to true" does that mean my friend?..Or Do I have to do something on the server. If someone can just post the code so i can just paste it into the Permissions file that'd be awesome! <33
I've noticed that using Blood bend on creepers won't stop them from exploding, but it stops other mobs from hitting you. Would it be possible to have blood bend pause the creeper wherever it is on its way to exploding?
Hurry up devbukkit I want to see 3.2.2 :)
@sirrus86
Thanks so much! :)