TeleParticles
Currently, this plugin is not under active development (I don't plan to add anything), I'll try however to fix any bugs found. If you have new ideas or are just interested, the source code can be found on Github
Features
- Adds sounds and particles when a player teleports
- Supports permissions
- Automatically disables effects if player is vanished with VanishNoPacket
- Supports PossessEm': Only the appropriate effects for the possessed player are played
- You can configure a list of commands with special treatment. Each command has four settings (Note that the player needs to teleport, so you can't add sounds to the /time command for example)
- It is possible to configure a command differently depending on the used arguments (see the example config below)
- You can configure a list of locations that trigger or disable effects if you teleport from/to them (or even from one to another)
- Configurable minimum-distance for sounds and effects
- You can tell the plugin to ignore any teleports with UNKNOWN as cause - this should disable any effects for entering minecarts and similar
- You can edit everything ingame using commands, so no need to edit the config file
Settings explanation
For every command/location you define, you can specify to controllers that affect the effects(particles/sound) being played:
- deny - this disables any effects, no matter what
- none - use this if you don't want the command/location to have any effect on what's being played
- force - this forces the effects for everyone (note that deny is "stronger", so if both deny and force are triggered for a teleport, no effect will be played) You can define two separate values for particles and sound
For a command, you can additionally define a value for argRegex. This is a regular expression that must match the argument of the command being used (default is .*, this allows any arguments) For locations, you can specify both from and to (or only one), each with a tolerance (it describes the maximum distance the real teleport start/target can have from the specified one) There's an additional setting: maxDelay. It defines the maximum amount of time between the command and the teleport of a player in milliseconds. (This is necessary since the plugin can't determine the command name of the command used to teleport the player, so it listens to all commands, and if a player teleports in a given interval after he issued a valid command, it plays the defined effects) The allowed format for all these settings are below.
Permissions
- teleparticles.particles - Enables teleport particles.
- teleparticles.sounds - Enables sound when teleporting.
- teleparticles.reload - Allows the player to reload the config.
- teleparticles.readmodify - Allows the player to read and modify any settings using the commands.
Commands
- /teleparticles reload/rld - reloads the configuration file from disk
- /teleparticles maxDelay/mD [<value>] - gets/sets the value
- /teleparticles minParticleDistance/mPD [<value>] - gets/sets the value
- /teleparticles minSoundDistance/mSD [<value>] - gets/sets the value
- /teleparticles ignoreUnknown/iU [<value>] - gets/sets the value
- /teleparticles commands/cmd - outputs a list of all configured commands (here you can get the id of a command)
- /teleparticles commands/cmd delete/del/d <id> - deletes the command with the specified id
- /teleparticles commands/cmd modify/mod/m <id> <data> - modifies the command with the specified id (the data format is explained below)
- /teleparticles commands/cmd add/a <command> <data> - adds a new command with the data specified (the data format is explained below)
- /teleparticles locations/loc - outputs a list of all configured locations (here you can get the id of a location)
- /teleparticles locations/loc delete/del/d <id> - deletes the location with the specified id
- /teleparticles locations/loc modify/mod/m <id> <data> - modifies the location with the specified id (the data format is explained below)
- /teleparticles locations/loc add|a <newData> - adds a new location with the data specified (the data format is explained below)
- /teleparticles matchingLocations|mLocations|matching|mL|nearbyLocations|nLocations|nearby|nL - outputs a list of all configured locations that match the current position
Data format (only for commands)
There are two possible formats for <data>:
- A simple list: <argRegex> [<spawnParticles>] [<playSound>] (for commands) or <from> [<to>] [<spawnParticles>] [<playSound>] (for locations)
- A list containing <id>:<value> pairs, where <id> can be:
- argRegex/arg/a (for argRegex)
- spawnParticles/particles/p (for spawnParticles)
- playSound/sound/s (for playSound)
- from|f (for from)
- to|t (for to)
Data format (for everything)
For the locations, there are three possible formats:
- <world>,<x>,<y>,<z>,<tolerance> (for a specific location)
- * (to allow any location, useful to reset values using the modify commands)
- #,<tolerance> (# means that it will use the current position of the player using the command, so it's no usable from the console or in the config file)
For the spawnParticles and playSound controllers there are three possible values:
- -1/deny/d (to deny any effect)
- 0/none/n (to not affect anything)
- 1/force/f (to deny any effect)
Installation
Just put the TeleParticles.jar file into the "Plugins" folder. There you go :)
Bugs/Problems
If you enter/leave any sort of vehicle, effects are triggered which isn't really nice and usefull There's now a config option to ignore any teleports with cause UNKNOWN. I don't know any teleport-cause except entering/leaving a vehicle that is UNKOWN, so it should work. If the effects aren't triggered in any other situation, set the ignoreUnknown-value to false to see if it works. (Be sure to report it, too)
If you find anything else, please report it! :-)
Is there any chance of adding a reload function so we don't have to restart the server when changing or editing the configuration?
@IMathe172I
Thanks for the update. I will be adding this now to test it out. If I find any bugs, will come to you.
@Steelsouls
I'm glad you like it! Is it possible that you moved to fast before it happens? Or is there any other reason why you could be teleported?
Just wanna say I absolutely love this plugin. It's so much fun! I do randomly get the effect sometimes as I'm moving around (usually up/down stairs or hitting my head on something while flying). It doesn't bother me though, just mentioning it. Just seriously I have all these huge plugins and I can't stop talking about this one ;) It's great. Thank you!
Updated to 1.2...
@Unknown_Mage
I mean that nobody has the permission by default. I'll try to add support for commands for the next version.
What do you mean they are disabled by default?
Either way, it seems to be conflicting with a plugin of mine by closing the chat and hindering any movement. Is there a way to make a configuration file to disable it for certain ranks, even when they teleport to spawn? It seems to glitch them at spawn only into just floating in the air not being able to move or use chat. Note: This only happens when teleporting to spawn.
Maybe a configuration file to make it so particles work for certain commands? Might be interesting to add for whenever someone joins a Mob/PvP Arena.
Currently using V1.1 with 1.4.7-R1.0. No errors on console, just glitchy chatbox and movement.
@Xatron7
Sorry for the long delay...How far do you teleport? Do you have the permissions? (Note that they're disabled by default for everyone)
@deleted_7379271
Nope no error messages.. My server is running bukkit 1.4.7 R1.0
Tested: Working perfectly. Thanks!
@Xatron7
hi Xatron7 Are there any error messages in the console? What bukkit version do you have?
Please post it or send me a pm, then i can help you :)
looks very nice on the picture above but doesn't work for me :( I simply put the TeleParticles.jar file into the plugins folder but when I type /spawn no particles are showing up :(
@Dommbringer
Since the release of Java SE 7 Update 4, the Java SE 7 runtime is now available on java.com as the default JRE. I would think that's a pretty good vouch for stability! :)
@Dommbringer
Hmm, I have java 7. Does it matter that im using the 64-bit version? Yes, i have a 64-bit operating system, btw.
Update: My mistake, I had 7 update7. I uninstalled it and installed 7 update 11 and it works fine. Thx!
@lucasdidur
Java 7 is not officially stable yet, I will probably end up manually rebuilding this plugin from source code for my server so it works with java 6 :P
@theeone2
Yes, it need java 7
@theeone2
Update to Java 7
unsupported class version error. http://pastebin.com/r0aen52h
@ManBeastPigDev
Yes of course, but when you find a bug, please tell us :)
Does it work with 1.4.7 ?