查看“Civs”的源代码

[[Category:机械]]
<!--HEAD-->
    <div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">
<!--标题-->
        <p style="color:#ffffff;font-size: 26px;text-align: center;margin:0; padding:14px;background-color: #3385ff;">
            欢迎来到Civs城镇文明插件百科
        </p>
        <div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">
 <!--内容-->
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>插件名<br>'''Civs</big>'''
            </p>
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>作者<br>'''Multitallented</big>'''
            </p>
            </p>
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>兼容版本<br>'''1.13-1.14</big>'''
            </p>
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>原文<br>'''[https://github.com/Multitallented/Civs/wiki/]</big>'''
            </p>
         </div>
    </div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">
        <!--标题-->
        <p style="color:#ffffff;font-size: 22px;text-align: center;margin:0; padding:16px;background-color: #3385ff;">介绍 {{·}} Introduction</p>
        <div style="padding:10px 20px;">
=主页=
== 简介: ==
Civs是一款强大的城镇管理/RPG 插件.可以让玩家从零开始造就一片繁荣的大都市和强大帝国.

Civs 为旧插件: HeroStronghold 和 Townships 的重写版本. 现在支持最新的服务端版本 (1.13.2 / 1.14.1). 高度自定义的配置选项可让你创建新的建筑、职业和城镇，一切皆有可能.

== 兼容服务端版本: ==

* Spigot 1.13.2 / 1.14.1

== 前置: ==

* Spigot 1.13.2 / 1.14.1 
* Vault
* PlaceholderAPI (可选)
== 指令 ==
* /cv - 打开菜单
* /cv town [城镇名] - 创建城镇
* /cv toggleann - 开启或关闭聊天框的提示
* /cv accept - 接受城镇邀请并加入城镇
* /cv bounty [玩家名|城镇名] [数量] - 设置玩家或城镇的悬赏
* /cv newday - 进入新的一天 (需要civs.admin权限)
* /cv really [旧联盟名] [新联盟名] - 重命名联盟
* /cv reload - 重载插件 (需要civs.admin权限)
* /cv rename [旧城镇名] [新城镇名] - 重命名城镇
* /cv reset [玩家名] - 删除玩家的所有数据 (需要civs.admin权限)
* /cv sell [数量] - 出售你所在的区域 (只能用于可出售区域，如住宅)
* /cv tax [城镇名] [税收] - 设置城镇每日税收 (只能在特定政体类型的城镇内使用)
* /cv withdraw [取钱数] - 从城镇银行里取钱 (只能由城主使用)

== 权限 ==
* civs.admin - 管理员权限，可无视城镇保护、拥有城镇所有权和其他管理员特性
* civs.join - 加入城镇所需权限 (默认拥有)
* civs.choose - 选择职业所需权限 (默认拥有)
* civs.shop - 购买城镇物品所需权限 (默认拥有)
* civs.create.admin_graveyard -购买管理员墓地所需权限. (请查看 item-types/admin-invisible/admin_graveyard.yml)

== 制作团队: ==

