查看“Crucible”的源代码

=须知=
本页面由鲲鲲(兼MM中文百科主编)搬运<br>
最后一次更新时间为'''2021年3月21日'''<br>
==影响较大的问题==
*onUse必须对着面前的方块(出现黑边)才能使用,对着空气无法使用
*使用技能替换当前拿着/副手拿着的MM物品,比如将副手物品替换为空气,看上去是莫得物品,实际上仍在激活
**当替换主手的MM物品(拥有技能)为其它物品(包括空气)时,技能将在切换物品(包括主副手切换,副手需有物品)后结束
**当替换副手的MM物品(拥有技能)为其它物品(包括空气)时,技能将在有物品放入副手或手持带有技能的MM物品后结束
**当替换装备槽的MM物品(拥有技能)为其它物品(包括空气)时,技能将在其他物品放入装备槽或手持/副手装备带有技能的MM物品后结束

=前言=
Artifacts,又名MythicArtifacts,允许您为物品添加MythicMobs技能<br>
并为您添加一些新的触发器(trigger)/选项(Options)与Lore属性系统

=下载&安装等=
==下载==
Artifacts是付费插件,插件地址:https//mythicmobs.net/index.php?resources/artifacts.37)
==前置==
*MythicMobs
*Java 8
==安装==
放进 服务器文件夹/plugins 内并重启服务器

==使用==
Artifacts在MythicMobs物品配置上工作,这意味着您不需要额外创建新的配置文档<br>
如果您不熟悉MythicMobs物品配置,请见：http://mineplugin.org/MythicMobs<br>
注意: 除非特意设置,不然物品技能不会选择创造/观察者模式玩家为目标

=配置=
==添加技能==
*将MM技能直接添加在物品配置里的'''Skills:'''下方<br>
*格式与MM技能'''完全一致'''
*若您莫得了解过MM技能,这是一个栗子：
{{Hide|标题=栗子
|内容=
火焰球鲲鲲:
  Id: DIAMOND_SWORD
  Display: '&6火焰球鲲鲲'
  Lore:
  - '&8一只会用火焰技能的鲲鲲QWQ.'
  Skills:
  - skill{s='''火焰球'''} @TargetLocation ~onUse
> 右键物品在目标的位置使用技能: '''火焰球'''
  - ignite{duration='''200'''} @trigger ~onAttack
> 左键时对攻击者造成'''10秒'''燃烧
  - effect:particles{p='''flame''';amount=20;speed=0.5} @self ~onTimer:4
> 每0.2秒为自己播放'''火焰'''粒子
}}

==Artifacts可用触发器(Trigger)==
*触发器: '''onFishGrab'''需服务器版本在1.13+(包括1.13)
*触发器: '''onTimer'''会导致damage、damagepercent、数值为负的heal无效(来自QQ372476678)
{| class="wikitable"
|-
! 触发器英文名 !! 介绍
|-
| onAttack || 当玩家攻击
|-
| onBlockBreak || 破坏方块后
|-
| onBlockPlace || 放置方块后
|-
| onConsume || 消耗物品(食物/药水等)后
|-
| onDamaged || 玩家受伤后
|-
| onDeath || 玩家死亡后
|-
| onInteract || 当玩家与其它实体互动
|-
| onBowHit || 玩家使用弓射击命中实体后
|-
| onPotionSplash || 药水被投掷出去后
|-
| onShoot || 玩家用弓发射后
|-
| onSpawn || 玩家登入/重生后
|-
| onSwing || 单击鼠标左键后
|-
| onTimer:# || 每#tick触发一次技能
|-
| onUse || 玩家手持物品单次右键后
|-
| onFish || 玩家手持鱼竿右键后
|-
| onFishBite || 鱼准备上钩后
|-
| onFishCatch || 鱼上钩后
|-
| onFishGrab || 钩中鱼(实体)后
|-
| onFishGround || 鱼钩被抛在地面后
|-
| onFishingReel || 收钩后
|-
| onFishingFail	|| 收钩莫得鱼后
|-
| onPressQ || 当按下"Q"键,需要ProtocoLib
|-
| onPressCtrlQ || 当按下"Q"与"CTRL"键,需要ProtocoLib
|-
| onPressF || 当按下"F"键,需要ProtocoLib
|}

==Artifacts新增技能(Mechanic)==
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | AmmoLoad—装弹
|-
| 
'''重新装填'''使用了选项：'''弹药(Ammo)'''物品的弹药
<pre>
鲲鲲:
  Skills:
  - ammoload ~onUse
</pre>
|}
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | ConsumeUsedDurability—射击损耗
|-
| 
作用于使用了选项：弹药(Ammo)的物品,'''每次射击所损耗的耐久'''<br>
耐久为0时,再次射击会导致物品损坏
{| border="1" cellpadding="5" cellspacing="0"
|-
|'''标签(缩写)'''
|'''描述'''
|'''默认设置'''
|-
|amount(a)
|损耗的耐久值
|未知
|}
<pre>
鲲鲲:
  Skills:
  - consumeUsedDurability{amount=1}
