本帖最后由 金瓯 于 2022-12-28 08:29 编辑


插件介绍
KingdomsX是一款类似于Factions的插件，它能够让玩家在服务器内建立王国，并以区块为单位占领土地。它还提供了很多高级功能，例如炮塔（防御塔）、外交、入侵、建筑设施等。本插件进行了良好的优化且易于使用，文本和配置均可自行设置。
本插件原贴地址：KingdomsX

译者的话：
KingdomsX插件是我非常喜欢的一个插件，本帖将持续关注官方wiki的动态。本帖几乎完全按照官方wiki结构进行分节，几乎所有部分进行了翻译，并更新了个别原wiki过时的内容。
本人自2017年便开始关注类似插件，本插件非常适合战争服或城镇服使用。
有关本插件的信息汉化文件请参考站内其他搬运贴（咕咕咕）
初次编写长篇翻译，如排版不符合美学请多多包涵。
不会做高大上的帖内跳转链接和目录 请大家直接下拉观看

前言
插件特色
安装
基础部分：

• 总体介绍
• 插件指令
• 插件权限
• 变量 Placeholders
• 配置文件
  

进阶部分：

• 容器保护
• 竞技区域
• 机制：入侵、建筑设施、防御塔
  

其他：

• 错误定位
• 常见问题
• API
  

搬运授权
更新记录

本帖最后由 691422759 于 2021-3-14 16:01 编辑

刚准备用这个插件做服，wiki就要出来了吗，机缘巧合？！

本帖最后由 691422759 于 2021-3-13 10:23 编辑
插件特色
KingdomsX的目标是提供比其他类似插件（例如Towny和Factions）更多的核心功能。KingdomsX适用于PVP服务器，不过你也可以不启用PVP相关特性，在和平的氛围下享受插件核心功能。当然，PVP理应是插件最有趣的部分~
入侵机制
王国管理层可以入侵其他王国，并击败土地守卫者（默认生物为一个僵尸）以占领他国领土。在准备开战前，王国成员间应当充分准备，并适当建造防御设施。使用防御塔、升级我方土地守卫、合理安排建筑设施（如要塞）将有利于更好地防守。
炮塔与建筑设施
炮塔实质上是一个有皮肤的玩家头颅方块，放置后会自动射出箭矢等发射物攻击敌对王国的玩家以及怪物。炮塔有多个种类，可以升级，需要补充弹药维持运作。通过改变外交关系或在调节器进行修改，可以改变炮塔的默认行为。
建筑设施是一类特殊的方块，一个区块最多存在一个建筑设施。它们起着不同的作用。
交互式操作
使用 /k help 指令所显示的帮助页面是可以点击的，鼠标移动到聊天栏内容时可以显示悬浮信息。这同样是可定制的。
同样，KingdomsX的其它部分指令也实现了交互式操作。
更新检查
使用异步更新检查器检查最新更新，新版本对设置做出的变动会自动添加到配置文件。
如果删除了某些配置选项，插件将自动使用默认值进行补充。
友好的GUI界面
插件的GUI界面支持JavaScript，并支持100%的定制。
可以为每个位置修改图标、音效、名称和描述等信息。
多样的领土设置
可以设置占领土地是否生成怪物等多个选项
自动备份
插件每天自动备份一次，所有备份信息保存在backup文件夹内。
你也可以设定自动删除指定日期之前的旧备份
自动重载
监听配置文件更改。每次保存配置文件都将自动reload插件，包括配置、GUI修改等选项。
Nation功能
几个Kingdom能够联合组成一个Nation，一旦加入Nation，将会开启相关机制，使得一切更加丰富复杂。
飞行管理
可以设置是否允许玩家在本王国或盟友领土上飞行，当靠近敌国时自动关闭飞行。
高级命令与权限
所有命令使用新的自动tab填充功能。
大多数权限易于使用，甚至可以让玩家不查看文档即可轻松使用。
聊天频道支持
玩家能够选择在王国、盟友、全球频道发言，聊天栏的发言格式也可由本插件进行修改。
高度可定制化
几乎各个方面均可自行修改配置。插件同时为开发人员提供API。
自定义王国阶层
可以自由新增或修改王国阶层角色，例如前缀、颜色、权限等。
王国核心机制
王国核心默认为一个信标方块，是整个王国的核心。
税收机制
支持定时征收固定的税收，也支持使用变量和公式对每个人征收不同的税收。
容器保护机制
类似于锁箱子Lockette插件，但这是专为Kingdoms插件提供的容器保护机制。通常只需在两者选择一个您更喜欢的即可。
竞技区域
可以创建一个区域，让不同王国在该区域内逐鹿天下。
兼容性
支持主流插件，例如LuckPerms权限插件和Dynmap地图插件。
尤其是Dynmap插件，本插件能够让王国在Dynmap网页地图上显示自定义的颜色和国旗。
其他
本插件进行了高度的优化，如果您运行的是大型服务器，也可以通过设置调整本插件的行为。
具有易于使用的API，拥有Java基础知识的人即可使用。
如有任何问题，您都可以在Discord服务器中获得快速回应。

