Skip to content

Commit

Permalink
[new] 导航栏布局更改
Browse files Browse the repository at this point in the history
[new] 内容更新
  • Loading branch information
ddaodan committed Jan 19, 2024
1 parent 956f5ae commit 7eca136
Show file tree
Hide file tree
Showing 11 changed files with 2,666 additions and 128 deletions.
29 changes: 7 additions & 22 deletions docs/.vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -7,31 +7,15 @@ export default {
theme: hopeTheme({
logo: "./assets/image/minecolonies_wiki.png",
navbar: [
{text: "主页", link: "/"},
{
text: "安装",
prefix: "Installation/",
link: "",
children: [
"gdlauncher",
"java",
"hmcl"
]
},
{
text: "教程",
prefix: "Tutorials/",
children: [
"getting-started",
"datapacks",
"schematics",
"worldgencolonies"
]
}
{text: "主页",link: "/",icon: "home"},
{text: "安装",link: "Installation/"},
{text: "教程",link: "Tutorials/"},
{text: "建筑",link: "Buildings/"},
],
sidebar: {
"/Installation/": "structure",
"/Tutorials/": "structure",
"/Buildings/": "structure",
"/": [
"start"
],
Expand All @@ -44,7 +28,8 @@ export default {
searchPro: {
indexContect: true,
autoSuggestions: true,
}
},
pwa: true
},
pageInfo: ["Original", "Date", "Category", "Tag", "Word", "ReadingTime"],
}),
Expand Down
5 changes: 5 additions & 0 deletions docs/Buildings/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
index: false
title: "建筑"
---
<AutoCatalog base='/Buildings/' />
146 changes: 146 additions & 0 deletions docs/Buildings/townhall.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,146 @@
---
title: "市政厅"
---
<!-- @include: ../temp.md -->
# 市政厅
市政厅是殖民地的中心部分。

**Note:** The Town Hall block **cannot** be crafted until **after** you have already placed the Town Hall you get from the [Supply Ship/Camp](/Items/supplycampandship). If needed, it can also be obtained in creative mode like any other block or by commands.
{% endinfobox_building %}

## Starting a New Colony

### Scouting the Area

Make sure you scout your area carefully before you decide where you want to place your Town Hall. Your colony will start with a 4 chunk radius (4 chunks in each direction) from the Town Hall block. Make sure this is where you want your colony to be.

### Placing your Town Hall

After you have carefully decided where you want to place your Town Hall (remember, the position where you placed the Town Hall block will be the center of your colony's protected area. Once placed, the area will be set and cannot be changed), use your [build tool](/Items/buildtool) to place the Town Hall block.

Right-click the ground in the area you want to place the Town Hall. The building GUI will display showing the 3D preview of the building. You will be able to use the arrow buttons to move the building to the location you desire.

**Note:** Make sure you use the + and - options in the GUI to make sure you have the ground level of the hut where you want the ground level to be. Not all hut blocks sit on the ground.

Once you commit to the placement of the Town Hall (green checkmark), the Town Hall block will be placed.

### Creating your Colony

Once you have placed the Town Hall block you will need to right-click on it and select Create New Colony.
<br>
<img alt="Creating New Colony" src="/assets/image/gui/th_colonycreationGUI.png"/>

A new colony will be created, the area of your colony will be established, and the entire area will be protected.

### Protection Area

When you start a colony, the area that is initially set also has protections added to it. The protection system includes blocking any player from placing/breaking or interacting with blocks of any kind, placing lava or water, and placing/lighting TNT. Once established it will also show in the informational screen.

The protected area of your colony (once the Town Hall has been placed) will depend on the [configuration](../../source/misc/configfile), but will be 4 chunks radius by default, measured from where you placed your Town Hall block the first time. Therefore, plan carefully where you want to place your Town Hall. Your protected colony area includes mountains, hills, lakes, oceans, caves, world generated structures, etc. from bedrock to the sky limit.

Due to the protected area of each colony, you have to carefully scout your surroundings to make sure you are clear of any other colonies nearby preventing you from placing your Town Hall or limiting your colony area in that direction.

**Note:** Once you place your Town Hall block, this will be the CENTER of your Town's protected radius. If you decide that you want your actual Town Hall building to be built in a different location (within your currently set protected radius), you can break the block and place it again with your build tool. Removing and replacing the Town Hall block will NOT remove the Protected area of your Town. The only way to remove the protected area of your colony so that you can place a Town Hall somewhere else is by a person with OP or admin permission deleting your colony through [commands](../../source/systems/command).

If there is another colony too close to your current position, you won't be able to place a Town Hall.

If you try to place another Town Hall outside of your protected area, you will get a message:

![Placing a Second Town Hall](/assets/image/gui/buildings/townhall/th_secondplace.png)

### Deleting a Colony

To delete your colony, place a Town Hall outside your current colony border (either by mining or deconstructing your old Town Hall or by crafting a new one). Interacting with the newly placed Town Hall outside of the current borders will prompt you to delete your colony.
Alternatively, if you have the proper permissions, you can use [commands](../../source/systems/command).

## {% building %} GUI

### **Information:** This is the overall information section of the Town Hall GUI.

{% building_gui_content_block_custom image_key="th_information" image_alt="Townhall information" cols=6 %}
**Page 1:** Here you will see some statistics on your citizens, like the number of citizens you have out of your max. Green is less than 90% of your max, orange is above 90%, and red is full. If it's red, hovering over the numbers will show what you need to do to get more citizens. The page also shows how many of each type of worker you have.

**Page 2:** Here you will see the overall happiness of the colony's citizens and any events that happened within the colony (the newest events are at the bottom). You can click the button to switch to a permission log, which will show any illegal actions that happened in the colony (like if a player tried to break a block when they aren't allowed to). Clicking the plus next to an illegal action will change it to a legal action if the player tries to do it again. For more information, see the [Protection system](../../source/systems/protection) and the Permission tab of the {% building townhall %} GUI.
{% endbuilding_gui_content_block_custom %}

### **Actions:** This is the most important section.

{% building_gui_content_block_custom image_key="th_actions" image_alt="Townhall actions" cols=6 %}
**Page 1:** Here you will see the name of your colony as well as the building level of the {% building townhall %}. And the buttons:
- **Build Options:** Lets you create a build, upgrade, reposition, or repair build order for the {% building townhall %}. To learn more about the building system, please visit the {% building_link builder %} page.
- **Rename Colony:** To change the name of your colony (from Your Username's Colony, which is the default) to anything you want.
- **Hire Mercenaries:** Here you can hire mercenaries to help defend your colony. Be warned, they're mean and will steal from citizens!

**Page 2:** This is only enabled if PVP is turned on in the [config file](../../source/misc/configfile). Here you have:
- **Allies:** Other colonies that you have added as allies and that have confirmed your colony as an ally as well.
- **Feuds:** Other colonies that you have added as a feud and that have confirmed your colony as a feud as well.
{% endbuilding_gui_content_block_custom %}

### **Permissions:** Here you can invite other players to your colony to collaborate.

{% building_gui_content_block_custom image_key="th_permissions1" image_alt="Townhall permissions" cols=6 %}
**Page 1:** Here you type the name of the player you want to add.

**Page 2:** Shows the list of players that have ben added as well as their current rank. You can click on the "-" or "+" to give them a higher rank or lower rank.
{% endbuilding_gui_content_block_custom %}

{% building_gui_content_block_custom image_key="th_permissions2" image_alt="Townhall permissions" cols=6 %}
**Page 3:** Here you can select the rank that you would like to manage.

**Page 4:** Here are the individual permissions (for the rank you have selected on the previous page) that you can toggle *ON* or *OFF*, giving each rank the permission you want. **Note:** the Fight Guards permission causes Guards to treat the player as an enemy and attack them. It is only recommended for Hostile players.
{% endbuilding_gui_content_block_custom %}

{% building_gui_content_block_custom image_key="th_permissions3" image_alt="Townhall permissions" cols=6 %}
**Page 5:** Where you enter the position (X, Y, Z) of the block that you want to make free for interaction.

**Page 6:** Here you will see the list of block positions that you have added as free for interaction and can remove them.
{% endbuilding_gui_content_block_custom %}

### **Citizens:** This section displays the names and skill levels of the citizens in your colony.

{% building_gui_content_block_custom image_key="th_citizens" image_alt="Townhall citizens" cols=6 %}
**Page 1:** When you select a citizen, their stats and job will appear here. You can also recall them to the Town Hall block on this page.

**Page 2:** Here you will see a list of the citizens in your colony. Select a citizen to see their skills.
{% endbuilding_gui_content_block_custom %}

### **Settings:** This section is where you can control how your citizens will be hired and assigned housing in your colony, among other things.

{% building_gui_content_block_custom image_key="th_settings" image_alt="Townhall settings" cols=6 %}
**Page 1:** There are four buttons here:
- **Worker hiring mode:** Clicking on this button lets you switch between automatic or manual. If it's in automatic mode, you can't fire or hire any citizen from any worker hut and the best unemployed citizen will be hired for you. In manual mode you will be able to *hire* and *fire* whichever citizen you want at any time.
- **Housing assignment mode:** Clicking on this button lets you switch between automatic or manual. If it's in automatic mode, citizens will be assigned a house as soon as they spawn (if housing is available). In manual mode, you can select which citizens will be housed in each [House](house) or [Tavern](tavern). This is better if you have a large colony and many workers spread out in a large area so you can house your citizens as close as possible to their workplace.
- **Print help messages:** Clicking on this button lets you choose whether MineColonies help messages will appear in the chat. It is recommended that this be turned on for first-time players.
- **Kids will be born:** Clicking on this button lets you choose whether new kids will be born in your colony.

**Page 2:** There are three buttons here:
- **Pick Team Color:** Whatever color you pick from here, your Guards will have a glow of this color around them when you put them in follow mode at their {% building_link guardtower %} or {% building_link barrackstower %}. This is for the PVP system, so you know which Guards are yours when you are fighting. Your citizens' names will also be in this color.
- **Edit Colony Flag:** Clicking this button will open up a banner designer where you can design your colony banner. Your {% worker_link knight %} will wear the finished design on their shields, and it is also used in some schematics.
![Town hall GUI banner designer](/assets/image/gui/th_colonybannerdesigner.png)
- **Switch Colony Pack:** This option controls the default selected style pack when opening the build tool.
- **Pick Citizen Style:** The option controls how the citizens look. This feature is exclusive for donators.
{% endbuilding_gui_content_block_custom %}

### **Work Orders:** Here you will see the work orders your

{% building_gui_content_block_custom image_key="th_workorders" image_alt="Townhall work orders" cols=6 %}
All the work orders in the order they have been assigned. {% worker_link builder plural=true %} will not start another order until they have successfully completed the top one.

**Page 1:** Blank page except for the header.

**Page 2:** Here are all the build orders for this colony (including decorations and your own schematics as well as huts). Your {% worker_link builder plural=true %} will complete the builds from top to bottom, and you can change the priority of the builds by moving them up or down in the list. You can also delete work orders. When you delete a work order that is currently being built, the Builder will stop building and will continue where they left off if you create the work order again."
{% endbuilding_gui_content_block_custom %}

### **Statistics:** This is the section for the global happiness of your colony so you can see what area needs more attention to raise the happiness level.

{% building_gui_content_block_custom image_key="th_statistics" image_alt="Townhall happiness" cols=6 %}
**Page 1:** The happiness indices. You can keep track of the areas that will lower or raise the happiness of your citizens here. The colors, in order from best to worst, are:
- Green (positive)
- Blue (neutral)
- Yellow (slightly negative)
- Red (negative)

There's also black, which will show up if something went wrong.

**Page 2:** Blank page.
{% endbuilding_gui_content_block_custom %}
5 changes: 5 additions & 0 deletions docs/Installation/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
index: false
title: "安装"
---
<AutoCatalog base='/Installation/' />
39 changes: 37 additions & 2 deletions docs/Installation/hmcl.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,41 @@
title: HMCL 启动器
---
# HMCL 启动器
> [!tip]
> 本文为中文Wiki原创

[[toc]]

本教程将通过使用[Hello Minecraft! Launcher](https://hmcl.huangyuhui.net/)下载并安装模拟殖民地。

## 下载Hello Minecraft! Launcher

点击[这里](https://hmcl.huangyuhui.net/download/)前往官方下载页面

## 安装Minecraft 1.20.1

打开启动器,在左侧选择`游戏-下载`->`新游戏-游戏`,游戏版本选择`1.20.1正式版`,安装最新版本的Forge。
::: tip
你可以重命名这个版本,例如`模拟殖民地`,以便于识别。
:::
::: caution
不要安装Optifine!这可能会导致出现一些莫名其妙的问题!
:::

## 安装模拟殖民地

返回主页,在左侧选择`游戏-下载`->`游戏内容-模组`,在名称处输入`Minecolonies`,选择游戏版本为`1.20.1`,点击搜索。
::: tip
你也可以搜索`模拟殖民地`,正常情况下也是可以搜索到的。
:::

搜索结果出现后,选择对应的结果,下拉找到1.20.1,点击展开后选择最新的版本(日期最接近现在的),确认安装。

## 安装前置

下载完成后,点击上方对应的前置模组,重复上述步骤,安装全部的前置模组。
::: caution
所有的前置模组缺一不可,缺少任何一个都无法启动游戏!
:::

## 启动游戏

当以上步骤完成后就可以启动游戏了!不过在这之前记得添加一个游戏账户哦!
13 changes: 10 additions & 3 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,19 @@ actions:
features:
title: 开始
---
<!-- @include: temp.md -->

# 欢迎来到模拟殖民地Wiki!
模拟殖民地是一个交互式建筑模组,可让你在 Minecraft 中创建自己的繁荣城镇。它通过提供一切你需要的工具,让你的领导技能得以发挥。模拟殖民地提供了灵活性,让你创建一个与其他玩家独一无二的殖民地。有了如此多的选择,你每次都会打造一个不同的殖民地,适应任何生态区域,建在山内、山顶、海底,或是天空中。
模拟殖民地是一个交互式建筑模组,可让你在Minecraft中创建自己的繁荣城镇。它通过提供一切你需要的工具,让你的领导技能得以发挥。模拟殖民地提供了灵活性,让你创建一个与其他玩家独一无二的殖民地。有了如此多的选择,你每次都会打造一个不同的殖民地,适应任何生态区域,建在山内、山顶、海底,或是天空中。
唯一的限制就是你的想象力!
模拟殖民地拥有 NPC 工人,例如 Builders, Farmers, Fishers, Foresters, Miners, Smelters, Bakers, Cooks, Couriers, five types of animal herders, Composters, and many more,随着模组的发展,更多内容正在开发和添加。
It also includes specialized buildings such as the Warehouse, Residence, Town Hall, Barracks, Library, University, and even the School.
模拟殖民地拥有NPC工人,例如 [建筑工], [Farmers], [渔夫], [护林员], [矿工], [Smelters], [Bakers], [Cooks], C[ouriers], 五种牧民, [Composters]等等,随着模组的发展,更多内容正在开发和添加。
It also includes specialized buildings such as the [Warehouse], [Residence], [市政厅], [Barracks], [图书馆], [大学], and even the School.

MineColonies is a free and open-source mod developed by Let's Dev Together (LDT), a non-profit community. The source code is available on [GitHub](https://github.com/ldtteam/minecolonies). Our developers are a hard-working, well-integrated coding team, continuously adding more content to make the MineColonies experience even greater. However, we are always looking for more people to contribute to the mod, whether as a coder, builder, artist, voice actor, wiki editor, tester, or simply supporting us on [Patreon](https://www.patreon.com/minecolonies)!

Found a bug? Report it as an [issue](https://github.com/ldtteam/minecolonies/issues/new/choose) to help us give you the best gaming experience. If you require any help or just want to join the conversation, check us out on [Discord](https://discord.minecolonies.com)!
## 让我们开始吧!
在导航栏中选择你要查看的页面。

::: tip
目前Wiki正处于起步阶段,当前的进度是将英文Wiki的内容搬运过来后进行本地化。
Expand Down
5 changes: 5 additions & 0 deletions docs/Tutorials/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
index: false
title: "教程"
---
<AutoCatalog base='/Tutorials/' />
Loading

0 comments on commit 7eca136

Please sign in to comment.