MobArena

已检索到其他语言的内容，请协助搬运外文内容至本页面，并翻译为本地化的中文。

点击此处开始搬运。（搬运完毕后请移除本模板并添加“待翻译”模板）

MobArena

外文名	MobArena
插件类型	Spigot / CraftBukkit
最新版本	v0.96.9
兼容服务端	1.8.1
源地址	http://dev.bukkit.org/bukkit-plugins/mobarena/

安装

安装MobArena其实很简单，只需以下四步:

• 关闭服务器咳咳，当然是关你自己的服务器啦.
• 从论坛主题或是Bukkit Dev站点的项目页下载jar文件.
• 将jar文件拖入服务端的plugins文件夹中.
• 重启服务端.

之后，配置文件 (config.yml) 以及一个宣告文本(announcements.yml) 会自动创建在plugins/MobArena/路径下. 文件结构如下:

plugins/
    MobArena.jar
    MobArena/
        config.yml
        announcements.yml

此时此刻, 或许你想直接开始设置竞技场, 但是你需要先看看配置文件，并把它配置成你喜欢的样子就是说，还是根据情况配置一下吧. 你可以在配置文件自定义MobArena的设置，职业，奖励，波数（怪物类型）

建立竞技场

建造一个竞技场

完整的竞技场应该包含一个可以选择职业的准备区域，一个竞技场地以及观察点(离开点) 下面是各个选项的讲解

大厅：

玩家加入游戏之前将会在大厅选择职业.一个建造好的游戏大厅会有每一个职业的选择牌子，玩家通过点击牌子可以获取一个职业, 还有一个铁块, 玩家可以通过点击铁块来表示他们已经准备好开始游戏.牌子必须在第一行写上职业的名字（区分大小写）,但是无论你在另外三行上写什么，都不会被怪物竞技场识别，你是不能写上 ,所以你不会得到确认的信息（如果有，那是另一个插件）

竞技场地：

这里是玩家和怪物搏斗的地方.竞技场地会有墙，可能会有一个屋顶 , 这样玩家和怪物就不能跑出去了. 这使得玩家们不会只是在竞技场外闲逛。.

观察点:

当玩家想要观看一场战斗时,他们可以使用/ma spec 命令来传送到竞技场的观察点. 这同样也是竞技场中玩家死去后会传送到的地方,前提是在配置文件中，把 spectate-after-death设置为ture. 这块区域要保证观看者不能走出去闲逛（进入竞技场地或者离远竞技场）因为在观看过程中，玩家是无敌的.

离开点:

在使用 /ma leave命令后,玩家和观察者会被传送到原来所在的地方,除非竞技场有一个离开点(只是可选). 使用离开点,可以准确控制玩家在游戏后去何处.

关于区域，传送点等，

当竞技场建好后，就是设置怪物竞技场的区域和传送点的时候了。在设置它们前，我们先来看看他们有什么作用.

区域:

一个竞技场需要一个竞技区域,然后还可以有一个准备区域，怪物竞技场会使用这些区域来确保玩家不会作弊（通过破坏竞技场来走出区域）,然后确保怪物竞技场所产生的怪物会在里面产生. 怪物竞技场非常排外（不要局外人）, 所以也最好把不想要的生物排除在外. 区域是通过区域工具来设置的.

传送点:

当玩家加入一个怪物竞技场的游戏时，他们会被传送到准备区域中的准备点来选择职业和准备开始游戏（通过点击铁块）.当每个人都准备好的时候，玩家会被传送到竞技场内的竞技场出生点。观察者会被传送到竞技场的观察点来进入观察区域,当游戏结束的时候，玩家和观察者会被传送到他们传送来之前的地方，或者去可选的离开点,传送点会用传送点工具来设置。.

出生点:

这里的出生点指的是怪物出生的地点.怪物竞技场只会在附近有玩家的出生点产出怪物（十五个方格的半径）.需要注意的是，怪物的数量不随着按照出生点的数量改变，只会因为在配置文件中波数的倍率改变和玩家的数量所改变.出生点可以通过出生点工具来设置。.

容器:

容器就是竞技场里的箱子，回收站等。 这些容器将会在一场游戏后重置其内部空间为初始值。只有被声明了的容器才会更新其存储空间，所以仅仅在竞技场里放一个箱子可不够 - 它还需要被用工具声明。

设置模式

我们能用配置模式来设置竞技场。 当我们进入配置模式时，物品栏将会被保存 并给我们一套金工具 （工具栏）， 每一个都有其独特作用。同时我们也可以飞行，使得我们在竞技场附近移动时更加快捷方便一些，最后，但不是绝对，我们不能够聊天或者使用普通命令如果在在配置模式下的话，因为配置模式和你建立起了独立会话（即你所发表的信息都是针对插件的。）

进入设置模式的方法：输入/ma setup 竞技场名，值得提醒的是，如果服务器中只有一个竞技场，你不用输入竞技场的名字，如果竞技场没有设置完毕或者没有被创造，首先使用/ma addarena 竞技场名来创造它

离开设置模式的方法：聊天框内输入done，注意不是命令，是聊天信息，没有斜杠

另外，如果你刚安装怪物竞技场插件，会有一个预置的，名称为default竞技场存在于配置文件中，如果你想要一个不同的名字，你需要先创造一个新竞技场然后把原来的竞技场使用/ma delarena default来删除

下面我们会提到在设置模式中有什么命令可以使用。

设置模式的命令

Setup Mode is an isolated conversation, which means Setup Mode will intercept everything we type. The reason for this is that it makes the commands in Setup Mode shorter (e.g. exp instead of /ma expandregion), and it also prevents us from accidentally typing commands from other plugins.

Below is a list of all the commands we can use in Setup Mode. Many of the commands have short-hand aliases which might make them even faster to type out. As an example, the expand command has the alias exp. Sometimes it's easier to remember the longer names, but the short-hand aliases are provided for faster setup.

done

Leave Setup Mode.
Aliases: end stop done quit

help

Display help screen.
Aliases: ? h

missing

Display a list of missing (mandatory) regions, warps, and points.
This command is useful if you have forgotten how far you are in the setup process, and what you still need to set up.
Aliases: miss

expand <region> <amount> <direction>

Expand a region by some amount in some direction.
Valid regions: ar for the arena region, or lr for the lobby region
Valid amounts: positive integers (whole numbers)
Valid directions: up, down, or out
Example: expand ar 5 up
Aliases: exp

show [<region>|<warp>|<point>]

 Show a region, warp, or point(s) as red wool blocks.
 Valid regions: ar for the arena region, or lr for the lobby region
 Valid warps: arena, lobby, spec, exit
 Valid points: spawns (or just sp) for spawnpoints, chests (or just c) for chests
 Example: show sp

设置时的工具

The Toolbox is a set of golden tools, where each tool has a specific function. We will use these tools to set up the regions, warps, and points of our arena. The tools are used by left- or right-clicking a block while holding them, and the actions vary depending on the specific tool.

Note that the functions of a tool are described in the item tooltip, which we can see by opening up our inventory and hovering our mouse over the tools.

区域工具

The arena and lobby regions can be set up using the Region tools (axe). There are two golden axes in the Toolbox, and they both behave the same, except that one is for the arena region, and the other is for the lobby region. The tools are named accordingly, and they will display either "Arena Region" or "Lobby Region" above the quickbar when we select them.

Note that the behavior of the Region tools is similar to that of the WorldEdit wand (wooden axe), so if you are familiar with defining regions in WorldEdit, the Region tools should feel familiar.

Left-click: Set the first point to be the location of the target block
Right-click: Set the second point to be the location of the target block