我寒假期间人工翻译了几乎所有的插件消息，还没发出来，欢迎关注~

本帖最后由 691422759 于 2021-3-13 10:25 编辑
安装
该插件不需要访问互联网，也不需要任何前置/依赖。
基本要求：

• Java8或Java11：如果使用JDK效果将更好，如果使用JRE而不是JDK，GUI面板中的JavaScript将不会起作用。Java11只有JDK，不必担心此问题。
• Minecraft核心版本：兼容1.9~1.16版本，若想使用所有功能，建议使用最新的Minecraft版本
• Spigot核心：服务器必须是Spigot或其fork，无法在bukkit核心上使用
  

配置
该插件几乎即插即用，所有必须的权限均已默认给予。当然，您也可以手动禁用指定权限。更详细的内容详见有关部分。

重载
切勿使用服务器自带的/reload或其他插件（例如PlugMan）进行重载
绝大多数的配置更改都无需手动reload，因为插件会自动检测配置文件是否被修改，随后自动重载。
个别复杂更改可能需要使用 /k reload 指令重载插件。
自动重载的性能比指令重载好很多，因为指令会重载插件的所有内容。除非自动重载没有生效，否则不需要使用指令重载。
自动重载最多可能需要5秒钟的时间来检测修改。
如果某选项需要重启服务器才能更改，将会在配置文件中特别标明。

版本更新
你可以升级Minecraft或者插件本体的版本，但不支持降级。很显然，这将可能破坏你的世界。
对于配置文件，插件新增加的配置选项将会把默认值自动添加到配置文件中。
GUI配置文件除外，它将不会被新的默认配置覆盖，对GUI做出的修改会被安全地保存。

插件卸载
你可以直接删除Kingdoms插件本体和文件夹，但是炮塔、建筑设置和全息文字将保留在世界内，并失去作用。
炮塔将变为普通的玩家头颅，建筑设施变为对应的普通方块，其他人均可破坏。
如果您介意的话，请准备重置您的世界和玩家背包。
如果您只是想重置本插件数据，而不是重置世界，只需要删除Players，Kingdoms，Nations和Lands文件夹即可。

兼容性
与下面插件的最新版本兼容：

• WorldGuard：禁止在某些地区占领土地
• DiscordSRV：将消息转发至Discord
• Citizens：炮塔不会攻击NPC
• MyPet：炮塔不会攻击宠物
• Authme：登录后才能使用功能
• LuckPerms：支持LuckPerms中的context特性
• Dynmap：可自定义王国在网页地图的颜色和国旗
• MythicMobs：支持将土地守卫设置为MM中的生物（默认守卫为僵尸，确实需要加强）
• PlaceholderAPI或MVdWPlaceholderAPI：支持丰富的变量
  

本帖最后由 691422759 于 2021-3-13 10:32 编辑
总体介绍
王国
王国是一群玩家的集合体，他们共同拥有占领的土地。
每个王国都有国库、资源点数、官职、外交关系和自己的领土。
王国（Kingdom）可以创建或加入Nation（没想好对应的中文翻译），Nation是一种类似联邦或阵营的组合体。
王国需要日常维护费用，通常需要对王国成员征税以平衡开支。国库不足以支付维护费用的王国将会被解散。

和平主义与战争护盾
王国可以选择是否进入和平主义模式（Pacifism）。
和平主义的王国不能入侵（Invade）他国，也不会被他国入侵。
王国入侵过他国后，将由一段时间无法恢复到和平主义模式。
护盾（Shield）可以在GUI界面内购买，能够阻止本国被入侵。
可以在 guis -> structures -> nexus -> settings -> shields 找到相关设置。
可以通过在GUI删除和平主义切换和护盾购买图标的方式，阻止玩家开启和平主义或者获得护盾，从而鼓励玩家间进行战争。（这么屑的行为真的好吗）

资源点
资源点（Resource point）是王国的主要货币，可以用它来升级炮塔、建筑设施、各种领土buff等内容。
资源点可以在王国核心GUI中使用物品来进行转化。
默认放入5个普通物品即可获得1点资源点。使用钻石、绿宝石等矿物可获得更多资源点。
当然，有关资源点兑换的设置也可以在 config.yml 中的 resource-points 部分修改。
除了资源点，创建国家和占领土地需要经济插件，需要使用诸如Vault之类的插件支持。
Essentials和CMI之类的插件都支持Vault。

