PlayEffect
PlayEffect
PlayEffect allows to spawn a visual (and sound) effects in your Minecraft worlds. You can play single effect in defined location or create a "static" effect that repeatedly plays in defined area. This plugin is logical extension of my plugin NoSmoking! and created to replace it.
Features
- 59 different types of effects
- Ability to play effect in defined area (location, line, cuboid, plain)
- Static effects repeatedly played in defined area
- Effect customization
Video demonstration
This video is created by EpicATrain. Thank you very much :)
New video created by EpicTrain. This videos is demonstrating how to use PlayEffect with command blocks :)
How to use PlayEffect
- /play <effect> <param1:value> <param2:value>... — play single effect
- /play set <effect> <param1:value> <param2:value>... — set static effect at your view poing
- /play wand <effect> <param1:value> <param2:value>... — link effect to a wand (default wand is the coal item)
Main effect parameters
- id:<effect id> — id or name of effect, necessary to static effects only;
- draw:<normal, line, plain, circle, area> — render view of effect: normal — single location poing, line — line defined by two point (loc and loc2), circle — ring defined by center and radius, plain — rectangle, area — cuboid region;
- loc:<world,x,y,z> — main (first) location point
- loc2:<world,x,y,z> — second location point (used with draw types: plain, line, area)
- radius:<radius> — radius (used with draw types: normal, circle)
- chance:<%> — chance to play effect
- time:<time> — repeating time for static effects (time formatis fully compatible used in plugin ReActions)
- dur:<time> — duration time for single effect (could be combined with static)
- freq:<time> — repeating time if single effect (use only with duration (dur) parameter)
Every effect could have own parameters, that listed in effect definition.
Effects
There are 45 different effect types. All of them listed here: Effect list
PlayEffect API
PlayEffect contains an API that allows plugin developers easy access to develop plugins with effect features.
I created plugin PlayeEffectRailgun as example of using API: PlayEffectRailgun (source code)
Plugins supported PlayEffect API:
- Laser: lasers and other beam weapon
- ReActions: very simple custom event processing system — add new actions to buttons, plates, etc..
If you developer and your plugins is using PlayEffect API please inform me and I will add you plugin to this list.
Commands
Main command of plugin is /playeffect. Aliases: /play, /pef, /pe
- /play help [page number] - Hmmm.... :)
- /play list [page] [effect id] — display list of static effects
- /play info [number of effect id] — display full information about effect
- /play remove [effect number] — remove effect
- /play set <effect> [param] — set the effect. If parameters loc and loc2 omitted player location and view point coordinates will used. If WorldGuard plugin is installed and you can use wand (wood axe) to select location point loc and loc2.
- /play wand <effect> [param] — line defined effect with wand (coal item)
- /play wand — disable wand mode
- /play show <effect id> — show effect(s)
- /play hide <effect id> — hide effect(s)
- /play restart — stop playing of all effects and start it again
- /play reload — reload configuration and effects from the file, restart effects
How to setup location points
You can define coordinates using:
- Parameters loc and loc2. You can use keyword "here" and "view" to define coordinates of player and coordinate of view point. Example: /play SMOKE loc:here, /play smoke loc:world,0,65,0 /play FIREWORK loc:here loc2:view draw:line
- WorldEdit tool. If WorlEdit is installed, after selecting a points using WE tool (wood axe - default) first (left-click) point will be used as loc parameter, second (right-click) will used as loc2.
- Default. If coordinates omitted and WordEdit was not used loc parameter will be equal to you view point loc2 to your position. Example: /play SMOKE is equal to /play SMOKE loc:view
Commands example
- /play SMOKE wind:north loc:here — plays effect with wind direction - north at player locations
- /play firework draw:line loc:here loc2:view type:burst — Oh! What a great laser effect!
- /play set driplava id:lavarain time:1s draw:plain loc:world,10,75,10 loc2:world,-10,75,-10 chance:10 — creates a lava rain
- /play set flamenew id:fireland time:5s draw:area land:true loc:world,10,50,10 loc2:world,-10,75,-10 chance:10 — creates a "flaming" land
Permissions
- playeffect.config - main for OPs
- playeffect.wand - ability to use wand command
- playeffect.set - ability to use /playeffect set command
- playeffect.play - ability to use /playeffect playe command
- playeffect.show - ability to use /playeffect show and /playeffect hide commands
How to upgrade from the NoSmoking! plugin
PlayEffect supports NoSmoking v0.0.7 file format. To import NoSmoking! effects you just need to copy smokepoints.yml file to PlayEffect folder and restart server. NoSmoking! effects will be imported to PlayEffect and file will be renamed to smokepoints.yml.old.
Warning! Imported effects could differ from the NoSmoking! effects: explosion and ender pearl effects are changed to another, sound effect is totally new (I tried to use the same sounds) and there a difference between time representations used in the plugins.
If you need to import from earlier versions of NoSmoking! you need to use NoSmoking v0.0.7 first to get a compatible file format
Metrics and update checker
PlayEffect includes two features that use your server internet connection. First one is Metrics, using to collect information about the plugin (versions of plugin, of Java.. etc.) and second is update checker, checks new releases of plugin after PlayEffect startup and every half hour. This feature is using API provided by dev.bukkit.org. If you don't like this features you can easy disable it. To disable update checker you need to set parameter "version-check" to "false" in config.yml. Obtain more information about Metrics and learn how to switch off it, you can read here.
@s32ialx
Sadly. they dont like people posting links to the unapproved versions, but we can give people hints. go to files, and change the number at the end of the url is what i generally give people.
@fromgate
do you have a Jenkins site I can download the jar from while we wait for approval? since they might take awhile to approve these as they are still in dev builds.
nvm This sites not built as secure as I thought... altering Link Removed took me to the direct link to the 1.7.2 version ;D I didn't think that would actually work but thanks bukkit for this :) much appreciate.
@Wonkee
Command play <effect> is supporting console, but you must define a locations. If you going to "bound" this command to any online player you can use parameter "player" (since v0.3.0)
Example:
play SMOKE player:fromgate loc:here loc2:view draw:line
v0.3.0 Uploaded, waiting for approval.
@pilvimaa In 1.7.2 was changed some class name. So PlayeEffect version 0.2.x will not work with 1.7.2. When PlayEffect v0.1.0 was release it was coded under 1.6.4 and I did not test it with 1.6.2, but some users said it works nice with 1.5.2 (I did not test it).
Today I will upload v0.3.0 and it will work with 1.7.2 fine
I'm having trouble using some of the particle effects like for example flamenew, lava and heart .. and, well, many others as well. They simply don't show up.
Smoke, potion and some others that I tested work fine. Help me understand why is it so? I'm using Spigot 1.7.2 but some effects like lava and the explosions were missing already with Minecraft 1.6.2.
I even tried coding my own little plugin to use the simple particle effect calls in Bukkit, but it's always the same ... some effects work just fine and some don't. I don't really see the difference between them. I mean, if one works shouldn't they all?
Some were missing in 1.6.2 and now with 1.7.2 even more have gone missing that were working with the earlier version.
Is it just me or does this affect other people as well? I haven't seen any complaints anywhere.
Any ideas?
@Stubkan
Under construction. There some problem with firework effect in 1.7.2. I think I will find solution at nearest future.
Can this be updated for 1.7.2 please?
I don't want to have to find another particle plugin!
Is there a way I can run a command as console and have the effect play as if the player ran it? like "/play smoke draw:line loc:here loc2:view wind:east" makes a really cool effect, but I would like to run it via the console instead of giving players perm to run the commands.
Added API description: http://dev.bukkit.org/bukkit-plugins/playeffect/pages/main/play-effect-api/
@Cubby219
Latest version is supported console sender for command playeffect <effect> <parameters>
But playeffect set is not supported.
Can you show me command that not work for you when you type it using console?
hello, i am attempting to get a command sign to run one of your commands. Unfortunately that command sign goes through the consle. so whenever i try to run it it says somethings wrong check command permissions. how can i keep the default settings for every plugin, but give the consle permission do do the play commands. The reason i think the consle should be able to is because you can specifiy a location. Thanks!
@Cubby219
Hmmm... what is "1000 10000 10001 001 001 010" that you typed after effect name????
Smoke effect supports only parameter wind (in addition for standart).
For example: /play smoke dur:10s freq:1s wind:north
ok i don't quite get this parameters setting thingy. umm... i try doing like /play smoke 1000 10000 10001 001 001 010 but that does regular smoke how can i create an effect with extra parameters?
@Cubby219
Hello!
1. There's no any effect that cause damage to players. All effects just visual (or sound) effects.
2. You can use parameters draw:area chance:XX to play random amount of effects in defined (by loc: and loc2: parameters) cuboid.
I have 2 questions! 1. Does the lighting effect cause player damage, creeper charge..ect? 2. How for effects like the end effect do you get it to cover a larger area? Im really enjoying finding cool ways to use your plugin in my server. The players are LOVING it!! Thanks soo much!
@fromgate
That was fast =D ! Thanks again !
@Zerkhaan
v.0.2.1
@fromgate
Yeah ! Thanks !
@cubby208
There's no "smoke" command in play effect. /smoke is command of NoSmoking plugin. PlayEffect implements command /playeffect (and it's alias - /play). So if you need to play smoke effect you must type /play smoke