Upon setting both points, the region will be defined. Type show ar (or show lr) to check that the region spans the desired area. If the region is a little bit too small, use the expand command (see above) to make it a little bigger.

Note: The region MUST look like a box (3D) and not a rectangle (2D). If the region is just a rectangle, your arena will not work correctly. The same applies if the arena floor is not fully contained in the box, so make sure to expand the region down a block or two to be sure.

玩家传送点工具

The arena, lobby, spectator, and exit warps can be set up using the Warps tool (hoe). The tool knows about all the warps, and we have to cycle through them to select the warp we want to place. The default selected warp is the arena warp.

Left-click: Set the currently selected warp on top of the target block
Right-click: Cycle between available warps

When left-clicking, the selected warp will be set to the top of the clicked block. The pitch (up and down) will be set to 0, which means when players are teleported, they will be looking "straight ahead". The yaw (rotation, left/right) will be set to whatever direction we are facing, when we set the warp. This means that we need to rotate ourselves to be looking in the direction we want the players to look in when they are teleported to the point.

Note: The arena, lobby, and spectator warps are all required. The exit warp is optional.

怪物产生点工具

The spawnpoints can be set up using the Spawnpoints tool (sword). The tool knows about all the spawnpoints of the arena, and allows us to remove existing ones or add new ones as we please.

Left-click: Add a spawnpoint on top of the target block
Right-click: Remove the spawnpoint on top of the target block (if the spawnpoint exists)

When left-clicking, a spawnpoint will be added on top of the clicked block, if one doesn't already exist. Right-clicking a block will remove a spawnpoint on that block, if one exists.

Note: Due to limitations and "bugs" in Minecraft, it is not possible (read: viable) to spawn mobs further than 15 blocks away from a player, and still make it target and attack the player naturally. Therefore, it is recommended to place many spawnpoints, so that every single location in the arena is within a 15-block radius of a spawnpoint. If a player is not within 15 blocks of any spawnpoint, MobArena will print a warning to the console with the coordinates. If no players are within 15 blocks of any spawnpoint, MobArena will default to using all spawnpoints, which may result in mobs spawning far away from players, so they will have to run around searching for them.

容器工具

The chests and containers can be set up using the Chests tool (spade). It works very much like the Spawnpoints tool, but requires that the clicked block is a valid container.

