Azitate
本帖最后由 Azitate 于 2020-6-20 09:56 编辑








MMOITEMS
维基翻译[[/]]插件教程

前言
F E I H U A
MMOITEMS是一款2017年创建的RPG属性插件
在长达2年多的维护中,作者Indyuce不断完善更新
使其成为功能最丰富的一款RPG插件
相比spigotmc在售的优质属性插件QuantumRpg
这款插件的功能更多、特效更好
但对于量产武器的RPG服务器插件使用上更加麻烦、繁琐
MMOITEMS的属性全存储于物品的NBT数据中
虽然通过NBT存储性能更好、更加安全
但这并不符合国内大部分服务器现状
你不可以通过添加Lore来给物品添加属性
可使用插件内部指令/编辑器或者是插件文件夹里添加自定义物品
且经询问后,作者表示永远不会更新Lore判断属性的功能
但这不妨有足够实力的RPG服主来使用这款插件因为它真的很棒
目录可能会出现跳转问题|若出现问题请自行手动查看
本帖将不会解答任何插件使用问题|如有问题可前往本站搬运贴内询问搬运者
该WIKI只针对于作者给出的WIKI做翻译|作者可能也未完善WIKI内容
可能会存在部分缺漏,请见谅
[官方维基界面]
[站内插件搬运贴]
[字数统计]
汉字 - 10510
标点 - 122
字母 - 12072
数字 - 699
实际有效完成天数 - 3日
目录
L I S T
来自群组: Minecraft插件百科
Azitate
插件安装
I N S T A L L A T I O N
| 前言 |

你可以在Spigotmc上购买这款插件
购买后可下载最新的构建文件
当然如果你还没决定是否购买本插件
可以先尝试插件的旧版本[1.8-1.12.2]
旧版本缺少了很多高级功能,仅做参考使用
如果你的服务器使用了WorldGuard,那么请务必确保WorldGuard的版本在6.2以上
且安装LegacyWG这个插件


|安装教程|

若您的服务器为1.12.2版本
MMOITEMS在4.7.6版本之后重新增加了对1.12.2版本的支持
但插件默认生成的配置文件等是针对1.13+制作的
所以如果你是1.12.2的服务器则需要一些更改才能使用该插件
以下操作必须严格按照顺序进行！
1.将插件放入到plugins文件夹中并运行服务器
2.此时你可以看到后台应该有很多的报错
3.加载完成后关闭服务器
4.删除plugins里MMOITEMS文件夹里的所有配置文件
5.用压缩包打开插件,里面有一个名为legacy-configs.zip的文件
6.解压后将里面的内容替换到原来的插件文件夹中
7.重启服务器,此时插件应该正常运行

|附属插件|

如果你是第一次使用MMOITEMS应该不会用到附属插件
附属插件需要安装在plugins文件夹中而不是MMOItems/addon folder里

| WorldDrops |

该附属插件可让你自定义方块/怪物在不同世界的掉落表
安装该附属插件后,MMOITEMS文件夹里应该出现一个drop文件夹
你可以在里面自定义掉落表

| Mana & Stamina |

为玩家添加法力和耐力功能
这些功能可以作用于武器和技能中
此外该附属还提供了三个新的属性[最大耐力][耐力恢复][法力恢复]
且必须要在MMOTIEMS里的Stats文件夹里添加
  1. max-stamina: '&7■ Max Stamina: &f<plus>#'
  2. mana-regen: '&7■ Mana Regeneration: &f<plus>#'
  3. stamina-regen: '&7■ Stamina Regeneration: &f<plus>#'
复制代码
在lore-format.yaml文件中添加以下Lore才可生效
  1. - '#max-stamina#'
  2. - '#mana-regen#'
  3. - '#stamina-regen#'
复制代码
安装该附属时,请确保你的服务器中没有安装SkillAPI 、Heroes 、RPGPlayerLeveling
否则附属将出现不可预料的错误



Azitate
本帖最后由 Azitate 于 2019-11-24 15:08 编辑

物品类型
I T E M - T Y P E S
| 前言 |

