Skip to content

Commit

Permalink
docs(SlopeCraft-tutorial.md): 优化缩进
Browse files Browse the repository at this point in the history
  • Loading branch information
@Mifan-T
Mifan-T committed Aug 12, 2024
1 parent 5a5a84b commit cc6c5c9
Showing 1 changed file with 57 additions and 57 deletions.
114 changes: 57 additions & 57 deletions docs/SlopeCraft-tutorial.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
| 地图文件 | 存储地图数据的 nbt 二进制文件，文件名形如 `map_<i>.dat` |

!!! tip "tip"
在菜单栏的 语言 下拉菜单中你可以找到切换语言的选项。
在菜单栏的 语言 下拉菜单中你可以找到切换语言的选项。

## Step 0. 图片预处理

Expand Down Expand Up @@ -62,7 +62,7 @@
- **平板地图画**：传统的地图画类型，**画质一般**，建造较简单。
- **纯文件地图画**：原版地图画能达到的**极限画质**，无法建造，一般只能通过指令获得。如果你不需要让地图画在游戏中以方块的形式存在，只需要让它显示于地图、并能被贴在物品展示框中，那么请选择此项。

请注意，这种纯文件地图画在使用时至少需要替换存档中的文件，有可能还需要使用命令。一般只适用于单机游戏，如果你是服务器管理员也可以。
请注意，这种纯文件地图画在使用时至少需要替换存档中的文件，有可能还需要使用命令。一般只适用于单机游戏，如果你是服务器管理员也可以。

这里我选择了立体地图画。

Expand Down Expand Up @@ -111,14 +111,14 @@ ________________________________________________________________________________
### 2.1 导入图像

??? question "“项目池”是什么？"
SlopeCraft在5.10版本引入了新功能：“**项目池**”，
你导入的每一张图片都会被程序创建为一个项目，后续的各种转换操作会为项目添加数据 。
*~~（没用的知识增加了(=・ω・=)！）~~* 。
SlopeCraft在5.10版本引入了新功能：“**项目池**”，
你导入的每一张图片都会被程序创建为一个项目，后续的各种转换操作会为项目添加数据 。
*~~（没用的知识增加了(=・ω・=)！）~~* 。

项目池的操作逻辑和系统文件管理器类似：选中单个图片，预览或进行相应操作
项目池的操作逻辑和系统文件管理器类似：选中单个图片，预览或进行相应操作

简单来说，你现在可以很方便地进行批量操作了！
**注意：同一批图像只能使用一种转换算法，风格、颜色差异大的图建议分批操作！**
简单来说，你现在可以很方便地进行批量操作了！
**注意：同一批图像只能使用一种转换算法，风格、颜色差异大的图建议分批操作！**

在项目池中，点击**添加**就可以导入**一个或多个**预处理后的图像，

Expand Down Expand Up @@ -232,31 +232,31 @@ SlopeCraft 支持两种压缩方式：有损和无损。

=== "Litematica 投影"

在 投影名称 和 投影区域名称 栏中，可以填入投影文件的信息。但这不是强制的。
在 投影名称 和 投影区域名称 栏中，可以填入投影文件的信息。但这不是强制的。

![Litematica options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-litematica.png)
![Litematica options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-litematica.png)

=== "原版结构方块文件"

原版结构方块文件采用稀疏矩阵的方式存储，没有存储的地方是结构空位。这种存储方式使得结构方块文件是原版兼容性最好但压缩率最差劲的格式。
原版结构方块文件采用稀疏矩阵的方式存储，没有存储的地方是结构空位。这种存储方式使得结构方块文件是原版兼容性最好但压缩率最差劲的格式。

![Structure options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-structure.png)
![Structure options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-structure.png)

因此结构方块文件就有了两种存储空气方块的选择：当作结构空位，或者如实存储。当作结构空位可以极大的节省空间，但在结构方块中粘贴出来时，不能覆盖掉其他的非空气方块；按空气方块存储可以克服这个问题，但文件体积会很大。
因此结构方块文件就有了两种存储空气方块的选择：当作结构空位，或者如实存储。当作结构空位可以极大的节省空间，但在结构方块中粘贴出来时，不能覆盖掉其他的非空气方块；按空气方块存储可以克服这个问题，但文件体积会很大。

=== "WE 原理图"

WE 原理图的属性略多，它们是对 WorldEdit 生成的原理图逆向工程得来的，直接对应着同名的 nbt 标签。
WE 原理图的属性略多，它们是对 WorldEdit 生成的原理图逆向工程得来的，直接对应着同名的 nbt 标签。

