差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- 插件手册:betonquest:事件列表 [2019/01/24 06:38] – 更新到BQ1.11 小小k酱
+++ 插件手册:betonquest:事件列表 [2021/12/02 09:41] (当前版本) – [日记: journal] duangfafa
@@ 行 29: / 行 29: @@
 **//persistent//**
-指定玩家一种积分进行操作. 可以用乘法. 第一个操作是积分的类型, 第二个参数是 加/减/乘.
+指定玩家一种积分进行操作. 可以用乘法. 第一个操作是积分的类型（自己命名）, 第二个参数是 加/减/乘.
-**例子**: ''%%point npc_attitude 10%%''
+**例子**: ''%%point 管家好感度 10%%''
-**例子**: ''%%point village_reputation *0.75%%''
+**例子**: ''%%point 村庄荣誉 *0.75%%''
+===== 删除积分： deletepoint =====
+**//persistent, static//**
+删除指定玩家的某项积分。
+**例子**: ''%%deletepoint 管家好感度%%''
+**例子**: ''%%deletepoint 村庄荣誉%%''
 ===== 标签: tag =====
@@ 行 53: / 行 62: @@
 ===== 日记: journal =====
-添加或删除玩家的日记. 第一个参数是添加(add)或删除(del), 第二个参数定义在 ''%%journal.yml%%'' 中. 也可以直邮一个参数''%%update%%'', 据说挺有用.
+添加或删除玩家的日记. 第一个参数是添加(add)或删除(delete), 第二个参数定义在 ''%%journal.yml%%'' 中. 也可以直邮一个参数''%%update%%'', 据说挺有用.
 **例子**: ''%%journal add quest_started%%''
+**例子**: ''%%journal delete quest_started%%''  从日志中删除一个页面
 **例子**: ''%%journal update%%''
@@ 行 91: / 行 102: @@
 给玩家药水效果。[[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html|效果列表]]，第二个参数代表药水效果的时间是多少秒，第三个代表了药水的等级。可以使用''ambient'' 可以让玩家看不到药水的视觉特效(类似于信标)。隐藏粒子特效添加''ambient''，不显示右上角图标则添加''noicon''。
-**例子**: ''effect BLINDNESS ambient hidden''
+**例子**: ''effect POISON 45 1 ambient hidden''
 ===== 移除药水效果: deleffect =====
@@ 行 112: / 行 123: @@
 ===== 生成生物: spawn =====
-**//static//**
+**//persistent//**, **//static//**
-在指定的位置放置一定数量的某种生物。第一个参数是坐标位置，然后第二个是[[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html|怪物类型]]。第三个是数量，最后可以给怪物个名字，名字内所有的空格需要用''%%_%%''代替。You can also mark the spawned mob with a keyword using `marked:` argument. It won't show anywhere, and you can check for only marked mobs in `mobkill` objective.
+在指定的位置放置一定数量的某种生物。第一个参数是坐标位置，然后第二个是[[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html|怪物类型]]，第三个是数量。最后一个是可选参数，你可以给怪物取个名字，名字内所有的空格需要用''%%_%%''代替。除此之外，你还可以通过`marked:`给怪物添加一个隐藏标记，你可以在`mobkill`任务目标检中使用这个标记，来限定被杀的生物必须具有这个标记。
 你还可以指定生物的装备和手持物品，如''h:''头盔、''c:''胸甲、''l:''腿部、''b:''鞋子、''m:''主手、''o:''副手，每样只可以规定一个物品所以不用填数量。物品名称来自''items.yml''。另外你还可以通过''drops:''指定生物死亡时的掉落物品，物品名称后面用'':''填写数量，多个物品用'',''隔开。
@@ 行 120: / 行 131: @@
 **例子**: ''spawn 100;200;300;world SKELETON 5 marked:targets''
-**例子**: ''spawn 100;200;300;world ZOMBIE name:Bolec 1 h:blue_hat c:red_vest drops:emerald:10,bread:2''
+**例子**: ''spawn 100;200;300;world ZOMBIE 1 name:Bolec h:blue_hat c:red_vest drops:emerald:10,bread:2''
 ===== 时间: time =====
@@ 行 288: / 行 299: @@
 ===== Play sound: playsound =====