你创建的物品必须拥有物品类型如武器、护甲、消耗品等
每一种物品类型都有他独特的属性、设置、标签等
你可以使用它们来创建自己的自定义物品类型


| 介绍 |

| 砍器类 |
当攻击到前方的第一个敌人时,同时伤害到他后方的敌人
伤害范围呈锥型
此类型的武器包括
剑、大剑、太刀、斧头、巨斧、戟等

| 锐器类 |
攻击第一个敌人时同时伤害它后方的敌人
伤害范围呈直线
此类型的武器包括
突刺剑、匕首、矛、长矛

| 钝器类 |
攻击后造成范围伤害
此类型的武器包括
锤、巨锤、拳套、琵琶、法杖、棍子

| 副手/双手武器类 |
只有把副手武器装备在副手栏才可生效
此类型的武器包括
盾、大盾、护符、药剂、法书
| 远程武器类 |
远程对敌人造成伤害
此类型的武器包括
法杖、手杖、弓、鞭子、弓弩、枪械
| 其他 |
防具、工具、消耗品、杂项、宝石、材料

| 如何创建自己的武器类型 |

打开MMOITEMS插件文件夹中的item-types.yml文件
只需简单的几步即可创建独特的武器类型
包括类型ID、类型名称、显示ID(显示于/mi browse和自定义高级配方功能中的样子)、父类型（上面几个主要的攻击类型）
下方为作者提供的例子
  1. LONG_SWORD:
  2.     display: IRON_SWORD:0
  3.     name: '长剑'
  4.     parent: 'SWORD'
  5.     unident-item:
  6.         name: '&f#prefix#神秘的长剑'
  7.         lore:
  8.         - '&7一把未鉴定的长剑.'
  9.         - '&7我必须想办法鉴定它!'
  10.         - '{tier}'
  11.         - '{tier}&8物品信息:'
  12.         - '{range}&8- &7装备等级: &e#range#'
  13.         - '{tier}&8- &7物品品质: #prefix##tier#'
复制代码
添加完成后记得使用/mi reload来重载插件
重载完毕后在MMOItems/item/文件中生成该物品类型的文件夹用于自定义物品
若你的步骤无误,在游戏中用指令补全即可识别到该武器类型
Azitate
本帖最后由 Azitate 于 2019-12-8 22:33 编辑

物品属性/设置
I T E M - S T A T S / Options
| 前言 |

本章介绍了创建一件MMOITEMS物品所需要的一些参数
你也可以在游戏中输入/mi edit 物品类型 文件名来快速编辑某件物品
随着插件的不断更新,本章可能不会及时更新,你可以在其他页面找到相应的帮助

| 介绍 |

  • 物品材质/损伤值

可编辑物品的材质和损伤值(data值)如下方的INK_SACK:1为红色染料(只适用于1.8—1.12)
在1.13版本上使用ROSE_RED作为红色染料
  1. material:  INK_SACK:1
复制代码
所有的材质ID都可在Spigot Javadocs中找到
但该网页将跟随最新版本更新,所以1.14以下的服务器查阅该网站可能会出现小部分过时的材质ID

  • 显示名称

物品的显示名称,支持颜色符号以及插件自带的变量系统
你可以在name-placeholders.yml中找到可用的变量甚至可以自己创建一个变量值
变量值将会在你设置的变量值列表中随机选取一个
  1. TEST_ITEM:
  2.     name: '<lms>钢剑'
复制代码
如上方的变量<lms>,他在name-placeholders.yml中含有以下随机值
  1. lms:
  2. - '大型'
  3. - '中型'
  4. - '小型'
复制代码
当你在游戏中获得该物品时,可能会获得大型钢剑、中型钢剑、小型钢剑
这样解释应该比较好懂

  • 皮革染色

该数值仅适用于皮革类装备的RGB颜色值
  1. TEST_ITEM:
  2.   material: LEATHER_CHESTPLATE
  3.   dye-color: 100 100 100
复制代码

  • 物品权限

玩家必须有指定的权限才可使用该物品,可配合职业插件来做职业专属武器

  • 攻击伤害/攻击速度