![WE options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-WE.png)
![WE options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-WE.png)

我并不清楚这些元属性对原理图有怎样的影响，因为我几乎不使用 WE。

=== "平面示意图"

设置导出的示意图是否包含分割线、以及分割线的间距。
设置导出的示意图是否包含分割线、以及分割线的间距。

![Flat Diagram options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-flat_diagram.png)
![Flat Diagram options](./assets/SlopeCraft-tutorial-images/page3-Export-extra_set-flat_diagram.png)

#### 预构建三维结构进行预览（可选）

Expand Down Expand Up @@ -303,15 +303,15 @@ ________________________________________________________________________________

- 如果你想通过/give命令来获得地图：

起始序号可以随意设置，只要不覆盖掉无关的地图。
起始序号可以随意设置，只要不覆盖掉无关的地图。

- 如果你不想使用命令，只替换地图文件：

**1.** 先创建与地图画对应的`n`个地图，n 就是 SlopeCraft 显示的地图文件数量，在本例中是 4。
**1.** 先创建与地图画对应的`n`个地图，n 就是 SlopeCraft 显示的地图文件数量，在本例中是 4。

**2.** 在游戏中查看地图文件对应的序号。这些地图对应的序号应当是 `a`~`(a+n-1)` ，共 n 个。
**2.** 在游戏中查看地图文件对应的序号。这些地图对应的序号应当是 `a`~`(a+n-1)` ，共 n 个。

**3.** 退出世界，在 SlopeCraft 的**地图文件起始序号**栏中填入`a`的值。
**3.** 退出世界，在 SlopeCraft 的**地图文件起始序号**栏中填入`a`的值。

确认设置无误后，就可以点击 **导出** ，选择相应的**文件夹**用于导出所有文件（建议使用空文件夹）。

Expand Down Expand Up @@ -339,7 +339,7 @@ ________________________________________________________________________________

=== "导入结构方块文件"

打开刚刚导出文件的文件夹，将导出的文件移动到 **结构方块文件目录**(1)下。然后打开 Minecraft，进入存档/服务器，在你想要创建地图画的地方加载这个结构。
打开刚刚导出文件的文件夹，将导出的文件移动到 **结构方块文件目录**(1)下。然后打开 Minecraft，进入存档/服务器，在你想要创建地图画的地方加载这个结构。
{ .annotate }

1. 结构方块的目录为：
Expand All @@ -356,7 +356,7 @@ ________________________________________________________________________________

=== "导入 WE 原理图"

打开刚刚导出文件的文件夹，将导出的文件移动到 **WE原理图文件目录**(1)下。
打开刚刚导出文件的文件夹，将导出的文件移动到 **WE原理图文件目录**(1)下。
{ .annotate }

1. World Edit原理图的目录为：
Expand All @@ -371,10 +371,10 @@ ________________________________________________________________________________

=== "导入地图文件"

打开刚刚导出文件的文件夹，将导出的文件移动到 **地图文件目录**(1)下。
打开刚刚导出文件的文件夹，将导出的文件移动到 **地图文件目录**(1)下。
{ .annotate }

1. 地图文件的目录为：
1. 地图文件的目录为：
`.minecraft(1)/saves/<游戏存档名>/data`
{ .annotate }

Expand Down Expand Up @@ -439,16 +439,16 @@ SlopeCraft 采用缓存减少转化多张图片时的内存占用，正常情况
| 1.19 立体 | 1.19 平面 | 1.19 纯文件 |

??? question "有什么用？"
输出颜色表实际上就是导出“色板”，以便于像素画创作
输出颜色表实际上就是导出“色板”，以便于像素画创作

如果你想要自己作画，并用在游戏里，请遵循以下步骤，避免发生意料之外的错误：
如果你想要自己作画，并用在游戏里，请遵循以下步骤，避免发生意料之外的错误：

