查看“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 - Lets you bypass protections, override membership, and use other admin features of Civs
* civs.join - Needed to join a town (defaults to true)
* civs.choose - Needed to choose a class (not finished, defaults to true)
* civs.shop - Needed to buy civ items in the shop (defaults to true)
* civs.create.admin_graveyard - Needed to buy an admin_graveyard region. (see item-types/admin-invisible/admin_graveyard.yml in the default configs)
== 制作团队: ==

* 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"
!区域名
!物品
|-
|Bakery
|Bread
|-
|Flint Works
|打火石
|-
|Gold Infuser
|Golden Carrot
|-
|Iron Works
|Iron Pickaxe
|-
|Lava Works
|Lava Bucket
|-
|Mill
|Bread
|-
|Stone Works
|Stone Pickaxe
|-
|Chicken Coop
|Feather
|-
|Rabbit Hutch
|兔子
|-
|Ranch
|Beef
|-
|Apple Orchard
|Apple
|-
|Carrot Farm
|Carrot
|-
|Cocoa Farm
|Cocoa Beans
|-
|Ender Pearl Farm
|Ender Pearl
|-
|Fishing Hut
|Salmon
|-
|Melon Farm
|Melon Slice
|-
|Potato Farm
|Potato
|-
|Pumpkin Farm
|Pumpkin
|-
|Sugar Cane Farm
|Sugar Cane
|-
|Wheat Farm
|Wheat
|-
|Acacia Lumberyard
|Acacia Log
|-
|Birch Lumberyard
|Birch Log
|-
|Dark Oak Lumberyard
|Dark Oak Log
|-
|Jungle Lumberyard
|Jungle Log
|-
|Oak Lumberyard
|Oak Log
|-
|Spruce Lumberyard
|Spruce Log
|-
|Coal Mine
|Coal
|-
|Diamond Mine
|Diamond
|-
|Gold Mine
|Gold Ingot
|-
|Gunpowder Mine
|Gunpowder
|-
|Iron Mine
|Iron Ingot
|-
|Lapis Mine
|Lapis Lazuli
|-
|Obsidian Mine
|Obsidian
|-
|Red Sand Pit
|Red Sand
|-
|Sand Pit
|Sand
|}

== 自定义区域 ==

=== Conveyor Region Effect ===
For a region to transport items using a conveyor, they must have the <code>conveyor:block_name</code> effect set in its configuration. For example, to export Stone Pickaxes from a region, use:
 effects:
 - conveyor:STONE_PICKAXE
You only need to specify items a region will export, not import.

=占位符=
=== 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 插件完全不同. 该插件独特的区域可以让你的死寂之城充满新意和生机.

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