两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 |
插件手册:betonquest:事件列表 [2018/06/20 14:02] – [积分: point] JohnHo | 插件手册:betonquest:事件列表 [2021/12/02 09:41] (当前版本) – [日记: journal] duangfafa |
---|
====== 事件列表 ====== | ====== 事件列表 ====== |
| |
(版本:2018-02-25 翻译:Afry、kjiang [[https://github.com/Co0sh/BetonQuest/wiki/Events-List/0744050ddc65722c8163d0c953a9f29dbc3c84d2|原文链接]]) | (版本:2019-01-20 翻译:Afry、kjiang [[https://github.com/bundabrg/BetonQuest/blob/5cac86e6a259b756f45d08372f4d987a67e98c52/docs/07-Events-List.md|原文链接]]) |
| |
===== 消息: message ===== | ===== 消息: message ===== |
**//persistent//** | **//persistent//** |
| |
指定玩家一种积分进行操作. 可以用乘法. 第一个操作是积分的类型, 第二个参数是 加/减/乘. | 指定玩家一种积分进行操作. 可以用乘法. 第一个操作是积分的类型(自己命名), 第二个参数是 加/减/乘. |
| |
**例子**: ''%%point npc_attitude 10%%'' | **例子**: ''%%point 管家好感度 10%%'' |
| |
**例子**: ''%%point village_reputation *0.75%%'' | **例子**: ''%%point 村庄荣誉 *0.75%%'' |
| |
| ===== 删除积分: deletepoint ===== |
| |
| **//persistent, static//** |
| |
| 删除指定玩家的某项积分。 |
| |
| **例子**: ''%%deletepoint 管家好感度%%'' |
| |
| **例子**: ''%%deletepoint 村庄荣誉%%'' |
===== 标签: tag ===== | ===== 标签: tag ===== |
| |
===== 日记: journal ===== | ===== 日记: journal ===== |
| |
添加或删除玩家的日记. 第一个参数是添加(add)或删除(del), 第二个参数定义在 ''%%journal.yml%%'' 中. 也可以直邮一个参数''%%update%%'', 据说挺有用. | 添加或删除玩家的日记. 第一个参数是添加(add)或删除(delete), 第二个参数定义在 ''%%journal.yml%%'' 中. 也可以直邮一个参数''%%update%%'', 据说挺有用. |
| |
**例子**: ''%%journal add quest_started%%'' | **例子**: ''%%journal add quest_started%%'' |
| |
| **例子**: ''%%journal delete quest_started%%'' 从日志中删除一个页面 |
| |
**例子**: ''%%journal update%%'' | **例子**: ''%%journal update%%'' |
===== 药水效果: effect ===== | ===== 药水效果: effect ===== |
| |
给玩家药水效果. [[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html|效果列表]]. 第二个参数代表药水效果的时间是多少秒. 第三个代表了药水的等级. 可以使用''%%--ambient%%'' 可以让玩家看不到药水的视觉特效(类似于信标). | 给玩家药水效果。[[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html|效果列表]],第二个参数代表药水效果的时间是多少秒,第三个代表了药水的等级。可以使用''ambient'' 可以让玩家看不到药水的视觉特效(类似于信标)。隐藏粒子特效添加''ambient'',不显示右上角图标则添加''noicon''。 |
| |
**例子**: ''%%effect ABSORPTION 120 1 --ambient%%'' | **例子**: ''effect POISON 45 1 ambient hidden'' |
| |
| ===== 移除药水效果: deleffect ===== |
| |
| 移除玩家身上的药水效果。如果效果填写''any''则移除全部药水效果。 |
| |
| **例子**: ''deleffect ABSORPTION,BLINDNESS'' |
===== 对话: conversation ===== | ===== 对话: conversation ===== |
| |
===== 生成生物: spawn ===== | ===== 生成生物: 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:''指定生物死亡时的掉落物品,物品名称后面用'':''填写数量,多个物品用'',''隔开。 | 你还可以指定生物的装备和手持物品,如''h:''头盔、''c:''胸甲、''l:''腿部、''b:''鞋子、''m:''主手、''o:''副手,每样只可以规定一个物品所以不用填数量。物品名称来自''items.yml''。另外你还可以通过''drops:''指定生物死亡时的掉落物品,物品名称后面用'':''填写数量,多个物品用'',''隔开。 |
**例子**: ''spawn 100;200;300;world SKELETON 5 marked:targets'' | **例子**: ''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 ===== | ===== 时间: time ===== |
===== 玩家指令: sudo ===== | ===== 玩家指令: sudo ===== |
| |
类似于''%%command%%''指令,但是这个相当于玩家自己输入指令。 | 类似于''%%command%%''指令,这个相当于玩家自己输入指令。 |
| |
**例子**: ''%%sudo spawn%%'' | **例子**: ''%%sudo spawn%%'' |
| |
| ===== 超级玩家指令: opsudo ===== |
| |
| 类似于''%%command%%''指令,但是这个相当于玩家使用超级管理员(op)权限使用指令。 |
| |
| **例子**: ''opsudo fly'' |
| |
===== 往箱子里添加物品: chestgive ===== | ===== 往箱子里添加物品: chestgive ===== |
| |
**例子**: ''variable some_var_obj name %player%'' | **例子**: ''variable some_var_obj name %player%'' |
| |
| ===== Title: title ===== |
| |
| This event displays a title or a subtitle. The first argument is the type (''title'' or ''subtitle''), second argument are title's duration times (in ticks) separated by semicolons - fade in, stay and fade out: ''20;100;20''. If you set it to three zeros (''0;0;0'') the plugin will use default Minecraft values. After these two required arguments there is a title message, formatted like in the ''message'' event, which supports multiple languages, color codes and variables. Keep in mind that the subtitle will only appear if the title is visible - that's how Minecraft works. |
| |
| **Example**: ''title subtitle 0;0;0 {en} Lobby joined! {pl} Dołączono do lobby!'' |
| |
| ===== Language: language ===== |
| |
| This event changes player's language to the specified one. There is only one argument, the language name. |
| |
| **Example**: ''language es'' |
| |
| ===== Play sound: playsound ===== |
| |
| 此事件将为玩家播放指定的声音。唯一必需的参数是声音名称(如果您使用的是资源包,则可以使用自定义值)。还有一些可选参数。 ''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 ===== |
| |
| Gives the specified amount of experience points to the player. If you want to give whole levels to a player add the `level` argument. |
| |
| **Example:** ''xp 4 level'' |
| |
| ===== 显示通知: notify ===== |
| |
| 使用[[插件手册: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//** |
| |
| 另一个事件容器。它选择一个(或多个)给定的事件并运行它。您必须通过在事件 ID 之前添加百分比来指定每个事件被选中的可能性。如果您的总百分比高于 100%,则事件不会中断。 |
| 默认情况下,它会从列表中随机选择一个事件,但如果添加 ''%%amount:3%%'' 就会选择随机三个事件,并且''%%amount:0%%''的时候什么都不做。 |
| 如果使用变量,则事件名称前必须有两个,一个来自变量,另一个来自事件的语法。 |
| |
| **例子**: ''%%pickrandom 20.5%event1,0.5%event2,79%event3 amount:2%%'' |
| |
| **例子**: ''%%pickrandom %point.factionXP.amount%%event1,0.5%event2,79%event3,1%event4 amount:3 '' |