领土增益Buff
包括近战伤害增加、伤害减少、弓箭伤害增加、生命回复等buff，这些效果仅在本国领土内生效。

国力
使用 /k top 或 /k nation top 可按照国力对国家排名。
有关国力（might）的设定可以在 config.yml->top-kingdoms 中找到。
默认的计算方法使用资源点数和王国成员作为主要指标。
在征税时，会向排名前10的王国发放奖励资金和资源点数，同样可以在 config.yml->top-kingdoms 中找到有关配置。

王国核心
王国核心（Nexus）是一个王国中最重要的方块，默认外表是一个信标。不过它不会被破坏，可以使用 /k nexus 随时随地更改核心位置。
右键点击核心即可打开王国GUI，几乎所有设置都可以在这里修改。
如果非盟友或者敌人敲碎了一次本国的王国核心，本国将会损失一些资源点，因此请确保核心处于安全位置。

外交关系
一个王国可以与另一个王国保持以下外交关系：

• Self：仅用于调试和API使用，表示这是您所在的王国
• Neutral：中立，表示您与此王国没有特殊关系
• Nation：表示您与此王国同在一个Nation中
• Ally：盟友关系
• Enemy：敌对关系
  

等级 官职
此设置可在 ranks.yml 文件中更改。每个等级（Rank）都有唯一的节点node和优先级priority。
其他内容是可以相同的，例如名称、颜色、符号、图标等。

• 节点（Node）：必须唯一，用于使用指令管理和辨识。不可使用空格或特殊字符
• 优先级（Priority）：最高等级的官职优先级为0（默认情况下为国王king），最低等级的优先级=官职数量-1（默认为member的优先级）
• 图标（Material）：仅用于在GUI中显示此等级
  

税收
默认情况下，王国每24小时（现实世界）征收一次税款。有关设置详见 config.yml->daily-checks-interval
缴纳税款使用的是经济插件，即缴纳金币，而不是资源点数。可以设置新建的王国在前几天时间不用交税。
王国可以按照定额或按照自己的税收公式向成员收取赋税。
下图为税收流程示意图：


Nation
此部分与王国部分类似，咱不翻译

Good afternoon

本帖最后由 691422759 于 2021-3-13 10:33 编辑
插件指令
插件的主要指令是 /kingdoms
以下别名也可使用，可以等价代替：

• /kingdomx
• /kingdomsx
• /kingdom
• /k
  

以上指令和别名都可在 commands.yml 中自定义。
若想完全禁用某个指令或功能，建议通过 commands.yml 中的配置部分禁用它，而不是在权限管理系统中删除有关权限。
指令参数中，<尖括号>代表必须使用的参数，[方括号]代表此参数可有可无。

玩家指令：
大多数操作都可以通过王国核心的GUI界面进行，以下指令作为参考。

/k help [页码] —— 打开帮助列表，OP将看到更多管理指令
/k create <王国名> —— 使用王国名创建新的王国 可在 config.yml 中设置王国名称是否允许中文、颜色等选项
/k rename <新名称> —— 重命名王国
/k claim —— 占领脚下区块的土地
/k claim [auto / fill / x] <y> —— auto:在行走时自动占领路过的土地 fill:尝试填充占领长方形区域 x:占领土地的x轴坐标
/k lore <标语> —— 设置王国标语 当有人进入土地边界时 此标语将以title形式展现
/k home —— 传送至王国传送点
/k sethome —— 将所在位置设置为王国传送点
/k unsethome —— 取消设置王国传送点
/k nexus [open / remove] —— open: 远程打开王国核心GUI remove: 删除当前的王国核心
/k bank <deposit / withdraw> <数量> —— 从王国的国库存钱/取钱 当然，需要国王给予权限
/k resourcepoints <deposit/withdraw/transfer> [王国名] <数量> —— 从王国 存入/取出/转化成 资源点数
/k sell —— 以资源点为交易方式 出售王国物品
/k promote <玩家名> —— 提升玩家的角色/官职
/k ally/truce/enemy <其他王国> —— 与其他王国 结盟/停战/开战
/k revoke <其他王国> —— 取消与其他王国的所有关系
/k demote <玩家名>         —— 降低玩家的等级/官职
/k pvp —— 切换pvp模式，开启后您将可以攻击盟友和本国成员，两个玩家都需要开启pvp后才会产生效果。
/k top —— 按国力查看排名最靠前的王国
/k teleport —— 当土地遭受入侵时 使用此指令传送至被入侵的区块
/k map —— 在聊天栏中显示简略的王国地图
/k broadcast <公告的消息> —— 向所有王国成员广播一条公告 支持颜色代码
/k chat <n / k / a / g> [聊天消息] —— 在王国频道（k）/盟友频道（a）/全球频道（g）发送聊天消息
/k disband —— 解散王国 所有土地和成员都将丢失
/k donate <王国名> <资源点数> —— 将资源点数捐赠给其他王国
/k fly —— 切换王国飞行 只有在本国领土或盟友土地上才能飞行 靠近敌人或中立土地时将关闭飞行
/k invade —— 站在他国土地内使用此指令进行入侵 请确保准备万全
/k kick <玩家名> —— 将玩家踢出王国
/k king <玩家名> —— 将玩家设置为新任国王 你将不再是国王
/k show —— 显示脚下的王国信息
/k surrender —— 在被入侵时主动投降（法国行为）
/k tradable —— 显示可兑换资源点的物品列表
/k visualize —— 可视化显示王国土地边界

