查看“ReActions”的源代码

== '''<big>ReActions</big>''' ==
'''<big>总览</big>'''：支持作者链接（是'''作者'''！不是'''[http://mineplugin.org/%E7%94%A8%E6%88%B7:JACV JACV]'''）[https://www.paypal.com/us/cgi-bin/webscr?cmd=_flow&SESSION=hmXi37Zp9rTVkWztTyD66rG1kvWgN9OPb3EUm1wUX09ucMxUILWWsi3VxXa&dispatch=5885d80a13c0db1f8e263663d3faee8d4fe1dd75ca3bd4f11d72275b28239088 Donation]<br />
::支持我翻译的链接 [http://adf.ly/1eHKPo Support]<br />
::'''ReActions'''是一款自定义事件的插件.它可以自动检测特定的情况，并在该情况下触发特定事件.也可以设定若该情况没有发生，将会发生什么事件.
----
=== '''<big>什么是ReActions？</big>''' ===
ReActions就是一款能让你自定义家具、物品、按钮甚至是……事件的插件.你可以自定义玩家在打开箱子或者按下按钮后会发生的事情.你可以更改杠杆的效果甚至把玩家传送到其他地方.你可以检查玩家是否在特定区域中，在玩家击杀BOSS时，也可以设置自动化的奖励.噢！当然！你甚至可以用ReActions来创造BOSS！ReActions完美支持各种第三者（例如Vault、Towny、Faction这些插件），当它和这些基础插件的配合下，甚至可以产生各种意想不到的效果！例如：你可以设置进入一个区域需要收取的费用、或者打开一格箱子需要收取的费用等等.你可以更改一个玩家在完成Faction之后会发生的事情（在搭配了Faction之后），或者玩家进入Town会发生的事（在搭配Town之后）……<br />
并且……你也不需要有很好的语言基础（我没有鄙视你的意思），ReActions的限制不在于语言上，而仅仅只在于你的想象力上.
----
=== '''<big>说明</big>''' ===
'''WiKi百科'''：[http://reactions.fromgate.me/ WiKi]<br />
'''中文WiKi'''：（待补充）
----
为了更好地理解其它描述，请先让我们看看专业术语的解释：<br />
'''Subscription''' —— 即“'''链接'''”.所谓链接，就是在执行动作之后，会发生的各种事件.例如：受到伤害、点击按钮、装备武器等等.当玩家执行这些动作后，一系列的事件（生命值提高、血量减少等等）就会随之发生.<br />
'''Activators''' —— 即“'''激活'''”，当你使用ReActions将某些物品与事件绑定之后，在特定情况下，玩家执行动作，就会激活相关事件.<br />
'''Flags''' —— 即“'''旗帜'''”，这里的旗帜，表示会发生的各种情况.<br />
'''Actions''' —— 即“动作”，指在发生了相关Flags之后，会执行的动作.这里，动作分两种：
*Actions：指如果相关Flags是有效的，会执行的动作；
*ReActions：指如果相关Flags是无效的，会执行的动作.
'''PlaceHolders''' ——“'''动态数值'''”，使用它来定义各种动态变量.
----

=== '''<big>特色</big>''' ===
*拥有能够掌控各种情况（Flags）的能力：控制各类权限（甚至是权限组），平衡玩家实力或者在背包中制作自定义物品.
*执行各种事件：你可以定义一个拥有特殊功能的按钮，传送玩家到特殊领域，或者激活某些第三方插件的相关指令等等.
*将动作和事件链接（Subscribing）：点击按钮或者踩踏踏板、进入一个[https://dev.bukkit.org/bukkit-plugins/worldguard/ WorldGuard]领域将会发生什么事情等等.
*建造 - 可以将玩家的行为和服务器里的时间（甚至是现实时间）相连接.
*MySQL支持（使用ReActions你可以很方便地将你的设置与相关网站相连接）
*创建可视化GUI
----
=== '''<big>使用ReActions，我能够创造出什么？</big>''' ===
以下，是一些服务器在使用ReActions之后，创造出的例子：
*传送系统可以和金钱系统、物品交换系统、甚至是游戏时间相绑定.例如：在白天的情况下，传送只需要消费一颗钻石.
*可以创建简单的管理员商店.例如：你可以让玩家通过点击一个按钮，来购买一堆钻石.
*创建有放射性的区域——玩家在进入某一个区域后，将会持续地收到伤害.
*创建桥梁、传送门
*创建出独特的命令（甚至可以用你的本地语言），这种方式完全不需要依赖第三方插件.
*简单解决一些RPG问题.例如：拿着钻石剑的玩家，将会传送到一个特殊地点，而没拿钻石剑的玩家将会传送到另一个地点.
*在第三方插件的支持下创建更多有趣的事情.
*我知道有个服务器有个非常具有战略性的特色.就是在一些领地中玩家不能建造，在另一些领地中玩家可以建造，但却不能采集资源.（建造的这个功能使用的是ScLoad，而非ReActions实现）
*创建出枪炮，甚至火箭弹.
----
=== '''<big>视频教程</big>''' ===
还有更多展现ReActions的视频目前正在制作中.我会尽可能地加快进度，下面这些视频将向你展示ReActions的一些功能：<br />
'''01.如何通过右击使用一个物品，达到执行飞行命令的效果：'''<br />
[https://www.youtube.com/watch?feature=player_embedded&v=gqDvxNiYojs ViDeo]<br />
'''02.展示两种激活效果：进入WG领地和离开WG领地，将发生的药水效果：'''<br />
[https://www.youtube.com/watch?feature=player_embedded&v=Jh2pGMGh-yY ViDeo]<br />
'''03.观看更多视频教程：'''<br />
[https://youtu.be/WIRj0wMdkYM?list=PLlAz3KfoBuy8UCacPVMPNjz1H7XnkKo6x Here]
----
=== '''<big>为什么选择ReActions？</big>''' ===
 有时候我总是不得不面对这样的问题：为什么我使用的是ReActions，而非Bukkit中其它的命令方块插件呢？对此我在长时间的思考之中，也算是有了些许答案.<br />
 如果你之前，曾经使用过其它脚本方块，并熟记了它们的语言，那么，我不建议你替换掉它们.因为许多命令方块插件也基本上都能达到ReActions的水平.<br />
 但是，下面有一些ReActions的特色，才是我想集中说的：
*ReActions使用起来真的非常非常简单.当你在创建了第一个ReActions脚本之后，你会发现以后的使用将会变得非常轻松.
*我编写ReActions初衷依然是倾向于使用者，而非开发者.Bukkit建造事件和玩家行为是两回事.很多脚本方块的编译都将建造事件排在前面.就是说它们都需要先检测领域，然后再对玩家行为作出判断.
:但是，ReActions则可以高效地对玩家行为作出应答.
*我已经尽最大努力，让ReActions和其它第三方插件兼容甚至是提升整体性能.目前，ReActions配合的第三方插件有：
:WorldGuard, Vault, Craftconomy3, Factions, Towny, PlayEffect and RacesAndClasses
*你既可以在游戏中设置脚本方块，也可以在后台修改Config来实现相关设置.
*ReActions并非真正意义上的脚本语言，并且，在长时间的使用中它已经受到广泛好评.因此，我才有了继续编译的动力.
----
=== '''<big>命令</big>''' ===
'''<param>''' —— 必须设置的变量<br />
'''[param]''' —— 选择设置的变量<br />
'''[param:<value>]'''  ——选择设置的变量，这种变量必须设置有效数值<br />
'''[v1 | v2 | v3]''' —— 选择设置的变量，当设置之后，事件将会和其中1种/2种/3种变量相关联.<br />
主要命令为：'''/react''' 可以简写成：'''/rea''', '''/ra'''.<br />
*'''/react help''' —— 显示帮助界面
*'''/react add <ActivatorType> <ActrName> [Param]''' —— 创造一个激活，和相关事件关联.
*'''/react add loc <LocName>''' —— 保存地点（例如你想要设置传送，就必须先保存地点）
*'''/react add <ActrName> f <Flag> <Param>''' —— 创建一个特殊旗帜下的激活.
*'''/react add <ActrName> a <Actn> <Param>''' —— 为一个激活添加动作.所有在该激活列表下的动作，如果被激活，将全部执行.
*'''/react copy [flag | actions | reactions] <SrcActr> <DestActr>''' —— 复制旗帜、动作和恢复动作.并且需要定义<SrcActr> 或<DestActr>（如果你没有定义[flag | actions | reactions]，那么就会复制所有）
*'''/react list [loc | group | type] [Page]''' —— 显示相关列表下的定义（如果你没有定义[loc | group | type]，那么就会显示所有）
*'''/react info <ActrName> [f | a | r]'''  —— 显示激活下的相关旗帜、动作、恢复动作的信息（如果你没有定义[f | a | r]，就会显示所有）
*'''/react group <ActrName> <GroupName>''' —— 更改指定激活所属于的组.（如果指定的组不存在，就会创造一个）
*'''/react remove <loc|activator> <ActrName|LocName>''' —— 移除激活、或者是地点.
*'''/react remove <ActrName> <f | a | r> <num>''' —— 移除拥有特殊值的激活、旗帜、动作等等.（你可以通过指令'''/react info <ActrName> [f | a | r]'''查看相关信息）
*'''/react clear <ActrName> <f | a | r> ''' —— 从一个激活中移除相关旗帜或动作、恢复动作.
*'''/react debug <true|false|off>''' —— 开启调试模式.'''true'''：所有的检查都会返回true；'''false'''：所有的检查都会返回false；'''off'''：关闭调试模式.
*'''/react check [radius]''' —— 显示范围内的自定义地点（如果你没有定义[radius]，就会显示8格半径以内的自定义地点）.
*'''/react reload''' —— 重载配置文件.
----
=== '''<big>命令</big>''' ===
*'''reactions.config''' —— 允许创造相关激活和地点.
*'''reactions.debug''' —— 允许开启调试模式.
----
=== '''<big>与第三方插件的合作</big>''' === 
ReActions和下面的插件完美支持，你可以选择添加一些插件：
*[https://dev.bukkit.org/bukkit-plugins/vault/ Vault] —— 一款经济插件.
*[https://dev.bukkit.org/bukkit-plugins/worldguard/ WorldGuard] —— 一款领地插件.
*[http://palmergames.com/towny/ Towny] —— 城镇插件.（警告：Towny这个链接指向的是一个外部网站，我承认它是一个好插件，但是，它始终没有搬运到Bukkit论坛里来.是不是有什么企图呢？你试试就知道）
*[https://dev.bukkit.org/bukkit-plugins/factions/ Factions] ——一款派系插件.
*[https://dev.bukkit.org/bukkit-plugins/racesandclasses/ Races and Classes] ——一款种族和等级插件.
*[https://dev.bukkit.org/bukkit-plugins/playeffect/ PlayerEffect] ——一款Buff收益插件.
*[https://dev.bukkit.org/bukkit-plugins/craftconomy/ Craftconomy] —— 新款经济插件.
----
=== '''<big>检查和更新</big>''' ===
ReActions有两项内容涉及联网.首先是'''检查'''，这是用来检测插件相关信息的.（例如插件版本、JAVA版本等等）另一个是'''更新'''，就是用来更新插件的.在你启用ReActions之后，它们两个就会每30分钟启动一次.<br />
这两个内容可以保证ReActions始终和Bukkit的API（dev.bukkit.org）一致，增强ReActions的实用性.当然，如果你不喜欢这样，也可以关闭它们.只需要在config.yml文件中将version-check设置为false即可.<br />
如果你想学习如何配置检查，你可以点击[http://mcstats.org/learn-more/ 这里]查看.
----

== '''<big>结束</big>''' ==