设置武器的攻击伤害及攻击速度,这两种属性基于原版的NBT属性
  1.   attack-damage: 6.0=8.0
  2.   attack-speed: 1.6=1.8
复制代码

  • 暴击率/暴击强度

物品的暴击概率(%为单位),暴击造成的基本伤害强度为250%,该值可在config文件中设置

  • 攻击范围

该设置仅适用于whip/staff类的物品,默认值为18
该值并非准确的范围块数,将此值乘以2.5以得到准确的方块范围

  • 钝器范围/钝器伤害

该设置仅适用于钝器类武器
钝器范围为单次攻击可攻击多少范围内的敌人
钝器伤害为武器伤害的百分比
下方的例子为,单次攻击前方范围内三格的敌人并造成70%的基础伤害
  1. BLUNT_ITEM:
  2.   material: IRON_HAMMER
  3.   blunt-power: 3
  4.   blunt-rating: 70
复制代码

  • 不可破坏属性

当为true时,设置物品为无限耐久,如果你使用了自定义材质包武器模型,请务必设置此值为true
  1. unbreakable: true
复制代码


  • 护甲值/护甲韧性

设置装备的护甲值和护甲韧性,该值为原版NBT属性
你可以插件minecraftWIKI来查阅具体的作用
但简单来说,护甲值可以减少玩家受到的伤害
而护甲韧性可以减少受击后扣除的耐久值
  1.   armor: 6.0
  2.   armor-thoughness: 3.0
复制代码

  • 移动速度

设置手持武器以及穿戴装备所给予玩家的移动速度加成
默认原版玩家速度为0.2若给一件装备的移动速度加成设置为0.02
则为增加10%的移动速度,以此类推
  1. movement-speed: 0.02
复制代码

  • 双持武器

如果玩家双手都拿着武器,且其中有一个武器是双持武器,他的移动速度将大幅降低
可在配置文件中设置成装备两件武器其中有一双持时无法使用武器
  1. two-handed: true
复制代码


  • 恢复(消耗品)


使用后恢复生命值、饥饿值
  1. TEST_ITEM:
  2.   material: POTION
  3.   restore:
  4.     health: 3
  5.     food: 8
  6.     saturation: 16
复制代码

  • 药水效果(消耗品)

使用消耗品后给予的药水效果,格式为
药水效果: [持续时间] [效果等级],持续时间以秒为单位
所有药水效果名可在Spigot javadocs中查看
  1. TEST_ITEM:
  2.   material: BREAD
  3.   effects:
  4.     increased_damage: 1 10
复制代码

  • 手持效果

设置手持物品给予玩家的药水效果,格式为
药水效果: [效果等级]
  1. TEST_ITEM:
  2.   material: IRON_SWORD
  3.   perm-effects:
  4.     increased_damage: 1
复制代码

  • 物品冷却

再次使用消耗品和使用武器所绑定指令的冷却时间
在MMOItems Legacy(旧版)版本中,每个武器绑定的指令都可以有不同的冷却时间
且消耗品有一个Consume Cooldown的参数,类似于Item Cooldown
  1. FIREBALL_SCROLL_II:
  2.   material: PAPER
  3.   item-cooldown: 25.0
复制代码

  • 普通合成配方

使你创建的MMOITEMS物品可以在合成台中合成
所有材质ID都可在Spigot Javadocs中找到
如果要自定义指定损伤值的物品来合成,请在他们之间加入 : 符号
如INK_SACK:2为仙人掌绿
可以看到下方的craft:选项,这三行每行有三样ID,ID的位置即为对应合成台九个格子的位置
  1. TEST_ITEM:
  2.   material: POTION
  3.   craft-enabled: true
  4.   craft:
  5.   - AIR PAPER AIR
  6.   - PAPER DIAMOND PAPER
  7.   - PAPER PAPER PAPER
  8.   craft-enabled: true
复制代码

  • 高级合成配方

