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.
@koenkoro
I'm planning to create one :)
Is there any plugin hooked with this PlayEffect where we can do something like Hypixel's /pp command? You know, where the particles are circling around player's head
@EpicATrain
Thanks! It will be great! :)
I'll be creating a new video soon showing off what all can be done with this plugin.
v0.3.2 Uploaded, waiting for approval
@DoubleZ Hello! It very strange. Which version of craftbukkit do you using? blockdust was added to minecraft since v1.7. So it could be a reason. So you can test command again in newer version of PlayEffect. If you'll find this problem again please inform me. But I hope it will work fine.
hi , this is amazing plugin, I like it!
I have a question about command:
/play BLOCKDUST item:redstone_wire num:100
don't works, but
/play BLOCKCRACKSOUND item:redstone_wire
works.
any suggestion?
Omg you forgot the most important feature. Add player location option ASAP.
Example: locp: Notch also locp: me
v0.3.1 Uploaded yesterday; waiting for approval (usually it takes about two days)
I don't know how since afaik PlayEffect doesn't use ProtocolLib - but updating ProtocolLib fixed the issue with nothing working.
Still got the other issue though. PlayEffect is working but I get awfully lot console spam when I'm in nether or other world than the main world. I haven't had any luck tracking down what could be causing it. It's happening in situation where there shouldn't be any effects playing :-I
@pilvimaa PlayEffect broke with Bukkit update that had something to do with Particle API. I have opened a ticket about it. Would be really nice if you answered posts and tickets. I can see that you login often to Bukkit :-I
There's no changes at BukkitAPI with particles. PlayEffect using own particles routines that send packets directly to clients. Spigot contains extended API for effects, but I will not use it until it will be implemented in craftbukkit.
Today I tested PlayEffect with latest beta of craftbukkit and latest build of spigot. And it works fine. I you can provide me additional information that describe how to reproduce error message it will be very helpful.
P.S. Yes I'm everyday visiting bukkit.org, but... my subscription options was disabled (I don't know why). I think next time I will answer faster :)
@Hangar
Strange. I copied this line "/playeffect wand SOUND type:LEVEL_UP pitch:1 volume:2" (provided by you) to Minecraft, pressed enter... and it works...
@Cubby219 Hey id just hought i would say my server constatntly says [particleeffect] failed to create a particle packet! and it basically spams it could you please see about fixing???
Which version of craftbukkit you using? With latest 1.7.2-R0.3 beta all effects works fine for me....
@pilvimaa Thanks for information. I'll check this errors.
I get a 'failed parse error' when I use the wand command, but the command also still works:
/playeffect wand SOUND type:LEVEL_UP pitch:1 volume:2
It also seems confusing to say "id:<effect id>" is one of the main effect parameters but then not require I use id:SOUND in the above example. Maybe I misunderstand something there however.
PlayEffect broke with Bukkit update that had something to do with Particle API. I have opened a ticket about it.
Would be really nice if you answered posts and tickets. I can see that you login often to Bukkit :-I
Well ... the author is obviously too busy fixing the bugs to reply. Nice.
Hey id just hought i would say my server constatntly says
[particleeffect] failed to create a particle packet!
and it basically spams it could you please see about fixing???
Any idea what could be causing the issue I'm having (opened a ticket some days ago)
@MrAlestien
Hello it's not possible to create reddust with fixed colors except black and red. You can try any values "speed" parameter to randomize particles color.
Hello I wanted to ask here how to do it at /play set reddust with the colors. Thanks in advance