[SCT][Wiki]MMOItems - MMO物品 | 最新维基翻译 | 使用帮助 - 联机教程

我真的按了

本帖最后由我真的按了于 2021-8-29 19:41 编辑

前言

S T A R T

此Wiki是MMOItems官方Wiki界面上最新版本的Wiki，我最大限度的还原了原Wiki的语句

仅删除了一些重复的页面和极难理解的内容，并用一些更通俗易懂的方式描述出来。

排版均按照原文Wiki进行排版。

MMOItems自19年至今更新了许多代，包括新的大版本6.0版本，

而站内最晚的Wiki则是19年由@Azitate大佬搬运翻译的帖子，

有一些已被最新版插件移除的内容和缺少一些最新内容，

所以我对其最新Wiki重新进行了翻译。

~~我在帖子的最后会附上当前最新版本6.5.1的汉化配置文件。~~

~~已更新至最新版本~~~~6.5.4 6.5.6 6.5.7~~

MMOItems已更新至6.6，插件搬运者白景景已完成了6.6版本的汉化配置文件更新

请去插件搬运贴下载6.6的汉化配置文件

别忘了给白景景一个评分哦~

声明：

该文件以@白景景在MMOItems搬运贴上发布的6.2.4版本作为基础，

我个人增添汉化了一些新内容而来。

所以，本帖的一些有争议的汉化在定名时（例如技能名字，类型名字），

全部以白景景的汉化配置文件为准。

这是大佬的搬运贴：[RPG][SCT]MMOItems[1.13.x-1.17.x]

本帖更多是对原Wiki的还原，我也在原Wiki的基础上增添了一些注释，

包括一些没有注释的配置文件也写了注释。

一些难理解的部分也写上了个人的使用经验，方便阅读和理解。

如果目录跳转有错误请手动翻页，楼层顺序与目录相同

[自定义方块]、[世界生成模板]、[MMOItems 5.5.5 自定义方块更新]、[Rev ID系统]、[物品掉落表]

这五个页面因为出了一些问题，是重新编写的，所以不按楼层顺序排列，

不过目录的跳转还是可以使用的。

[字数统计]

汉字 26005 字

单词 3299 词

字符（不计空格） 48501 个

总字数 29304 字

（该字数在统计后，原Wiki又发布了新内容，我也做了翻译，所以字数只会更多）

（实际字数在3w+）

相关链接

插件原帖

原Wiki

站内搬运贴

本人能力微弱，如有错误欢迎指出，我会去确认并修改的。

如有MMOItems使用的相关问题，可以直接在贴下回复，

或者在问答区发帖并艾特我，看到了我会在能力范围内尽量为你解答问题

！！问答版的帖子更容易获得支持，我也想恰爱心！！

如果这篇帖子对你有些许帮助，可以给我一点人气吗？秋梨膏！

插件介绍

I N T R O D U C E

对此插件的介绍依旧沿用@Azitate 大佬的介绍，他对该插件的概述描写的十分清楚。

MMOITEMS是一款2017年创建的RPG属性插件
在长达2年多的维护中,作者Indyuce不断完善更新
使其成为功能最丰富的一款RPG插件
相比spigotmc在售的优质属性插件QuantumRpg
这款插件的功能更多、特效更好
但对于量产武器的RPG服务器插件使用上更加麻烦、繁琐
MMOITEMS的属性全存储于物品的NBT数据中
虽然通过NBT存储性能更好、更加安全
但这并不符合国内大部分服务器现状
你不可以通过添加Lore来给物品添加属性
可使用插件内部指令/编辑器或者是插件文件夹里添加自定义物品
且经询问后,作者表示永远不会更新Lore判断属性的功能
但这不妨有足够实力的RPG服主来使用这款插件因为它真的很棒

以下是个人结合使用经验对该插件的点评

该插件作为一款RPG物品插件，上手非常的简单，
并且相比于QuantumRpg有更适合于编辑的内置GUI（就是没有中文）。
但是在更具体的物品编辑方面，QuantumRpg的上限也更高一点，
但是MMOItems内置的一些掉落表系统，自定义方块系统，合成站系统，
自动更新系统相比于QuantumRpg会更好一点。各有各的好处。

L I S T S

总览

[主界面]

[安装指南]

[命令]

[变量]

[权限]

物品创建

[物品类型]

[物品创建]

[物品模板]

[物品修饰符]

[物品属性 & 选项]

[Lore的格式]

[属性配置格式]

功能

[伤害规避]

[元素伤害]

[物品鉴定]

[物品稀有度]

[宝石系统]

[自定义耐久]

[套装系统]

[物品升级]

[灵魂绑定]

[动态Lore]

[战利品]

合成站

[合成站]

[合成站布局]

[升级配方]

[配方条件]

[配方材料]

[配方触发]

自定义方块

[自定义方块]

[世界生成模板]

[MMOItems 5.5.5 自定义方块更新]

物品管理

[Rev ID系统]

[物品掉落表]

[获取物品]

技能

[技能概述]

[技能列表]

API与兼容项

[兼容插件]

[自定义材质]

[更新记录]

相关文件

[config.yml]

未翻译的内容

[API]

个人不太懂这方面，且开发插件的大佬英文水平肯定拉我10条街。

我就不来献丑了。

汉化配置文件

C O N F I G

~~这里放上此贴发布之时最新的MMOItems 6.5.1的配置文件~~

~~配置文件已更新至最新版本MMOItems 6.5.4~~

~~配置文件已更新至最新版本MMOItems 6.5.6~~

~~配置文件已更新至最新版本MMOItems 6.5.7~~

配置文件里基本都有白景景和我写的注释文本

对了解这个插件有很大帮助

并且白景景为内部的示例物品都做了汉化

照葫芦画瓢也能写出一个属于自己的物品

当版本更新旧配置文件无法满足基本使用时，可以在此贴下回复，我会对配置文件进行更新

每次我会尽量将新内容进行汉化，如果有漏了的地方也可以来提醒我，提醒方式同上

MMOItems 6.5.7汉化配置文件.zip (79.92 KB, 下载次数: 491, 售价: 10 粒金粒)

6.6版本的汉化配置文件已由白景景更新于插件搬运贴

链接：
[RPG][SCT]MMOItems[1.13.x-1.17.x]

注：如装上配置文件有关于health-regeneration属性未找到的报错，为正常现象。因为该属性必须有MMOCore才会加载。如果装了MMOCore就不会报错了。

来自群组: Server CT

我真的按了

本帖最后由我真的按了于 2021-5-30 02:10 编辑

主界面

H O M E

欢迎来到MMOItems Wiki！

你可以在SpigotMC上购买MMOItems。如果你想在购买前试用该插件，则可以尝试使用MMOItems Leagacy。它是MMOItems的较旧版本，该版本没有和MMOItems一样多的功能，并且它仅支持旧版（1.8-1.12.2）服务器。
这是一个安装指南，由于安装过程中的出现的问题在很大程度上取决于您服务器的版本和已装的插件，所以很多问题可以尝试更换插件版本解决。

<1.14版本用户的重要说明：

我们鼓励MMOItems的用户始终保持使用最新的Spigot版本。插件目前为止，仍支持1.12和1.13，但是因为版本限制，提供的功能相较高版本会更少（译者注：如CustomModelData）。
例如，1.12无法使用原版的工作台来做合成系统（只能使用合成站）。再举个例子，与1.14不同，1.12和1.13仍使用耐久度条的方式来提供自定义材质，所以你不能在低于1.14的MMOItems上拥有CustomModelData功能。
在MMOItems 6.0.0+中不再提供1.12支持，而支持1.12的最新版本是MMOItems 5.5.5。

（译者注：根据用户反馈，MMOItems 6.5.7与MythicArtifacts有冲突现象。如在装有MythicArtifacts的服务器上使用MMOItems的物品击杀一个实体，会导致&f颜色代码失效，也就是白色失效。）

我真的按了

本帖最后由我真的按了于 2021-5-30 02:06 编辑

安装指南

I N S T A L L A T I O N G U I D E

| 在旧版MC（<1.13）上安装MMOItems |

从MMOItems 4.7.6开始，MMOItems开始支持1.12，但插件本身默认版本仍为1.14。所以安装插件后，你必须在启动服务器之前下载1.12的配置文件并手动覆盖。
（译者注：该配置文件的下载需要魔法上网，为了方便各位下载已经去下载完毕了。但是没有做汉化，各位见谅。）
（里面的文件与1.14+的文件大同小异，可以根据1.14+的汉化文件对照翻译一下。）

如果你想在拥有WorldGuard插件的服务器上运行MMOItems Legacy，则必须安装MMOItems LegacyWG，否则MMOItems Legacy在加载时会报错，且不会正常启用。

MMOItems 6.0.0+版本不再支持1.12，请确保你的服务器为最新版本，以便你能使用所有的功能！

（译者注：MMOItems最新版本MMOItems 6.5.7需要的前置为MythicLib，低版本则为MMOLib）

| MMOItems WorldDrops |

MMOItems WorldDrops允许你为每个方块和怪物在特定世界创建掉落表。这使得怪物/方块可以根据被杀死/开采来在不同世界掉落不同的物品。如果你想使用该插件，只需要将其与MMOItems一起拖放到Plugins文件夹下即可。重启服务器后，在MMOItems文件夹中应该会出现drops文件夹。在该文件夹中，每个.yml文件都对应一个世界掉落表。如果想了解如何配置这些YAML配置文件，请查看[物品掉落表]页面。
（译者注：MMOItems WorldDrops实测在6.5.1版本无法使用，目前已移交至作者反馈，坐等修复。）

| MMOMana |

MMOMana是旧版插件MMOItems Mana & Stamina插件的最新版本，该插件开源并且正常维护。它为玩家增加了法力值和耐力值属性，并且可以在不同的MMOItems机制中使用。MMOMana与其他拥有法力值和耐力值的其他RPG核心插件不兼容。（译者注：例如SkillAPI，Heroes）注：MMOMana提供的变量与MMOItems Mana & Stamina相同！

·  ％mana_mana％
·  ％mana_stamina％
·  ％mana_mana_regen％
·  ％mana_stamina_regen％
·  ％mana_mana_bar％
·  ％mana_stamina_bar％
·  ％mana_max_mana％
·  ％mana_max_stamina％

我真的按了

本帖最后由 1628872797 于 2021-4-25 20:20 编辑

命令

C O M M A N D

物品命令

/mmoitems create <类型> <ID> - 创建一个新的物品并且定义物品的类型与ID。注：这里的ID与物品的显示名不一定要相同。
/mi copy <类型> <原物品ID> <新ID> - 将一个类型下的物品复制并单独给予一个新的ID。这对批量生产物品很有帮助。
/mi delete <类型> <ID> - 删除一个物品。
/mi edit <类型> <ID> - 对特定的物品打开编辑界面。
/updateitem - 更新你手持的物品。
/updateitem <类型> <ID> - 打开特定物品的自动更新程序。不建议始终开启这个功能，因为如果您频繁的更新该物品，则服务器一直更新会导致延迟。
/mi drop <类型> <ID> <世界名> <x> <y> <x> - 在某个世界的特定坐标生成该物品并掉落。
/mi item identify - 鉴定你手持的物品。
/mi item repair - 修复你手持的物品。
/mi item unidentify - 使你手持的物品变为未鉴定状态。
/mi item deconstruct - 拆解你手持的物品。
/mi give <类型> <ID> (玩家) (最小值-最大值) (未鉴定的几率) (silent) - 给予一个玩家物品。如添加silent参数则在给予玩家物品时不会提示玩家。

物品管理命令

/mi browse - 打开所有创建的物品的GUI，GUI内会按物品类型排序（建议用于大多数的物品创建！）
/mi itemlist <类型> - 列出该类型下所有的物品。
/mi allitems - 列出所有创建的物品，不如/mi browse有用。
/mi giveall <类型> <ID> <最小值-最大值> <未鉴定的几率> - 给所有在线的玩家一个物品。

合成站命令

/mi stations list - 列出所有可用合成站。
/mi stations open <合成站名称> (玩家) - 这将为指定玩家打开特定合成站。这条命令一般用于NPC或脚本方块。

实用/其他命令

/mi ability <技能名> (玩家) (参数1) (数值1) (参数2) (数值2) - 释放MMOItems技能（也可以使用MM技能）。并且可以选择特定技能，释放它的玩家以及修改诸如伤害和冷却等参数的数值。
/mi heal - 基本与/CMI heal类似，这可以完全恢复玩家并且消除所有负面Buff。（此指令可能无效）
/mi debug info (玩家) - 打开一个GUI，其中包含某个玩家的属性。包括等级和法力值之类的统计信息（如果适用）。
/mi list (type/spirit/ability) - 显示所有武器技能，个人技能或实体技能。

重载命令

/mmoitems reload - 编辑配置文件后，重载插件。无需重启服务器！
/mi reload (all/adv-recipes/stations) - 重载整个插件/高级配方/合成站。（译者注：想要重载合成站或配方请直接使用/mi reload all，只用/mi reload只会重载物品。）

物品生成器命令

/mi generate <玩家> (额外参数) - 查看[获取物品]页面获取详细信息。

我真的按了

本帖最后由 1628872797 于 2021-2-17 05:11 编辑

变量

P L A C E H O L D E R S