管理员指令：
/k reload
/k updates
/k admin claim <王国名> —— 为王国占领所在区块
/k admin kick <玩家> —— 强制将玩家踢出所在王国
/k admin disband <王国名> —— 解散指定王国
/k admin join <玩家名> <王国名> —— 让一个玩家加入指定王国
/k admin maxlandmidifier <王国名> <数量> —— 增加王国的土地占领上限
/k admin nexus <王国名> —— 远程打开一个王国的核心GUI页面 以国王的身份做一些事情
/k admin home <王国名> —— 传送至某王国的传送点
/k admin dailycheck —— 对税收、奖励等定时事项进行手动检查 并重置每日计时器
/k admin rank <玩家> <等级> —— 修改一个玩家在王国中的等级
/k admin resourcepoints <王国名> [add / set / remove] <数量> —— 为一个王国 添加/设置/删除 资源点数
/k admin bank <王国名> [add/set/remove] <amount> —— 为一个王国 添加/设置/删除 国库资金
/k admin spy —— 监听所有聊天
/k admin sound <音效名> [音量] [pitch角度] —— 在使用音效之前 可以先使用此指令测试音效
/k admin test <信息> —— 使用插件消息系统之前 可使用此指令评估内容
/k admin hologram <半径> —— 删除半径内所有有问题的炮塔和全息文字 仅当插件出现问题时使用
/k amdin toggle —— 开关管理模式
/k admin unclaim —— 强制放弃脚下的区块
/k admin evaluate <表达式> —— 评估表达式的结果
/k admin dynmap <fullrender / remove> —— fullrender: 对整个地图进行手动渲染 remove: 删除地图上的标记、图标等王国有关信息
/k admin masswar <start / end> —— 开启/关闭混战模式
/k admin shield <kingdom> [add/set/remove] <时间> —— 添加/设置/移除 王国战争护盾的持续时间
/k admin player [玩家名] —— 显示有关玩家的有关王国的所有信息
/k admin land [世界名] <x> <z> —— 使用区块坐标（注意 不是位置坐标）传送至指定区块

本帖最后由 691422759 于 2021-3-13 10:34 编辑
权限
玩家所需要的权限默认情况下已全部授予。
所有权限都遵循格式：Kingdoms.command.xxx.[名称]
此处 [名称] 为该命令的全称
如果您的权限插件支持通配符 *，也可以使用通配符进行设定，例如：Kingdoms.command.admin.*
推荐使用 LuckPerms 作为权限管理插件
所有与命令有关的权限格式均如下表格式所示：

示例

命令	权限
/k fly	kingdoms.command.fly
/k show	kingdoms.command.show
/k info	kingdoms.command.show
/k nation spawn	kingdoms.command.nation.spawn
/k admin disband	kingdoms.command.admin.disband
/k admin unclaim	kingdoms.command.admin.unclaim
/k admin nation disband	kingdoms.command.admin.nation.disband

其他权限