</pre>
|}
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | Set Model—自定义CustomModelData
|-
| 
修改物品的NBT: '''custommodeldata'''的值
{| border="1" cellpadding="5" cellspacing="0"
|-
|'''标签(缩写)'''
|'''描述'''
|'''默认设置'''
|-
|model(m)
|custommodeldata的数值
|未知
|}
<pre>
鲲鲲:
  Skills:
  - setmodel{m='''3'''} ~onUse
> 右键后设置物品的NBT: '''custommodeldata'''的值为'''3'''
</pre>
|}
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | Set Slot Model—自定义指定槽位的CustomModelData
|-
| 
修改物品的NBT: '''custommodeldata'''的值
{| border="1" cellpadding="5" cellspacing="0"
|-
|'''标签(缩写)'''
|'''描述'''
|'''默认设置'''
|-
|model(m)
|custommodeldata的数值
|未知
|-
|equipslot(slot,s)
|槽位,可用:HEAD(头部), CHEST(胸甲), LEGS(护腿), FEET(靴子), MAIN(主手), OFFHAND(副手)
|未知
|}
<pre>
鲲鲲:
  Skills:
  - setslotmodel{m=3;s=HEAD} ~onDamaged
> 受伤后设置头部物品的NBT: '''custommodeldata'''的值为'''3'''
</pre>
|}
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | ResetAttackCooldown—重置攻击冷却
|-
| 
<pre>
鲲鲲:
  Skills:
  - ResetAttackCooldown @self ~onUse
</pre>
|}

==Artifacts新增条件(Condition)==
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | EnchantLevel—附魔等级
|-
| 
支持指定数字/范围
{| border="1" cellpadding="5" cellspacing="0"
|-
|'''标签(缩写)'''
|'''描述'''
|'''默认设置'''
|-
|l(level)
|附魔等级
|未知
|}
<pre>
作用于Conditions:
鲲鲲:
  Conditions:
  - enchantlevel 2
作用于技能行↓
鲲鲲:
  Skills:
  - ignite{ticks=100} ?enchantlevel{level=1}
  - ignite{ticks=200} ?enchantlevel{level=2}
  - ignite{ticks=300} ?enchantlevel{level=3}
</pre>
|}
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | EquipSlot—检测槽位
|-
| 
当物品被放在指定槽位时,才会触发技能
{| border="1" cellpadding="5" cellspacing="0"
|-
|'''标签(缩写)'''
|'''描述'''
|'''默认设置'''
|-
|slot(s)
|槽位,可用:HEAD(头部), CHEST(胸甲), LEGS(护腿), FEET(靴子), MAIN(主手), OFFHAND(副手)
|未知
|}
<pre>
作用于Conditions:
鲲鲲:
  Conditions:
  - equipslot HAND
作用于技能行↓
鲲鲲:
  Skills:
  - ignite{ticks=200} ?equipslot{slot=HAND}
</pre>
|}
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align: left;" | HasAmmo—检测弹药
|-
| 
这在计划之内(还莫得做)
|}

==自定义附魔(Custom Enchant)==
自定义附魔在MythicMobs/EnchantMents文件夹内工作<br>
手持一本书输入/artifacts enchant <附魔名> <附魔等级>为书添加附魔<br>
您无法在不关闭服务器的情况下删除/修改附魔和附魔ID,Artifacts会将附魔变成和原<br>
版附魔一样,莫得花里胡哨的Lore,意味着您无法在不关闭服务器的情况下修改附魔<br>
<pre>
鲨鲨:
  Display: '鲨鲨'
  MinLevel: 1
#附魔最低等级为I
  MaxLevel: 3
#附魔最高等级为III
  ItemType: WEAPON
  Options:
    Cursed: FALSE
#负面附魔: 关闭
    Treasure: FALSE
#稀有附魔: 关闭
    ShowInLore: FALSE
#添加Lore以展示附魔: 关闭
    LevelAsPower: FALSE
#不知道: 关闭
  EnchantableItems:
  - DIAMOND_SWORD
  - IRON_SWORD
  - GOLDEN_SWORD
  - STONE_SWORD
  - WOODEN_SWORD
#允许钻石剑/铁剑/金剑/石剑/木剑得到此附魔
  ConflictingEnchants:
  - FIRE_ASPECT 
  Skills:
  - effect:particles{p=happyVillager;amount=5;speed=0.1;yOffset=1;hS=0.5;vS=0.1} @target ~onAttack
  - potion{type=SLOW;d=100;level=1} @trigger ~onAttack
  - potion{type=WITHER;d=100;level=1} ?enchantlevel{level=1} @trigger ~onAttack
  - potion{type=WITHER;d=100;level=2} ?enchantlevel{level=2} @trigger ~onAttack
  - potion{type=WITHER;d=100;level=3} ?enchantlevel{level=3} @trigger ~onAttack
</pre>