（提前说明，变量即为占位符，因为平时习惯称其为变量故也按此翻译。）
所有变量会在插件加载时自动注册，并且变量功能要求PlaceholderAPI插件正常启用。你无需执行任何命令即可初始化变量。小贴士：你也可以使用MVdWPlaceholderAPI插件的所有PAPI变量。

属性变量

%mmoitems_stat_<属性名>% - 返回玩家的某种属性值
%mmoitems_stat_defense_percent% - 返回玩家减伤的百分比

物品类型变量

%mmoitems_type_<类型>_name% - 返回指定类型的名称。
%mmoitems_type_<类型>_total% - 返回指定类型的物品总数。

耐久度变量

%mmoitems_durability% - 返回当前物品的剩余耐久度
%mmoitems_durability_max% - 返回当前物品的最大耐久度
%mmoitems_durability_ratio% - 以百分比形式返回当前物品的耐久度
%mmoitems_durability_bar_square% - 以长条（方格）形式返回当前物品的耐久度
%mmoitems_durability_bar_diamond% - 以长条（菱形）形式返回当前物品的耐久度
%mmoitems_durability_bar_thin% - 以短横的形式返回当前物品的耐久度

杂项

%mmoitems_tier_<稀有度名称>% - 返回该稀有度的名称
%mmoitems_ability_cd_<技能名>% - 返回特定技能的冷却时间

我真的按了

本帖最后由 1628872797 于 2021-2-17 05:11 编辑

权限

P E R M I S S I O N S

以下是权限节点及其作用的列表。

mmoitems.admin - 管理员命令权限
mmoitems.bypass.level - 无视物品等级限制
mmoitems.bypass.item - 无视物品权限限制
mmoitems.bypass.ability - 无视技能权限限制
mmoitems.bypass.class - 无视MMOCore类的权限限制（译者注：MMOCore是该插件作者开发的另一款RPG核心插件。在这里可以理解为职业插件。）
mmoitems.update - 允许使用/updateitem命令

我真的按了

本帖最后由 1628872797 于 2021-3-26 23:05 编辑

物品类型

I T E M T Y P E S

你创建的物品必须拥有一种物品类型：比如剑、护甲、消耗品等。每种物品类型都拥有一组特定的物品属性/选项/标签，这些玩意用于你自定义你的物品。同种类型的物品效果相同。当物品未鉴定时，不用的物品类型也决定了该物品的外观。

物品类型也被分为了几种大类，这些大类也具有特殊的类型效果。

| 砍器大类 |

当进行近战攻击时，物品会对攻击目标后面的锥形范围也造成范围伤害。

剑
大剑
武士刀
斧头
巨斧
戟
...

| 锐器大类 |
当进行近战攻击时，物品会对目标后方一条直线的实体也造成伤害。

刺剑
匕首
矛
长矛

| 钝器大类 |
当进行近战攻击时，物品会对目标的周围造成范围伤害。

锤
大锤
护手
琵琶
大棍
大棒

| 副手物品与配饰大类 |
副手物品是仅当副手持有时才会发挥其属性的物品

法术
护符
触媒
副手触媒（副手触媒仅副手持有才有效）
饰品：这些物品只有放入特殊背包时才会生效（如RPGInventory的饰品栏）

| 远程武器大类 |
远程武器根据其物品类型不同也有不同的特性
魔杖-可以释放魔法攻击[左键单击]，也可以击退敌人[右键单击]
棍-与魔杖相同
弓
长弓
鞭子-远程鞭子攻击[左键]
十字弩-可以发射箭
滑膛枪-可以发射子弹[右键]

| 其他 |

护甲-装备上后才会产生效果
工具-可以拥有一些特殊属性
消耗品-可以消耗[右键单击]也可以应用在其他物品上[左键拖放]（译者注：可制食物或鉴定卷轴之类的物品）
杂项
宝石
材料-可用于在高级工作台上制作其他物品。

| 如何创建新的物品类型？ |

你可以修改item-types配置文件将新的物品类型添加到MMOItems。
创建一个新的物品类型非常简单。你必须设置4个必要参数：类型ID（如consumable），name（类型名称），display（用于/mi browse中的显示或高级合成配方的显示）和parent（父类）（如SWORD）。

你需要使用以下格式：

LONE_SWORD:
display: IRON_SWORD:0
name: '长剑'
parent: 'SWORD' # 父类
unident-item:
name: '&f#prefix#未鉴定的长剑'
lore:
- '&7这是一个未鉴定物品'
- '&7我要想办法鉴定他！'
- '{tier}'
- '{tier}&8物品信息:'
- '{range}&8- &7等级范围: &e#range#'
- '{tier}&8- &7稀有度: #prefix##tier#'

复制代码

例如，这将添加一个名为长剑的物品类型，他的物品特性将和SWORD类完全相同。父类的类型将定义自定义类型的特性。比如，当设置为'GEM_STONE'时，该自定义类型的特性将与宝石完全一样，并且可以为任何物品提供宝石属性。类型名称则在/mi browse，高级合成配方列表或是Lore上显示。

在unident-item配置的部分将决定该类型物品未鉴定时的样子。你也可以使用变量来更改Name和Lore。#prefix#对应该物品稀有度的颜色前缀，因此该变量取决于该物品具体的稀有度。#predix#是未鉴定物品的显示名称。#range#是未鉴定物品的等级范围。仅当未鉴定的物品具有稀有度时，才会显示以{tier}开头的行。仅当物品具有“等级需求”属性的时候，才会显示以{range}开头的行。

你可以根据需要添加任意数量的自定义类型。添加新物品类型后，不要忘记使用/mi reload，这样就可以生成与你自定义类型对应的配置文件（位于\MMOItems\items\中）。如果你的物品类型已在MMOItems中成功注册，则应该你在使用命令时可以在TAB补全中找到它。

我真的按了

本帖最后由 1628872797 于 2021-2-20 20:48 编辑

物品创建

I T E M C R E A T I O N

该Wiki页面介绍了可用于在MMOItems中创建物品模板的两种方法，并简要介绍了物品生成器。

| 内置GUI |
内置GUI可以让你直接在游戏中创建和编辑物品，并且无需修改配置文件。这是一种功能强大且易于理解的方式。但我们建议有能力的用户直接手动修改配置文件来编辑，如果你知道所有物品属性的格式，这样编辑将更快捷。
1.通过以下命令打开内置GUI并创建一个物品：/mi create <物品类型> <这个物品的ID>

你可以使用/mi list type来查看所有可用的物品类型（Sword，Axe，Tool...）
在每个命令/配置文件中将会使用物品类型来标记该物品。比如STELL_DAGGER的类型是TOOLS，这样会使配置设置更加简洁。

2.执行创建命令后，将打开物品内部设置GUI。如果你关闭了它，仍可以使用以下命令重新打开它：/mi edit <物品类型> <这个物品的ID>

在内置GUI的第5格，你可以查看该物品及其当前属性。你可以单击箱子图标来将该物品添加到你的背包中。
每个图标都对应一个你可以编辑的物品属性。有关如何编辑他们的说明直接在游戏中显示。
一旦添加了所有你想要的物品属性，你就可以获取你的物品了。

| 手动修改配置文件 |

有能力的用户应该考虑使用此方法，因为如果你已经知道了要使用的属性以及如何设计其格式，则这种方法更迅速。

1.打开/MMOItems/items/文件夹。

2.选择你的物品类型，然后使用你喜欢的文本编辑器（译者注：这里推荐Notepad++）打开相应的.yml文件。

3.这是一个默认的物品配置模板：

你的物品ID:
base:
material: 你的物品材质

复制代码

4.所有materials项（译者注：就是原版的物品名称，如：STONE,WOOD,DIAMOND_SWORD）都可以在这里找到。这些物品材质是你要添加的第一个选项，因为他是物品生成唯一的真实存在的选项。

5.根据需要添加尽可能多的物品选项（技能，攻击力...）。你可以在[物品属性 & 选项]页面上看到所有可用的物品选项（以及如何配置它们）。

6.保存文件，然后再返回Minecraft。使用/mi reload让MMOItems加载刚刚添加到配置文件中的物品，并使用/mi give <物品类型> <你的物品ID>获取你的物品！

| 物品生成器系统的工作方式（非常重要！） |

当你在MMOItems中创建一个物品时，你实际上在创建一个物品模板。物品模板由一组默认的物品选项（显示名称，材质，附魔，攻击力...）和一组物品修饰符组成，这些物品修饰符是随机选择的，并在玩家获取该物品的时候赋予该物品特定属性。

该系统的目标是使一个物品模板能够生成同一物品的多个版本/实例，就像在任何RPG游戏中一样。物品修饰符使物品的每个版本都是独一无二的：该物品的强力版本将拥有许多强力修饰符，而该物品的弟弟版本却只有1-2个弟弟修饰符。

生成物品时，所有物品都有一个物品等级，可以直接确定物品属性的强度，还有一个修饰符容量，可以决定物品可以拥有多少个修饰符。MMOItems物品生成器挂接在MMOItems稀有度系统上。稀有度越高，物品拥有的修饰符就越多。换句话说，物品稀有度决定了修饰符容量。

物品稀有度和物品等级是我们的“随机游标”。这意味着它们将单独决定一个物品的功能。并且它们是完全独立的，这意味着你可能拥有一个高属性，但几乎没有修饰符的物品，反之，则是具有大量修饰符的低属性武器。

我们将通过一些示例来了解MMOItems物品生成器的基本概念。

| 例一 |

这两个物品使用相同的物品模板生成，该模板的名称为Long Sword。但是，右边武器的一个Sharp修饰符使他获得一个+3攻击力，而左边的那个没有修饰符。

这两个物品具有相同的攻击速度，因为选择它的选择器不随物品等级的改变而改变（译者注：即物品等级不会修改攻击速度）。

但是，攻击伤害却会随着物品等级的提高而变化：尽管第一个物品的等级更高，但是第二个物品具有Sharp修饰符，因此会有更高的攻击伤害。

该Sharp修饰符也给了这个物品一个Sharp前缀，并增加了该物品Lore中一行额外的描述。

（译者注：别问为什么没有示例图片，只有文字介绍，问就是原文也没有。根据原文介绍自己去理解理解。就是本来该物品攻击力随物品等级改变，但是第二把武器等级没有第一把高，按理来说第一把武器攻击力更高。但是第二把物品随到了一个Sharp修饰符，增加了伤害，也多了一个前缀，反而伤害比第一把高了。）

| 例二 |

右边的物品具有更高的物品等级，因此他的攻击伤害更高。他还有两个修饰符：Sharp和Fiery。Sharp仍然会给该物品+3攻击力，但是考虑到这个物品的物品等级，这3点伤害基本没卵用。

Firey修饰符给该物品了一个漂亮的红色名称前缀，并且使该物品具有击中使目标燃烧的技能。

这个物品具有Rare稀有度，因此它比无稀有度的剑具有更多的修饰符，这也解释了它为什么获得了两个修饰符。并不是说没有稀有度的物品就不能获得修饰符，但相比来说要少得多。

在这把武器你只能看到Fiery前缀（译者注：Sharp也有前缀），因为此修饰符具有更高的优先级（尽管你可以配置修饰符，以便显示所有的前缀，并可以看到一个具有10个后缀或前缀的有趣物品名！）。

最后但并非最不重要的一点是，更高的物品等级并不意味着有更多的修饰符。（译者注：同上段，物品等级并不决定修饰符的多少）

| 例三 |

默认物品是一把弓，它具有一定的攻击力和暴击率。第一个Heavy修饰符使其成为双手武器，并且增加了一些攻击力和一些致命一击能力。具有后缀的第二个修饰符增加了其命中能力。

| 物品模板配置 |

这是物品模板在MMOItems配置文件中的样子

LONG_SWORD:
base: # base项代表了武器的基础属性
material: IRON_SWORD
attack-damage:
base: 10 # 基础攻击力10点
scale: 1 # 武器等级每升1级提升1点
critical-strike-chance: 30 # 暴击几率30%
# 此处省略一些物品属性...
modifiers:
first-modifier: # 修饰符first-modifier
prefix: 'Modifier Prefix' # 添加前缀Modifier Prefix
stats:
attack-damage: 3 # 该修饰符可以提供3点攻击力
# 此处省略一些物品属性...
second-modifier:
suffix: 'Modifier Suffix' # 添加后缀Modifier Suffix
stats:
pvp-damage: 20 # 该修饰符可以提供20%的PVP伤害
# 此处省略一些物品属性...

复制代码

在base配置部分包含所有的基本属性（物品材料，显示名称，即独立于物品级别应用在物品中的物品信息）。在modifers配置部分则包含了所有可应用于该物品的修饰符。

我真的按了

本帖最后由 1628872797 于 2021-2-20 20:50 编辑

物品模板

I T E M T E M P L A T E S

确保首先阅读[物品创建]页面。MMOItems的物品生成系统非常复杂，需要一些时间才能完全理解。

物品生成模板是生成随机物品的最基本工具。它们的物品属性由base项（无论生成的结果如何，生成的物品至少都会具有的基础属性）以及一系列的物品修饰符组成，修饰符将被随机选择并应用于生成的物品（具体会根据物品的稀有度而变化）。

