首次上传

docs/1_netease-tutorial-102.2/关于开发者账号和工具/5-安装与了解存档工具/1-编辑存档NBT.md

@@ -0,0 +1,29 @@
+# 编辑存档NBT
+
+ **NBT** （ **N** amed **B** inary  **T** ags）译为二进制命名标签，是《我的世界》独有的一种存储（序列化）格式，可以非常方便地存储《我的世界》的存档和网络交换信息。因此，为了编辑《我的世界》存档，我们必须知道如何编辑NBT。
+
+## NBT Studio
+
+NBT Studio是一款Java版和基岩版通用的NBT编辑软件，支持编辑Java版NBT文件、Java版区域文件（`.mca`、`.mcr`）、基岩版NBT文件、SNBT文件等。
+
+### 下载
+
+打开NBT Studio的GitHub发布页，我们可以下载到最新版NBT Studio：https://github.com/tryashtar/nbt-studio/releases 。下载最新版本的“ **Assets（资产）** ”一栏下方的`NbtStudio.exe`文件即可。
+
+### 使用
+
+用NBT Studio打开一个NBT文件即可使用。基岩版一个存档的根目录下的`level.dat`文件便是一个典型的基岩版NBT文件。我们打开一个`level.dat`，以此为例来了解NBT Studio的功能。
+
+![image-20240802194912573](./assets/image-20240802194912573-1722599353716-67.png)
+
+上图是一个完整的`level.dat`文件在NBT Studio中打开后所显示的界面。NBT是一个树状结构，结构中的每个字段都会有一个类型，例如上图的根节点`level.dat`是一个复合标签类型，复合标签下可以挂接多个其他字段。其下的`BiomeOverride`是字符串类型，`CenterMapsToOrigin`是字节类型，等。具体的NBT格式你可以参考中文Minecraft Wiki的[NBT格式](https://zh.minecraft.wiki/w/NBT%E6%A0%BC%E5%BC%8F)页面。如果你学有余力，可以额外参考[这个页面（英文）](https://wiki.vg/NBT)。
+
+双击一个字段以编辑它的键名和值。选中一个复合标签，例如上图我们选中了`level.dat`字段，之后点击工具栏上的“B”、“S”等类型按钮，便可以在该复合标签下添加一个新的选中类型的字段。具体类型可以将鼠标移动到按钮上方，以查看该按钮的工具提示信息。
+
+NBT Studio还有编辑SBNT等其他高级功能，但对于初学者而言，了解至此便已足够。如果你感兴趣，你可以自行探索这款软件。
+
+## LevelDB
+
+基岩版的存档有一个`level.dat`和一个LevelDB结构合在一起而组成。`level.dat`文件用于存储该世界的基本配置信息。LevelDB用于存储该世界内的区块格式信息和必要的硬编码数据信息。《我的世界》使用一种改造的LevelDB格式来结合NBT存储区块等信息，因此你需要一款能够编辑《我的世界》这种特殊LevelDB的工具来修改存档。
+
+如果你对底层的直接修改感兴趣，我们推荐[McpeTool](https://github.com/midnightfreddie/McpeTool)这款工具。但由于这款工具使用命令行或网页API，门槛过高，我们不做介绍。在之后的课程中，我们会介绍更多友善且实用的存档编辑软件，可以部分访问且修改到LevelDB内的信息。请继续向后阅读！

docs/1_netease-tutorial-102.2/关于开发者账号和工具/5-安装与了解存档工具/2-安装BedrockMap.md

@@ -0,0 +1,15 @@
+# 安装BedrockMap
+
+BedrockMap是一款能够修改基岩版存档的免费工具。提供了`level.dat`修改，部分的LevelDB修改，可视化地形地图等多种功能。下面，我们一起来下载和安装BedrockMap。
+
+![sample.png](./assets/sample.png)
+
+## 下载
+
+BedrockMap发布在GitHub，我们需要访问GitHub的发布页来获取最新版本的BedrockMap：https://github.com/bedrock-dev/BedrockMap/releases 。下载最新版本的`BedrockMap.vx.x.x.zip`即可。
+
+![image-20240802202859663](./assets/image-20240802202859663-1722601740790-75.png)
+
+该软件是免安装软件，因此你只需要将包体内的文件解压到你指定的一个空文件夹中，便可以完成安装。
+
+双击`BedrockMap.exe`打开该软件。

docs/1_netease-tutorial-102.2/关于开发者账号和工具/5-安装与了解存档工具/3-BedrockMap简介.md

@@ -0,0 +1,81 @@
+# BedrockMap简介
+
+当你下载好BedrockMap之后，便可以双击`BedrockMap.exe`来使用它了！当然，你也可以右键该可执行程序，发送快捷方式到桌面来方便以后快速打开。
+
+## 基本功能
+
+![image-20240802200728397](./assets/image-20240802200728397-1722600449837-71.png)
+
+打开BedrockMap后，我们需要选择一个基岩版存档进行打开，点击中央的“未打开存档”按钮，将弹出文件选择器用于选择你的存档。选择合适的基岩版存档打开。
+
+![image-20240802201536709](./assets/image-20240802201536709-1722600938117-73.png)
+
+左侧的竖列是地图中控制显示的选项和工具。从上到下依次是：
+
+- 显示区块和区域网格
+- 在区块和区域网格左上角显示坐标
+- 显示主世界地图
+- 显示下界地图
+- 显示末地地图
+- 显示地形图
+- 显示群系图
+- 显示高度图
+- 显示史莱姆区块
+- 显示实体
+- 显示村庄
+- 显示硬编码生成区域（HSA）
+- 过滤显示的工具
+- 编辑该存档内 **除了区块数据之外的NBT** ，点击后会在底部打开选择和编辑窗口
+
+如果要编辑某一区块的相关NBT，你需要定位到该区块，然后右键。然后在右键菜单中选择“ **在区块编辑器中打开** ”。
+
+![image-20240802202125398](./assets/image-20240802202125398.png)
+
+然后你会在右侧看到区块编辑器，这里是查看和编辑区块NBT数据的窗口。你可以在这里编辑地形、实体、方块实体和计划刻数据。
+
+注意，进行编辑前请务必勾选编辑窗口内的“ **编辑** ”按钮，之后存档才可以编辑。这样做是为了默认保护存档不会在预期之外遭到编辑。
+
+该工具完全开源免费，如果你学有余力，且具有一定的专业水平，也可以参与开发贡献，让我们的开发社区变得更好。
+
+如果你还未明白该工具内的某些功能，请不要着急，你可以多创建一些存档慢慢尝试和实验，相信你很快就能总结出存档编辑的规律！
+
+### 中国版存档
+
+如果你想从国际版编辑存档并移植发布到中国版，那么你在BedrockMap中见到的界面将如同上面所述，没有任何问题。但是如果你的存档是从中国版从零创建的，例如来自于《我的世界》开发工作台，那么你将会遇到下面的问题：
+
+我们现在拥有一个刚从《我的世界》开发工作台创建的存档。在用BedrockMap打开该存档后，你将只能看到如下形状：
+
+![image-20240807140849216](./assets/image-20240807140849216.png)
+
+换言之，存在地形的位置将错误显示为纯黑，不存在地形的位置将正常显示为透明棋格样式。这是由于BedrockMap的一些不兼容性导致的。不过，除了不能正常绘制地形地图之外，其余的功能将全部正常。包括如下这些功能：
+
+#### 右键显示方块数据
+
+![image-20240807141052299](./assets/image-20240807141052299.png)
+
+#### 区块编辑器中右键读取方块
+
+虽然所有方块显示为纯黑，但这并不影响读取该方块的信息。
+
+![image-20240807141119499](./assets/image-20240807141119499.png)
+
+#### 实体地图和区块编辑器中编辑实体
+
+![image-20240807141151256](./assets/image-20240807141151256.png)
+
+#### 生物群系地图
+
+![image-20240807141237688](./assets/image-20240807141237688.png)
+
+#### 高度图
+
+![image-20240807141249846](./assets/image-20240807141249846.png)
+
+#### 其他独立NBT编辑
+
+![image-20240807141311479](./assets/image-20240807141311479.png)
+
+以及其他所有功能。简而言之，只有地形绘制功能因某些不兼容性问题缺失。这并不影响其它功能的使用。
+
+当然，如果你对地形地图的功能非常依赖，请翻开下一课，我们将介绍另一款可以正常绘制中国版地图的地形图的存档编辑工具！
+

docs/1_netease-tutorial-102.2/关于开发者账号和工具/5-安装与了解存档工具/4-安装Universal Minecraft Tool.md

@@ -0,0 +1,43 @@
+# 安装Universal Minecraft Tool
+
+Universal Minecraft Tool（简称UMT）是一款收费的《我的世界》地图编辑软件，它具有更多更强大的《我的世界》地图编辑功能，除此之外，他还有近乎完美的、不限制大小的JE、BE地图转换功能和地图修剪功能。并且，他正常支持中国版创建的存档的地形地图。
+
+## 订阅
+
+为了使用UMT，你需要向UMT的开发团队付费。打开UMT的官方网站：https://www.universalminecrafttool.com/ 。
+
+![image-20240802203621111](./assets/image-20240802203621111-1722602183736-79.png)
+
+点击顶部栏的“ **Pricing（定价）** ”按钮，你可以看到各档位的定价。
+
+![image-20240802203149397](./assets/image-20240802203149397-1722601910828-77.png)
+
+你依旧可以选择免费继续，但这样你将只能编辑`level.dat`，而不能享受其他所有功能。
+
+## 下载
+
+假设我们已经为我们的账户进行了付费，我们接下来一起来下载UMT软件。
+
+点击官网上方的“ **Download（下载）** ”按钮，我们来到UMT的下载页：
+
+![image-20240802203705810](./assets/image-20240802203705810-1722602227058-81.png)
+
+这款工具支持在Windows上运行，在此点击蓝色的“ **Download（下载）** ”按钮下载安装包。
+
+## 安装
+
+下载完成后，双击安装包以开始安装：
+
+![image-20240802203838426](./assets/image-20240802203838426-1722602320228-83.png)
+
+你可以根据自己的喜好更改安装路径。
+
+![image-20240802203908573](./assets/image-20240802203908573-1722602350077-85.png)
+
+在点击“ **Next（下一步）** ”后，可以选择是否创建桌面快捷方式，默认为创建。然后再次点击“ **Next（下一步）** ”，我们来到准备安装界面：
+
+![image-20240802204005011](./assets/image-20240802204005011-1722602406376-87.png)
+
+点击“ **Install（安装）** ”，等待安装完成即可。
+
+这样我们便安装了UMT软件！安装完成UMT后，如果你选择了创建桌面快捷方式，我们会在桌面上找到名为“Universal Minecraft Tool”的快捷方式，双击即可打开UMT。

docs/1_netease-tutorial-102.2/关于开发者账号和工具/5-安装与了解存档工具/5-Universal Minecraft Tool简介.md

@@ -0,0 +1,103 @@
+# Universal Minecraft Tool简介
+
+安装完成Universal Minecraft Tool（UMT）之后，我们便可以打开UMT使用它的功能了！
+
+## 登录
+
+UMT的订阅是与我们在付费时注册的UMT账号绑定的，因此我们需要先登录我们的账号。在此期间，请确保你的网络良好，能够连通UMT的登录服务器。
+
+![image-20240802204915554](./assets/image-20240802204915554.png)
+
+输入账号和密码之后，点击“Sign In（登录）”即可完成登录。
+
+## 基本功能
+
+登录完成后，我们将来到功能选择界面：
+
+![image-20240802205036593](./assets/image-20240802205036593-1722603037728-89.png)
+
+UMT有三个基本功能：
+
+- NBT Editor（NBT编辑器）：编辑存档中的NBT，查看区块地图和各项数据。
+- Converter（转换器）：将JE、BE、主机板存档在它们之间互相转换。
+- Pruner（修剪器）：修剪地形，去掉想去掉的部分，使地形没有赘余。
+
+![image-20240802205306687](./assets/image-20240802205306687-1722603187709-91.png)
+
+不管是选择哪个功能，你都需要先选择一个存档继续。点击你希望使用的版本，并选择符合该版本的存档。
+
+### NBT Editor
+
+在 **NBT Editor** 中，当你选择一个存档后，你将打开如下页面：
+
+![image-20240802205449150](./assets/image-20240802205449150-1722603291075-93.png)
+
+我们依次介绍各部分功能：
+
+- Chunk Locator（区块定位器）：打开一个区块地图，供你定位到你想编辑的区块，以进行下一步的编辑。
+
+  ![image-20240802205550141](./assets/image-20240802205550141-1722603351928-95.png)
+
+  点击想要编辑的区块后，点击“ **Open Selected Chunk（打开选择的区块）** ”，便可以进入该区块信息的编辑界面：
+
+  ![image-20240802205640874](./assets/image-20240802205640874-1722603402200-97.png)
+
+- LevelDB Search（LevelDB搜索）：搜索LevelDB键名，更细节且底层地编辑区块和相关数据。
+
+  ![image-20240802205748782](./assets/image-20240802205748782-1722603470020-99.png)
+
+- World Settings（世界设置）：打开`level.dat`的编辑界面。
+
+  ![image-20240802205819524](./assets/image-20240802205819524-1722603501245-101.png)
+
+- Players（玩家）：点击展开该存档加入过的所有玩家的数据。双击玩家数据可以编辑该NBT数据。
+
+  ![image-20240802205925416](./assets/image-20240802205925416-1722603566311-103.png)
+
+  ![image-20240802205933320](./assets/image-20240802205933320-1722603574479-105.png)
+
+- All Files（所有文件）：浏览实际目录的所有文件。
+
+  ![image-20240802210010316](./assets/image-20240802210010316-1722603611305-107.png)
+
+### Converter
+
+在 **Converter** 中，当你打开一个存档后，会继续弹出一个版本选择界面，询问你要将存档转换为何种版本，你也可以选择目标版本的版本号：
+
+![image-20240802210150254](./assets/image-20240802210150254-1722603711576-109.png)
+
+选择完成后，点击“ **Next（下一步）** ”按钮进入转换选项界面。
+
+![image-20240802210319141](./assets/image-20240802210319141.png)
+
+这里选择你可以转换哪些内容，限制哪些内容不转换，以及一些额外的设置。在此点击点击“ **Next（下一步）** ”按钮进入准备转换界面，点击“ **Start Conversion（开始转换）** ”按钮开始转换。
+
+转换器会先扫描世界：
+
+![image-20240802210503760](./assets/image-20240802210503760-1722603905753-111.png)
+
+然后转换相关区块：
+
+![image-20240802211905407](./assets/image-20240802211905407-1722604746477-117.png)
+
+在转换期间，你可以点击左侧的NBT Editor或Pruner同时进行其他工作。在转换完成后，你可以看到如下界面：
+
+![image-20240802211931296](./assets/image-20240802211931296-1722604772250-119.png)
+
+“ **Start Over（重新开始）** ”按钮将放弃此次转换，重新开始。“ **Save World（保存世界）** ”按钮按下后会让你选择一个位置进行存储，之后你转换的世界会存储在你选择的位置处。当你需要转换多个存档时，你可以在保存世界之后点击重新开始，重新开始新的其他转换。
+
+### Pruner
+
+在 **Pruner** 中，你可以通过左侧的工具选取想要剔除的区域进行修剪。
+
+![image-20240802211308723](./assets/image-20240802211308723-1722604390394-113.png)
+
+长按“ **Prune（修剪）** ”按钮五秒即可完成修剪。
+
+点击“ **Inverted（反选）** ”按钮可以将剔除变为保留。
+
+![image-20240802211406079](./assets/image-20240802211406079-1722604447062-115.png)
+
+此外，点击 **“Optimize（优化）** ”按钮可以优化世界，优化世界需要一段时间，可以清理你的LeveDB中无用的键名，提升你存档的性能！你可以在长期游玩的大存档中善用这个功能。
+
+以上是UMT的所有基本功能。一些功能的细节在这里并为详细说明，还请大家善于自行探索和总结，发掘新的功能！

docs/1_netease-tutorial-102.2/关于开发者账号和工具/5-安装与了解存档工具/6-Chunker简介.md

@@ -0,0 +1,45 @@
+# Chunker简介
+
+Chunker是Mojang联合Hive Games开发的一款在线JE、BE地图转换器，是一款WebApp。
+
+## 访问
+
+访问Chunker的网址：https://chunker.app/ 即可打开该WebApp。当你成功访问时，你将看到如下页面：
+
+![image-20240802212738249](./assets/image-20240802212738249-1722605260367-121.png)
+
+## 基本功能
+
+Chunker的基本功能便是世界版本转换。你可以点击左侧按钮选择一个存档所在的文件夹开始，或点击右侧按钮选择一个存档压缩包以开始。
+
+选择好存档之后，Chunker会开始上传：
+
+![image-20240802212950181](./assets/image-20240802212950181-1722605394200-123.png)
+
+如若上传顺利，上传完成后，会自动进入选择输出版本的页面：
+
+![image-20240802213024656](./assets/image-20240802213024656-1722605425787-125.png)
+
+他会标注哪些版本目前是测试版，以及你上传存档的源版本（图片的例子中是JE 1.20.0）：![image-20240802213109531](./assets/image-20240802213109531-1722605471900-127.png)
+
+选择好之后，在页面底部可以选择进入“ **Advanced Mode（高级模式）** ”或直接开始“ **Convert & Download（转换并下载）** ”。为了演示，我们这里直接开始转换，如果你想进入高级模式修改一些转换选项，你可以参考Microsoft Learn上的教程[高级模式](https://learn.microsoft.com/en-us/minecraft/creator/documents/chunkeradvancedmode?view=minecraft-bedrock-experimental)。
+
+![image-20240802213245015](./assets/image-20240802213245015-1722605567256-129.png)
+
+如果你之前有人正在使用该工具，你将进入排队模式。如图示例，我当前在队伍中的第一位，这意味着我前面的人处理完成之后就会开始处理我的存档。
+
+![image-20240802213302045](./assets/image-20240802213302045.png)
+
+开始处理存档后，将显示转换进度。
+
+![image-20240802213308062](./assets/image-20240802213308062.png)
+
+转换完成后，Chunker将开始压缩我们转换好的存档。将我们的存档压缩成压缩包供之后下载。
+
+![image-20240802213324360](./assets/image-20240802213324360.png)
+
+压缩完成后，“Download（下载）”按钮将可用，我们可以点击该按钮下载我们的存档。这样我们就完成了一次存档转换！
+
+![image-20240802213329731](./assets/image-20240802213329731.png)
+
+以上便是Chunker提供的基本功能。值得注意的是，Chunker支持转换的存档大小有限。如果你希望进行超大存档的转换，请使用上一课教授的工具Universal Minecraft Tool。