==Artifacts新增选项(Opiton)==
{| class="wikitable"
|-
! 选项英文名 !! 介绍
|-
| CancleDamage: true/false || 是否使物品无法造成平a伤害
|-
| Destroy: true/false || 是否使物品从所有玩家背包中消失
|-
| DestroyOnDrop: true/false || 是否使物品被丢弃后消失
|-
| KeepOnDeath: true/false || 是否使玩家死亡后不会丢失此物品
|-
| PreventDropping: true/false || 是否防止物品被丢弃
|-
| Permission: 权限名 || 是否令物品拥有使用权限
|}

==弹药系统(Ammo)==
Artifacts内置弹药系统,将剩余弹药以Lore的形式呈现出来<br>
开启仅需在物品配置里面的写上模块：Ammo与设置Enabled为True

===模块修改项===
{| class="wikitable"
|-
! 修改项英文名 !! 介绍
|-
| Enabled: TRUE/FALSE || 是否开启弹药系统
|-
| Bullet: 物品名 || 使指定MM物品作为弹匣类型
|-
| ClipSize: 数值 || 单个弹匣最大弹药值
|-
| AmmoPerItem: 数值 || 弹药最大值
|}

===重新装填(Reloading)===
使用技能: '''reloadammo'''重新装填弹药,若玩家莫得弹匣物品则不会工作
===栗子(Example)===
<pre>
鲨鲨的后庭:
  Id: wood_sword
  Data: 0
  Display: '&7鲨鲨的后庭'
  Resource: Ammo
  Ammo: 
    Enabled: TRUE
    Bullet: 不明透明液体
    ClipSize: 8
    AmmoPerItem: 8
  Lore:
  - "&f需要添上'''不明透明液体'''才可以开火." 
  - "" 
  - "&7Ammunition 8 / 8"
  - "&7Durability 50 / 50"
  Hide:
  - ATTRIBUTES
  Attributes:
    MainHand:
      ATTACK_SPEED: -0.75
      DAMAGE: 1
  Skills:
  - skill{s=流出来力..嘤哼} @TargetLocation ~onUse
  - skill{s=添上液体} @self ~onSwing
</pre>
技能配置:
<pre>
流出来力..嘤哼:
  Skills:
  - projectile{onTick=液体特效;onHit=粘粘の腥味液体;v=8;i=1;hR=1;vR=1}
液体特效:
  Skills:
  - effect:particles{p=flame;amount=20;speed=0;hS=0.01;vS=0.01} @origin
粘粘の腥味液体:
  Skills:
  - damage{a=10}
  - potion{type=SLOW;duration=100;lvl=2}
添上液体:
  Skills:
  - reloadammo
</pre>

==耐久度系统(Durability)==
Artifacts带有自己的耐久度系统,且以Lore文本的形式工作<br>
带有耐久度Lore的物品会和原版物品一样失去耐久,如造成伤害/<br>
受到伤害(仅适用于盔甲类物品),使用技能('''需要触发器：onUse''')等<br>
即使Lore Stats被禁用,耐久度Lore仍会工作,耐久度目前莫得恢复途径<br>

<pre>
鲲鲲:
  Id: leather_boots
  Data: 0
  Display: '&7非常耐用的鲲鲲靴子'
  Lore:
  - "&7Durability 5000 / 5000"
  Hide:
  - ATTRIBUTES
</pre>
==Lore属性系统(Lore Stats)==
Artifacts附带了自己的Lore属性系统,但仍在不断测试此功能在默认情况下处于禁用状态<br>
因为它尚未完成，但可以在物品配置中启用<br>
<br>
===添加属性===
要将自定义的属性添加到物品内,仅需将属性放在该物品的配置中的任意位置<br>
并且对服务器性能需求较小,仅需从插件内获取数据
<pre>
  Id: leather_helmet
  Lore:
  - "&f+1000 Armor"
  - ""
  - "&7+250 Critical Strike"
  - "&7+300 Dodge"
</pre>
Lore属性使用典型的MMORPG系统,以保持属性相对平衡,耐久度影响属性将在以后更新

===属性列表===
{| class="wikitable"
|-
! 属性英文名 !! 介绍
|-
| Ability Power || 提升/降低技能力量 n%
|-
| Ammunition || 当前子弹数量
|-
| Armor || 提升/降低护甲 n%,替换原版的护甲
|-
| Critical Strike || 暴击几率
|-
| Dodge || 闪避几率,几率受伤时免受伤害
|-
| Fire Resistance || 提升/降低火焰伤害的 n%,替换原版的附魔：火焰保护
|-
| Leech || 造成伤害后恢复自身生命,数值为伤害的 n%
|-
| Speed || 提升/降低 n%移速
|}

===注意事项===
保护现在每级增加2%的护甲,火焰保护现在每级增加5%的火焰抗性<br>
抗性效果在激活时每级减少5%的伤害,而抗火在激活时给予50%的抗火能力

===栗子===
<pre>
鲨鲨:
  Id: leather_boots
  Data: 0
  Display: '&7非常耐用的鲨鲨'
  Lore:
  - "&f+1000 Armor"
  - ""
  - "&7+250 Critical Strike"
  - "&7+300 Dodge"
  - ""
  - "&eDurability 5000 / 5000"
  Hide:
  - ATTRIBUTES
</pre>