-This event will play a specified sound for the player. The only required argument is the sound name (can take custom values if you're using a resource pack). There are also a few optional arguments. ''location:'' makes the sound play at specified location, ''category:'' is the [[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/SoundCategory.html|sound category]] (if not specified it will use ''MASTER''), ''volume:'' is a decimal responsible for the sound's volume and ''pitch:'' specifies the pitch.
+此事件将为玩家播放指定的声音。唯一必需的参数是声音名称（如果您使用的是资源包，则可以使用自定义值）。还有一些可选参数。 ''location:'' 在固定地点播放音乐, ''category:'' 是 [[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/SoundCategory.html|声音类型]] (如果没有指定，将默认使用 ''MASTER''), ''volume:'' 是一个控制音量的小数， ''pitch:'' 控制音高
+**例子**: ''%%playsound ENTITY_EXPERIENCE_ORB_PICKUP location:100;200;300%%''
 ===== Give experience: xp =====
@@ 行 296: / 行 309: @@
 **Example:** ''xp 4 level''
-===== Notification: notify =====
+===== 显示通知: notify =====
-Trigger a notification using the NotifyIO system. The first arguments are the message to send. A comma seperated list can be provided to an optional `category` tag to use a Notification Category. You can optionally set which NotifyIO to use by providing it with an `io` tag. You can also optionally pass flags in the form of `key`:`value` to provide custom config to the NotifyIO that will override those by the category used.
+使用[[插件手册:betonquest:通知提示|NotifyIO通知提示系统]]触发一个通知。第一个参数是你需要显示的通知内容。第二个可选参数是[[插件手册:betonquest:通知提示#通知类型|通知类型]]''category:''，如果有多个可用英文逗号分隔开。你还可以通过''io:''参数[[插件手册:betonquest:通知提示#notifyio通知方式|选择NotifyIO来自定义通知显示的方式]]。如果你决定采用自定义通知，你需要用''选项:值''的格式在后面为NotifyIO添加具体的参数。
+如果你既不设定一个有效的''category:''类型，也没在''custom.yml''中定义过默认的类型，那么你必须指明具体用哪一个''io:''，否则系统会直接使用默认的io（一般情况下是聊天框）展示你的通知内容。
+具体请参阅[[插件手册:betonquest:通知提示|通知与提示]]章节。
+**例子: ** ''notify 这是一个测试 category:类型A io:bossbar barColor:red sound:BLOCK_CHEST_CLOSE''\\
+（上例中用到[[插件手册:betonquest:通知提示#boss血条bossbar|Boss血条 NotifyIO]]）
+===== 全局积分： globalpoint =====
+**//persistent, static//**
+这与正常点事件的工作方式相同，但它操纵全局类别中的积分，而不是操纵特定玩家类别的积分。这些全局类别与玩家无关，因此您可以例如在每次玩家执行任务时向此类全局类别添加一点积分，并为第 100 个执行任务的玩家提供一些特殊奖励。
+**例子**: ''globalpoint global_knownusers 1''
+===== 全局标签： globaltag =====
+**//persistent, static//**
+与普通标签事件的工作方式相同，但不是为一个玩家设置标签，而是为所有玩家设置全局标签。
+**例子**:  ''globaltag add global_areNPCsAgressive''
+===== 随机选择： pickrandom =====
+**//persistent, static//**
-Please note that if you don't provide a valid category and haven't defined a default category then you must provide an io flag otherwise the default io (Generally chat) will be used.
+另一个事件容器。它选择一个（或多个）给定的事件并运行它。您必须通过在事件 ID 之前添加百分比来指定每个事件被选中的可能性。如果您的总百分比高于 100%，则事件不会中断。
+默认情况下，它会从列表中随机选择一个事件，但如果添加 ''%%amount:3%%'' 就会选择随机三个事件，并且''%%amount:0%%''的时候什么都不做。
+如果使用变量，则事件名称前必须有两个，一个来自变量，另一个来自事件的语法。
-Please refer to the Notification chapter for more details.
+**例子**: ''%%pickrandom 20.5%event1,0.5%event2,79%event3 amount:2%%''
-**Example:** ''notify This is a test category:MyCategory io:bossbar barColor:red sound:BLOCK_CHEST_CLOSE''
+**例子**: ''%%pickrandom %point.factionXP.amount%%event1,0.5%event2,79%event3,1%event4 amount:3 ''