* Multitallented - 主要开发者. (Discord: Private)
* Louis - 文档和服务器测试. (Discord: L. B. Clockworker#3819)
=API=
<spoiler>
== 城镇 ==

* Town town = TownManager.getInstance().getTown("TownName");
* town.getName();
* town.getLocation();
* town.getPower();
* town.getMaxPower();
* HashMap<UUID, String> people = town.getPeople(); //映射玩家UUID的城镇角色. 拥有 "ally" 的玩家不是城镇的成员，而是盟友城镇的成员.

== 城镇类型 ==

* TownType townType = (TownType) ItemManager.getInstance().getItemType(town.getType());
* townType.getBuildRadius(); // 返回无视中心方块的半径. 如: 50 = 101x101 size town, 40 = 81x81
* townType.getBuildRadiusY(); // 返回无视中心方块的高度

== 区域 ==

* Region region = RegionManager.getInstance().getRegionAt(location);
* Set regions = RegionManager.getInstance().getContainingRegions(location, 50); //获取 100x100x100 范围内的所有区域
* region.getLocation(); // 区域中心方块位置
* region.getRadiusXP(); // 正 X 轴长度
* region.getRadiusXN(); // 负 X 轴长度
* region.getRadiusYP(); //正 Y 轴长度
* region.getRadiusYN(); // 负 Y 轴长度
* region.getRadiusZP(); // 正 Z 轴长度
* region.getRadiusZN(); // 负 Z 轴长度
* region.hasUpkeepItems(ignoreReagents); // 返回区域是否至少有一个维护物品. 布尔参数忽略试剂，只看输入

== 区域类型 ==

* RegionType regionType = (RegionType) ItemManager.getInstance().getItemType(region.getType());
* String regionTypeName = regionType.getRebuild(); // 子区域类型名
* boolean mustRebuild = regionType.getRebuildRequired(); // 区域是否需要升级或可建筑才能独立
</spoiler>
=运输装置=
运输装置为区域间的矿车铁轨，用于将区域产出的物品运输至消耗物品的区域。 这个装置非常有用，比如你可以自动将采石场产出的圆石运输至磨石坊。

== 步骤 ==
以下为建造运输装置的步骤:

# 在铁路起点请放置已激活的倾斜的充能铁轨。
# 将铁路链接到另一个区域。矿车会通过铁轨进行运输，所以你需要放置多点充能铁轨以保持矿车的速度。
# 在产出物品的区域放置箱子矿车.

如果你成功地建造起运输装置，矿车就会在区域间进行物品运输。

视频介绍请查看：https://www.bilibili.com/video/av62708492/

== 限制 ==
运输装置无法运输同一产出区域的物品到多个区域。因此你需要建立一条通往仓库的运输铁路。

== 使用运输装置的区域 ==
{| class="wikitable"
!区域名
!物品
|-
|面包店
|面包
|-
|燧石工厂
|打火石
|-
|黄金注射器
|金胡萝卜
|-
|炼铁厂
|铁镐
|-
|岩浆厂
|岩浆桶
|-
|磨坊
|面包
|-
|磨石坊
|石镐
|-
|鸡舍
|羽毛
|-
|兔笼
|兔子
|-
|牧场
|牛排
|-
|苹果园
|苹果
|-
|胡萝卜农场
|胡萝卜
|-
|可可豆农场
|可可豆
|-
|末影珍珠
|末影珍珠农场
|-
|钓鱼小屋
|鲑鱼
|-
|西瓜农场
|西瓜
|-
|土豆农场
|土豆
|-
|南瓜农场
|南瓜
|-
|甘蔗农场
|甘蔗
|-
|小麦农场
|小麦
|-
|金合欢木伐木场
|金合欢木
|-
|桦木伐木场
|桦木
|-
|深色橡木伐木场
|深色橡木
|-
|从林木伐木场
|从林木
|-
|橡木伐木场
|橡木
|-
|云杉木伐木场
|云杉木
|-
|煤炭矿源
|煤炭
|-
|钻石矿源
|钻石
|-
|黄金矿源
|金锭
|-
|火药矿源
|火药
|-
|铁矿源
|铁锭
|-
|青金石矿源
|青金石
|-
|黑曜石矿源
|黑曜石
|-
|红沙坑
|红沙
|-
|沙坑
|沙子
|}

== 自定义区域 ==

=== 运输区域效果 ===
使用运输装置运输物品的区域必须在配置内设置<code>conveyor:block_name</code> 以显示效果. 比如从区域内运出一个石镐:
 effects:
 - conveyor:STONE_PICKAXE
你只需填写区域内运出的物品。
=建造者之路示例=
以下为建造者职业的推荐建筑顺序。

# 建造庇护所，如果有条件的话可建造小麦、甘蔗、土豆、胡萝卜农场。
# 当你有96个小麦时建造牧场。牛排就是你的第一桶金。
# 接下来伐木场可以为你的建筑提供足够多的建材。其他如圆石采石场、染坊、绵羊农场的建筑也很有用。
# 煤炭商店可以通过出售煤炭为伐木场提供更多收入。
# 当你挣到了 $500 后你可以购买会议室并用你从牧场获得的皮革合成书架。
# 接下来你需要建造一个定居点，在定居点内会防止TNT爆炸伤害。
# 现在你已经建立起了一个城镇，请建造一个土豆农场。
# 如果可以的话请建造绿宝石商店或绿宝石矿源来和其他城镇进行交易。
# 建造仓库来分配物品并进一步地增加城镇能量。
# 建造图书馆并附魔物品以吸引更多玩家加入你的城镇。
# 铁矿源和铁商店也可以增加你的收入。
# 继续建造住宅、村民住宅。当你的城镇人口达到10后，你就可以建造一个村庄了。
# 想要更快地移动你可以建造马厩。
# 建造旅馆或军营来获得更多住宅。这些建筑可以让你邀请更多的玩家并让玩家建造自己的房子。.
# 在城镇附近建造墓地来方便复活居民并且可以增加城镇能量。
# 在你的城镇人口达到20时升级'''会议室'''为'''城镇大厅'''来升级你的城镇.
# 继续建造更多的住宅、农场和公共事业，升级你的城镇。

祝你好运!
=政体类型=
提醒: 政体类型可以配置。但是有一些选项无法修改, 增幅和政体变革则完全可以配置。以下为默认政体类型

政体类型主要更改了城镇所有权的机制，同时也更改了城镇经济。<br>
你的城镇的政体类型可以在城镇菜单中看到。只有城主才可以更改政体类型。政体类型每天只能更改一次。

也有以下几种方式可以强制更改政体类型:

* 不活跃: 城主很久没有登录游戏
* 贫富差距: 当城镇居民或城主的钱超过了其他城镇成员的钱的总和的特定百分比时
* 城镇能量: 当城镇能量低于一定百分比时
* 反抗: 如果XX%的玩家在城镇菜单内举起了反抗的火把 (默认每名玩家需要64个火药才能进行反抗)

== 无政府主义 (地狱岩) ==
[[image:gov1.png]]
=== 政体核心 ===
* 所有居民可以为其他的城镇居民升职、降职或踢出城镇
* 所有居民可以邀请其他玩家加入城镇
* 无法在城镇菜单内摧毁城镇
* 城主拥有区域所有权
* 没有税收和银行

=== 政体变革 ===

* 无. 你必须升职为城主才能更改政体类型

=== 增幅 ===

* 所有公共设施、防御工事、住宅和战争建筑的消耗减少 35% 
* 所有商店的收入增加 25% 
* 所有公共设施、防御工事和旅馆的冷却减少 15%
== 资本主义 (青绿色玻璃) ==
[[image:gov2.gif]]
=== 政体核心 ===

* 每周获得选票最多的玩家当选城主
* 成员可以支付200元增加额外选票
* 城主拥有城镇所有区域的所有权
* 城主可以设置税收和从银行内取钱

=== 政体变革 ===

* 贫富差距 70% => 寡头政治
* 反抗 58% + 贫富差距 40% => 共产主义
* 反抗 51% + 城镇能量 30% => 末日主义
* 反抗 61% => 自由主义

=== 增幅 ===

* 商店和住宅的收入增加 10%
* 增加 10% 城镇能量上限

== 殖民主义 (灰色混凝土) ==
[[image:gov3.jpg]]
=== 政体核心 ===

* 选择该政体后，所有城主会卸任并且你需要选择另一个城镇来统治这个城镇
* 统治城镇的城主拥有区域所有权，可设置税收和从银行内取钱
* 无法在城镇菜单内摧毁城镇

=== 政体变革 ===

* 反抗 66% => 自由主义

=== 增幅 ===

* 增加 25% 城镇能量上限
* 所有住宅的消耗降低10%

== 共产主义 (红色混凝土) ==
[[image:gov4.png]]
=== 政体核心 ===

* 所有城镇居民可以升职为城主并获得区域所有权
* 无法在城镇菜单内摧毁城镇
* 没有税收和银行
* 所有区域所得平均分配给每个城镇居民

=== 政体变革 ===

* 贫富差距 40% + 反抗 51% => 自由社会主义
* 反抗 51% => 民主社会主义

=== 增幅 ===

* 工厂、矿源和采石场的冷却减少 10%
* 玩家住宅的消耗减少20%
== 合作主义 (红色染色玻璃) ==
[[image:gov5.jpg]]
=== 政体核心 ===

* 每周获得选票最多的玩家当选城主。
* 区域所得平均分配。 15%的收入置入城镇银行, 剩余收入根据城镇成员有多少区域进行分配。
* 任何建造了升级城镇或公共设施的建筑的成员所需费用由城镇银行承担。
* 没有税收，但城主可以从银行内取钱。

=== 政体变革 ===

* 贫富差距 70% => 寡头政治
* 反抗 51% + 贫富差距 40% => 共产主义
* 反抗 51% + 城镇能量 30% => 末日主义
* 反抗 51% => 自由社会主义

=== 增幅 ===

* 商店和住宅的收入增加 15%
* 增加 10% 城镇能量上限

== 民主主义 (白色玻璃板) ==
[[image:gov6.png]]
=== 政体核心 ===

* 每周获得选票最多的玩家当选城主。
* 城主拥有区域所有权，可设置税收和从银行内取钱

=== 政体变革 ===

* 反抗 51% + 贫富差距 40% => 共产主义
* 贫富差距 60% => 资本主义
* 城镇能量 33% + 反抗 51% => 末日主义
* 反抗 51% => 民主社会主义

=== 增幅 ===

* 增加25%城镇能量上限

== 民主社会主义 (青色玻璃) ==
[[image:gov7.png]]
=== 政体核心 ===

* 每周获得选票最多的玩家当选城主。
* 城主拥有区域所有权，可设置税收和从银行内取钱
* 所有农场、矿源、工厂和采石场是共用的

=== 政体变革 ===

* 反抗 51% + 贫富差距 40% => 共产主义
* 反抗 51% + 城镇能量 33% => 末日主义
* 反抗 75% => 自由社会主义

=== 增幅 ===

* 增加 15% 城镇最大能量
* 减少10% 的工厂、矿源和采石场冷却

== 专政体制 (萤石) ==
[[image:gov8.png]]
=== 政体核心 ===

* 城主拥有区域所有权，可设置税收和从银行内取钱

=== 政体变革 ===

* 贫富差距 66% => 寡头政治
* 反抗 66% + 城镇能量 40% => 末日主义
* 反抗 75% => 自由主义
* 3周不活跃 => 无政府主义
* 城镇能量 20% => 部落主义

=== 增幅 ===

* 每日增加 10% 城镇能量
* 公共设施、防御工事和旅馆的冷却减少 15%

== 封建主义 (圆石) ==
[[image:gov9.png]]
=== 政体核心 ===

* 城主拥有区域所有权，可设置税收和从银行内取钱
* 只有城主可以建造区域
=== 政体变革 ===

* 贫富差距 66% => 寡头政治
* 反抗 66% + 城镇能量 30% => 末日主义
* 反抗 75% => 自由主义
* 3周不活跃 => 无政府主义
* 城镇能量 20% => 部落主义

=== 增幅 ===

* 每日增加 10% 城镇能量
* 住宅、公共设施、矿源、采石场和工厂的消耗减少 20%

== 末日主义 (黑色混凝土) ==
[[image:gov10.png]]
=== 政体核心 ===

* 杀死了城主的人成为城主。
* 城主拥有区域所有权，可设置税收和从银行内取钱。

=== 政体变革 ===

* 2周不活跃 => 无政府主义

=== 增幅 ===

* 增加 10% 城镇能量上限
* 增加 25% 每日城镇能量
* 公共设施、防御工事和旅馆的冷却减少 20%

== 自由主义 (黄色混凝土) ==
[[image:gov11.png]]
=== 政体核心 ===

* 没有城主
* 没有税收和银行
* 任何城镇成员都可以邀请其他玩家加入城镇

=== 政体变革 ===

* 贫富差距 70% => 寡头政治
* 城镇能量 30% + 反抗 51% => 无政府主义
* 反抗 51% + 贫富差距 60% => 资本主义
* 反抗 51% + 贫富差距 30% => 民主主义
* 反抗 51% => 精英体制

=== 增幅 ===

* 住宅收入增加 15%
* 住宅消耗减少 25%

== 自由社会主义 ==
[[image:gov12.png]]
=== 政体核心 ===

* 没有城主
* 没有税收和银行
* 任何城镇成员都可以邀请其他玩家加入城镇
* 所有农场、矿源、工厂和采石场是共用的

=== 政体变革 ===

* 贫富差距 70% => 寡头政治
* 城镇能量 30% + 反抗 51% => 无政府主义
* 反抗 51% + 贫富差距 60% => 资本主义
* 反抗 51% + 贫富差距 30% => 民主社会主义
* 反抗 51% => 精英体制

=== 增幅 ===

* 所有工厂、矿源和采石场的冷却减少 10%
* 住宅的收入增加 10%
* 所有住宅的消耗减少 10%

=占位符=
=== Civs占位符列表 ===
----Civs会在服务器安装了 PlaceholderAPI后使用占位符来让服主显示更多插件信息.
----
{| class="wikitable"
!占位符
!作用
!状态
|-
|%civs_townname%
|显示玩家的城镇.
|运行中
|-
|%civs_karma%
|显示玩家的'''业'''.
|运行中
|-
|%civs_kills%
|显示玩家的击杀数.
|运行中
|-
|%civs_killstreak%
|显示玩家的连杀数.
|运行中
|-
|%civs_highestkillstreak%
|显示玩家的最高连杀数.
|运行中
|-
|%civs_deaths%
|显示玩家死亡数.
|运行中
|-
|%civs_points%
|显示玩家点数.
|运行中
|-
|%civs_highestbounty%
|显示玩家最高悬赏.
|运行中
|-
|%civs_mana%
|显示玩家魔法值.
|运行中
|-
|%civs_nation%
|显示玩家最大的联盟
|测试中
|}
=玩家教程=
主要指令: ''/cv'' 或右击城镇文明插件向导，打开菜单后，你可以:

* 管理城镇、区域和职业.
* 购买城镇、区域蓝图和职业.
* 邀请玩家加入你的区域或城镇.
* 查看城镇排行榜.
* 宣战.


菜单分成七大类.

* 选择语言: 可以让你更改语言.
* 社区: 显示信息并可让你管理城镇.
* 区域: 你可以管理区域成员和头衔.
* 蓝图: 查看你拥有的Civs区域.
* 魔法: 在做了
* 职业: 在做了
* 商店: 你可以购买大多数城镇、区域物品.

== 观念 ==
Civs 为一款城镇管理插件的重写版本：Townships. 插件的主要目标就是创建真正的城镇! 你可以造出生成物品和工具的工业区或是生产胡萝卜以在乱世中生存的和平村庄.

区域内最重要的方块为箱子, 如果箱子被破坏了，那个整个建筑都会被破坏. 
<br />

== 如何使用: ==
首先让我们建造一个'''庇护所-Shelter''' (基础的保护区域) (11x11x11).

* 1: /cv 或右击向导书.
* 2: 点击商店.
* 3: 点击Starter.
* 4: Shelter -> 购买 -> 确认.
* 5: 蓝图 -> 获取箱子.
* 6: 将箱子放到你想受到保护的区域中心.
* 7: 完成!

庇护所内受到保护: 火焰、爆炸、容器保护等. 一些建筑需要一些方块才能建造. 比如伐木场区域大小为 11x11x11:

* 需要: 10块原木, 5个铁轨, 10个圆石.

当你放置完方块后, 你只需在附近放置箱子即可声明其为伐木场区域.

== 为何使用这款插件 ==
Civs 和 Factions / Towny 插件完全不同. 该插件独特的区域可以让你的死寂之城充满新意和生机.

死寂之城不必等待资源枯竭而灭亡,即使你离线城镇也可以生产资源!想要金钱? 没有问题,建造商店并出售物品给服务器! 想要设置传送点? 建造一片墓地, 下次你死亡时会重生在附近.
=区域效果=
在区域内会有一定的效果。

=== 用法 ===
这些效果可以保护区域免受非成员玩家建造或破坏方块:
 effects:
 - block_break
 - block_build
一些效果有一种或多种参数。比如<code>arrow_turret</code> 效果, for instance, can accept the damage, speed and spread of the arrows it shoots。 The arguments are separated from the effect by a colon (<code>:</code>), while multiple arguments are separated by a period (<code>。</code>):
 effects:
 - arrow_turret:3。30。38
详情请查看下面的区域效果列表。

=== 区域效果列表 ===
{| class="wikitable"
!效果
!描述
|-
|indestructible
|区域所有者或成员无法破坏区域
|-
|arrow_turret:damage.speed.spread
|向附近的怪物和敌人发射弓箭
|-
|block_break
|非成员玩家无法破坏方块
|-
|block_build
|非成员玩家无法放置方块
|-
|block_fire
|非成员玩家无法使用打火石和防止火势蔓延
|-
|block_liquid
|非成员玩家无法在区域内放置液体
|-
|block_explosion
|防爆
|-
|block_tnt
|阻止使用TNT
|-
|block_ghast
|阻止恶魂火球
|-
|block_creeper
|阻止苦力怕爆炸
|-
|door_use
|阻止非成员玩家使用门
|-
|chest_use
|阻止非成员玩家使用箱子
|-
|button_use
|禁止非成员玩家使用按钮
|-
|block_use
|禁止非成员玩家交互
|-
|deny_mob_spawn
|阻止区域内的怪物生成
|-
|housing:amount
|增加可加入你的城镇的玩家数
|-
|tnt_cannon
|发射TNT
|-
|villager
|使你的城镇人口增加1并生成一个村民
|-
|cant_override
|城主没有该区域所有权
|-
|public_graveyard
|公共墓地，可以让玩家在区域内重生
|-
|graveyard
|可以让城镇居民在该区域内重生
|-
|jail
|监禁侵略城镇的玩家一段时间
|-
|port
|允许区域成员通过菜单的港口进行传送
|-
|deny_damage
|阻止方块破坏
|-
|deny_pvp
|禁止在区域内PVP
|-
|conveyor:block_name
|允许矿车从区域内运出物品
|-
|raid_port
|将使用者传送到目标城镇内的随机位置
|-
|charging_raid_port
|给强袭传送门充能
|-
|drain_power:period。damage
|减少目标城镇的能量
|-
|charging_drain_power
|充能
|}

=城镇效果=
* power_shield
* indestructible
* block_break
* block_build
* block_fire
* block_liquid
* block_explosion
* block_tnt
* block_ghast
* block_creeper
* door_use
* chest_use
* button_use
* block_use
* deny_mob_spawn
* control_override
* deny_damage
* deny_pvp