安装

安装本插件十分简单。过程与其他插件相同。将jar文件放入*plugins*文件夹即可。你的插件文件夹应该和服务器核心jar文件，*eula.txt, ops.json, bukkit.yml, logs*等文件夹/文件处于同一级文件夹。如果你没有看到*plugins*文件夹或其他文件，运行服务器，然后这些文件就会被生成。

如果你放入插件的时候服务器正在运行，你需要重启服务器。

## 系统要求

插件没有需要额外人工下载的前置插件，因此首次安装插件无需联网，但安装附属或语言包等需要网络连接。

* Java - 1.8及以上
* Minecraft 版本 - 本插件仅与Minecraft Java版兼容。本插件不能且不会支持与其他软件链接的版本。
* 服务器版本 - 本插件与1.9以上直至Spigot页上的最高版本兼容，但只会支持该大版本的最后一个小版本。以1.14版本为例，插件只会支持*1.14.4*版本，也就是**1.14**全部小版本中的最后一个(补丁)版本，而不支持*1.14, 1.14.1, 1.14.2, 1.14.3*版本。你只会在插件支持的**最高Minecraft版本**中得到**全部**插件功能。

* 软件 - 服务器核心必须为**Spigot或Paper**。本插件不适用于bukkit服务器，但*理论上*应支持Paper及其他Spigot分支服务器。如果不支持，则问题出在服务端核心上而非插件。注意：插件可能在**Forge+Bukkit**, **Java+Bedrock**等服务器核心上不会很好的运转。添加跨平台的服务端软件同理，尤其Magma, Mohist，极度不兼容。

* 硬件 - 本插件倾向于牺牲内存以换取性能，运行一个中等服务器（100人左右）需要至少1GB内存。本插件内置的唯一一个资源占用系统为炮塔系统。插件会尽力让炮塔的攻击间隔接近设置（通常很短），但由于Minecraft Java版的单线程本质，插件对老CPU或低预算CPU有自己的限制。**注意：**这些数字仅为预测，与服务器版本和其他插件无关。
* 客户端 - 插件理论上可以与所有装载模组的客户端兼容，但如果出于某种原因本插件在模组客户端不工作，但在官方无模组客户端上正常，你应该反馈给**客户端**的开发人员。
* 网络连接：
	+ 库
	+ 语言包
	+ 附属

## 插件安装

插件的默认配置偏向于多数服主喜欢选择的选项。所有必要的权限都已默认给予玩家，你也可以移除它们。

本插件对于最新Minecraft版本基本处于“安装即可游玩”模式，但鉴于旧版不支持一些功能，对于其则需要做出一些改动。若不更改可能会导致插件出错。

每项配置均有文字解释，若你有问题可以在任意社区提问。

注意本插件没有任何前置，官方附属也仅有前哨锦标赛，地图兼容，和平条约三个，插件的其他全部功能均包含于插件的jar文件中。本插件也支持其他的一些插件，但仅作兼容之用，并不会为本插件增加任何新功能玩法。

在服务器公开前建议禁用你想要禁用的部分功能，因为在插件保存玩家数据后禁用某些功能可能会导致插件出错，甚至数据损坏。

一个很好的例子就是炮塔/设施的种类（严格意义上来讲应当被称为“风格”），因为等它们被放置后再禁用该炮塔/设施种类不会将方块和全息显示从世界移除，而插件因不知道如何处理它们而不断报错。

库

库指插件*libs*文件夹中的文件。有些库为插件运作所必需，其他则为选择性的。为了不超过Spigot的文件上传大小限制，它们不包含在插件中。不下载特定选项不需要的无用内容也很有帮助。

你可以删除这些文件，但请一次性全部删除。本插件会重新下载它们。

你可以在移动插件文件夹的时候移动这些文件，不会影响它们运作。

重载
--

**永远**不要使用服务器的/reload指令或plugman插件重载本插件！

没错，插件会自动重新读取配置，其中90%的改动会自动应用，但较为复杂的改动需要输入/k reload 或重启服务器应用，其中99%都可以用指令解决。

请注意，自动读取优于插件重启，因为后者会重启整个插件。除非配置未被应用，否则你不应使用后者。

自动检测通常需要五秒钟的时间。如果某项配置需要重启服务器应用，配置文件上方会有注明。

处于上方的原因，本插件会禁用服务器/reload 指令与plugman的重启指令，你无法取消此限制，也请避免一切形式的热重载。

由于Java的应用原因，自动检测在linux机上并不可靠，可能包括两次重载，没有重载，甚至无限重载，但本功能应在Windows系统上运行良好。这无法被避免，所以如果你的服务器有异常行为，请禁用自动检测。

