查看“Multiverse-Core”的源代码

{{Bukkit Plugin Infobox
|插件名= Multiverse-Core
|版本= 2.5-b717
|兼容服务端版本=1.9
|作者= MultiverseTeam
|網址= http://dev.bukkit.org/bukkit-plugins/multiverse-core/
}}
==基础==
===安装===
欢迎。我们很高兴你能够来查看我们卑微简陋的Wiki页面。

这里是非常简单的安装指南，并没有任何其他的东西！

要想查看英文语言的视频教程请查看[[https://www.youtube.com/watch?v=CN0MA_TykSk 这里]]，感谢 Koz4Christ 的贡献。

要想查看西班牙语的视频教程请查看[[https://www.youtube.com/watch?v=VJYISGaFuCw 这里]]，感谢 LastWishSpain 的贡献。

※※ 在你安装多世界插件之前，你需要做一些准备工作。

※※※ 这取决于你正在运行服务器的 CraftBukkit 的构建版本。

你需要挑选符合版本的 Multiverse 插件。

详情请去[[https://dev.bukkit.org/projects/multiverse-core/files 这里]]选择。

要想弄清你服务端的版本，去你的控制台（或游戏内）输入 version （在游戏中请输入 /version）。

你能够看到一条类似于下面的消息。

...

XX:XX:XX [INFO] This server is running Craftbukkit version git-Bukkit-1.1-R1-b1818jnks (MC: 1.1) (Implementing API version 1.1-R1)

...


仔细看第一行，在最末尾你能够看到——

Implementing API version 1.1-R1

这告诉你你的Bukkit的版本。

如果你看到了 1.1-R1 这种，你的版本就是'''正式版'''。

如果你看到了 1.1-R1-SNAPSHOT 这种，你的版本是'''开发'''版本。

这样，你就能得到你的 CraftBukkit 版本了，将其与上面的网页中的文件对应。

※※※可选项：我们强烈推荐你安装一个权限插件。

我们测试时使用的权限插件是 [[http://dev.bukkit.org/server-mods/permbukkit/ PermissionsBukkit]] ，但你可可以使用执行 SuperPerms API 的权限插件，这儿列出了一些——

* [[http://dev.bukkit.org/server-mods/bpermissions/ bPerms]]
* [[http://dev.bukkit.org/server-mods/groupmanager/ GroupManager]]
* [[http://dev.bukkit.org/server-mods/permbukkit/ PermissionsBukkit]]
* [[http://dev.bukkit.org/server-mods/permissionsex/ PEX]]
* [[http://dev.bukkit.org/server-mods/privileges/ Privileges]]

后面的向导能够帮助你设置权限，但你现在也可以去下面看一看。

'''第一步'''

抓取你的Jar文件，你可以从[[http://dev.bukkit.org/server-mods/multiverse-core/files/ 这儿]]获得正式版的 Multiverse-Core Jar 文件，或者从[[http://ci.onarandombox.com/job/Multiverse-Core/ 这儿]]获取开发构建版本。

当前你不能获取Zip压缩文件。

Multiverse-Core（以及所有 MV 系列的插件）都会在第一次运行时创建默认的配置文件。

※可选项：安装 [[http://dev.bukkit.org/server-mods/multiverse-portals/files/ 多世界传送门]] 与 [[http://dev.bukkit.org/server-mods/multiverse-netherportals/files/ 多世界地狱传送门]] 插件！

将 Jar 文件放在你的插件文件夹里，就像这样：

[[文件:Mv-01.png]]

'''第二步'''

开启你的服务器，然后就没了——我很认真的。

===基础设置===
====介绍====
Multiverse-Core提供世界的创建功能。

它可以控制怪物的生成，环境的种类，启用自定义的地形生成器，当然功能有更多。

尽管Multiverse-Core能够做到这些，但是请注意Multiverse-Core插件本身是无法创建世界的，它仅仅是调用了Bukkit-API来创建新的世界。

如果同时存在其它能够创建世界的插件，那么就很有可能会与本插件发生冲突。

《盗梦空间》就是一个很好的例子，在冲突的确发生前许多恐怖的故事都已经讲完了。

（很明显地，Multiverse-Core能够与一些插件共存，但与其它插件则不一定兼容。）

另一个警告是，Bukkit仍控制着创建的世界；Multiverse会尽其所能来控制世界的行为，

但最终，其它插件或是Bukkit服务端所发生的意外都有可能覆盖、重置已有的设置。

插件开发与测试者已经完成了包括 Multiverse-Core 工具在内的这些极棒的工作来帮助你快速容易地解决这些问题。
====上传已经创建好的世界====
如果你是一名服务器的OP，当你在安装 Multiverse-Core 插件后，首次登入游戏时，你将会收到以下的提示信息：

[[文件:Mv-02.png]]

这些信息表明，尽管你可能已经在服务端上传了存档，你也需要将这些世界告知 Multiverse-Core 插件。

这样做的原因是我们不知道你的主世界的类型——普通世界或甚至是漂浮的空岛！

要想告知 Multiverse-Core 插件这些世界，操作很简单。输入：

/mv import WORLD ENV

现在你需要将 WORLD 替换为文件夹的名称，将 ENV 替换为环境类型。

当前可选的环境类型有三种：normal(普通), nether(地狱)和 end(末地)。

如果你忘记了类型的名称，你可以使用 /mv env 来查看这些选项。

这个指令会列出所有可用的环境类型。

大多数服务器会将主世界的文件夹命名为world(即默认)。这里是我输入的一个示例：

[[文件:Mv-03.png]]

你将会看到的结果是：

[[文件:Mv-04.png]]

好了！现在你只需要将你所有的世界重复以上过程即可完成载入。

（不喜欢你的文件夹名称？不需要重命名文件夹，仅仅需要设置 Multiverse 世界别名就好了！）

====创建你的第一个世界====
现在，你已经导入了你的主世界和地狱世界，但是现在你想要一个创造模式的世界！

世界的创建是一个十分简单的过程，神奇的调用指令如下：

/mv create {NAME} {ENV} -s [SEED] -g [GENERATOR[:ID]]

不要担心这些参数，你只需要知道{}之中的内容是必填的，[]中的内容则是选填的即可。

举个例子，我们输入

/mv create creative NORMAL

这个过程所需要的时间比上传存档要长一些，你可以在服务器的控制台看到整个世界的创建过程。

这个命令创建了一个名为"creative"的世界，整个世界的环境类型为normal（主世界类型）。

如果你很聪明的话，你也可以设置种子，或将世界类型转换为 NETHER（地狱） 或 END（末地） 。

或者如果你真的很聪明的话，你可以找出如何设置地形创建器来创建特别酷的各种地形（如：-g BukkitFullOfMoon）。

让我们暂时不要担心这个问题。

通过这些步骤，你的新世界应该就创建好了。欢呼吧！

※※在你创建世界之后传送到你的世界中吧，那多棒！

但是，你需要知道怎么传送，不是吗？

好的，那也很简单，你只需要输入：

/mv tp testworld

现在你应该已经到达了新世界。

如果你想要带你的朋友过来，并且你的朋友不介意的话，你只需要输入：

/mv tp YOURMATE testworld

==== 设置新世界的出生点 ====

新世界的(0,0)坐标并不总是理想的出生点。

你也不想让玩家在传送到新世界或在新世界重生时就坠入虚空吧？

无论你是走，是爬，还是挖到你想要的新出生点的地方，站在上面，然后输入：

/mv setspawn

即可完成新世界出生点的设置。

就像魔法一样！

==== 回到出生点 ====
哦，不！你在你的新世界中目录了！你需要回到出生点！

很好，那很简单：

/mv spawn

欢呼！欢迎回家！

==== 修改一些参数 ====
嗯，你对苦力怕爆炸造成一些东西的丢失感到很厌烦吗？

或者你想要关闭敌对生物的生成？

没问题！

/mv modify set monsters false

你可以很轻松地修改其他设置（例如关闭动物生成和PvP）

==== 清除怪物以及其它实体 ====
你可能很厌烦大量的动物挡住了去你的建筑的道路。

可能一些愚蠢的OP在你建筑时生成了大量的牛。

没关系！只需要输入以下命令即可清除指定世界的所有动物：

/mv purge testworld animals

你也可以将 testworld 替换为 ALL 来对全部世界执行清理命令。

除了动物，你还可以指定一个列表中的怪物来清除。

列表的各个项之间用逗号分离。

你可以将 animals 替换为 monsters ，或替换为 all ——这会清除所有怪物。

==== 移除你的世界 ====
你对这个世界已经厌烦了！你想放弃它！

好，接下来你就可以摧毁这个世界！

要想摧毁它，请输入：

/mv delete testworld

[[文件:Mv-05.png]]

你有十秒钟的时间来确认这个命令，通过输入以下命令来确认操作：

/mv confirm

记住，一旦确认执行命令，这个世界将会被完全地移除。

完全移除，无法恢复——永远。

使用这个指令要尤其小心了！

==== 总结 ====
以上就是本节的全部内容。

想了解更多进阶的使用方法，请在游戏中输入 /mv 命令或是查看命令参考页面。

这里值得一提的是，我们已经在本教程中讲解了很多冗长的命令。

想要了解某个具体的命令，只需要在游戏中输入：

/COMMAND ?

然后插件将会为你展示该指令的详细内容。

注意：90%的Multiverse命令可以在控制台执行。

只有部分需要指定其它变量的命令才无法在控制台使用，

例如:/mv setspawn（需要脚下方块作为选定点，所以无法在控制台中使用。）
===权限===
注意：你可以在下面查看完整的 Multiverse-Core 插件命令。

==== Multiverse 插件支持的权限插件列表 ====
Multiverse 系列插件支持使用 SuperPerms Bukkit Permissions API 的任何权限插件。

当前（最后查阅时间为 2012/1/19）所有支持的权限插件有：

PermissionsBukkit ， bPerms ， PEX 以及 GroupManager。

==== Multiverse 进入世界权限 ====
Multiverse 允许你通过权限来控制谁可以进入世界！

当你创建世界或将世界导入 Multiverse-Core 插件时，本插件会自动创建一条权限：

multiverse.access.世界名

如果玩家拥有 multiverse.access.世界名 权限的话，他们就可以进入该世界。

注意：请确保你在你的 Multiverse 插件的 config.yml 配置文件中启用了 enforceaccess 项。

如果 enforceaccess 项被设置为 false 的话，所有人都可以去任何的世界，并且需要权限才能进入指定世界的设定会被忽略。

如果你给某些玩家 multiverse.access.* 权限的话，他们就可以去所有世界。

==== 关于 PermissionsBukkit ====
[[http://forums.bukkit.org/threads/26785 PermissionsBukkit]]是一款官方的Bukkit插件，它能够通过使用新的 [[http://forums.bukkit.org/threads/25080/ Permissions API]] 管理权限。

其它的权限插件可能也会合并本 API 来管理你的服务器的权限，但是我们当前测试所用的权限插件是官方的插件（[[http://forums.bukkit.org/threads/26785 PermissionsBukkit]]）。

幸运的是，[[http://forums.bukkit.org/threads/26785 PermissionsBukkit]]插件为其它插件建立的一座桥梁能够让仍然需要 Permissions 2.7/3.1 请求的插件去请求和处理它们。

但对于 Multiverse 2 插件来说你不需要使用这座权限的桥梁。

==== PermissionsBukkit 插件的 config.yml ====
注意：这是存在于插件目录 PermissionsBukkit 文件夹下的 config.yml！

在配置文件中设置权限也很简单。

你可能发现它很类似于以前的权限插件。

这是包括一些 Multiverse 2 插件权限的一个示例配置文件：

<nowiki>
    users:    
        myplayername:
            permissions:
            groups:
            - admin
    groups:
        default:
            permissions:
                permissions.build: false
                multiverse.core.tp.self: true
        admin:
            permissions:
                permissions.*: true
                multiverse.world.create: true
            inheritance:
            - default
    messages:
        build: '&c你没有权限在这里建筑。'
</nowiki>

这样设置以后，所有用户都有权限通过使用 /mvtp 命令传送它们自己，

同时属于 admin 权限组的所有玩家会有创建世界的权限。

注意 admin 权限组拥有 permissions.*: true 配置项，因此在该权限组中的玩家能够在游戏中使用 PermissionsBukkit 插件的命令。

这对于 Multiverse 2 插件来说是尤其有用的。

===== MV2 的权限 =====
你可以将 multiverse.* 权限给予某玩家来给予他所有 Multiverse 指令的权限。

如果你仅仅想让某玩家能够在各个世界间任意移动不受限制的话，请给他们 multiverse.access.* 权限。

===杂项===





=== 部分名词说明 === 
阀值 -------- true开启 false关闭

== 权限 ==

•帮助权限
   multiverse.help——允许拥有该权限的用户使用/mv查看指令帮助


•访问权限
   multiverse.access.NAME——允许拥有该权限的用户去指定的世界
   multiverse.exempt.NAME——允许拥有该权限的用户去指定的世界无需access权限
   mv.bypass.gamemode.NAME- - -允许拥有该权限的用户可以保持模式去往各个世界，如果一个玩家拥有mv.bypass.gamemode.*权限，可以保持他的创造模式去往生存模式的世界.


•传送的权限
   multiverse.teleport.self.NAME——允许拥有该权限的用户可以使用/mv tp [PLAYER] {WORLD}传送自己进入一个指定世界
   multiverse.teleport.other.NAME——允许拥有该权限的用户可以使用/mv tp [PLAYER] {WORLD}传送自己和他人进入一个指定的世界


•信息权限
   multiverse.core.confirm——拥有该权限的用户使用/mv confirm可以确认使用上一个指令
   multiverse.core.coord——拥有该权限的用户可以使用/mv coord显示当前坐标
   multiverse.core.info——拥有该权限的用户可以使用/mv info显示当前世界
   multiverse.core.list.environments——拥有该权限的用户可以使用/mv env显示有效的环境
   multiverse.core.list.who——拥有该权限的用户可以使用/mv who显示目前世界
   multiverse.core.list.worlds——拥有该权限的用户可以使用/mv list显示你可以进入的世界
   multiverse.core.version——允许拥有该权限的用户可以使用/mv version 查看版本信息
   multiverse.core.generator——允许拥有该权限的用户可以使用/mv generators 列出生成器插件

•出生点的权限
   multiverse.core.spawn.other——允许拥有该权限的用户可以使用/mv spawn *把别人传送去出生点
   multiverse.core.spawn.self——允许拥有该权限的用户可以使用/mv spawn 把自己传送去出生点
   multiverse.core.spawn.set——允许拥有该权限的用户可以使用/mv spawn set设置世界的出生点

•编辑世界的权限
   multiverse.core.create——允许拥有该权限的用户可以使用/mv create创建世界
   multiverse.core.delete——允许拥有该权限的用户可以使用/mv delete {WORLD}删除世界
   multiverse.core.load——允许拥有该权限的用户可以使用/mv load加载世界
   multiverse.core.unload——允许拥有该权限的用户可以使用/mv unload {WORLD}暂时卸载世界
   multiverse.core.remove——允许拥有该权限的用户可以使用/mv remove {WORLD}从 Multiverse 中卸载一个世界并移除worlds.yml内相应世界信息, 这个指令不会删除该世界文件夹.
   multiverse.core.import——允许拥有该权限的用户可以使用/mv import转换一个世界为指定类型

   multiverse.core.modify——允许拥有该权限的用户可以使用/mv modify修改世界各个方面的设置
   multiverse.core.modify.add——允许拥有该权限的用户可以使用/mv modify add 添加世界参数
   multiverse.core.modify.clear——允许拥有该权限的用户可以使用/mv modify clear 移除所有设置的值. 设置将在所有包含的列表里生效
   multiverse.core.modify.modify——未知
   multiverse.core.modify.remove——允许拥有该权限的用户可以使用/mv modify remove 移除世界参数
   multiverse.core.modify.set——允许拥有该权限的用户可以使用/mv modify set 设置世界参数
   multiverse.core.purge——允许拥有该权限的用户可以使用/mv purge [WORLD|all] {all|animals|monsters|MOBNAME}从指定世界清除掉指定类型的生物

   multiverse.core.reload——允许拥有该权限的用户可以使用/mv reload重新加载配置文件

•设置的权限
   multiverse.core.config——允许拥有该权限的用户可以使用/mv config 修改全局配置
   multiverse.core.debug——允许拥有该权限的用户可以使用/mv debug切换调试模式
   multiverse.core.silent——允许拥有该权限的用户可以使用/mv silent 切换沉默模式

•有待编辑的权限
   multiverse.core.anchor
   multiverse.core.sleep
   multiverse.core.spout
   multiverse.core.tp.*
   multiverse.core.tp.self
=== '''<big>Config</big>''' ===
 下面是Multiverse-Core（2.9版本）默认Config.yml文件，我们会尽可能地保持和Multiverse-Core更新同步.
*<big>首先，请确保你的Multiverse-Core已经是最新版本.</big>
 在后台输入这个指令<code>/mv version</code>即会弹出下列数据：
<nowiki>
...</nowiki><br />
XX:XX:XX [INFO] [Multiverse-Core] [Multiverse-Core] Dumping Config Values: (version 2.9)<br />
...
 后面显示的，就是你当前Multiverse-Core的正确版本.如果'''你的版本号与下面例子中的版本（2.9）不一致'''，请立即更新你的'''Multiverse-Core'''<br />
 （当然，如果大同小异的话用也没什么不合适）以及所有'''有关Multiverse的插件'''.
*<big>Config.</big>
'''#这是一个内部设置，请不要动它.'''<br />
multiverse-configuration:<br />
:'''# 这是一个让Multiverse-Core更加高效运行的设置.请不要动它.'''<br />
:==: com.onarandombox.MultiverseCore.MultiverseCoreConfiguration
:'''# 如果设置为false，那么Multiverse-Core将不会强制管理'''
:'''# 每个世界的通过权限.(在其它多世界插件范围内）'''
:enforceaccess: 'false'
:'''# 如果这个设置为true，那么Multiverse-Core就会在聊天名称前加上'''
:'''# 你定义的多彩世界前缀；如果这个设置为空，那么Multiverse-Core就会'''
:'''# 在聊天名称前加上白色单调的世界前缀；如果这个设置为false，那么'''
:'''# Multiverse-Core将不会干预聊天窗口.'''
:prefixchat: 'true'
:'''# 如果这个设置为true，那么Multiverse-Core将强制管理每个'''
:'''# 世界的通过权限.（在所有插件范围内）'''
:teleportintercept: 'true'
:'''# 如果这个设置为true，玩家将会被提示他们可以使用多世界的哪些命令.'''
:'''# 如果设置为false，他们将不会知道自己能使用什么命令.'''
:displaypermerrors: 'true'
:'''# 如果这个设置为true，将应用Multiverse-Core出生点设置'''
:'''# 设置为false应用其它出身点管理插件的设置（如果你有的话）'''
:firstspawnoverride: 'true'
:'''# 以下是你想让新玩家出生的世界名.'''
:'''# 如果这个世界名没有对应文件,将会被自动创建.'''
:firstspawnworld: Lobby_World
:'''# 给玩家发送信息的时间间隔'''
:'''# 单位：毫秒 - 5000=5秒'''
:messagecooldown: '5000'

:'''# 玩家使用'''<code>/MVTP</code>'''时间间隔'''
:'''# 单位：毫秒 - 1000=1秒'''
:'''# 如果你上面的'teleportintercept'设置为'true','''
:'''# 那么所有插件的TP（例如/tpa）都会受到限制.'''
:teleportcooldown: '1000'
:'''# 调试模式设置.值为0~3'''
:'''# 除非你是wiki编译者或者插件开发者，否则不要动.'''
:globaldebug: '0'
:'''# 版本号
:'''# 请不要修改这个值
:version: '2.9'
:'''# 搜索传送门范围.这是Bukkit服务端原生功能'''
:'''# 如果设置为true，将允许Multiverse-Core接替Bukkit掌管这一功能'''
:'''# 并应用自己的搜索半径.如果设置为false，Bukkit就会'''
:'''# 使用自己的默认搜索半径.'''
:defaultportalsearch: 'false'
:'''# 如果上面的设置为true，就会应用下面这个搜索半径.
:'''# 注意，搜索传送门范围这一功能仅对Vanilla类型的传送门有效.
:'''# 当然也包括支持Multiverse-NetherPortals的传送门.
:portalsearchradius: '16'