 配置文件（如何设置职业、游戏奖励） |
（完成此配置后，可以达到的最终效果：自定义竞技场的各种属性，自定义竞技场前缀，自定义职业，自定义奖励）
注意：编辑配置文件时，必须使用空格缩进！ 使用制表符代替空格会导致配置文件无法读取！（就是说：后面要空一格）
全局设定 global-settings:
- enabled: [true|false] - 这决定了MobArena是否启用，如果设置为false，玩家将无法加入任何游戏，无论游戏中的个人状态如何。
- update-notification: [true|false] - 自动更新开关。
- allowed-commands: /list, /pl - 游戏内允许使用的命令，插件本身自带的命令可以不用写进去，两个命令之间请用“, ”隔开。
- prefix: '&a[MobArena] ' - 插件的前缀，每一个提示前面都会显示的东西。
|
职业稍微复杂一点，因为有许多个职业，其中每个职业都有一个名称，每一个职业都有专属的物品和工具，甚至包括专属的武器、护甲、价格、权限、大厅权限、无限耐久的武器和无限耐久的装甲。至于如何设置专属武器，可以参照上文物品语法进行编辑，为了让各位服主更好地进行理解，我们直接使用官方Wiki列出的举例进行拆分讲解。
classes:
Archer: <—职业名称，经过测试，是可以使用中文的！
items: wood_sword, bow, arrow:128, grilled_pork <┐
armor: 298,299,300,301 <—可以给玩家专属的物品和护甲（护甲会直接装备在身上）
permissions: 物品可以是物品名称也可以是物品ID
- EffectiveArrows.use.* <—可以给专属的职业添加权限，玩家选择该
- -mobarena.use.leave 职业后，即可获得这些权限。
Tank:
items: iron_sword
armor: 310,311,312,313
offhand: shield <—你可以给职业的副手（左手）也装备物品，可以不仅仅
Knight: 是盾牌，可以是任何东西。
items: '276'
armor: iron_helmet, iron_chestplate, iron_leggings, iron_boots
Wolf Master:
items: stone_sword, grilled_pork, bone:2 <—有一些特定的职业可以使用狼作为
armor: 298,299,300,301 宠物进行辅助攻击，设置非常简单
Crusader: 只需在初始物品里面添加骨头即可。
items: iron_sword
armor: 302,303,304,305
price: $5 <—你甚至可以设置使用职业的价格，玩家要使用这个职业，必须
付费才能使用。
还有一种职业比较特殊，类似于骑士的功能，在玩家选择好职业进入游戏后，会出现一匹马可以供特定职业骑乘。我们引用官方的一个例子进行讲解。
classes:
Crusader:
items: iron_sword, hay_block:17 <—在物品里面添加干草块，并在“:”后面标上
armor: 302,303,304,305 标上对应的标签（标签将决定马的种类）
下面就是标签决定的马匹种类表格：
╲ | 无装备 | 铁马凯 | 金马凯 | 钻石马凯 | 普通马 | 1 | 9 | 17 | 25 | 驴 | 2 | - | - | - | 骡子 | 3 | - | - | - | 骷髅马 | 4 | - | - | - | 僵尸马 | 5 | - | - | - |
因此，我们上面例子职业中的马就是装备了金马凯的普通马。至此，关于职业的所有讲解已完毕。
|
游戏设定 arenas:
default:
settings:
prefix: ''（竞技场的前缀名字，可以自定义，这将会替换前面的全局前缀）
world: world（所在的世界，请不要随意修改）
enabled: true（是否开启此竞技场，未开启的话玩家将无法加入这个竞技场）
protect: true（竞技场地图的保护，防止被破坏，包括玩家破坏和怪物爆炸）
entry-fee: ''（加入这个竞技场的费用，例如$20，玩家就需要20元才能加入游戏，当然，你还可以向玩家索要某件物品才能进入竞技场，例如$5, stick:2，则需要玩家上交5元以及2个木棍才能加入竞技场，这里的物品遵守上面的物品语法）
default-class: ''（默认职业，在玩家不选择职业的情况下的默认职业）
clear-wave-before-next: false（是否杀死当前波数的怪物才刷新下一波怪物）
clear-boss-before-next: false（BOSS波，同上）
clear-wave-before-boss: false（同上）
soft-restore: false（如果开启，所有竞技场内破坏的方块会在游戏结束后被复原）
soft-restore-drops: false（如果开启，方块被破坏后会掉落在地上）
require-empty-inv-join: false（是否需要清空背包才能加入游戏）
require-empty-inv-spec: false（是否需要清空背包才能加入旁观者模式）
hellhounds: false（开启宠物的火焰特效，例如狼，特效没有任何作用，仅仅是为了好看）
pvp-enabled: false（是否允许玩家之间PVP）
monster-infight: false（怪物之间是否会内讧）
allow-teleporting: false（游戏开始后，是否允许非游戏中的玩家传送进入竞技场）
spectate-on-death: true（死亡后进入观察者模式）
auto-respawn: true（是否开启自动重生）
share-items-in-arena: true（是否允许玩家在竞技场内丢出自己的物品）
min-players: 0（竞技场的最小人数，0为不限制）
max-players: 0（竞技场的最大人数，0为不限制）
max-join-distance: 0（设置加入游戏的距离，离竞技场太远会无法加入，0为不限制）
first-wave-delay: 5（玩家进入游戏后，离第一波怪物生成的准备时间，以秒为单位）
wave-interval: 15（每一波的间隔，如果之前设置了杀完一波怪才能开始下一波，则此选项无效）
final-wave: 0（游戏最多有多少波，0为不限制）
monster-limit: 100（竞技场内怪物最多的数量）
monster-exp: false（怪物是否会掉落经验）
keep-exp: true（是否会保存获得的经验，在竞技场内获得的经验将在游戏结束后被带出竞技场，如果经验掉落为false，则无视此选项）
food-regen: false（玩家在满饱食度情况下是否会恢复生命值，注意，这样玩家会很容易恢复生命值，坦克职业设置可能会非常耐打，请各位服主仔细考虑后再决定）
lock-food-level: true（开启后，玩家的饥饿值不会掉）
player-time-in-arena: world（在竞技场内的时间设置，world则是随当前世界时间相同，也可以设置：dawn黎明, sunrise日出, morning早晨, midday接近中午, noon中午, day白天, afternoon下午, evening晚上, sunset日落, dusk黄昏, night夜晚, midnight午夜）
auto-ignite-tnt: false（玩家放置TNT后，是否自动点燃）
auto-start-timer: 0（游戏自动开始的的时间，游戏会在一段时间后自动开始）
start-delay-timer: 0（游戏开始后进入游戏区域的延迟时间）
auto-ready: false（是否自动让玩家准备，不用敲击铁块）
use-class-chests: false（是否开启职业箱子，上文已经进行讲解）
display-waves-as-level: false（用经验条来显示怪物波数）
display-timer-as-level: false（用经验条来显示时间）
use-scoreboards: true（是否开启计分板）
isolated-chat: false（开启后，只有竞技场内的玩家可以看到发送的消息）
global-join-announce: false（是否在游戏开始时发送全服公告让玩家加入游戏）
global-end-announce: false（是否在游戏结束是全服公告）
show-death-messages: true（是否显示死亡信息）
|
奖励设定 奖励的设置非常简单并且遵循之前的物品语法，因此你可以自定义多种奖励，为了更加的简单易懂，我们直接在官方给出的示例奖励设置上讲解。
rewards:
waves:
every: <—每通过N波的奖励
'3': feather, bone, stick
'5': dirt:4, gravel:4, stone:4
'10': iron_ingot:10, gold_ingot:8
after: <—通过第N波的奖励
'7': minecart, storage_minecart, powered_minecart
'13': iron_sword, iron_pickaxe, iron_spade
'16': $200 <—同样是可以设置金钱奖励的
请注意：波数的格式应该是'7':而不是7:
|
当MobArena第一次生成配置文件时，coords-section这个选项不存在，因此服主无需在配置文件中进行坐标设置，坐标需要由服主在游戏中进行设置， 有关如何设置所有坐标详细信息，请参阅上文。 整个竞技场包括五个关键的点和任意数量的生成点：
- p1和p2 - 这是游戏区域的两个选取点坐标
- l1和l2 - [可选]大厅区域的两个选取点
- arena - 这个坐标是玩家在游戏开始时被传送到的地方。
- lobby - 玩家在进入大厅时被传送的地方。
- spectator - 玩家在死亡后或旁观者的传送点。
- spawnpoints - 怪物生成点。
请注意：手动编辑这些坐标可能会产生一些无法预测的后果， 所以更建议再游戏内编辑这些坐标，这样会更加方便和安全。 |
|
|
|
入门（插件的安装与简介）
消息文件(announcements.yml的配置)
设置竞技场（配置模式，游戏区域，传送点，刷怪点设置与讲解）
职业箱子设定（职业箱子的使用）
计算公式（插件内部计算公式的讲解）
物品语法（配置自定义物品讲解）
排行榜（如何设立排行榜）
命令（玩家、管理员、设置竞技场命令讲解）
默认所有玩家都有权限执行以下命令（无需设置权限）：
管理员命令列表（只能OP使用这些命令）：
竞技场配置命令列表：
怪物类型（如何自定义怪物）
权限（如何禁止玩家使用某些职业或功能）
波数设定（自定义怪物、BOSS）
6大波数类型：
默认波会生成怪物列表里面的所有怪物，并通过计算公式进行分配和数量增长。
特殊波只会随机生成怪物列表中的其中一种，并且在怪物后面设置数量是固定数量，和默认波不同的是，默认波可以是固定数量也可以使概率值。
一大波像特殊波一样，只会生成一种类型的怪物，但是这种波生成的怪物生命值很低，只有半颗心。 然而，与默认和特殊波相比，它们的数量非常庞大，可能会卡服，请谨慎使用此类型！
补给波这种类型的波会在玩家身边生成一个怪物，并且有着特殊掉落，所以你需要设置一个特定于补给波的选项，例如：
升级波这种波不会生成怪物，而是给玩家一定的补给来让他们得到续航，你可以设置所有职业都可以得到的补给，也可以设置单独职业可以得到的补给。在以下示例中，所有玩家都获得了治疗药水，所有Archer职业都获得64个箭头，所有Oddjob职业都可以获得2个TNT或一个地狱岩：
Boss波可以自定义怪物的生命值、技能以及特殊功能的配置，下面是一个例子：
至此，你已经完成了该插件的所有配置，真是不容易呢，我相信能看到这里的服主，一定可以做出一个让所有人都喜欢的好服务器。
MobArena的使用（配置完成后可以开始享受成果了）