LONG_SWORD:
# 物品选项
option:
tiered: true # 如未指定稀有度，是否为该物品启用随机稀有度
level-item: true # 如未指定等级，是否为该物品启用随机物品等级
# 基本物品数据
base:
material: IRON_SWORD
name: '&fLong Sword'
attack-speed: 1.6
attack-damage:
base: 6
scale: 1.2
required-level:
base: 0
scale: 1
# 物品修饰符
modifiers:
sharp: # 该修饰符名为sharp
chance: 0.3 # 有30%的几率随到这个修饰符
prefix: '&fSharp' # 如随到这个修饰符会给物品加一个白色的Sharp前缀
stats: #该修饰符可以提供的属性
attack-damage: 3 # 该修饰符可以提供3点攻击力
lore: #该修饰符提供的lore
- '&7Much sharper!' #如随到这个修饰符则会给该物品加一段Much sharper!的lore

复制代码

在base配置部分对应于物品的基本属性。例如，该物品的基本属性为名称为Long Sword的铁剑。基本的攻击速度为1.6，基本攻击力则为6，每提升一级攻击力提升1.2。在option配置部分用于配置一些额外的选项。更多的信息请查看[物品属性 & 选项]页面。
可以在\MMOItems\items文件夹下找到所有的物品生成模板。你可以在该文件夹中添加任意数量的YML配置文件，以及对模板进行排序。
（译者注：这个Wiki页面对修饰符解释的不是很详细，可以尝试去看一下[物品创建]这个页我于示例模板配置文件写的注释，这个页面上的示例模板配置文件我也会也一点注释，结合游戏实际测试，其他插件经验，我的注释结合起来理解就会好理解很多。）

| 物品模板选项 |
一小列用于物品模板的其他选项，设置为true以启用它们。

roll-modifier-check-order - 在物品生成时打乱物品修饰符列表。
tiered - 如果在生成物品是如未指定任何稀有度，则会为你的物品随机选择一个稀有度
level-item - 如果在生成物品时未指定任何物品等级，则会为你的物品随机选择一个物品等级

我真的按了

本帖最后由 1628872797 于 2021-4-16 17:03 编辑

物品修饰符

I T E M M O D I F I E R S

确保首先阅读[物品创建]。MMOItems物品生成系统非常复杂，需要一段时间才能完全理解。
修饰符使你可以使用物品生成器来进一步随机化物品。修饰符是物品属性的组合包，它有可能在物品生成时添加进物品中。

| 使用一个简单的例子来了解这个概念 |
修饰符是挂接到物品模板的属性包。可以进一步修改随机物品，例如Sharp修饰符，是一个可以使武器增加3点Toxic（毒）属性伤害的修饰符，也是一个使武器增加击中使目标中毒技能的修饰符。
重要的是，修饰符不能自行定义物品，它只能由物品模板确定的基本属性中添加一些额外的属性。
有些修饰符比其他修饰符更强大/稀有，因此相比于其他修饰符被选中的几率应该要更小。或者这个修饰符甚至只能在物品有特定稀有度时被选中。

| 创建物品修饰符 |
创建物品生成器模板时，需要确定该模板的可用修饰符列表：

# 一个示例物品
LONG_SWORD:
base: ...
# 每个不同的修饰符都有不同的几率被选中
modifiers:
# 第一个修饰符
sharp:
weight: 2.5
prefix: '&fSharp'
stats:
attack-damage: 3
lore:
- '&7Much sharper!'
# 第二个修饰符
fiery:
weight: 5
prefix:
format: '&cFiery'
priority: 1
stats:
ability:
on-hit:
type: burn
mode: on_hit

复制代码

如[物品创建]页所示，可以在一个物品里使用多个修饰符。修饰符由4个选项定义：

它的selection chance（选中几率）
它的modifier weight（修饰符重量）
它的list of item stats（属性列表）
它的prefix/suffix（前缀/后缀）

| 前缀/后缀 |

在物品生成过程中选中一个修饰符时，该修饰符的前缀/后缀会自动应用于该物品。如果一个物品被添加了多个前缀/后缀，则MMOItems仅保留具有最高优先级的前缀/后缀。
例如，一个优先级为0（默认值为0）的Sharp修饰符和一个优先级为1的Fiery修饰符。它们各有前缀Sharp和Fiery。此时，这两个修饰符被同时应用在了一个物品上，这个物品会只显示Fiery前缀，但是该物品会同时拥有两种修饰符的属性。（译者注：这段原Wiki写的比较笼统和难理解，我结合使用经验自己修改了一下）
如果你不想使用前缀/后缀的优先级系统，只需要使用以下格式写前缀/后缀。

modifier:
prefix: '&fSharp'

复制代码

使用以上格式，代替以下格式。

modifier:
prefix:
format: '&fSharp'
priority: <优先级值>

复制代码

| 修饰符重量 |
修饰符重量是当修饰符应用于该物品时，会受制于该物品的最大容量。如果你的物品具有5个修饰符容量，则将无法获得重量为6的修饰符。由于修饰符容量直接由物品稀有度决定，因此某些稀有度无法具有过重的修饰符。

modifier:
weight: 5

复制代码

请查看[物品稀有度]部分，以设置物品稀有度对应的修饰符容量。

| 选中几率 |
这是用于平衡修饰符的选项。你可以通过此选项的设置，来达成即使生成的物品有足够的修饰符容量来获得该修饰符，修饰符仍有一定几率不会被获得。使用以下格式即可：

modifier:
chance: .1 # 有10%的几率选择该修饰符

复制代码

| 属性列表 |
如果物品选择了该修饰符，并且该物品具有足够的修饰符容量并且再用选中几率尝试选中时选中成功，则这些属性将会应用于该物品。
此选项用于定义要该修饰符具有的属性，格式与物品基础属性格式完全相同。

toxic:
prefix: '&2Toxic'
stats:
ability:
on-hit:
type: poison
type: on-hit

复制代码

我真的按了

本帖最后由 1628872797 于 2021-2-20 20:53 编辑

物品属性 & 选项

I T E M S T A T S & O P T I O N S

使用内置GUI菜单（/mi edit）可以使你了解可以添加到该物品的属性以及如何配置它们。尽管这些属性大多数是不言自明的，但以下是有关于更复杂的物品属性的一些说明。
此列表不包含你可以在MMOItems中找到的每个物品属性和选项。但是，在提问之前，请确保你详细阅读了Wiki的其他部分，它们可能包含了你寻找的信息！
如果你确实不想使用内置GUI菜单，则以下的物品示例可以帮助你手动配置配置文件。某些字段（例如材料/附魔/声音）可能会有所不同，具体取决于你的服务器版本。
提示：可以使用CTRL + F查找所需的物品属性。

| 数值属性 |
确保首先阅读[物品创建]页面。MMOItems的物品生成系统非常复杂，需要一些时间才能完全理解。
大多数基于数值的物品属性（攻击力/暴击几率/PVP伤害/...），甚至更具体的物品属性（技能，药水效果持续时间/等级，附魔等级）都具有复杂的计算公式。这些公式用于计算物品的属性随着物品等级的变化而变化。因此，较高等级的物品相比于低等级物品具有更好的基本属性。
使用的格式如下：

some-stat-or-item-option:
base: 10
scale: 2
spread: 0.1
max-spread: 0.3

复制代码

base对应如果这个属性如果用于等级为0的物品，则其拥有的值（译者注：即为基础值）。scale是物品属性每增加一个额外等级获得的额外数值。使用上面给出的公式，假设物品等级为6，则属性值为10 + 2 * 6 = 22。

spread是物品属性值的相对标准偏差（使用高斯分布生成随机属性值）。将其设置为0.1意味着大多数（68%）的属性值偏移量 +/- 10%，该数值大约是19.8 - 24.2 。这是一个小功能，可以使一个物品模板生成的所有物品都有不相同的属性值。

max-spread是属性值可获得的最大相对标准偏差。如果将其设置为0.3，则最终属性值不能小于22%的70%，并且不能大于22的130%。这是使用spread时的重要功能，因为这会阻止物品达到一个离谱的属性值。

因此，使用上面的公式，代入以下配置模板来计算，它的数值将是这样的：

some-stat-or-item-option:
base: 10
scale: 0
spread: 0.2
max-spread: 0.4

复制代码

几率最终值
68.4% 8-12
27.2% 6-14
4.2% 6-14
0.2% 6-14

如果你不想使用以上四个选项中任意的一个，那也可以使用以下格式：

some-stat-or-item-option:
base: 10
scale: 2

复制代码

some-stat-or-item-option:
base: 10
spread: 0.1
max-spread: 0.3

复制代码

some-stat-or-item-option: 10 # 属性值将不随等级改变而改变

复制代码

| 物品材质/损伤值（Material, Durability）|
设置你的物品材质/损伤值（Data值）。示例：INK_SACK:1对应玫瑰红（1.8-1.12）。而1.13+为ROSE_RED。所有材质都可以在Spigot Javadocs中找到。注意，这些材质名称对应最新版的Spigot，因此在<1.14，尤其是MMOItems Legacy中不是100%兼容。

| 显示名称（Display Name）|
物品的显示名称。使用“&”表示颜色代码。生成该物品时，修饰符的前缀/后缀将添加到基本物品名称中。

TEST_ITEM:
base:
name: '&f钢剑'

复制代码

添加于6.0.1-显示名称变量旨在通过使物品名称统一和动态变换来使物品创建时保持格式一致。每当定义物品显示名称时，只要将变量放在某个位置，它就可以自动替换。

<tier-name> - 显示物品的稀有度名称
<tier-color> - 获取物品稀有度的颜色代码

| 染色（Dye Color）|
此参数仅适用于皮革盔甲。使用RGB（红绿蓝）来使用它。

TEST_ITEM:
base:
material: LEATHER_CHESTPLATE
dye-color: 100 100 100

复制代码

| 附魔（Enchantments）|
附魔可以决定附魔类型和附魔等级。格式如下：

enchants:
efficiency:
base: 1
# 不存在效率1.几，但是使用这个技巧
# 可以物品每10级提升1级效率等级
# 这个小技巧同样使用与药水等级
scale: .1
# 这种格式仍然有效，因为附魔等级只是一个数值罢了
sharpness: 10

复制代码

| 物品权限（Item Permissions）|
任何玩家都必须具有相应的权限才可以使用该物品。你也可以给某个玩家添加相应的权限节点来绕过该限制。可以配合做一些VIP武器或者职业武器。

| 攻击力、攻速（Attack Damage, Attack Speed）|
你的武器造成的伤害量与以何种速度攻击（以攻击次数/秒为单位）。这些属性值基于原版NBT属性。

attack-damage: 6.0=8.0
attack-speed: 1.6=1.8

复制代码

| 暴击率和暴击伤害（Critical Strike Chance & Power）|
你的物品发生暴击的几率（%）。暴击造成的默认暴击伤害为250%（可在配置文件中配置）。暴击伤害相当于暴击所造成的初始伤害的百分比。

| 范围（Range）|
你的鞭子/大棒的攻击范围。默认值为18。此处的单位并非为方块范围，请将该值除与2.5得到游戏中的实际方块范围。

range: 22

复制代码

| 钝器范围和钝器伤害（Blunt Power & Rating）|
钝器范围对应钝击的半径。越大，你可以同时击中的敌人就越多。钝器伤害对应钝器攻击造成的伤害。以初始伤害的百分比表示。示例：一把武器的钝器范围 = 3，钝器伤害为70%，则击中一个实体时，半径为3内的敌人将受到初始伤害的70%。

BLUNT_ITEM:
base:
material: IRON_HAMMER
blunt-power: 3
blunt-rating: 70

复制代码

| 无法破坏（Unbreakable）|
设置为true时，武器永远无法破坏。如果想使用耐久度来自定义材质，可以启用此选项。

| 不可堆叠（Unstackable）|
设置为true时，这个物品永远不会和自身堆叠。

| 护甲、护甲韧性（Armor, Armor Toughness）|
设置护甲的护甲值与护甲韧性。这些属性值应用了原版的NBT属性。可以查看MC官方Wiki了解这两个属性的作用。简要的说：护甲值可以减少受到的伤害，而护甲韧性可以减少护**少的耐久值。注意：1.8版本不支持某些属性值。

| 防御（Defense）|
此属性数值可以确定玩家的防御值，并且可以调整为任何正数。任何物品类型都可以加上这个属性。可以在MMOLib的config.yml编辑计算防御减伤的公式。

| 移动速度（Movement Speed）|
该物品向持有者/穿着者提供的移动速度。MC默认的移动速度为0.2。如果将该属性设置为0.02，则将+10%移动速度。

| 双持（Two Handed）|
如果一个玩家双手同时持有两个物品，并且其中一个具有双持属性，那么他的速度就会大大降低（缓慢2效果）。当修改config.yml中的特定选项时，你也可以设置玩家在以上情形时无法使用任何物品。

| 永久药水效果（Permanent Potion Effects）|

产生的效果与时限性药水效果相同，但是由于这些药水效果在玩家持有特定物品时永久地赋予玩家，因此你不必指定药水持续时间。

perm-effects:
speed:
base: 1
scale: 1
# 这种格式也适用
haste: 3

复制代码

| 物品冷却（Item Cooldown）|

玩家在使用消耗品或者执行物品中的命令之前必须有一段冷却。在MMOItems Leagacy中，不同命令可以具有不同的冷却时间，并且消耗品有一个选项为Consume Cooldown，类似于Item Cooldown。

| 工具选项（Tool Options）|

Autosmelt：当这个选项启用，该工具会自动熔炼挖下的矿物，比如铁矿和金矿可以熔炼为铁锭和金锭。

Bouncing Crack：当这个选项启用，该工具会在挖掘的方块后面额外挖一个方块。