玩家Shift+右键合成台即可打开高级工作台
高级合成配方不再仅仅局限于原版物品
你可以自定义合成台指定格子需要放置的物品数量、物品名称、损伤值等
  1. TEST_ITEM:
  2.   material: IRON_SWORD
  3.   advanced-craft-enabled: true
  4.   advanced-craft:
  5.     '0':
  6.       material: IRON_INGOT
  7.       amount: 1
  8.       durability: 0
  9.       name: ''"
  10.     '1':
  11.       material: AIR
  12.       amount: 1
  13.       durability: 0
  14.       name: ''"
  15.     '2':
  16.       material: AIR
  17.       amount: 1
  18.       durability: 0
  19.       name: ''"
  20.     '3':
  21.       material: AIR
  22.       amount: 1
  23.       durability: 0
  24.       name: ''"
  25.     '4':
  26.       material: IRON_INGOT
  27.       amount: 1
  28.       durability: 0
  29.       name: ''"
  30.     '5':
  31.       material: AIR
  32.       amount: 1
  33.       durability: 0
  34.       name: ''"
  35.     '6':
  36.       material: AIR
  37.       amount: 1
  38.       durability: 0
  39.       name: ''"
  40.     '7':
  41.       material: AIR
  42.       amount: 1
  43.       durability: 0
  44.       name: ''"
  45.     '8':
  46.       material: STICK
  47.       amount: 1
  48.       durability: 0
  49.       name: ''"
复制代码

  • 工具设置

Autosmelt:启用后,挖掘铁矿石与金矿石时会自动熔炼为铁锭和金锭
Bouncing Crack:启用后,每次挖掘会额外挖掘它后面的一个方块

  • 物品指令

设置使用物品后执行的命令以及使用的冷却
注意!物品冷却和指令冷却为两个单独的设定,请将物品冷却和指令冷却设置为统一数值
否则可能会出现不可预料的后果
  1. EGGNOG:
  2.   material: EGG
  3.   item-cooldown: 3.0
  4.   commands:
  5.     '1':
  6.       format: me Mmmmmh!
  7.       cooldown: 3.0
复制代码

  • 箭矢特效

发射弓箭后箭矢的粒子特效
可自定义粒子类型、数量、速度
  1. MARKING_BOW:
  2.     material: BOW
  3.     arrow-particles:
  4.         particle: SMOKE_NORMAL
  5.         amount: 3
  6.         speed: 0.05
复制代码


  • 使用等级

物品/武器的使用等级要求
  1. required-level: 15.0
复制代码

  • 头颅材质(仅适用于材质ID为PLAYER_HEAD的物品)

注意!在1.12.2及以下头颅材质ID为PLAYER_HEAD:3,1.13及以上不需要后面加上损伤值
  1. DEAD_PHARAOH_HELMET:
  2.   material: PLAYER_HEAD
  3.   skull-texture:
  4.     value: 材质ID
复制代码

Azitate

物品创建
I T E M - C R E A T I O N
| 前言 |

目前共有两种方法创建MMOITEMS物品,分别是游戏内编辑器与后台手写文件


|编辑器|

此方法可在游戏中直接编辑一件物品而无需在后台中手写文件
但编辑器仅适用于较简单的物品,对于较复杂的物品请使用手写文件创建

|手写文件|

当你大致了解该插件的物品属性/设置模块
你就可以通过文件来创建自己独一无二的物品了
创建步骤如下:
  1. 进入后台找到/plugins/MMOItems/item/物品类型/
  2. 创建一个空文件如:测试.yml
  3. 打开文件开始编辑
复制代码
创建完成后输入/mi reload重载插件后输入/mi 物品类型 物品ID 来获得物品
Azitate
本帖最后由 Azitate 于 2019-11-24 15:23 编辑

伤害规避
M I T I G A T I O N

|前言|


MMOITEMS提供了三种方法来使你规避受到的伤害
分别为格挡、闪避、招架三种方式
他们的数值皆可在config中的mitigation参数中设置
当玩家规避伤害后会有一个漂亮的粒子特效和聊天栏actionbar栏提示[size][font]