权限	描述
kingdoms.land.build.place	在其他王国土地上放置方块
kingdoms.land.build.break	在其他王国土地上破坏方块
kingdoms.land.interact	在其他王国土地上进行交互操作
kingdoms.command.claim.chunk	使用 /k claim 占领土地
kingdoms.command.show.others	使用 /k show 查看其它王国信息
kingdoms.command.show.admin	使用 /k show 查看其它王国的所有详细信息
kingdoms.command.nation.show.others	查看其它nation的信息
kingdoms.command.nation.show.admin	查看其它nation的所有详细信息
kingdoms.command.teleport.bypass.timer	使用 /k tp 传送时无需进行等待
kingdoms.command.home.bypass.timer	使用 /k home 时无需进行等待
kingdoms.command.nation.home.bypass.timer	跳过使用 /k nation spawn 传送时的等待
kingdoms.nexus.remove	允许删除王国核心
kingdoms.protection-signs.use	允许使用容器牌子保护
kingdoms.protection-signs.use.creative	允许在创创造模式下使用容器牌子保护
kingdoms.protection-signs.open	允许打开所有受保护的容器
kingdoms.protection-signs.break	允许移除所有受保护的容器
kingdoms.command.visualize.details	使用 /k visualize 时显示更多具体信息
kingdoms.debug	查看debug调试消息 很少使用
kingdoms.updates	如果启用了更新检查并且本地插件已过时 向有该权限的玩家发出通知
kingdoms.creative.pickup	创造模式下捡取炮塔和建筑结构
kingdoms.silent.leave	离开服务器而没有离开消息
kingdoms.silent.join	加入服务器时不显示消息
kingdoms.flight.damage	受到伤害后不会暂停王国飞行模式
kingdoms.flight.lands	进入其他王国土地时不会终止飞行模式
kingdoms.flight.nearby-enemies	附近有敌国土地时也不会终止飞行模式
kingdoms.lands.<整数>	拥有此权限的玩家如果加入了一个王国 该王国将获得此数量的土地上限加成
kingdoms.chat.colors	在聊天中使用颜色代码
kingdoms.chat.bypass.ranged	允许玩家使用配置中定义的前缀 绕过远程频道并将消息发送给所有人。
kingdoms.markers.default	将 /k visualize 显示的标记设置为默认类型
kingdoms.markers.blocks	将 /k visualize 显示的标记从颗粒效果设置为方块类型
kingdoms.markers.<颗粒效果>	将 /k visualize 显示的标记设置为某种颗粒效果 或许需要重启服务器生效

本帖最后由 691422759 于 2021-3-13 10:36 编辑
变量 Placeholders
本插件支持 PlaceholderAPI 和 MVdWPlaceholderAPI，自带变量扩展，无需使用 /papi ecloud 下载扩展。
一些变量的默认值可以在 config.yml 中的 default-placeholders 修改，以实现自定义效果。

和数字有关的变量可分为2种格式：short变量和fancy变量
short变量将根据数字的位数缩写长度
fancy变量会将数据详细表达出来

示例：

short变量	fancy变量	原始输入数据	short格式	fancy格式
%kingdoms_short_members%	%kingdoms_fancy_members%	130	130	130
%kingdoms_short_bank%	%kingdoms_fancy_bank%	12330.34	12.3K	12,330.34
%kingdoms_short_nation_kingdoms%	%kingdoms_fancy_nation_kingdoms%	42345234	42.3M	42,345,234

玩家相关变量

变量	描述
%kingdoms_chat_channel%	当前的聊天频道名称
%kingdoms_joined%	加入王国的时间
%kingdoms_resource_points%	王国的资源点
%kingdoms_last_donation_time%	上次您将资源点捐赠给王国的时间
%kingdoms_last_donation_amount%	您在上一次捐赠的捐赠总数
%kingdoms_total_donations%	累计捐献资源点数
%kingdoms_tax%	需要缴纳的税款
%kingdoms_territory%	当前所在位置的王国的名称
%kingdoms_rank_node%	所在王国的等级节点
%kingdoms_rank_name%	所在王国的等级名称
%kingdoms_rank_color%	所在王国的等级颜色
%kingdoms_rank_symbol%	所在王国的等级符号
%kingdoms_rank_priority%	等级优先级 越低优先级越高 0代表国王 普通成员的数字最大
%kingdoms_rank_max_claims%	您的等级可以在您的王国中占领的最大区块数量

王国相关变量

