Minecraft世界转换工具Chunker的完整使用指南

Minecraft世界转换工具Chunker的完整使用指南

【免费下载链接】ChunkerConvert Minecraft worlds between Java Edition and Bedrock Edition项目地址: https://gitcode.com/gh_mirrors/chu/Chunker

Chunker是一款功能强大的开源Java应用程序，专门用于在Minecraft的Java版和基岩版之间转换世界文件。无论你是想在两个版本间迁移世界，还是需要升级或降级世界版本，Chunker都能提供简单易用的解决方案。

项目核心功能概述

Chunker的主要功能包括：

• 跨版本转换：在Java版和基岩版之间无缝转换世界
• 版本升级降级：支持在世界文件的不同游戏版本间进行升级和降级操作
• 批量处理：能够高效处理大型世界文件的转换
• 设置自定义：提供丰富的转换选项和配置参数

系统环境要求

在开始使用Chunker之前，请确保你的系统满足以下要求：

• Java 17或更高版本：这是运行Chunker的基础环境
• 足够的内存：建议至少8GB可用内存，大世界文件需要更多
• 磁盘空间：确保有足够的空间存储原始和转换后的世界文件

快速安装步骤

方法一：使用预编译版本

1. 从项目的发布页面下载适合你操作系统的预编译版本
2. 解压下载的文件到合适的位置
3. 直接运行可执行文件即可启动图形界面

方法二：从源码构建

如果你希望从源码构建Chunker，可以按照以下步骤操作：

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/chu/Chunker.git

2. 构建项目

   cd Chunker ./gradlew build

3. 获取构建产物构建完成后，在build/libs/目录下可以找到以下文件：

   • CLI版本的JAR文件
   • 原生CLI可执行文件
   • 包含Electron前端的完整版本

图形界面使用教程

启动应用程序

如果你使用的是包含Electron前端的版本，直接运行对应的可执行文件即可启动图形界面。

基本转换流程

1. 选择输入世界：点击"选择世界"按钮，找到你的Minecraft世界文件夹

2. 配置输出设置：

   • 选择输出目录
   • 指定目标格式（如JAVA_1_20_5或BEDROCK_1_19_30）

3. 开始转换：点击"开始转换"按钮，Chunker将自动处理所有转换工作

4. 监控进度：在转换过程中，你可以实时查看转换进度和状态

命令行界面高级用法

对于需要批量处理或集成到自动化流程中的用户，Chunker提供了功能强大的命令行界面。

基本命令格式

java -jar chunker-cli-VERSION.jar -i "输入世界路径" -o "输出路径" -f "目标格式"

必需参数说明

• -i/--inputDirectory：输入世界的文件夹路径
• -o/--outputDirectory：输出世界的文件夹路径
• -f/--outputFormat：输出格式，格式为EDITION_X_Y_Z，例如JAVA_1_20_5或BEDROCK_1_19_30

可选参数配置

• -m/--blockMappings：块映射的JSON文件路径或JSON对象
• -s/--worldSettings：世界设置的JSON文件路径或JSON对象
• -p/--pruning：修剪设置的JSON文件路径或JSON对象
• -c/--converterSettings：转换器设置的JSON文件路径或JSON对象

查看可用格式

要查看Chunker支持的所有格式，可以运行：

java -jar chunker-VERSION.jar -f ?

内存配置优化

Chunker默认使用最多75%的可用内存。如果你的世界文件较大，可以手动配置内存使用量：

Chunker.exe -Xmx8G

对于其他JVM选项，可以使用--java-options="..."参数。

支持的格式版本

基岩版支持

• 1.12.0 - 1.21.130

Java版支持

• 1.8.8 - 1.21.11

常见问题与解决方案

转换速度慢

• 确保分配足够的内存
• 关闭其他占用资源的应用程序
• 使用SSD硬盘可以显著提升读写速度

内存不足错误

• 增加JVM内存分配：-Xmx8G（8GB）
• 清理系统内存，关闭不必要的程序

格式不支持

• 确保你选择的格式在Chunker的支持列表中
• 检查输入世界的版本是否在支持范围内

注意事项

目前Chunker在转换过程中对以下功能的支持有限：

• 实体（画和物品展示框除外）
• 结构数据（如村庄、要塞等）

通过本指南，你应该能够顺利安装和使用Chunker来转换你的Minecraft世界。如果在使用过程中遇到任何问题，建议参考项目文档或寻求社区帮助。

【免费下载链接】ChunkerConvert Minecraft worlds between Java Edition and Bedrock Edition项目地址: https://gitcode.com/gh_mirrors/chu/Chunker