格挡
格挡近战伤害和弹射物伤害时会大大减少玩家受到的伤害
你可以自定义格挡的概率和格挡伤害量百分比
格挡量具有一个默认的初始数值,这意味着玩家即使不穿戴防具也有一个初始的格挡值
默认格挡率为25%，最大格挡率为75%,最大格挡伤害量80%,你可以在config文件中自定义数值
  1. STEEL_BREASTPLATE
  2.     material IRON_CHESTPLATE
  3.     block-power 10
  4.     block-rating 5
复制代码

闪避
当玩家触发闪避时,将快速向后方移动来规避所受伤害,闪避率最高上限为80%
可自定义触发闪避时是否后退以及闪避后退的格数
  1. SWIFT_LEATHER_BOOTS
  2.     material LEATHER_BOOTS
  3.     dodge-rating 10
复制代码

招架
触发招架时将免疫所受伤害并击退敌人
可自定义触发招架的冷却间隔
  1. ROGUE_AMULET
  2.     material RED_DYE
  3.     dodge-cooldown-reduction 40
复制代码
Azitate
本帖最后由 Azitate 于 2019-12-7 23:11 编辑

元素
E l e m e n t a l -  D a m a g e

| 前言 |

当给物品添加元素属性时,玩家的攻击将造成额外的元素伤害
造成的元素伤害取决于你的物品上的元素属性和敌人的元素防御
除此之外,元素属性还具有它们特定的攻击效果

| 功能示例 |


玩家手持一把属性为[火元素伤害+10%/冰元素伤害+15%]默认伤害为10的剑
攻击一个穿戴属性为[火元素防御+40%]的僵尸
由于剑具有[火元素伤害+10%]的属性,那么攻击会附带的火元素伤害值为[10x10%=1]
由于剑具有[冰元素伤害+15%]的属性,那么攻击会附带的冰元素伤害值为[10x15%=1.5]
因此武器的总伤害为10+1+1.5=12.5

由于僵尸穿戴了一件[火元素防御+40%]的装备
那么攻击造成的火元素伤害值为[1(100%-40%)=0.6]
而僵尸穿戴的装备并没有冰元素防御,那么将会受到完整的1.5伤害

总结最后所受伤害为
  1. 10+0.6+1.5=12.1
复制代码


| 元素效果 |

元素具有一个独特的"暴击"功能
元素加成不仅仅会使武器伤害提高并且有与加成数值相同的概率造成元素暴击效果
如10%的火元素伤害,那么就有10%的概率触发火元素暴击
每次触发元素暴击的冷却间隔为2秒

| 火元素 |
  1. 造成双倍的火元素伤害并点燃敌人[0.1x<造成的冰元素伤害>]秒
复制代码

| 冰元素 |
  1. 造成双倍的冰元素伤害并冰冻敌人[0.75x<造成的冰元素伤害>]秒
复制代码

| 风元素 |
  1. 造成双倍的风元素伤害并击飞附近的敌人
复制代码

| 土元素 |
  1. 造成双倍的土元素伤害并震击附近的敌人
复制代码

| 电元素 |
  1. 造成双倍的电元素伤害并对附近的敌人造成[电元素值]%的伤害
复制代码

| 水元素 |
  1. 造成双倍的水元素伤害并使敌人在5秒内受到的伤害增加30%
复制代码

Azitate
鉴定
I d e n t i f i c a t i o n

| 前言 |

破坏方块或击杀怪物时概率掉落未鉴定的物品
未鉴定的物品在鉴定前无法得知物品属性
只有使用特定的鉴定书才可鉴定物品属性
可以输入/mi unidentify来封装一件已鉴定物品
Azitate
本帖最后由 Azitate 于 2019-12-8 22:35 编辑

物品品质
I T E M - T I E R S

| 物品拆解 |