变量	描述
%kingdoms_name%	王国名称
%kingdoms_lore%	王国标语
%kingdoms_members%	王国现有成员数量
%kingdoms_max_members%	最大成员数量
%kingdoms_online_members%	王国在线成员数量
%kingdoms_offline_members%	王国离线成员数量
%kingdoms_flag%	Dynmap中王国旗帜的网址链接
%kingdoms_color%	王国在地图上的颜色代码
%kingdoms_king%	国王名称
%kingdoms_might%	王国国力数值
%kingdoms_since%	王国创建日期
%kingdoms_home%	王国home传送点坐标
%kingdoms_nexus%	王国核心坐标
%kingdoms_lands%	王国占领土地的区块数量
%kingdoms_max_lands%	王国占领土地上限
%kingdoms_shield_since%	战争护盾已开启时长
%kingdoms_shield_time%	战争护盾持续时间
%kingdoms_shield_time_left%	战争护盾剩余时间
%kingdoms_bank%	国库资金
%kingdoms_ranks%	王国等级数量
%kingdoms_pacifist%	如果启用了和平主义模式为true，否则为false
%kingdoms_max_lands_modifier%	王国通过管理员 /k admin maxlandmodifier 指令获得的额外土地
%kingdoms_server_kingdom_tax%	王国向服务器缴纳的维护费用
%kingdoms_kingdom_tax%	王国向服务器缴纳的维护费用 如果王国不在nation中 那么这个数值和上个变量相同

关系变量

%kingdoms_relation_name%	relations.yml 中定义的外交关系名称
%kingdoms_relation_color%	relations.yml 中定义的外交关系颜色

本帖最后由 691422759 于 2021-3-13 10:38 编辑
配置文件
大多数设置项都在配置文件中做了说明，一些特殊用法说明如下：

• 将消息内容设置为 ~ 或 null 将不会发送该消息，而如果将其设置为 "" 将会发送一个空行
• 使用 \n 换行符可以使文本换行
• 所有的材质名称都可以在这里找到
• 有关声音的格式为 <类型> [音量] [角度] 所有的生音种类都可以在这里找到 音量为0到1之间的一个数字，如果音量大于1，将只会增加声音被听到的半径
• 使用快捷键 Ctrl + F 可以快速搜索文件内容 令人惊讶的是很多人并不知道QWQ
• 配置文件中有关时间的选项大都支持时间后缀 如果没有后缀 则默认使用秒 例子：time-limit: 10days
  

数学方程式

• 以下规则适用于配置文件中的任何方程式。
• 支持常规的数**算 诸如 + - * / () ^ 等。
• 变量能否使用取决于具体情况。 例如，有些情况下表达式仅对王国进行计算，此时则无法使用和玩家有关的变量。比如%kingdoms_name%可以用在表达式中，而%kingdoms_rank_name%无法使用。因为此时无法指定一个玩家并获取相关变量。
• 可以使用 /k admin evaluate 评估方程式的结果
• 支持整数、十进制和十六进制
• 支持所有的 Java Math 函数
• 特殊函数：
  - random(min, max) 获得min和max之间的一个随机数
  - randInt(min, max) 在min和max之间获得一个随机整数
  - ...
• 支持按位逻辑运算
  - & 按位与
  - | 按位或
  - ! 按位XOR
  - ~ 按位补码
  - > 按位二进制右移
  - < 按位二进制左移
  - $ 按位右移填零
• 1.16版本中支持16进制颜色
  

高级消息提示
此功能无法在bukkit核心使用，仅适用于spigot及其衍生版本。
使用此功能，需要在文本内容最开始添加 COMPLEX:
随后，可以在消息文本的任何地方插入鼠标悬浮文字，格式为 hover:{}
具体格式为 hover:{聊天框显示文本;鼠标显示悬浮文本;点击后执行的指令}
点击后执行的指令需要添加斜杠 /
如果不添加斜杠，将在聊天框中发出消息，就像玩家自己说话一样
例子：