| 物品元素属性（Item Elemental Stats）|

element:
fire:
defense:
base: 10
scale: 3
# 这种格式也适用
damage: 10
water:
defense: 50

复制代码

| 物品命令（Item Commands）|

单击右键物品时执行的命令列表。命令可以有冷却时间和延迟，延迟之后他会自动执行。

你可以在制作消耗品的时候使用此选项，例如使用/spawn将其传送回出生点。

警告：命令的冷却时间和消耗品的冷却时间并不共用，因此你需要确保这两个时间相同，否则可能会消耗了消耗品而不触发命令。

你可以使用%player%变量来指代玩家。

TEST_ITEM:
base:
material: PAPER
name: '&r回城卷轴'
commands:
'1':
command: spawn
cooldown: 10
delay: 1

复制代码

| 箭矢粒子（Arrow Particles）|

此选项可以在弓箭发射的箭周围显示粒子。粒子可以修改种类，速度，颜色。

MARKING_BOW:
base:
material: BOW
arrow-particles:
particle: SMOKE_NORMAL
amount: 3
speed: 0.05

复制代码

| 装备优先级（Equip Priority）[新增于2021/2/10 Build #626版本] |

为装备分配一个优先级，当你右键单击你手持的MMOItems护甲时，如果该护甲的优先级高于或等于你目前装备的护甲，则会将其从身上替换下来。

DIAMOND_CHESTPLATE:
base:
material: DIAMOND_CHESTPLATE
tier: COMMON
unbreakable: true
equip-priority: 4.0

复制代码

可以在config.yml文件中配置该选项来禁用此功能：auto-equip-feature: false

（译者注：我在翻译这个页面的时候明明还没有这个选项的...发帖当天翻Wiki居然更新了。）

| 等级需求（Required Level）|

你的武器/物品需要一定的等级才可以使用。这个等级限制完全支持其他RPG核心插件的等级。

| 职业等级限制（Required Profession Level）|

此属性可以使只有到达所需职业等级的玩家才可以使用该物品。需要MMOCore。

| 自定义头颅材质（仅可在玩家头上使用）|

用于自定义头颅材质。对于1.13+，请使用PLAYER_HEAD来获取玩家的头颅。旧版本用户必须使用Data值为3的SKULL_ITEM。由于自定义头颅材质本身的问题，该属性的配置文件格式相当奇怪。

SKULL_ITEM:
base:
skull-texture:
value: <材质值>
uuid: 62a6ff60-98f3-4769-9dd6-2b5fe5e8046f

复制代码

随机UUID生成器

如果使用内置GUI输入头颅材质值（即value值），MMOItems将为你生成一个随机的UUID。

你可以在minecraft-heads.com这样的MC头颅数据库中获得头颅材质值。

| 法杖精神（Staff Spirit）|

法杖精神选项可以修改法杖和权杖的左键普攻。

你可以使用/mi list staff查找所有的法杖精神列表。

| 宝石插槽（Gem Sockets）|

在你的物品上设置宝石插槽，可以将宝石镶嵌在上面。宝石可以增强你的物品属性。每个绑定的宝石会占用一个宝石插槽。在此[宝石系统]页面上可以查看到更多相关信息。

| 禁止互动（Disable Interactions）|

当启动该选项后，此选项将禁止所有右键单击/放置时所有可能发生的互动。它会阻止方块的放置和物品的使用（雪球/可可豆/树苗....）

| 禁止互动和禁用右键消耗（Inedible & Disable Right Click Consume）|

Inedible项将禁用此物品所有的右键互动。

Disable Right Click项将使你在右键使用该物品时，该物品会产生效果，但不会被消耗。（译者注：比如做一个永远吃不完的食物）

| 物品粒子（Item Particles）|

手持/装备物品时会显示一些粒子。一个物品的粒子效果由3种选项定义：粒子图案、图案修饰符、使用的粒子种类。

type项决定粒子该如何显示，组成何种形状等。例如，选择HELIX（螺旋）形粒子图案会使粒子形成一个向上去和向下去的圆周。

particle项决定使用该粒子效果时使用何种粒子。你可以在此处看到所有粒子的列表。注意：其中一些粒子不适用于MMOItems。

然后，你可以通过粒子修饰符来稍微调整粒子效果，例如，你可以更改螺旋的y轴偏移，半径，高度，显示速度...

某些粒子可以修改颜色，如ruggest（红石粒子）。这意味着你可以通过编辑颜色来使粒子效果更佳炫酷！可以使用RGB来修改颜色。

FIRE_GREATLANCE:
base:
material: BLAZE_ROD
item-particles:
type: DOUBLE_RINGS
particle: FLAME
radius: 1.3
rotation-speed: 0.4
// 这将生成两个火焰粒子环缓慢的绕着玩家旋转

复制代码

以下是可用的粒子飞行模式的列表：OFFSET, FIREFLIES, VORTEX, GALAXY, DOUBLE_RINGS, HELIX, AURA。

| 滑膛枪属性（Musket Stats）|

你可以使用两个主要的物品属性来定制滑膛枪。滑膛枪是特殊的远程武器，在单击右键时会发射子弹。knockback（击退）属性决定了当子弹击中目标时对目标产生的击退效果，必须为正值。

recoil（后坐力）属性决定了滑膛枪的射击精度。比如将此值调为5，则在射击时该武器将在鼠标光标5°范围内移动。

| 琵琶属性（Lute Stats）|

琵琶是远程武器，单击右键会发出音乐弹。琵琶具有不同的攻击效果（使用内置GUI编辑器编辑琵琶攻击效果时会提示所有的可以的攻击效果表），它们定义了子弹的外观。

你还可以编辑攻击时播放的声音。如果将Weight（重量）设置为大于0的任何值，将使子弹在射出时随着时间的推移略微向下下垂，就好像被重力拉下来一样。

| 自定义物品音效（Custom Item Sounds）|

自定义物品的声音是在对物品执行特定操作时（如攻击实体，右键单击物品，拿起物品）时播放的声音...

注意：这些声音于Spigot javadocs的声音名称不对应，而与MC原版的声音名称对应。如正确的声音名称是entity.zombie.attack_iron_door（而不是ENTITY_ZOMBIE_ATTACK_IRON_DOOR）。

由于使用原版声音名称，所有你可以使用服务器材质包的音效！你可以再pastebin上找到声音名称列表。

| 技能（Abilities）|
使用物品生成器，可以创建有特殊技能的物品，物品的等级越高，技能也就越强。准确地说，技能的强度可以随着物品等级的变化而变化（造成多少伤害，持续多长时间的药水效果...）。

使用此格式可以给物品生成模板/物品生成修饰符添加技能：

ability:
first-ability-id:
type: burn
mode: on_hit
# 第一个修饰符
cooldown:
base: 6
spread: .1
max-spread: .3
# 第二个修饰符
duration:
base: 3
scale: .2
second-ability:
type: life-ender
mode: right-click
damage:
base: 10
scale: 3
third-ability:
type: blizzard
mode: left-click
damage:
base: 5
cooldown:
base: 7
scale: 2

复制代码

你可能会注意到，技能格式与向普通的MMOItems物品添加属性的格式完全相同。唯一改变是其是技能属性而不是其他属性。用于定义技能修饰符的公式与其他属性的公式相同。

在此示例中，击中目标使其燃烧的技能冷却为6s，但是该值的相对平均偏差为10，最大偏差为10%。每一级都会使燃烧持续的时间增加0.2s。

注：如果想设置一个技能修饰符但不希望强度随着物品等级变化，则仍必须指定一个基础值，然后将scale项改为0或直接删掉。可以参考上面示例的third-ability。在此示例中，使用暴风雪技能生成的每个物品造成5点伤害。不随等级的改变而改变。但冷却时间还是随着等级的改变而改变。

| 使用消耗品获得药水效果 |
药水效果由三个选项决定：效果类型，持续时间和效果等级

potion-effect:
speed:
level:
base: 1
scale: 1
duration:
base: 10
scale: 3

复制代码

* 只要你看到了类似base/scale/spread/max-spread这样的项时，就代表了这个属性可以随着等级进行变动。
** 并且套用于上文相同的公式。

因为这些都是数值属性，所以，如果你希望每次药水的等级（译者注：持续时间同理）不随物品等级变化，可以使用此格式：

potion-effect:
speed:
level: 1
duration: ...

复制代码

或者以下格式：

potion-effect:
speed:
level:
base: 1
scale: 0
spread: 0
max-spread: 0
duration: ...

复制代码

（译者注：所有的属性都可以这样设定，可以举一反三）

| 消耗品恢复（生命、饱食度、饱和度）|

恢复能力决定了消耗品在使用时能恢复多少生命、饱食度和饱和度。（译者注：如果不懂饱和度的定义可以去查查官方Wiki）

restore:
health: #生命值
base: 3
scale: 2
spread: .3
max-spread: .5
# 看到熟悉的选项了没，能干啥不用我说了吧？
food: 5 #饱食度
saturation: 3 #饱和度

复制代码

我真的按了

本帖最后由 1628872797 于 2021-2-18 05:32 编辑

Lore的格式

L O R E F O R M A T S

Lore的格式决定了物品的外观。在languages文件夹中可以找到默认格式文件lore-format.yml。你可以将其他格式添加到该文件中，每当你重启服务器或重载插件时，都会加载新的格式。

| 创建和使用格式 |
要创建新的Lore格式，只需将默认的lore-format.yml文件复制在同文件夹下并编辑，你的新格式将被分配一个ID，此ID等同于你新创建的文件名。使用此ID可以为特定物品分配新的Lore格式。

| 默认Lore格式 |

lore-format:
# - '{bar}&8&m--------&f&l &nGeneral&8 &m--------------'
- '#item-type#' # 物品类型
- '{bar}' # 空格
- '#required-class#' # 所需职业
- '#required-level#' # 所需等级
- '#required-dexterity#' # 所需敏捷
- '#required-strength#' # 所需力量
- '#required-intelligence#' # 所需智力
- '#success-rate#' # 成功几率（用于宝石之类的物品）
- '{bar}'
- '#soulbound#' # 灵魂绑定
# - '{bar}&8&m--------&f&l &nProfessions&8 &m--------------'
- '#profession-alchemy#' # 所需炼金等级
- '#profession-enchanting#' # 所需魅力等级
- '#profession-farming#' # 所需种植等级
- '#profession-fishing#' # 所需钓鱼等级
- '#profession-mining#' # 所需挖矿等级
- '#profession-smelting#' # 所需冶炼等级
- '#profession-smithing#' # 所需锻造等级
- '#profession-woodcutting#' # 所需伐木等级
# - '{bar}&8&m--------&f&l &nStatistics&8 &m-------------'
- '{bar}'
- '#can-identify#' # 可以鉴定
- '#can-deconstruct#' # 可以拆解
- '#attack-damage#' # 攻击伤害
- '#knockback#' # 击退
- '#recoil#' # 后坐力（用于滑膛枪）
- '#note-weight#' # 音符力量（用于琵琶）
- '#attack-speed#' # 攻击速度
- '#arrow-velocity#' # 箭速
- '#critical-strike-chance#' # 暴击率
- '#critical-strike-power#' # 暴击伤害
- '#range#' # 攻击范围
- '#pvp-damage#' # PVP伤害
- '#pve-damage#' # PVE伤害
- '#blunt-power#' # 钝器力量
- '#blunt-rating#' # 钝器范围
- '#weapon-damage#' # 武器伤害
- '#magic-damage#' # 魔法伤害
- '#skill-damage#' # 技能伤害
- '#physical-damage#' # 物理伤害
- '#projectile-damage#' # 远程伤害
- '#defense#' #防御
- '#damage-reduction#' # 伤害削减
- '#fall-damage-reduction#' # 坠落伤害削减
- '#fire-damage-reduction#' # 火焰伤害削减
- '#magic-damage-reduction#' # 魔法伤害削减
- '#projectile-damage-reduction#' # 远程伤害削减
- '#physical-damage-reduction#' # 物理伤害削减
- '#undead-damage#' # 不死伤害
- '#faction-damage-undead#' # 不死派系伤害
- '#block-power#' # 格挡强度
- '#block-rating#' # 格挡几率
- '#dodge-rating#' # 闪避几率
- '#parry-rating#' # 招架几率
- '#block-cooldown-reduction#' # 格挡冷却
- '#dodge-cooldown-reduction#' # 闪避冷却
- '#parry-cooldown-reduction#' # 招架冷却
- '#armor#' # 护甲
- '#armor-toughness#' # 护甲韧性
- '#knockback-resistance#' # 抗击退
- '#max-health#' # 最大生命
- '#max-mana#' # 最大魔力
- '#max-stamina#' # 最大耐力
- '#health-regeneration#' # 生命恢复
- '#mana-regeneration#' # 魔力恢复
- '#stamina-regeneration#' # 耐力恢复
- '#movement-speed#' # 移动速度
- '#staff-spirit#' # 法杖精神
- '#lute-attack-effect#' # 琵琶攻击效果
- '#two-handed#' # 双持
- '#autosmelt#' # 自动熔炼
- '#bouncing-crack#' # 更多挖掘
- '#pickaxe-power#' # 镐力量
- '#restore-health#' # 恢复的血量
- '#restore-food#' # 恢复的饱食度
- '#restore-saturation#' # 恢复的饱和度
- '#restore-mana#' # 恢复的魔力
- '#restore-stamina#' # 恢复的耐力
- '#soulbinding-chance#' # 灵魂绑定几率
- '#soulbound-break-chance#' # 破坏灵魂绑定的几率
- '#soulbound-level#' # 灵魂绑定的等级
- '#repair#' # 可修复
- '#item-cooldown#' # 物品冷却
- '#additional-experience#' # 额外经验
- '#cooldown-reduction#' # 冷却恢复
- '#mana-cost#' # 消耗魔力
- '#stamina-cost#' # 消耗耐力
- '#max-consume#' # 最大消耗
# - '{bar}&8&m--------&2&l &nElements&8 &m--------------'
- '{bar}'
- '#fire-damage#' # 火焰伤害
- '#fire-defense#' # 火焰防御
- '#ice-damage#' # 冰冻伤害
- '#ice-defense#' # 冰冻防御
- '#wind-damage#' # 风系伤害
- '#wind-defense#' # 风系防御
- '#earth-damage#' # 地系伤害
- '#earth-defense#' # 地系防御
- '#thunder-damage#' # 雷电伤害
- '#thunder-defense#' # 雷电防御
- '#water-damage#' # 水系伤害
- '#water-defense#' # 水系防御
# - '{bar}&8&m--------&b&l &nEffects&8 &m---------------'
- '{bar}'
- '#effects#' # 药水效果
# - '{bar}&8&m--------&b&l &nAbilities&8 &m--------------'
- '{bar}'
- '#abilities#' # 技能
- '{bar}'
- '#commands#' # 使用的命令
# - '{bar}&8&m--------&b&l &nEffects&8 &m---------------'
# - '#perm-effects#' # 永久药水效果
# - '#arrow-potion-effects#' # 箭矢药水效果
# - '{bar}&8&m--------&e&l &nGem Stones&8 &m-----------'
- '{bar}'
- '#gem-stones#' # 宝石镶嵌槽
# - '{sbar}&8&m--------------------------------'
- '{bar}'
- '#lore#' # 物品的自定义Lore
- '#gem-stone-lore#' # 宝石的Lore
- '{bar}'
- '#set#' # 套装
- '{bar}'
- '#tier#' # 稀有度

复制代码

（译者注：原文是没有注释，我基本都做了注释，这样应该能了解的比较清楚。）

我真的按了

本帖最后由我真的按了于 2021-6-7 21:56 编辑

属性配置格式

C O N F I G F O R M A T O f S T A T S

（小声BB：这个页面本来是没有的，在我发帖的5小时前原Wiki更新了这个页面，我吐了！！而且很长。不过这个页面极其有效，它收录了所有你在配置文件中会用到的字段和其作用！当然，不保证有缺失。）
（阅读顺序为：上方的代码为其格式，下方的引用为其说明，套用了原Wiki的格式，请悉知！）

| 武器类属性配置示例 |

WIKISWORD:
base:
material: NETHERITE_SWORD

复制代码

material字段是为该物品套用MC原版材料的字段，你可以使用任何适合你版本的材料！

revision-id: 2

复制代码

revision-id字段为当前该物品的“版本”。是用于Rev ID系统的字段。当一个物品的Rev ID与配置文件中的Rev ID不匹配时，插件就会更新那个物品。

durability: 100.0

复制代码

此字段的作用是定义该物品的当前的耐久度。一般用于老版本<1.14的自定义材质，这个属性不会影响该物品的最大耐久值

custom-model-data: 5.0

复制代码

该物品的CustomModelData值，懂得都懂。

max-durability: 1000.0

复制代码

设置物品的最大耐久度。

will-break: true

复制代码

设置某个物品的耐久度为0时是否被摧毁。如果设置为false则耐久度为0时只会变得不可用而不会被摧毁。

name: '&c这是一把测试剑'

复制代码

设置物品的显示名称。

lore:
- reeee
- fffffffff

复制代码

设置物品的Lore。

custom-nbt:
- NBT_TAG_KEY TAG_VALUE

复制代码

自定义物品的NBT标签，可以用来兼容其他插件，或者使用一些MC原版的功能。

lore-format: lore-format

复制代码

设置该物品的Lore格式应该以哪个格式为准。可以使不同的物品有不同的格式。不填则为默认格式。

displayed-type: 假类型放这里

复制代码

可以更改其显示的类型。比如一把剑的类型实际上是“SWORD”，通过修改这个选项可以把类型改成“山东菏泽曹县牛B666我的宝贝！”。实际上的类型还是SWORD。

enchants:
sharpness: 1.0
mending: 2.0

复制代码

物品的附魔列表。

hide-enchants: true

复制代码

设置是否只有附魔光效，而看不见在Lore上的具体附魔。

permission:
- useme.sword

复制代码

设置该物品要什么权限才可以使用。

item-particles:
type: FIREFLIES
particle: FLAME
amount: 5.0
radius: 1.4
speed: 1.0
rotation-speed: 2.0
height: 2.0

复制代码

在物品上的粒子效果列表。所有的type项都可以使用游戏里的list命令查看。不同的粒子具有不同的修饰符，你可以使用粒子编辑器来查看所有的修饰符。

disable-interaction: true

复制代码

是否禁用右键互动。比如方块放置。

disable-crafting: true

复制代码

设置该物品是否不可用于合成。

disable-smelting: true

复制代码

设置该物品是否不可用于熔炉。

disable-smithing: true

复制代码

设置该物品是否不可用于锻造。

disable-enchanting: true

复制代码

设置该物品是否不可附魔。

disable-repairing: true

复制代码

设置该物品是否不可被改名/修复。

disable-attack-passive: true

复制代码

设置该物品是否关闭砍/刺/钝器武器的被动效果。

required-level: 5.0

复制代码

设置使用该物品的等级限制，兼容各种RPG核心插件，也可以使用原版等级。

required-class:
- ARCHER

复制代码

兼容各种RPG插件的职业限制。

attack-damage: 10.0

复制代码

设置武器攻击时的伤害，或是弓箭攻击时箭的伤害。

attack-speed: 10.0

复制代码

设置武器攻击时的攻击速度，以每秒内攻击的次数为单位。

critical-strike-chance: 5.0

复制代码

设置攻击时暴击的几率。

critical-strike-power: 5.0

复制代码

设置暴击时的暴击伤害。基于MythicLib的config.yml文件的数值。（注：也可能是MMOLib文件夹内的config.yml文件，下同）

block-power: 5.0

复制代码

格挡时减伤的百分比。基于MythicLib的config.yml文件的数值。

block-rating: 5.0

复制代码

格挡的几率。基于MythicLib的config.yml文件的数值。

block-cooldown-reduction: 5.0

复制代码

减少基于MythicLib的config.yml中设置的格挡冷却。

dodge-rating: 5.0

复制代码

闪避的几率。

dodge-cooldown-reduction: 5.0

复制代码

减少基于MythicLib的config.yml中设置的闪避冷却。

parry-rating: 5.0

复制代码

招架的几率。招架会完全抵挡攻击并击退攻击者。

parry-cooldown-reduction: 5.0

复制代码

减少基于MythicLib的config.yml中设置的招架冷却。

cooldown-reduction: 5.0

复制代码

缩减物品技能和玩家技能的冷却时间。（%）

mana-cost: 5.0

复制代码

使用该物品的法力值消耗。

stamina-cost: 5.0

复制代码

使用该物品的耐力值消耗。

pve-damage: 5.0

复制代码

对非玩家实体的额外伤害，以%为单位。

pvp-damage: 5.0

复制代码

对玩家实体的额外伤害，以%为单位。

weapon-damage: 5.0

复制代码

增加武器的伤害，以%为单位。

skill-damage: 5.0

复制代码

增加MMOItems中技能的伤害，以%为单位。

projectile-damage: 5.0

复制代码

增加远程武器的伤害，为%为单位。

magic-damage: 5.0

复制代码

增加法术的伤害，以%为单位。

physical-damage: 5.0

复制代码

增加物理伤害，以%为单位。

defense: 100.0

复制代码

增加防御力，以MythicLib（也可能在MMOLib）中的公式进行计算。

damage-reduction: 5.0

复制代码

设置整体减伤，以%为单位。

fall-damage-reduction: 5.0

复制代码

减少摔落伤害，以%为单位。

projectile-damage-reduction: 5.0

复制代码

减少远程武器的伤害，以%为单位。

physical-damage-reduction: 5.0

复制代码

减少物理伤害，以%为单位。

fire-damage-reduction: 5.0

复制代码

减少火焰伤害，以%为单位。

magic-damage-reduction: 5.0

复制代码

减少药水伤害，以%为单位。

pve-damage-reduction: 5.0

复制代码

减少以除玩家之外的生物造成的伤害，以%为单位。

pvp-damage-reduction: 5.0

复制代码

减少由玩家造成的伤害，以%为单位。

undead-damage: 5.0

复制代码

增加对不死生物的伤害。

unbreakable: true

复制代码

设置物品是否无法破坏。

tier: RARE

复制代码

设置物品稀有度。

set: STARTER

复制代码

设置物品套装。

armor: 5.0

复制代码

设置物品的护甲值，显示上限为20，实际上限为30。

armor-toughness: 5.0

复制代码

设置护甲韧性，用的是原版的属性。

max-health: 10.0

复制代码

设置额外最大生命值。

unstackable: true

复制代码

设置物品是否可以堆叠。true为不可堆叠。

max-mana: 20.0

复制代码

设置额外的最大法力值。

knockback-resistance: 0.7

复制代码

设置抗击退数值，0.7是70%。

movement-speed: 0.2

复制代码

改变移动速度，原版速度为0.2。可为负值。

two-handed: true

复制代码

设置是否为双持。

equip-priority: 5.0

复制代码

新版的装备优先级，可查看[物品属性 & 选项]页面了解其功能。

perm-effects:
POISON: 1.0

复制代码

给予手持或装备该物品的玩家药水效果。至于为什么是毒药...我不知道！

granted-permissions:
- tempperm.ree

复制代码

装备该物品时给予临时权限。

auto-soulbind: true

复制代码

是否自动灵魂绑定在第一个获得该物品的玩家身上，可以在config.yml文件中配置详细选项。

item-cooldown: 10.0

复制代码

以秒为单位，适合于消耗品的物品冷却。

crafting:
shaped:
'1':
- diamond AIR AIR
- AIR diamond AIR
- AIR AIR netherite_block
shapeless:
'1':
- AIR
- AIR
- AIR
- AIR
- nether_star
- AIR
- AIR
- slime_ball
- AIR
furnace:
'1':
item: COAL
time: 200
experience: 10.0
blast:
'1':
item: COAL
time: 200
experience: 10.0
smoker:
'1':
item: COAL
time: 200
experience: 10.0
campfire:
'1':
item: COD
time: 100
experience: 10.0
smithing:
'1':
input1: DIAMOND_SWORD
input2: DIAMOND

复制代码

所有合成配方的配置。

craft-permission: youneedthis.tocraft

复制代码

合成该物品的权限需求。

crafted-amount: 10.0

复制代码

一次可以制作多少MMOItems的物品。

sounds:
on-attack:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-pickup:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-consume:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-right-click:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-left-click:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-item-break:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-block-break:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-craft:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0
on-placed:
sound: entity.generic.drink
volume: 1.0
pitch: 1.0

复制代码

添加自定义音效。

element:
fire:
damage: 10.0
earth:
defense: 10.0

复制代码

设置元素伤害和元素防御。该系统正在重制。

commands:
cmd0:
format: -d1 bc Hello, this is a test command.
delay: 0.0
op: true
cmd1:
format: -d1 bc Hello, this is a test command from console.
delay: 0.0
console: true

复制代码

右键单击物品时，该物品执行的命令。

gem-sockets:
- RED
- GREEN
- Poop

复制代码

该物品的宝石槽。

repair-type: EXAMPLE_REPAIR_STAT

复制代码

使用消耗品维修该物品时的维修参考，消耗品的维修参考必须和该物品相同才可以维修。留空的话所有的维修消耗品都可以维修该物品。（注：严格区分大小写！）

ability:
ability1:
type: BLOODBATH
mana: 3.0
mode: RIGHT_CLICK

复制代码

该物品的技能列表。

upgrade:
workbench: true

复制代码

具体请查看[物品升级]页面。篇幅太长不在此概述。

health-regeneration: 10.0

复制代码

增加MMOCore中的生命恢复属性，以%为单位。

mana-regeneration: 10.0

复制代码

增加MMOCore中的法力恢复属性，以%为单位。

max-stamina: 10.0

复制代码

增加MMOCore中的额外耐力。（注：以数值为单位，别搞混了）

stamina-regeneration: 10.0

复制代码

增加MMOCore中的耐力恢复属性，以%对单位。

additional-experience: 50.0

复制代码

增加MMOCore中的经验获取，以%为单位。

faction-damage-enemy: 50.0

复制代码

增加对MythicMobs某个派系的伤害。

required-dexterity: 10.0
required-strength: 10.0

复制代码

该物品需要到达MMOCore中的某些属性数值才能使用。

profession-enchanting: 10.0
profession-smithing: 10.0
profession-mining: 10.0

复制代码

该物品需要到达MMOCore中的某些职业等级才能使用。

| 消耗品类额外属性配置示例 |

WIKICONSUMABLE:
base:
material: APPLE
disable-right-click-consume: true

复制代码

disable-right-click-consume项为右键单击是否消耗该消耗品。true为不消耗。

restore-health: 10.0

复制代码

当消耗该消耗品时可以获得的生命值。

restore-food: 10.0

复制代码

当消耗该消耗品时可以获得的饱食度。

restore-saturation: 10.0

复制代码

当消耗该消耗品时可以获得的饱和度。

restore-mana: 10.0

复制代码

当消耗该消耗品时可以获得的法力值。

restore-stamina: 10.0

复制代码

当消耗该消耗品时可以获得的耐力值。

can-identify: true

复制代码

该消耗品是否能鉴定其他物品。

can-deconstruct: true

复制代码

该消耗品是否能拆解其他物品。

can-deskin: true

复制代码

该消耗品是否能移除其他物品的皮肤。

effects:
REGENERATION:
duration: 100.0
amplifier: 1.0

复制代码

该消耗品被使用时获得的药水效果列表。

soulbinding-chance: 100.0

复制代码

该消耗品灵魂绑定其他物品时的成功几率。

soulbound-break-chance: 100.0

复制代码

如果该消耗品破坏其他物品灵魂绑定的几率。

soulbound-level: 1.0

复制代码

该消耗品的灵魂绑定等级。这一块具体请查看[灵魂绑定]页面。

item-cooldown: 5.0

复制代码

该消耗品的物品冷却。

vanilla-eating: true

复制代码

是否有像原版一样的食用动画，只能用于原版就能吃的食物上，效果可以自定义。

inedible: true

复制代码

该消耗品是否不可食用。

max-consume: 5.0

复制代码

该物品可以最多使用几次。

repair: 100.0

复制代码

该消耗品可以维修其他物品的百分比。

repair-type: EXAMPLE_STAT

复制代码

该消耗品的维修参考，与上面武器的维修参考类似。当两个物品的维修参考相同时才可以维修。

| 弓箭类额外属性配置示例 |

ELF_KINGS_LOST_BOW:
base:
material: BOW
name: '&aElf King''s Lost Bow'
arrow-particles:
particle: FLAME
amount: 5
offset: 1.0
speed: 1.0

复制代码

箭在空中飞过时的粒子效果。

arrow-velocity: 100.0

复制代码

箭的飞行速度，也决定其能飞多远。

arrow-potion-effects:
POISON:
duration: 100.0
amplifier: 1

复制代码

当弓箭击中目标时给予的药水效果。

（译者注：弓箭也可以有技能，像武器一样配置即可。）
（这块如果有更新我有时间会来更新。）

我真的按了

本帖最后由 1628872797 于 2021-4-3 20:36 编辑

伤害规避

M I T I G A T I O N

MMOItems中的伤害规避分为三种机制：“格挡”，“闪避”和“招架”。该项的任何数值都可以在前置MMOLib插件（译者注：目前置插件已变为MythicLib，与MythicMobs相同）的config.yml（mitigation部分）进行编辑。
为了增强与MMOCore的兼容性，伤害规避默认数值的调整已移至MMOLib。（译者注：以前数值这块是放在MMOCore中编辑的，现在你只装了MMOItems也可以在config文件中找到该模块并编辑）
只要通过伤害规避成功抵挡了对方的攻击，就会在玩家面前播放粒子效果，并在动作栏上（或者聊天栏）向他发送消息。

| 格挡 |
当成功格挡近战或者远程攻击时，玩家会大幅降低受到的伤害。物品的格挡几率和格挡强度（格挡伤害的百分比）均可调整。格挡强度拥有默认值和上限，如果玩家没有获得任何物品给予的格挡强度，则默认格挡25%的伤害。格挡强度不能超过75%。格挡的几率由”block-rating”项的数值决定。最高不得超过80%（可于config中修改）。

STEEL_BREASTPLATE:
material: IRON_CHESTPLATE
block-power: 10
block-rating: 5

复制代码

| 闪避 |
在成功闪避近战或者远程攻击时，玩家会完全抵挡受到的伤害并向后快速后退，从而使其脱离战斗。闪避几率的上限是80%。（可于config中修改）

SWIFT_LEATHER_BOOTS:
material: LEATHER_BOOTS
dodge-rating: 10

复制代码

| 招架 |
和闪避一类似，不同的是招架在完全抵消伤害的同时会击退攻击者。招架几率的上限是80%。（可于config中修改）
击退的强度可以在config.yml文件中编辑。

DWARVEN_SHIELD:
material: SHIELD
parry-rating: 10

复制代码

| 伤害规避冷却缩减 |
每种伤害规避属性都具有默认的冷却时间，而此项可以减少其冷却。默认情况下，玩家每隔几秒钟都不能闪避，格挡或者招架。这个属性就可以减少其冷却，这在玩家残血的时候很好用。

ROGUE_AMULET:
material: RED_DYE
dodge-cooldown-reduction: 40

复制代码

以上便是闪避的冷却缩减，为减少40%，如果要修改格挡和招架的冷却缩减，则使用以下字段。

parry-cooldown-reduction: 20 # 招架冷却缩减
block-cooldown-reduction: 20 # 格挡冷却缩减

复制代码

我真的按了

本帖最后由 1628872797 于 2021-4-3 20:37 编辑

元素伤害

E L E M E N T A L D A M A G E

将元素属性绑定在物品上，会使物品的伤害变得有所不同，具体取决于你的元素伤害和对手的元素防御。元素伤害增加了元素暴击的几率，而元素防御则根据其造成的元素伤害的不同而降低最终伤害。

| 元素攻击示例 |
玩家用10%火焰伤害/15%冰冻伤害/10基础伤害的剑去攻击一只僵尸。僵尸有一件40%的火焰防御胸甲。

元素伤害比决定了伤害用元素伤害的形式释放的百分比。比如，该剑有10%的火焰伤害，且基础伤害为10，则基础伤害的10%被视为火焰伤害，故火焰伤害为1点。（10 x 10% = 1）而该剑的冰冻伤害有15%，按照以上公式计算，冰冻伤害为1.5。故该剑实际为7.5点基础伤害，1点火焰伤害，1.5冰冻伤害。

元素防御则降低了物品造成相应元素伤害。由于该胸甲有40%的火焰防御，则该剑攻击时，原本的1点火焰伤害会被削减40%，实际造成了0.6火焰伤害。冰冻伤害不受影响。而7.5基础伤害不受元素防御的保护，也不会削减。

故最后实际造成伤害为：7.5 + 0.6 + 1.5 = 9.6

| 元素暴击 |
武器造成的元素伤害越多，发生元素暴击的几率和元素暴击的伤害就会越高。发生元素暴击时不仅伤害提高，也会有额外的攻击效果。如果武器有10%的火焰伤害，则其产生元素暴击的几率也为10%，任何元素相同。
元素暴击的默认冷却为2秒，所以就算是满元素暴击几率的武器也不会太强。
元素暴击的冷却时间可以在config.yml文件中调整。

火焰元素暴击 - 使火焰伤害翻倍，并着火0.1 x <火焰伤害>秒
冰冻元素暴击 - 使冰冻伤害翻倍，并冻结0.75 x <冰冻伤害>秒
风系元素暴击 - 使风系伤害翻倍，并产生强大的AOE击退效果
地系元素暴击 - 使地系伤害翻倍，并产生强大的AOE震地波
雷电元素暴击 - 使雷电伤害翻倍，并对附近的目标造成武器伤害<雷电伤害>%的伤害
水系元素暴击 - 使水系伤害翻倍，并削弱目标，使其易伤30%，持续5秒

我真的按了

本帖最后由 1628872797 于 2021-4-3 20:38 编辑

物品鉴定

I T E M I D E N T I F I C A T I O N

自定义方块和怪物有可能掉落未鉴定的物品。这些物品的数据将完全隐藏，且需要玩家鉴定才能正常使用。玩家鉴定物品的唯一途径是通过特定的鉴定消耗品。

玩家可以将鉴定消耗品放置于要鉴定的物品上来鉴定该物品。并且此鉴定消耗品在配置时必须启用can-identify项。
并且，/mi unindentify指令可以将已鉴定的物品转变为未鉴定状态。
当鉴定成功时，玩家会听到音效，并且收到一条成功提示，说明他们的物品已经鉴定成功。

我真的按了

本帖最后由 1628872797 于 2021-4-16 16:59 编辑

物品稀有度

I T E M T I E R S

| 物品拆解 |
具有稀有度（COMMON、UNCOMMON、RARE...）的物品可以被拆解。拆解物品会将该物品转换为另一件MMOItems物品，你可以让玩家可以使用拆解后的材料在合成站上制作其他物品。
拆解一个物品时所获得的材料完全取决于物品的稀有度。当玩家拆解时，可能会得到其他武器，或是其他投掷物，不一定是材料。

该功能可以让玩家选择拆解一些他们无法使用的物品，比如具有某些职业限制的物品。（拆解物品也需要使用一件消耗品才可以）

玩家必须使用特定的消耗品来拆解物品，此消耗品必须启用can-deconstruct项。当拆解成功时，就像鉴定一样会有提示音和聊天框信息提示。

默认情况下，稀有度为’Trash’（劣质），’Common’（普通），’Uncommon’（罕见），’Rare’（稀有），’Very Rare’（卓越），’Legendary’（传说），’Mythical’（神话），’Epic’（史诗），’Magical’（魔幻）和’Unique’（独一无二）。你可以在item-tiers.yml文件编辑这些稀有度。该文件可以编辑稀有度名称和特定稀有度拆解时的掉落表。此掉落表的格式与怪物/方块的掉落表格式完全相同，详细内容可以去查阅[物品掉落表]页面。

RARE:
name: '&6&lRARE'
deconstruct-item:
sucess:
coef: 1
items:
MATERIAL:
RARE_WEAPON_ESSENCE: 100,1-1,0
lose:
coef: 3
items:
MATERIAL:
WEAPON_POWDER: 100,1-1,0

复制代码

拆解一个物品时可以得到不同的掉落物，这表示你可以设置当玩家拆解一个高稀有度的物品时，可以得到一些更好的掉落物。

| 物品发光与提示 |
当特定稀有度的物品掉落在地上时，可以使用以下功能来使其发光和显示名称：使用全息字来显示名称，使用发光效果使其发光（调用的是原版发光药水效果）。

RARE:
name: '&6&lRARE'
item-glow:
hint: true # 该稀有度的物品掉落时是否有名称
color: 'GRAY' # 发光的颜色

复制代码

使用以上功能你必须安装GlowAPI和PacketListenerAPI作为前置插件。

| 未鉴定物品 |
你还可以修改某稀有度物品在未鉴定状态下的显示，模板如下：

EPIC:
name: '&4&lEPIC'
unidentification:
name: 'Epic'
range: 6
prefix: '&4'

复制代码

name项为该物品在未鉴定状态下显示的稀有度，range为等级的范围，比如该物品实际为10级，range设为5，则显示的等级范围在5-15级。Prefix项则为物品名和稀有度名的颜色。

| 修饰符容量（物品生成器功能）|
首先请确保了解了[物品创建]，[物品模板]和[物品修饰符]这三个页面后再来阅读此部分。
这是item-tiers.yml中的默认格式，我们将其一块块拆开来使你了解如何为你的物品稀有度设置修饰符容量。

UNCOMMON:
....
generation:
chance: 0.15
capacity:
base: 6
# 每级提升的量
scale: .1
spread: .1
max-spread: .3

复制代码

chance项决定了生成该物品时选择稀有度的几率。如果设为0.15，则生成物品时有15%的几率稀有度为UNCOMMON。
而capacity项则为修饰符容量，具体计算方式与物品生成器计算伤害等属性的方式相同。
一件物品各修饰符的修饰符重量总和不会超过该物品稀有度的修饰符容量。

我真的按了

本帖最后由 1628872797 于 2021-2-18 05:35 编辑

宝石系统

G E M S T O N E S

你可以使用GEM_STONE物品类型来创建宝石。宝石是特殊物品，你可以将其拖放到其他物品上镶嵌来获得额外的属性。但该物品必须至少有一个空的宝石槽。物品限制（权限/等级/职业）像普通物品一样适用于宝石。

此外，你可以给宝石设定物品类型限制，使其只能用于特定类型的物品。这样，就可以防止类似于一个增加伤害的宝石镶嵌于护甲上的情况，为什么你会尝试让护甲增加伤害？

宝石还可以将技能增加到武器上。即将推出的功能：可以添加药水效果和粒子效果的宝石。

宝石有一定的成功几率，如果失败，宝石会被摧毁，但宝石插槽不受影响。

| 插槽颜色 |
每个宝石和宝石插槽都有颜色。你只可以将与插槽颜色相同的宝石镶在该插槽上。宝石颜色可以使用内置GUI进行编辑，但是不会显示在lore上。（译者注：可以手动设置lore来让玩家识别宝石颜色）

你可以使用displayered-type选项来修改在物品上显示的类型来表示宝石颜色。比如你的宝石是蓝色宝石，则将该项设为蓝宝石。你也改变物品材质的方式来表示宝石颜色，比如说蓝色宝石就是钻石。

插槽严格区分大小写！！如果该物品的gem-sockets（宝石插槽）为Blue，则宝石的gem-color（宝石颜色）也必须是Blue。

| 无色插槽 |
没有宝石颜色的宝石可以用于所有宝石插槽。同样，无色的宝石插槽可以容纳任何宝石。如果你没有给宝石定义宝石颜色，则默认为无色宝石。要设置无色宝石插槽，请确保输入的插槽颜色与config.yml中以下的设置完全相同。

gem-sockets:
# 如果要创建无色宝石插槽，也就是通用的宝石插槽
# 请定义你在物品的宝石插槽中所需要的输入的文本
uncolored: 'Uncolored'

复制代码

如果你不想使用宝石颜色系统，则只创建带有无色插槽的物品，并且在制作宝石时不要定义宝石颜色。

我真的按了

本帖最后由 1628872797 于 2021-2-18 05:35 编辑

自定义耐久

C U S T O M D U R A B I L I T Y

自定义耐久是一个非常强大的系统，可以让你创造具有特定用途的物品。

所有的物品都有一个max-durability属性，这个属性决定了该物品可以具有的最大耐久度。而lost-when-broken属性（该属性存疑，新版本可能更改了属性，可以去查看[属性配置格式]页面查看最新属性）决定了该物品耐久度为0时是否会摧毁该物品。

耐久度显示在物品的原版耐久度栏上，你也可以使用PAPI变量来显示玩家持有的物品的耐久度。物品可以使用铁砧或者使用消耗品维修。

| 耐久度变量 |

％mmoitems_durability％ - 返回玩家持有的物品的剩余耐久度。
％mmoitems_durability_max％ - 返回物品的最大耐久度。
％mmoitems_durability_ratio％ - 以百分比的形式返回物品的耐久度。
％mmoitems_durability_bar_square％以长条的形式返回物品的耐久度。
％mmoitems_durability_bar_diamond％以菱形的形式返回物品的耐久度。
％mmoitems_durability_bar_thin％以短横的形式返回物品的耐久度。

（译者注：MMOItems的耐久度显示其实比较恶心，我当初也摸索了一段时间。如果不会用的人多了我会在此补充一条个人使用教程）

我真的按了

本帖最后由 1628872797 于 2021-2-18 05:36 编辑

套装系统

I T E M S E T S

套装可以让你将多个物品连接在一起，以使它们在同时装备时更加强大。如果玩家穿着相同套装中的足够装备，则套装会给玩家额外的属性。而此系统在配置文件中也很好配置。（译者注：MMOItems的套装系统和Qrpg的套装系统其实大同小异，配置也一样，还是比较易用的。缺点是不支持通过前缀后缀配置套装。）

| 示例配置文件 |

ARCANE: # 套装配置名，在给装备增加套装时以此名为准
name: '&2奥术套装' # 套装名,用处不大
bonuses:
'3': # 3件装备时的效果
magic-damage: 20
'4': # 同上
max-mana: 30
potion-speed: 1
lore-tag: # 该套装显示的Lore
- '&7奥术套装效果:'
- '&8[3] +20% 魔法伤害'
- '&8[4] +30 最大法力值'
- '&8[4] 永久速度 I'

复制代码

这个套装显示的lore在lore-tag项下。你可以在lore中加任何内容，不过还是建议加这个套装的具体效果。bonuses则是该套装对应的额外属性，数字则是具体几件套装装备时享有的额外属性。

| 套装效果 |
套装属性也可以设置为永久药水效果。你必须指定药水效果名称（名称可以在此处找到）和药水等级，药水等级必须是整数。

SPEED:
name: '&2速度套装'
bonuses:
'4':
potion-speed: 1

复制代码

你甚至可以设置技能为套装效果。设置技能作为效果时的格式与在物品上设置技能的格式相同。在以下示例中，只要有两件该套装的装备被玩家穿戴，则会被暂时授予一个LIFE_ENDER技能，并在玩家击中实体时触发该技能。该技能CD为30秒。

HATRED:
name: '&c仇恨套装'
bonuses:
'2':
ability-1:
type: LIFE_ENDER
cooldown: 30
mode: ON_HIT

复制代码

我真的按了

本帖最后由 1628872797 于 2021-3-21 13:02 编辑

物品升级

I T E M U P G R A D I N G

物品升级是增加物品强度的一种方式。成功升级物品后，物品的属性将会增强，这会让该物品变得更强大。
玩家可以使用特定的消耗品或者在合成站使用特定的升级配方来升级他们的物品。升级后，物品会获得一个等级。级别会显示在物品显示名称的旁边。
你可以在插件的config.yml（item-upgrading.name-suffix）中修改物品升级后的后缀。如该项没有内容，则后缀不会显示。

| 自定义升级模板 |
可以在upgrade-templates.yml文件中配置升级模板。配置很简单，但是可能需要花很多的时间去研究数据平衡。以下是模板文件。

# 模板ID, 仅供参考。
# 这是你在物品编辑GUI中所需要的输入的文本
# 以便为特定物品设置物品强化
weapon-default:
# 每升级一次，攻击伤害提升3%（相对于当前值）
attack-damage: 3%
# 每升级一次,暴击几率提升2%（与当前值无关）
critical-strike-chance: 2
pve-damage: 1%
armor-template-example:
armor: 3%
armor-toughness: 2%
block-rating: 5%
dodge-rating: 5%
parry-rating: 5%

复制代码

该配置文件中的每个节点都对应一个单独的升级模板。你可以添加任意数量的模板，来适配不同的武器装备。

你甚至可以每个物品都来一个特定的升级模板！配置完成后，你可以将这些模板绑定到物品上，以确定该物品在升级的时候套用的模板。
我们逐步拆分该配置文件来说明各个模块的作用。

以上配置文件的weapon-default:
这是一个武器的升级示例模板。每次升级，该武器的攻击伤害将增加3%，因为数值的结尾是%。每升级一次该物品，它也会提升2%的暴击率（不是相对于当前的暴击率乘上1.02，因为暴击率本身就是以%统计的，所以会增加2的数值）以及1%的PVE伤害（而这1%的PVE伤害则是以原本伤害做计算的，则为乘上1.01）。

weapon-default:
# 每升级一次，攻击伤害提升3%（相对于当前值）
attack-damage: 3%
# 每升级一次,暴击几率提升2%（与当前值无关）
critical-strike-chance: 2
pve-damage: 1%

复制代码

以上配置文件的armor-template-example:
这是一个护甲的升级模板。升级后，带有此模板的物品将获得3%的护甲，2%的护甲韧性，5%的格挡，闪避和招架几率（相对于其当前属性），因为数值的结尾是%。

armor-template-example:
armor: 3%
armor-toughness: 2%
block-rating: 5%
dodge-rating: 5%

复制代码

在数值以%作为结尾的升级模板中，这表示升级该物品时升级后的数值会以相对于之前的数值来计算。例如，比如一把有8点伤害的剑，让其提升3%（相对值）于提升3点攻击力不同（绝对值）。

让我们看下另一个例子：
假设我们有一把10点攻击力的剑，并且绑定了以上的默认升级模板（weapon-default），则该剑会提升其当前伤害的3%，因此它最终会有10 + （3% * 10） = 10 + 0.3 = 10.3攻击力，以及2%的暴击率。（译者注：因为暴击率本身就是以%结算，所以提升时就是提升绝对2%而不是相对2%）
而该剑没有任何PvE伤害，因此就算该升级模板会提升PvE伤害，也不会对该剑有任何提升（0 + （0 * 1%） = 0）。

*当前，物品升级仅适用于如暴击率、攻击力、护甲等用数值统计的属性。

| 使用消耗品升级 |
玩家可以使用消耗品来升级物品。如果你想以这样升级，则要对该消耗品指定两个选项，upgrading reference（升级参考）和upgrade chance（升级几率）。你可以在内置GUI中配置这两个选项。

| 物品的升级选项 |
所有物品都可以升级，包括武器/护甲等等。但是你需要设置一些选项该物品才能被升级。
在使用消耗品升级物品时，其成功升级的几率以以下公式计算：成功几率 = 物品升级成功几率 * 消耗品升级成功几率。
比如，该物品的成功几率为40%，而该消耗品的成功几率也为40%，则最终计算的成功几率为16%。
如果该物品不是100%成功升级，你也可以为其启用一个额外的选项，使该物品在升级失败时被摧毁。

一个物品也可以设定其最大升级次数。这意味着当该物品升级到特定次数时，就不能再对其进行升级了。如果你不希望一个物品被无限升级而太过强大，则这是一个极为重要的选项。

不要忘记使用内置GUI中的相应选项将升级模板绑定到你的物品！先前描述的选项也可以使用内置GUI进行配置。

upgrade:
template: weapon-default # 使用的升级模板
max: 3 # 最大升级次数
workbench: false # 是否只能使用合成站升级
success: 80.0 # 成功几率，和以上公式使用
destroy: true # 升级失败时是否破坏该物品
reference: '钢剑升级' # 升级参考

复制代码

在物品上添加以上配置即可绑定，template项为该物品绑定的升级模板，max项为该物品的最大升级次数，workbench项用于设置该物品升级是否必须使用合成站，success项为升级该物品的成功几率，destroy项设置升级该物品时如果失败是否破坏该物品。reference项为升级参考，注：workbench如为true则和升级参考不兼容。

| 升级参考（upgrading reference）详解 |
此选项用于使用消耗品来升级物品的情况。升级参考用于说明特定的消耗品是否可以升级该项目。

该选项的规则是：消耗品的升级参考只有在匹配该物品的升级参考时才可以升级该物品。
如果未指定该消耗品的升级参考，则该消耗品可以升级任何物品。如果某个物品没有指定升级参考，则可以被任何消耗品升级，除非你启用“workbench-only”（只能用合成站升级）项。

升级参考是一条文本，而且该文本并不会显示在物品的lore中。它仅在内部用于检查消耗品与物品是否匹配，因此你可以将升级参考设定为任意文本，只要确保它们绝对匹配即可（就像宝石槽颜色一样）。

| 在Config.yml中修改关于升级的全局选项 |
你可以在Config.yml文件中修改一些物品升级时的全局选项。全局选项全在以下的注释中：

item-upgrading:
# 物品升级后显示名称的后缀
name-suffix: '&f &e(+#lvl#)'
# 是否显示在物品名称或描述中
# 如果玩家可以重命名物品，则建议禁用
# 如果设置为'false'，请记住要在你的物品描述中包含
# '%upgrade_level%'变量
display-in-name: true
# 属性变化后在原属性后缀的格式
stat-change-suffix: '&f &e(+#stat#)'
# 是否显示在描述中说明修改了哪些属性
# 实验性功能
display-stat-changes: false

复制代码

我真的按了

本帖最后由 1628872797 于 2021-3-9 04:06 编辑

灵魂绑定

S O U L B O U N D

玩家可以使用特定的消耗品将物品对自己灵魂绑定。一旦绑定了物品，其他玩家将无法使用该物品，并且如果尝试强行使用它还会受到伤害，除非他们使用另一种消耗品来破坏灵魂绑定。灵魂绑定会显示在物品的lore上。
你可以设置灵魂绑定的物品无法丢弃，并且死亡时也会留着玩家背包中。

| 灵魂绑定等级 |
灵魂绑定也有等级。绑定的等级取决于绑定该物品时的消耗品。消耗品具有特定的选项，可以指定当用该消耗品绑定时绑定等级是多少。灵魂绑定等级决定了当其他玩家使用被绑定的物品时会受到多少伤害。当使用消耗品创建灵魂绑定失败时，该消耗品会消失。

| 破坏灵魂绑定 |
玩家可以使用特定的消耗品来破坏灵魂绑定。并且此消耗品的灵魂绑定破坏等级必须高于或等于该灵魂绑定等级。破坏灵魂绑定时可能会失败，这取决于该消耗品破坏灵魂绑定的几率。当破坏灵魂绑定失败时，该消耗品就会消失。

| 自动绑定 |
你可以在编辑器中为物品启用自动绑定。启用该选项后，该物品会自动绑定第一个获得该物品的玩家。并且该项可以使用config.yml文件配置。

soulbound:
# 当玩家试图使用非自身灵魂绑定的物品时所受到的伤害
damage:
base: 100
per-lvl: 100
# 当玩家死亡时是否保留非自身灵魂绑定的物品
keep-on-death: true
# 玩家是否可以丢弃非自身灵魂绑定的物品
can-drop: true
auto-bind:
# 自动灵魂绑定时默认的绑定等级
level: 10
# 你可以禁用个别选项触发自动绑定
# (该选项必须保证'Auto-Bind'为true)
disable-on:
pickup: false
craft: false
click: false
join: false # 推荐 'true'

复制代码

我真的按了

本帖最后由 1628872797 于 2021-2-18 05:37 编辑

动态Lore

D Y N A M I C L O R E

使用动态Lore，你可以在特定的属性变更时更新物品的Lore。

| 支持的属性 |
目前，唯一使用动态Lore系统的属性是自定义耐久。
这样你就可以在物品中显示物品的耐久，并随着耐久的减少自动更新Lore。

| 配置 |
要使用动态Lore，只需要将%durability%添加到lore-format.yml中即可。
并且你可以通过改变%durability%的位置来自定义该属性显示的位置。

| 默认配置文件 |

# 这个文件可以自定义所有的动态Lore。
# 更改这个文件来得到不同的动态Lore格式。
format:
durability: "&7耐久: %durability% / %max_durability%"

复制代码

我真的按了

本帖最后由 1628872797 于 2021-2-19 18:12 编辑

战利品

L O O T S P L O S I O N

战利品这个名称是我们模仿《无主之地》系列游戏效果时的昵称。现在，你的掉落物可以在杀死怪物时喷发在天上，而不是无聊的掉在地上。

# 该项为战利品于MythicMobs怪上掉落时爆出的范围与速度
# Offset选项是在X和Y上移动的距离
# Height是Y轴移动的速度
# 这只在MythicMobs怪物上触发
# 修改此项后请重启服务器
lootsplosion:
enabled: true
color: true
offset: .2
height: .6

复制代码

你可以在config.yml中进行配置，改变物品在飞出时X轴和Y轴的速度。现在，你可以做到在玩家杀死BOSS后，让大量的发光物品飞走，让玩家互相抢夺！

为了对某个MM怪物启用该项，你需要先给他一个Lootsplosion变量。该变量的值可以是任何值，比如1。而以下的技能则是在该怪物生成时给他一个变量。

- setvariable{var=Lootsplosion;scope=target;value=1} @self ~onSpawn

复制代码

战利品系统与MMOItems的稀有度系统完全兼容。当使用MM的掉落表掉落有稀有度的物品时，掉落的物品将有一些粒子效果，而这些粒子效果的颜色完全取决于其稀有度！
在加上MMOItems的物品名称提示和发光效果，你将得到一些美丽的掉落物！

为了使有稀有度的掉落物有颜色，你需要做的就是在稀有度配置文件中设置该稀有度的颜色，如下所示：

RARE:
name: '&6&lRARE'
unidentification:
...
item-glow:
color: 'ORANGE'

复制代码

我真的按了

本帖最后由 1628872797 于 2021-2-19 18:14 编辑

合成站

C R A F T I N G S T A T I O N S

合成站可以使玩家使用需要材料和条件的合成配方来合成特定物品。当打开合成站时，玩家可以查看相关配方的信息，包括合成条件（权限，等级），所需材料和合成的物品，并可以分页浏览它们。

你可以使用以下命令使玩家打开合成站GUI：/mi stations open {合成站ID} (player)。你可以使用/mi stations list来查看所有可用的合成站。

| 创建一个新的合成站 |
合成站保存在/MMOItems/crafting-stations文件夹中。该文件夹中的每一个yml文件都对应一个合成站，因此你可以创建一个新的yml文件来创建新的合成站。
当命名yml文件的文件名时要小心，因为它对应于你通过前面的命令打开的合成站的ID。

| 合成站示例配置 |

# 打开合成站时显示的名字
name: 'Arcane Forge (#page#/#max#)'
max-queue-size: 10 # 最大队列数
sound: ENTITY_EXPERIENCE_ORB_PICKUP
layout: default # 使用的合成站显示模板
# 改变GUI物品
items:
fill: # 空白位置的显示的物品
material: PINK_STAINED_GLASS_PANE
name: '&a'
no-recipe: # 该位置无配方时的显示的物品
material: GRAY_DYE
name: '&a'
no-queue-item: # 该队列无正在生产的物品时显示的物品
material: GRAY_STAINED_GLASS_PANE
name: '&a没有物品在队列中'

复制代码

每个合成站都需要合成站的配置文件中提供一些基本要素，比如name是于合成站GUI名字对应的选项。在items选项配置部分则是改变一些GUI的显示物品。比如fill项用于填充配方周围一些空白位置的物品。no-recipe则是当没有配方时，用于填充无配方空位的填充物。

| 创建合成站配方 |
我们将一步步制作一个合成配方，使你直观的掌握该功能。我们将为STEEL_SWORD这个物品创建一个配方，该配方的条件要求玩家至少有5级，并且需要两个权限。材料则为4个MMOItems的物品STEEL_INGOT和2个原版的木棍。

第一步，创建recipes配置部分于合成站配置文件中。（译者注：该项下都为该合成站的配方）然后，你需要配置该合成表的配方。steel-sword是该合成站中此合成表的ID，此ID仅在插件内部使用。该ID并不重要，只需确保不同的配方具有不同的ID就行。

recipes:
steel-sword:

复制代码

第二步，设置该配方的输出。在任何玩家使用该配方时会输出特定的物品。由于我们希望玩家获得一把STEEL_SWORD（物品类型为SWORD，ID为STEEL_SWORD），因此该output项的格式如下。

recipes:
steel-sword:
output:
type: SWORD
id: STEEL_SWORD
amount: 1

复制代码

配方也可以有制作时间，即玩家花在制作该物品上的时间（以秒为单位）。在GUI中单击配方后，玩家将会暂时退出GUI，并使用原版动作栏提示进度条，直到制作完成（译者注：这是老版本MMOItems的显示方式，新版将直接在GUI内展示一条队列条，队列条上是正在制作的物品）。

如果你想设置配方制作时间，请添加以下配置模板：

recipes:
steel-sword:
output:
type: SWORD
id: STEEL_SWORD
amount: 1
crafting-time: 5

复制代码

如果你不希望在不满足合成条件的情况下显示该配方，请使用hide-when-locked选项，类似以下模板：

recipes:
steel-sword:
output:
type: SWORD
id: STEEL_SWORD
amount: 1
crafting-time: 5
options:
hide-when-locked: true

复制代码

第三步，我们加上该配方的合成条件，设定玩家必须大于5级才并且拥有mmoitems.recipe.steel-sword和mmoitems.recipe.station.steel权限才可以使用该配方。

recipes:
steel-sword:
output:
type: SWORD
id: STEEL_SWORD
amount: 1
crafting-time: 5
options:
hide-when-locked: true
conditions:
- level{level=5}
- permission{list="mmoitems.recipe.steel-sword,mmoitems.recipe.station.steel"}

复制代码

最后，加上该配方所需的材料，我们的配方就大功告成啦~

recipes:
steel-sword:
output:
type: SWORD
id: STEEL_SWORD
amount: 1
crafting-time: 5
options:
hide-when-locked: true
conditions:
- level{level=5}
- permission{list="mmoitems.recipe.steel-sword,mmoitems.recipe.station.steel"}
ingredients:
- mmoitem{type=MATERIAL,id=STEEL_INGOT,amount=4,display="Steel Ingot"} # 使用MMOItems的物品作为配方
- vanilla{type=STICK,amount=2,display="Wooden Stick"} # 使用原版物品作为配方
# 译者注：配方材料内的display项是显示在配方上该种材料的名字

复制代码

我们将以上的配置文件加在一起，就是一个完整的只有一个配方的合成站了！

name: 'Arcane Forge (#page#/#max#)'
max-queue-size: 10 # 最大队列数
sound: ENTITY_EXPERIENCE_ORB_PICKUP
layout: default # 使用的合成站显示模板
# 改变GUI物品
items:
fill: # 空白位置的显示的物品
material: PINK_STAINED_GLASS_PANE
name: '&a'
no-recipe: # 该位置无配方时的显示的物品
material: GRAY_DYE
name: '&a'
no-queue-item: # 该队列无正在生产的物品时显示的物品
material: GRAY_STAINED_GLASS_PANE
name: '&a没有物品在队列中'
recipes:
steel-sword:
output:
type: SWORD
id: STEEL_SWORD
amount: 1
crafting-time: 5
options:
hide-when-locked: true
conditions:
- level{level=5}
- permission{list="mmoitems.recipe.steel-sword,mmoitems.recipe.station.steel"}
ingredients:
- mmoitem{type=MATERIAL,id=STEEL_INGOT,amount=4,display="Steel Ingot"}
- vanilla{type=STICK,amount=2,display="Wooden Stick"}

复制代码

以下是Wiki作者提供的另一个合成站示例：

name: 'Steel Crafting Station (#page#/#max#)'
max-queue-size: 10
sound: ENTITY_EXPERIENCE_ORB_PICKUP
layout: default
items:
fill:
material: AIR
no-recipe:
material: GRAY_STAINED_GLASS_PANE
name: '&a'
no-queue-item:
material: GRAY_STAINED_GLASS_PANE
name: '&aNo Item in Queue'
recipes:
two-handed-steel-sword:
output:
type: GREATSWORD
id: TWO_HANDED_STEEL_SWORD
amount: 1
crafting-time: 10
conditions:
- 'level{level=8}'
ingredients:
- 'mmoitem{type=MATERIAL,id=STEEL_INGOT,amount=8}'
- 'vanilla{type=STICK,amount=4}'

复制代码

| 合成站配方选项 |

配方选项可以单独应用到每一个配方上，它们决定该配方在合成站工作时的一些功能。

recipes:
steel-sword:
options:
output-item: false
hide-when-locked: false
silent-craft: true

复制代码

output-item - 是否将输出项给予玩家
hide-when-locked - 如果玩家没有满足任何合成条件时会隐藏该配方
hide-when-no-ingredients - 如果玩家没有满足任何配方材料时会隐藏该配方
silent-craft - 当玩家合成该配方时不会播放声音

我真的按了

本帖最后由 1628872797 于 2021-2-18 05:38 编辑

合成站布局

S T A T I O N L A Y O U T S

合成站布局是当你使用合成站时配置的一些基本按钮。
每当你重启服务器或者使用以下命令，合成站布局就会重载：/mi reload station

| 创建布局 |
每当你创建一个新的合成站时，它们会使用默认布局。
在/MMOItems/layout文件夹中存放着所有的合成站布局，每一个yml文件则对应着一个新的布局，你可以通过创建一个新的yml文件来创建一个新的布局。合成站布局的名字与yml文件的名字相同，这与合成站类似。

| 使用布局 |
这是一个合成站配置的示例。在layout项下，你可以写上你想要调用的布局。

# 打开合成站时显示的名称
name: '神秘锻造' (#page#/#max#)'
# 制作队列中的最大物品数量，即玩家能够同时制作的最大物品数量
# 只能在1-64之间
max-queue-size: 10
# 每在制作站中完成一个动作时播放的声音
# 在这里获取所有可用音效的名称:
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
sound: ENTITY_EXPERIENCE_ORB_PICKUP
# 这就是gui的配置
# 你可以在crafting-stations/layouts中制作你自己的配置
# 创建新的文件，文件名就是填在这里的id
layout: default

复制代码

| 默认布局 |

# gui的大小。必须在9和54之间，且必须是9的倍数。
slots: 54
layout:
# 显示合成站内配方的位置
recipe-slots: [10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25]
# 显示合成站内队列的位置
queue-slots: [38, 39, 40, 41, 42]
# 显示箭头的位置，用于合成站的配方
# 只有在可以使用的时候才会显示
recipe-previous-slot: 18
recipe-next-slot: 26
# 显示箭头的位置，用于合成站的队列
# 只有在可以使用的时候才会显示
queue-previous-slot: 37
queue-next-slot: 43

复制代码

我真的按了

本帖最后由 1628872797 于 2021-3-19 23:54 编辑

升级配方

U P G R A D I N G R E C I P E S

升级配方是合成站的一种特殊配方类型。它们允许玩家使用材料升级特定物品。升级配方也支持合成配方的条件与选项，例如hide-when-locked。在阅读如何配置升级配方之前，请确保自己已经了解了合成配方。

| 升级配方示例 |

recipes:
steel-sword-upgrade:
item:
type: SWORD
id: STEEL_SWORD
conditions:
- 'level{level=5}'
ingredients:
- 'mmoitem{type=MATERIAL,id=STEEL_INGOT,amount=4}'

复制代码

此配方允许玩家升级在SWORD类下名为STEEL_SWORD的物品。升级配方不支持制作时间，所有升级配方都是即时给予的，就好像使用消耗品一样。

以上配方要求玩家至少必须有5级，且背包中必须有4个MATERIAL类下的名为STEEL_INGOT的物品。

当然，当玩家在使用此配方时，首先必须有一把STEEL_SWORD。否则他会收到一条错误提示。

我真的按了

本帖最后由 1628872797 于 2021-4-25 20:25 编辑

配方条件

R E C I P E C O N D I T I O N S

就跟配方材料一样，必须满足某种条件才能使用该配方。与配方材料不同，使用配方时，配方条件不会从玩家背包上获取任何物品。
配方条件有几种类型，主要是等级条件和权限条件。就和配方材料一样，配方条件也存储在配方配置部分的列表里。

| 示例配置 |

recipes:
steel-sword:
conditions:
- 'level{level=5}'
- 'permssion{list="mmoitems.recipe.steel-sword,mmoitems.recipe.station.steel"}'

复制代码

| 一般条件 |

level{level=<最低等级>} - 玩家必须至少有X等级
class{list=<职业1>,<职业2>...} - 玩家必须拥有列表中的职业（注：未测试是拥有单个职业即可还是必须要所有职业，知道的可以说下）
permission{list="<权限1>,<权限2>..."} - 具有XX权限的玩家才可以使用该配方
placeholder{placeholder=<变量>~<比较器>~<数值>} - 检查玩家的变量，并与你设定的数值进行比较。满足才可使用该配方。比较器列表：<，<=，>，>=，==，=，!=，或者使用equals比较器用于比较字符串而非数值。
food{amount=<数量>} - 配方需要（并消耗）X点饱食度
mana{amount=<数量>} - 配方需要（并消耗）X点法力值
stamina{amount=<数量>} - 配方需要（并消耗）X点耐力
money{amount=<数量>} - 配方需要（并消耗）X点金钱

而hide-when-locked选项只是当玩家没有满足该配方的任何一个条件时，就会隐藏该配方，如果玩家满足了条件而未满足配方材料，该配方就会显示。

| MMOCore条件 |

profession{profession=<职业>,level=<最低等级>} - 玩家必须达到某职业的某个等级才可以使用该配方