PlayEffect
PlayEffect 允许在你的 Minecraft 世界中生成视觉效果(以及声音效果)。你可以在指定位置播放单个效果,或者创建一个在指定区域内重复播放的“静态”效果。此插件是我之前发布的 NoSmoking! 插件的逻辑扩展,旨在替代它。
功能特性
- 59 种不同类型的效果
- 能够在指定区域(位置、直线、长方体、平面)播放效果
- 静态效果在指定区域内重复播放
- 支持自定义效果参数
视频演示
该视频由 EpicATrain 制作。非常感谢 :)
更多视频...
这是由 EpicTrain 制作的新视频。本视频展示了如何配合命令方块使用 PlayEffect :)
如何使用 PlayEffect
- /play <effect> <param1:value> <param2:value>... — 播放单个效果
- /play set <effect> <param1:value> <param2:value>... — 在你当前的视角位置设置静态效果
- /play wand <effect> <param1:value> <param2:value>... — 将效果绑定到手持物品上(默认手持物品为煤炭)
主要效果参数
- id:<effect id> — 效果的 ID 或名称,仅对静态效果必要;
- draw:<normal, line, plain, circle, area> — 效果的渲染视图:normal — 单个位置点,line — 由两个点定义(loc 和 loc2)的直线,circle — 由中心和半径定义的圆环,plain — 矩形,area — 长方体区域;
- loc:<world,x,y,z> — 主要(第一个)位置点
- loc2:<world,x,y,z> — 第二个位置点(用于 draw 类型:plain, line, area)
- radius:<radius> — 半径(用于 draw 类型:normal, circle)
- chance:<%> — 播放效果的几率
- time:<time> — 静态效果的重复间隔时间(时间格式与 ReActions 插件完全兼容)
- dur:<time> — 单个效果的持续时间(可与静态效果结合使用)
- freq:<time> — 单个效果的重复间隔时间(仅在与持续时间 (dur) 参数结合时使用)
每种效果都可能有其特有的参数,详见效果定义列表。
效果列表
共有 45 种不同的效果类型。全部列在此处:Effect list
PlayEffect API
PlayEffect 包含一个 API,允许插件开发者轻松开发具有效果功能的插件。
我创建了插件 PlayeEffectRailgun 作为使用 API 的示例:PlayEffectRailgun(源代码)
支持 PlayEffect API 的插件:
如果你是开发者且你的插件使用了 PlayEffect API,请通知我,我会将该插件添加到此列表中。
命令
插件的主要命令是 /playeffect。别名:/play, /pef, /pe
- /play help [page number] - 呵呵.... :)
- /play list [page] [effect id] — 显示静态效果列表
- /play info [number of effect id] — 显示关于效果的完整信息
- /play remove [effect number] — 移除效果
- /play set <effect> [param] — 设置效果。如果省略了参数 loc 和 loc2,则使用玩家位置和视角坐标。如果安装了 WorldGuard 插件且你可以使用手持物品(木斧)来选择位置点 loc 和 loc2。
- /play wand <effect> [param] — 使用手持物品(煤炭)定义效果直线
- /play wand — 禁用手持物品模式
- /play show <effect id> — 显示效果(s)
- /play hide <effect id> — 隐藏效果(s)
- /play restart — 停止播放所有效果并重新开始
- /play reload — 从文件重新加载配置和效果,重启效果
如何设置位置点
你可以使用以下方式定义坐标:
- 参数 loc 和 loc2。你可以使用关键字 "here" 和 "view" 来定义玩家坐标和视角坐标。例如:/play SMOKE loc:here, /play smoke loc:world,0,65,0 /play FIREWORK loc:here loc2:view draw:line
- WorldEdit 工具。如果已安装 WorldEdit,在使用 WE 工具(默认是木斧)选择点后,第一个点(左键点击)将用作 loc 参数,第二个点(右键点击)将用作 loc2。
- 默认值。如果省略坐标且未使用 WordEdit,则 loc 参数将等于你的视角位置,loc2 等于你的实际位置。例如:/play SMOKE 等同于 /play SMOKE loc:view
命令示例
- /play SMOKE wind:north loc:here — 在玩家所在位置播放带有北风方向的烟雾效果
- /play firework draw:line loc:here loc2:view type:burst — 哇!多么炫酷的激光效果!
- /play set driplava id:lavarain time:1s draw:plain loc:world,10,75,10 loc2:world,-10,75,-10 chance:10 — 创建一场熔岩雨
- /play set flamenew id:fireland time:5s draw:area land:true loc:world,10,50,10 loc2:world,-10,75,-10 chance:10 — 创建一片“燃烧”的土地
权限
- playeffect.config - OP 的主要权限
- playeffect.wand - 使用法杖命令的能力
- playeffect.set - 使用 /playeffect set 命令的能力
- playeffect.play - 使用 /playeffect playe 命令的能力
- playeffect.show - 使用 /playeffect show 和 /playeffect hide 命令的能力
如何从 NoSmoking! 插件升级
PlayEffect 支持 NoSmoking v0.0.7 文件格式。要导入 NoSmoking! 效果,只需将 smokepoints.yml 文件复制到 PlayEffect 文件夹并重启服务器即可。NoSmoking! 效果将被导入到 PlayEffect 中,原文件会被重命名为 smokepoints.yml.old。
警告!导入的效果可能与 NoSmoking! 中的效果存在差异:爆炸和末影珍珠效果已替换为其他效果,音效完全重新设计(我尝试使用了相同的音效),且两个插件在时间表示方式上也有所不同。
如果您需要从早期版本的 NoSmoking! 进行导入,请先使用 NoSmoking v0.0.7 以获取兼容的文件格式。
指标与更新检查器
PlayEffect 包含两项会使用您服务器互联网连接的功能。第一项是 Metrics,用于收集 关于该插件的信息(如插件版本、Java 版本等);第二项是更新检查器,会在 PlayEffect 启动后以及每隔半小时检查插件的新版本发布情况。此功能使用的是 dev.bukkit.org 提供的 API。如果您不喜欢这些功能,可以轻松禁用它们。要禁用更新检查器,请在 config.yml 中将参数 “version-check” 设置为 “false”。如需了解更多关于 Metrics 的信息以及如何关闭它,请阅读 此处。
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 :)
More videos...
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