1. 首先要完成“地图画配置”页面的设置，这样才能输出你想要的颜色表
2. 在高级设置内导出颜色表
3. 将颜色表导入到相应的图像处理软件，进行创作，并导出图像
4. 再次进行“地图画配置”页面的设置(如果你关闭过软件的话)，并导入图像
5. 在转换图像时，选择RGB+算法，**不要**勾选抖动
6. 剩下的导出步骤就和普通流程一样了，参见[上文](#step-3)
1. 首先要完成“地图画配置”页面的设置，这样才能输出你想要的颜色表
2. 在高级设置内导出颜色表
3. 将颜色表导入到相应的图像处理软件，进行创作，并导出图像
4. 再次进行“地图画配置”页面的设置(如果你关闭过软件的话)，并导入图像
5. 在转换图像时，选择RGB+算法，**不要**勾选抖动
6. 剩下的导出步骤就和普通流程一样了，参见[上文](#step-3)

______________________________________________________________________________________________________________

Expand All @@ -462,43 +462,43 @@ ________________________________________________________________________________

1. 方块的**完整**id，包含**命名空间前缀**以及**所有方块属性**。

如涂蜡铜块上半砖：
如涂蜡铜块上半砖：

```file
minecraft:waxed_copper_slab[type=top,waterlogged=false]
```
```file
minecraft:waxed_copper_slab[type=top,waterlogged=false]
```

这里面`minecraft:`是原版方块的命名空间前缀，中括号里的内容是所有方块属性。保险起见，你应当给每个方块属性都设置对应的值。
这里面`minecraft:`是原版方块的命名空间前缀，中括号里的内容是所有方块属性。保险起见，你应当给每个方块属性都设置对应的值。

2. 方块最早出现的游戏版本

SlopeCraft 在方块列表中约定了以下几个值代指大版本：
SlopeCraft 在方块列表中约定了以下几个值代指大版本：

| 数字 | 版本 |
| :---: | :-------: |
| 0 | 早于 1.12 |
| 12 | 1.12 |
| 13 | 1.13 |
| 14 | 1.14 |
| 15 | 1.15 |
| 16 | 1.16 |
| 17 | 1.17 |
| 18 | 1.18 |
| 19 | 1.19 |
| 20 | 1.20 |
| 255 | 未来版本 |
| 数字 | 版本 |
| :---: | :-------: |
| 0 | 早于 1.12 |
| 12 | 1.12 |
| 13 | 1.13 |
| 14 | 1.14 |
| 15 | 1.15 |
| 16 | 1.16 |
| 17 | 1.17 |
| 18 | 1.18 |
| 19 | 1.19 |
| 20 | 1.20 |
| 255 | 未来版本 |

正常情况下，你不应该使用 255，它只是一个预留的值。如果你非要给一个方块指定为未来版本，那么导致的一切都属于未定义特性——我也不知道会发生什么。
正常情况下，你不应该使用 255，它只是一个预留的值。如果你非要给一个方块指定为未来版本，那么导致的一切都属于未定义特性——我也不知道会发生什么。

3. 方块在 1.12 的 id

添加这个属性是因为 Mojang 从 1.12 更新到 1.13 修改了相当多方块的 id。如果你要添加的方块在 1.12 未添加，或者 id 没有改变，可以填空字符串。
添加这个属性是因为 Mojang 从 1.12 更新到 1.13 修改了相当多方块的 id。如果你要添加的方块在 1.12 未添加，或者 id 没有改变，可以填空字符串。

4. 方块的基色

这可能是最容易出错的地方。对于原版方块，你可以查询[Minecraft Wiki](https://zh.minecraft.wiki/w/%E5%9C%B0%E5%9B%BE%E7%89%A9%E5%93%81%E6%A0%BC%E5%BC%8F#%E5%9F%BA%E8%89%B2)。如果是 mod 自定义的方块，要么自己想办法测，要么去问 mod 开发者。
这可能是最容易出错的地方。对于原版方块，你可以查询[Minecraft Wiki](https://zh.minecraft.wiki/w/%E5%9C%B0%E5%9B%BE%E7%89%A9%E5%93%81%E6%A0%BC%E5%BC%8F#%E5%9F%BA%E8%89%B2)。如果是 mod 自定义的方块，要么自己想办法测，要么去问 mod 开发者。

如果不懂什么是基色，去看[地图画原理](./principles-introduction.md)
如果不懂什么是基色，去看[地图画原理](./principles-introduction.md)

5. 方块中文名称
6. 方块英文名称
Expand Down Expand Up @@ -578,4 +578,4 @@ SlopeCraft 中，方块列表以 json 格式存储，相关的图片放在 Fixed
src="https://cdn.jsdelivr.net/npm/sakana-widget@2.7.0/lib/sakana.min.js"
></script>

*你发现了世界的尽头(=・ω・=)，奖励你一个石蒜*
*你发现了世界的尽头(=・ω・=)，奖励你一个石蒜*

0 comments on commit cc6c5c9

Please sign in to comment.