Android 项目设置

工具推荐 ​

为 Android 平台寻找合适的附加包开发应用并不容易，但我们已尽力为您收集了 Google Play 上的优质应用。在 Android 上进行开发，您需要以下三类应用的组合：

1. 文件管理器（若设备运行 Android 12 或更高版本，需支持创建 ZIP 压缩包）
2. 代码编辑器（任何文本编辑器均可使用，但只有专业代码编辑器能提供语法高亮）
3. 图像编辑器（系统自带的编辑器通常无法进行像素级编辑）

文件管理器 ​

以下文件管理器已知具备 ZIP 压缩功能，并能访问 Android/data 文件夹（仅查看权限）：

1. Zarchiver - 支持多种压缩格式（ZIP/7z/RAR等），可创建/解压加密压缩包，支持多线程加速。在已 root 设备或使用 Shizuku 时，可修改 Android/data 和系统目录文件。

2. X-Plore - 双面板树状视图文件管理器，内置文本编辑器（非代码专用），支持多种压缩格式。root 后可直接编辑 Android/data。

3. Total Commander - 基础功能略逊于 X-Plore，但同样支持双面板/ZIP/RAR，能以列表视图访问 Android/data（需插件扩展功能）。

代码编辑器 ​

1. Acode：免费版含可关闭的广告。支持 GitHub 集成（需个人访问令牌）、FTP/SFTP、100+ 语言语法高亮（含 JSON）、多标签页编辑、多种主题。付费版提供深度主题定制。

图像编辑器 ​

1. Pocket Paint - 轻量级编辑器，支持 JPG/PNG/ORA 多图层格式，开源免费。
2. PixaPencil - 无广告内购，提供丰富画笔工具，支持调色板保存（仅 F-droid 分发）。
3. Pix2D - 简易轻量，适合制作纹理占位图或小型动画。

工作区设置 ​

首先创建工作区：

1. 使用文件管理器进入内部存储（通常为 / 或 /storage/emulated/0/）
2. 创建总项目文件夹（示例路径：/Minecraft Packs/MyFirstAddon）
3. 在其中分别创建行为包和资源包子文件夹（示例：../MyFirstAddon/addonBP 和 ../MyFirstAddon/addonRP）

在 Acode 中配置工作区：

1. 打开 Acode → 点击左上角三横线图标 → 选择"打开文件夹"
2. 添加存储 → 选择文件夹 → 导航至项目总文件夹（如 /Minecraft Packs）
3. 授权访问后，即可在文件浏览器中树状查看工作区

Shizuku 配置（可选） ​

配置步骤：

1. 启用开发者选项（不同机型操作不同）
2. 开启 USB 调试和无线调试
3. 打开 Shizuku → 点击配对 → 进入开发者选项
4. 启用无线调试 → 使用通知中的配对码完成配对
5. 启动 Shizuku 服务

配合支持的文件管理器（如 Zarchiver）即可获得 Android/data 写入权限。

清单文件配置 ​

清单文件（manifest.json）是 Minecraft 识别资源包的核心文件。每个包必须有且仅有一个清单文件。

行为包清单示例：

{
    "format_version": 2,
    "header": {
        "name": "pack.name",
        "description": "pack.description",
        "uuid": "...",
        "version": [0, 0, 1],
        "min_engine_version": [1, 16, 0]
    },
    "modules": [
        {
            "type": "data",
            "uuid": "...",
            "version": [0, 0, 1]
        }
    ]
}

资源包清单示例：

{
	"format_version": 2,
	"header": {
		"name": "pack.name",
		"description": "pack.description",
		"uuid": "...",
		"version": [0, 0, 1],
		"min_engine_version": [1, 16, 0]
	},
	"modules": [
		{
			"type": "resources",
			"uuid": "...",
			"version": [0, 0, 1]
		}
	]
}

清单字段解析 ​

• format_version: 始终使用最新稳定版 2
• name/description: 将在语言文件中定义（支持使用 § 格式代码）
• uuid: 必须使用唯一标识符（下文详述）
• version: 版本号，建议从 [0,0,1] 开始
• min_engine_version: 最低兼容的 Minecraft 版本
• modules.type: 指定包类型（data=行为包，resources=资源包）

UUID 生成指南 ​

UUID（通用唯一标识符）格式示例：5c830391-0937-44d6-9774-406de66b6984

重要提示：

• 每个清单需要 2 个不同的 UUID
• 严禁重复使用 UUID
• 推荐使用 在线生成工具

包图标配置 ​

为资源包/行为包添加识别图标：

1. 准备 64x64 像素的 PNG 图片
2. 重命名为 pack_icon.png
3. 分别放入 BP/RP 文件夹

示例图标：

语言文件配置 ​

在 texts 子文件夹中创建以下文件：

行为包语言文件：

pack.name=§2我的§l首个§r§2行为包！
pack.description=本附加包由Wiki贡献者制作！

["en_US"]

资源包语言文件：

pack.name=§2我的§l首个§r§2资源包！
pack.description=本附加包由Wiki贡献者制作！

["en_US"]

导入附加包 ​

1. 用文件管理器选中 BP/RP 文件夹
2. 创建 ZIP 压缩包
3. 重命名时将 .zip 改为 .mcaddon
4. 点击生成的 .mcaddon 文件自动导入

成功导入后会显示提示横幅，也可在 设置 > 存储 中验证。

启用内容日志 ​

启用方法：

1. 进入 设置 > 创作者
2. 开启所有内容日志选项
3. 游戏中按 Ctrl+H 可打开日志界面

创建测试世界 ​

1. 点击"创建新世界"
2. 确保启用以下设置：
3. 激活行为包和资源包
4. 点击"创建"

最终项目结构 ​

完成本指南后，您的项目应包含以下文件（后续指南中将用 BP 和 RP 简写表示路径）：

学习总结 ​

当前进度 ​

• 完成基础包配置
• 创建自定义物品
• 创建自定义实体
• 创建自定义方块 :::