拆解功能可以拆解MMOITEMS中的物品
当这类物品被拆解时,玩家可以根据设置获得对应的拆解后的材料
拆解后的材料可用于在MMOITEMS的高级工作台中制作其他物品
拆解出的物品和数量与被拆解物品的物品品质息息相关
该功能可以缓解玩家手中拥有过多他们不可使用的物品而感到苦恼的问题
玩家可以通过使用拆解消耗品来拆解他们的物品
被拆解的物品必须将"can-deconstruct"选项设置为true才可以被拆解
拆解成功后插件发送一段提示音以及提示信息,说明物品已被拆解完毕
默认配置下,物品等级分为
TRASH(垃圾)、COMMON(普通)、UNCOMMON(罕见)、RARE(稀有)、
VERY_RARE(超稀有)、LEGENDARY(传奇)、MYTHICAL(神话)
EPIC(史诗)、MAGICAL(魔幻)、UNIQUE(独特)
你可以在item-tiers文件中编辑他们的品质名称、拆解表等
  1. RARE:
  2.     name: '&6&l稀有'
  3.     deconstruct-item:
  4.         sucess:
  5.             coef: 1
  6.             items:
  7.                 MATERIAL:
  8.                     RARE_WEAPON_ESSENCE: 100,1-1,0
  9.         lose:
  10.             coef: 3
  11.             items:
  12.                 MATERIAL:
  13.                     WEAPON_POWDER: 100,1-1,0
复制代码



| 物品光效 |

当稀有物品掉落在地面上时,它们会显示全息名称并有发光效果
这两个显示功能取决于物品的品质,你可以在item-tiers文件中设置它们
不同的品质还可以设置成不同的颜色
  1. RARE:
  2.     name: '&6&l稀有'
  3.     item-glow:
  4.         hint: true
  5.         color: 'GRAY'
复制代码
要使用此功能,你需要安装GlowAPI和PacketListenerAPI作为前置


| 未知物品 |

名称(name)参数与未知物品中的物品品质名称相对应
范围参数(range)是指未知物品的物品等级范围
该选项仅在物品拥有required-level选项时才会生效
等级范围给玩家提供额外的信息,让玩家知道
自己手中的这个物品等级的大致范围
以此来决定是否要鉴定它
prefix设置适用于未知物品的名称和物品信息中品质的颜色
  1. EPIC:
  2.     name: '&4&l史诗'
  3.     unidentification:
  4.         name: 'Epic'
  5.         range: 6
  6.         prefix: '&4'
复制代码


Azitate
本帖最后由 Azitate 于 2019-12-8 10:14 编辑

宝石
GEM - STONES

| 前言 |

你可以在gem_stone的物品类型文件中创建宝石
(等级、权限、职业)等使用的制约条件也同样适用于宝石上
宝石是一种特殊物品,你需要打开背包将它拖到要镶嵌的物品上来镶嵌
被镶嵌的物品必须要有宝石槽
除此之外,你可以给宝石指定物品类型,使宝石只能镶嵌在指定的物品上
就像你有一颗磨刀石来使你的剑更加锋利,但你不能将它作用在盔甲上
如果你想让你的盔甲多几条划痕的话
通过镶嵌宝石,你可以为你的物品附加上特殊技能,后续将更新药水效果和粒子效果
镶嵌宝石也有概率会失败,镶嵌失败后会导致宝石被破坏
但这不会影响到你的镶嵌槽和物品


| 镶嵌槽类型 |

MMOITEMS将镶嵌槽类型表示为镶嵌槽颜色
每个宝石和镶嵌槽都有一个对应的颜色
只有对应颜色的宝石和镶嵌槽才能镶嵌
宝石的颜色可以在MMOITEM的物品编辑GUI中编辑,但颜色不会作用在物品信息上
(说明镶嵌槽颜色只是代表了一个类型 你设置的颜色不会作用在宝石的介绍上)
你可以在displayed-type上编辑颜色类型,需要严格区分大小写
比如一个宝石的设置中gem-color为Red,那么一件武器/装备的gem-sockets参数下
必须要有Red才可以将这个宝石镶嵌在上面



| 通用镶嵌槽 |

没有指定颜色的宝石可以镶嵌在任何类型的物品上
同理,没有指定颜色的物品可以镶嵌上任何颜色的宝石
如果你不想使用该插件的宝石颜色系统,那么就把宝石和其他物品都设置成无色
并在创建宝石时不添加gem-color这条参数即可
除此之外,你可以在插件的config中的gem-sockets参数上更改无色类型的格式
  1. gem-sockets:
  2.     uncolored: 'Uncolored'
复制代码

下一页 最后一页