此外，本功能受文本编辑器的影响，与系统无关。例如Vim 和 Sublime会导致重复存档，但本插件会尽力无视这些重复文件。

## 版本升级

如果你升级你的服务器版本，对插件没有任何影响。但你不能回溯至低版本，这会使地图崩坏。升级插件版本应该也没有问题，如果出现问题，你也可以使用备份。

新的消息会被自动添加至语言文件。至于其他配置，你可以使用配置自动更新器，或在github上查看配置的版本历史。也可以使用比较文件改动的工具，例如diffchecker，来检查配置改动。开发组有打算将此过程自动化。

如果你更改了很多设置，更新将会很复杂。简单的时候你只需替换jar文件，而困难的时候如同一场噩梦。此插件的原则之一是它不会牺牲性能与优化（即使是很小的优化也会导致很大的差距）符合配置的兼容性。即便配备了配置自动更新系统，一些选项的格式也可能更改，而系统也无法自动更新这些配置，因为这可能会覆盖掉你的个性化配置。

值得庆幸的是，插件的第二条原则是永远不会有涉及数据重置的大改动，Beta版本除外。

这些配置的大变动并不常见，通常出现在更新循环后的新大版本里。

如果你更新至一个不稳定版本，你应在更新前阅读稳定性词条获取更多信息。

卸载
--

启用了本插件的设施或炮塔，你无法把本插件从服务器中安全移除。移除后它们仍会以方块或物品的形式存在。

如果你准备移除本插件，请记住重置世界与玩家物品栏。

## 兼容性

本插件不与**任何***模组*兼容。

本插件仅与以下几个插件的最新版本兼容（支持v6与v7+的WorldGuard除外）。

* WorldGuard 默认禁用区域内的土地占领。支持16\*256\*16的区块方形检查，意味着即使某区块内仅有一个方块属于WorldGuard区域，该区块也无法被占领。该功能也可以被用于更次要的功能，如在一个WG区域内的土地指示器与前哨区域。如果玩家进入一个使用WorldGuard 额外权限 允许飞行的区域，此项并不会禁用 /k fly 指令。插件支持WorldGuard v6与v7。
	+ kingdoms-claimable 区域内是否允许地块占领（默认为否）。
	+ kingdoms-friendly-fire 玩家是否可以无视王国外交关系互相攻击（默认为否）。
	+ kingdoms-damage-champion 玩家是否可以对区域内的斗士造成伤害（默认为是）。
* DiscordSRV: 将私人聊天频道的消息（如王国内部或盟友间对话）发送至一个特定的Discord频道，同时将全球消息发送至另一个频道。也可以用于播报广播，如入侵通知。
* Citizens: 阻止王国炮塔射击NPC。无需人工设置。
* MyPet/MCPet: 阻止王国炮塔射击被动/中立生物变成的宠物（仅限主人有该王国炮塔停火权限的情况下生效)。
* Vault: 用于赋税，经济等系统，如王国、邦联的存款。也可以用于规定占领地块的价格等。需要搭配一个经济插件（如Essentials）使用。
* AuthMe: 在发动入侵前检测双方人数（但入侵方也可以不登录，仅用被入侵方账号登入服务器）。
* LuckPerms: 为权限设置添加自定义内容。
	+ territory: 仅当玩家在特定领地内时权限生效。领地类型包括无主之地、盟友、敌人、休战、中性和本国。
	+ hasKingdom: 权限对无王国玩家不生效。
	+ **注意**：大多数人不知道，但是如果你想使用KingdomsX占位符或其他任何类型占位符，你应该使用官方的LuckPerms附属: 额外内容。一个易于理解的高级运用的例子是自定义杂项升级。
* BlueMap-Dynmap-squaremap-Pl3xmap: 地图标记与王国图标。每个王国都可以在王国核心中设置自己的旗帜与标志器颜色。这个功能作为一个附属插件存在，你可以下载后放入plugins文件夹。
* MythicMobs v4&v5: 可以自定义王国斗士，守卫，和士兵。常见问题里有相关教程。
* PlaceholderAPI&MVDWPlaceholderAPI: 提供插件占位符支持，也支持短、复杂、和关系占位符。
* Slimefun: 防止插件物品，如爆炸镐，破坏炮塔与设施等。但鉴于其系统的设计方式，并非所有本插件功能都与其兼容。
* ProjectKorra: 这本该是ProjectKorra的开发者们应做的兼容，但他们因为“API的经常变动”无法维护插件，因此我编写了内置支持。~~（Crypto怨气直冲云霄）~~ 玩家无法在敌对地块上使用*法术*。