• hover:{点我回主城;**起飞;/spawn}
• hover:{&9百度一下;&c我也不知道;url:https://www.baidu.com/}
  
  

可以用 /k admin test 测试所有的聊天框效果

主要文件
插件主要配置都在 config.yml 文件中，部分设定放在其他yml文件中。
所有配置文件都会随文件修改而自动重载。
配置文件不可汉化翻译，请勿随意修改。GUI和语言消息文件可以翻译。
如果配置文件缺少某个选项，插件将自动使用默认值补充完全

语言
默认语言文件在 en.yml 中，由插件自动生成，所有语言条目均支持：

• 颜色代码以及1.16新版十六进制颜色
• 换行符 \n 换行后将保留上一行的颜色
• 悬浮高级消息
• 各类变量占位符
• 设置为 null 即可完全禁用某条消息
• 如果启用了插件消息前缀，可以在消息开头使用 NOPREFIX| 禁用插件全局前缀
  

GUI设置
有关GUI的设置位于 gui 文件夹下
与配置和语言文件不同，它不会被插件自动用默认值更新，因为它是完全由管理员定制的
如果无法在GUI使用js脚本，说明你正在使用jre而不是jdk
GUI配置包含以下内容：

• title: GUI上方标题
• rows: GUI的行 数值为1到9
• type: 如果未指定rows，则可将GUI切换为其他类型，点击这里查看其它容器类型
• sound: GUI打开时的音效
• message: 打开GUI时玩家收到的消息
• commands: GUI打开时默认执行的指令
• interactable: 可点击的槽位
• disallow-creative: 设置GUI是否可在创造模式下打开
  

图标选项

• name: 图标的名称
• lore: 图标的描述
• material: 显示的材质物品
• amount: 显示的数量
• damage: 物品的耐久
• skull: 使用头颅材质，搭配 minecraft-heads.com 即可生成丰富的头颅材质
• unbreakable: 是否具有无限耐久
• model-data: 1.14自定义数据模型功能
• enchants: 是否附魔 以下为示例：
  1. enchants:
     
  2.   ARROW_FIRE: 2
     
  3.   DURABILITY: 3

  复制代码
  
  
• flags: Minecraft的flags命名混乱，详情请见这里。以下为示例：
  1. flags: [HIDE_ATTRIBUTES, HIDE_POTION_EFFECTS]

  复制代码
  
  
• attribute: 使用示例如下：
  1. attributes:
     
  2.   Attribute: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
     
  3.     name: https://minecraft.gamepedia.com/Attribute
     
  4.     amount: The modifier's number.
     
  5.     operation: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/AttributeModifier.Operation.html
     
  6.     slot: HEAD - CHEST - LEGS - FEET` - HAND - OFF_HAND

  复制代码
  
  
• sound: GUI打开时的音效
• message: 打开GUI时玩家收到的消息
• commands: GUI打开时默认执行的指令
• can-take: 如果设置为true 玩家可以将其从gui中取出
• slots/posx,posy/slot: 图标的位置，可以是绝对位置slots，也可以是用x和y定位的坐标系位置
• color: 皮革护甲的RGB颜色，格式为 r, g, b
• spawner: 生成实体的类型
• projectiles: 弩中装填的发射物
• effects: 可疑树藤（暂不明确）的效果
• color / pattern-color: 彩色染料和热带鱼的图案
• power: 烟花发射高度
• firework: 烟花类型及效果
  

JavaScript条件判别

本帖最后由 691422759 于 2021-3-13 10:43 编辑
进阶设置
容器保护
这是类似于锁箱子插件的一个功能，所有的配置均可在 protection-signs.yml 文件中更改。
容器可以是箱子、熔炉、漏斗等
使用任何牌子按住shift键放置在容器上，并在第一行输入 [protect] [protected] [private] 就可以保护这个容器了。
可以右键点击牌子来更改有关保护设置。
您可以在牌子上输入 [everyone] 让王国每个人都能打开这个箱子。
在牌子输入 [everyone*] 能让任何人打开这个箱子 无论是否在您的王国中

竞技区域
竞技区域（Outpost）基于WorldGuard创建。
竞技区域默认是关闭状态，若竞技区域开启，区域内的王国之间需要互相混战。在结束时，区域内占领时间最长的王国将获得胜利。
所有有关设置均可在文件 outposts.yml 中设置，例如奖励、限制、位置等。
参与此活动的王国需要支付一定的费用，一旦参加的成员超出上限便无法继续进入竞技区域。
您还可以通过放置刷怪笼的方式让这场赛事更加激烈，在活动期间，进度将以bossbar血条的形式显示。
您可以充分发挥您的想象力，让这一机制更加有趣

插件机制
入侵
入侵（Invade）其他王国能够占领并获得他国土地，入侵的主要目的是获取物资。（当然，简单的复仇也可以）王国需要有足够的资源点数才能发起入侵行动
准备阶段
炮塔是有效的防御武器，请尽可能熟悉各种防御炮塔的属性。同时，使用黑曜石建立一个0-255的高墙或许也是有效的手段（Trump行为）
请确保王国核心绝对安全，必须安放在最可靠的位置。
建筑设施中的堡垒（Outpost）是专为防御而生的，敌人必须先攻占堡垒才能继续攻占其相邻的土地。注：堡垒（Outpost）与竞技区域（Outpost）仅仅是名字相同，实际上是不同的2个概念
土地守卫
当一块土地被入侵时，将在入侵者附近生成一只守卫者（Champion）。
入侵者击杀守卫者后，土地将被占领。
守卫者默认情况下为穿戴装备的僵尸，其技能均可通过资源点升级。
守卫者类型可以更改为MythicMob插件中的生物，它对一些事件是免疫的，例如在阳光下不会燃烧。
入侵期间
入侵期间无法使用任何指令或工具，本插件的一些功能也将暂停
入侵结束判定

• 防御方投降
• 攻击者投降
• 攻击者下线
• 攻击者死亡
• 被入侵的区块被防御方放弃
• 一方的王国被解散
• 攻击者被击退
• 守卫被击杀或长时间未被击杀
  

大混战
有关设置可在 invasions.yml 修改。
在混战（Masswar）期间，入侵他国不需要花费资源点数。

建筑设施
每个区块只能包含一个建筑设施（Structure），建筑设置占地为1个方块

• 王国核心（Nexus）：最重要的东西，必须严防死守
• 堡垒（Powercell）：保护相邻区块共计3x3区块的土地，想入侵周围的土地，必须先占领堡垒所在的区块
• 提取器（Extractor）：定时生成部分资源点数
• 前哨（Outpost）：可以在前哨中花费资源点数购买各类物品，或者远程方位王国核心
• 传送器（Warp pad）：传送至其他建筑设置，每个传送器都有特定的名称
• 调节器（Regulator）：管理王国各种设置，例如生成动物、tnt爆炸、自动装填防御塔等
  

炮塔
炮塔（Turret）实际上是带有皮肤的头颅方块，仅能放置在木栅栏或石墙上。可以在一定范围内自动攻击敌人或治疗盟友。
炮塔可以升级，各种特性均可在 Turrets 文件夹中设定
注意：炮塔过多会影响服务器性能，因此请尽量降低密度或限制使用

本帖最后由 691422759 于 2021-3-13 00:24 编辑
其他
错误定位
在遇到问题时，请保证你：

• 使用的是Java8或11，Java8以上的任何一个发行版理论都可用，但不**可靠
• 您不是在管理模式或是op
• 使用的是大版本的最新小版本，例如1.16.5或1.14.4
• 服务器核心是spigot或paper，其他魔改端可能会出现问题
• 检查插件配置是否过时
  

请将详尽内容发送至作者联系方式

常见问题
我可以免费获得插件吗？
可以，请加入Discord服务器获得。

是否支持1.8和更低的版本？
本插件不会再支持1.8以下的版本。而且，理论上建议您使用越新的版本越好。
在稳定性方面，1.12版本优于1.8-1.11

为什么玩家无法捡起炮塔和建筑设施？
创造模式下的玩家无法捡取，可授予权限 kingdoms.creative.pickup

为什么防御炮塔不会自动开火？
请保证炮塔有足够的弹药，右键点击炮塔打开GUI即可装填。

聊天格式错误，出现重复聊天信息？
如果您同时需要使用其他聊天插件，请转到 chat.yml-> global-channel-> format->false

玩家因为炮塔被踢出服务器？
目前地狱炮塔会导致这个情况，主要是因为bungeecord网络无法处理发射物信息。
你可以转到炮塔设置，修改炮塔发射类型。也可以简单粗暴地禁用此炮塔，不过所有此类炮塔都会变成普通的玩家头颅。

国库功能不可用？
请确保安装Vault和支持它的经济插件。

API说明
API说明见此，笔者认为开发者都有能力读懂官方说明。

排版好看, 辛苦楼主.

我也准备翻译一些插件 和插件的wiki  你这排版好看.

啊真的吗 qwq 感谢你的肯定 只是用了加粗而已 qwq

看着舒服 方便阅读就挺好

楼主，你有个错别字，不应该是“试做”，而是“视作”

感谢楼主夸奖!

非常的不错 我挺喜欢的 u

真的不错，支持作者大大！

好玩嘛这个游戏我的世界

学习了！！！

阿巴........

王国插件感觉挺好的支持作者

还以为是kh kingdom hearts 呢

sdl. wsl阿巴阿巴

阿巴.........

可以啊这个很强，支持作者

楼主牛逼 赞了

楼主牛逼 赞了

跪求漢化檔案

都看完了 期待楼主汉化

感谢分享

有点服务器还没汉化这个模组就很难受

小时候玩过 嗯...是很好玩的 国战嘛 攻防战术也很多 炮塔很丰富 资源点可以刷铁轨(全自动)和刷雪(半自动) 是个好插件 但是后期谁也打不过谁

mcbbs有你更精彩~

已下载，现在就去找腐竹加进服务器！

拉做个新手任务//

感谢分享！

怎么禁用飞行

插件好是好，就是买不起。还是自己动手丰衣足食吧。

现在发出来了没呀  好期待呀

没有看到汉化文件在哪里

感谢版主的分享，太有用了

感谢版主的分享，挺有意思的

本帖最后由 dougou 于 2021-8-15 10:53 编辑

这个和Kingdoms+有什么区别呢，是这个更新一些么

666666666666666666666666666

請問王國不能命名中文怎麼辦呢

666666666666666