Left-click: Register the clicked container (if it wasn't registered)
Right-click: Unregister the clicked container (if it was registered)

When left-clicking a container, MobArena will register the container (if it wasn't registered already), such that when an arena session ends, the container will be restored to contain whatever was in it when the arena began. Right-clicking a container will unregister it.

命令

玩家命令

这些指令能够给所有玩家使用. 它们包括了加入, 离开, 旁观和列出所有竞技场(可用或不可用)

/ma join (<竞技场>) or /ma j (<竞技场>) - 加入指定名称的竞技场.
/ma leave or /ma l - 离开竞技场或是离开旁观者模式.
/ma notready - 获取所有未准备的玩家.
/ma spec (<竞技场>) or /ma s (<竞技场>) - 以旁观者模式加入指定名称竞技场.
/ma arenas - 获取所有竞技场的名字, 若是绿色则已启用, 灰色则未启用.
/ma players - 获取当前所有竞技场的所有玩家.
/ma players <竞技场> - 获取指定竞技场的所有玩家.
/ma class <职业> - 如果你在大厅里, 是应直接用指令而不是透过牌子互动选择职业.

管理员指令

只有后台或者服务器op能使用下面这些指令. 这里包括了开始或是停止竞技场, 启用或是卸载竞技场甚至包含了MobArena的所有管理.

/ma enable - 启用MobArena插件.
/ma disable - 卸载MobArena插件.
/ma enable <竞技场> - 启用指定名字的竞技场.
/ma disable <竞技场> - 关闭指定名字的竞技场.
/ma force end - 停止所有竞技场的运作.
/ma force end <竞技场> - 停止指定名称竞技场的运作及使该竞技场的所有玩家离开. 
/ma force start <竞技场> - 开始运作一个指定名称的竞技场以及请出该竞技场内未准备的玩家.
/ma notready <竞技场> - 获取该竞技场内所有未准备的玩家.
/ma restore <玩家> - 在可能的情况下恢复指定玩家背包.
/ma config reload - 重载config配置文件夹.

建设指令

只有op (以及某些合理的指令能在后台) 使用这些指令. 它们包括了设置竞技场传送点, 竞技场出生点以及竞技场范围.

/ma setup <竞技场> - 进入建设指定名称的竞技场模式.
/ma addarena <竞技场> - 建立一个新的竞技场节点于当前所在世界.
/ma delarena <竞技场> - 删除指定名称的竞技场.
/ma editarena <竞技场> - 开启或关闭指定竞技场修改模式.
/ma editarena <竞技场> [true|false] - 开启 (true) 或关闭 (false) 指定竞技场的修改模式.
/ma setting <竞技场> - 列出所有指定竞技场的设置项.
/ma setting <竞技场> <设置项> - 查询当前指定设置项的值于指定的竞技场.
/ma setting <竞技场> <设置项> <值> - 设置指定竞技场中指定设置项的指定值.
/ma checkspawns - 显示竞技场出生点 (在你当前的竞技场下) 是使用红色羊毛覆盖的范围在当前你当前的位置上. 这个指令同时也能查询在这个范围内不同的点是否被出生点覆盖着.
/ma classchest <职业> - 当正在查询箱子, 使指定的职业与这个箱子建立连接. 连接一个职业箱子意味着当MobArena连接建立后, 将同时复制于职业箱子内的物品, 而不是于竞技场大厅内的任何职业箱子. 当你建立一个职业箱子网络时它能带给你便利.
/ma auto-generate <竞技场> - 自动生成一个指定名称的竞技场. 这个竞技场只会生成于玩家所站的位置下方.
/ma auto-degenerate <竞技场> - 自动停止生成竞技场, 能基于自动生成器下有效地恢复, 当这是一个 "bulldozed" 补丁.

权限

A permissions plugin is NOT required for MobArena to work, but if you want that extra bit of control, here's a rundown of the different types of permission nodes you can use with MobArena.

NOTE: MobArena uses sane defaults. This means that by default, all players can use all arenas and all classes, and ops can use all admin and setup commands. Unless you want to prevent some groups from accessing certain arenas or classes, or you want to give non-ops admin and setup permissions, there is no need to mess with any permissions at all, so go away from this page and remove all occurrences of mobarena in your permissions-file!

竞技场权限

Did you read the note at the top? If not, read it before you continue.

So, you want to remove permissions for certain arenas from certain users? Alright, that means you will have to negate or revoke the permissions in your permissions plugin. In bPermissions, the negation modifier is a caret, ^, in GroupManager and PermissionsEx it is a minus, -, and in zPermissions it is by setting the permission to false. The examples below revoke the permission for the default arena.

bPermissions: ^mobarena.arenas.default
GroupManager: -mobarena.arenas.default
zPermissions: mobarena.arenas.default: false

I recommend letting everyone enjoy all your arenas, but this could be used in combination with "leveling" plugins to allow players to use "harder" arenas at higher levels. It could also be used for sponsors-only arenas.

Still confused? Check the sample setup at the bottom of the page!

职业权限

Did you read the note at the top? If not, read it before you continue.

Alright, if you're reading this, you want to remove permissions for certain classes from certain users. As with the arena permissions, you need to negate or revoke the permissions in your permissions plugin. In bPermissions, the negation modifier is a caret, ^, in GroupManager and PermissionsEx it is a minus, -, and in zPermissions it is by setting the permission to false. The examples below revoke the permission for the Knight class.

bPermissions: ^mobarena.classes.knight
GroupManager: -mobarena.classes.knight
zPermissions: mobarena.classes.knight: false

Note how the class name is lowercase. This is important. Even if the Knight class is called KnIGhT in your config-file, it MUST be all lowercase in your permissions-file.

As with arenas, I recommend letting everyone enjoy all the classes, unless you have a special reason not to.

Still confused? Check the sample setup at the bottom of the page!

命令权限

Did you read the note at the top? If not, read it before you continue.

If you're reading this, you want to either give certain users access to some of the admin and/or setup commands, or you want to remove some of the user commands from some groups. If this is not the case, stop reading and leave this page!

The first group of commands are the user commands. They are accessible by all players by default, so don't put mobarena.use.* or something stupid like that in your permissions-file! If you want a group to not have access to the user commands, negate the permission mobarena.use, which is the parent permission node for all the user commands. See the classes and arenas sections for information on how to negate permissions. If that doesn't work, negate the mobarena.use.join and mobarena.use.spec permissions. That should be enough.

mobarena.use.join
mobarena.use.leave
mobarena.use.spec
mobarena.use.arenalist
mobarena.use.playerlist
mobarena.use.notready
mobarena.use.class

The admin commands are simple. They allow disabling/enabling MobArena and individual arenas, kicking players from the arenas, restoring player inventories if they got lost somehow, forcing arenas to start or end, and teleporting in and out of arenas regardless of what the arena state is. If you want to grant all of these permissions, use the parent permission node mobarena.admin. Don't mess around with * or something stupid like that.

mobarena.admin.enable
mobarena.admin.kick
mobarena.admin.restore
mobarena.admin.force
mobarena.admin.teleport

Setup commands are only for ops, just like admin commands. Do not give these permissions to random people, because they can remove your arenas and destroy your config-files, if they do something stupid. The setup commands allow you to manage arenas, regions, spawnpoints, chests, leaderboards, etc. They also allow you to set up new classes in-game. If you want to grant all of these permissions, use the parent permission node mobarena.setup. Don't mess around with * or something stupid like that.

mobarena.setup.config
mobarena.setup.setup
mobarena.setup.setting
mobarena.setup.addarena
mobarena.setup.removearena
mobarena.setup.editarena
mobarena.setup.spawnpoints
mobarena.setup.containers
mobarena.setup.checkdata
mobarena.setup.checkspawns
mobarena.setup.classchest
mobarena.setup.classes
mobarena.setup.leaderboards
mobarena.setup.autogenerate
mobarena.setup.autodegenerate

Sample setup

Assume you have a class called DiamondKnight that you only want your donors to be able to use (very common use case). How do you set up your permissions plugin when you have to revoke the class permission from the default group, but the donor group inherits from the default group? It's very simple: You're doing it wrong...

What you have to do instead is make an auxiliary default-group that contains all your default permissions, and have your default group inherit from that group, and furthermore revoke the DiamondKnight class permission in MobArena. Your donor group then also inherits from the auxiliary group, and everything is wonderful. Confusing? Here's a pseudo-code example:

default-aux:                            <-- This is the auxiliary group that is to
  permissions:                              be inherited by the default group and
  - essentials.balance                      the donor group. It is not used for
  - essentials.pay                          anything else.
  - essentials.sell

default:                                <-- This is the default group. It inherits
  inherits: default-aux                     from default-aux, but also revokes the
  permissions:                              permission for the special class.
    - -mobarena.classes.diamondknight

donor:                                  <-- This is the donor group, which also
  inherits: default-aux                     inherits from default-aux, but it
  permissions:                              does not revoke any class permissions,
   - essentials.balance.others               which means it has access to all of
   - essentials.kit                          them by default.

This sample setup is pseudo code and cannot be simply copy/pasted into your own permissions file. It's your job to figure out how your permissions plugin works, and what its syntax is.

怪物种类（Monster types待搬运）

以上内容搬运自英文wiki[1]