# MC_Resource_Extraction_tool

**Repository Path**: Bilibili-Supercmd/MC_Resource_Extraction_tool

## Basic Information

- **Project Name**: MC_Resource_Extraction_tool
- **Description**: 用于解析我的世界中的资源文件并提取的可视化工具
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-22
- **Last Updated**: 2025-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MC_Resource_Extraction_Tool

## 简介

MC_Resource_Extraction_Tool 是一个用于从 Minecraft 游戏文件中提取特定资源（如音乐文件）的小工具。它通过读取 `.minecraft` 文件夹中的资源索引文件，解析并允许用户选择需要导出的资源文件，最终将选定的资源文件复制到用户指定的目标文件夹。

## 功能特性

- 支持从默认或自定义路径下的 `.minecraft` 文件夹中加载资源索引文件。
- 提供图形化界面 (GUI) 方便用户选择要导出的资源文件。
- 支持全选/取消全选功能。
- 提供详细的日志记录，便于调试和问题排查。
- 支持错误处理和用户提示信息。

## 对开发者的温馨提醒
### 记得更换图片
### 替换方式1
1. 将Logo.ico替换成自己的图标。
2. 将resource代码中的`FILE_ICON_BASE64`改成自己的图标BASE64编码（注意不要带`,`前面的东西)
### 替换方式2
运行ICON打包工具（不用安装其他第三方库），根据要求进行选择
### 替换方式3
直接使用命令行运行ICON打包工具打包
```bash
ICON打包工具

                      使用方法：

                      python.exe ICON打包工具.py [mode] [file] [language]

                      mode：

                      help：显示帮助

                      gui：图形模式

                      bash：命令行模式

                      img：后面尾随图片文件路径，不填默认为Logo.ico
                      
                      language:

                      cn：中文(默认)

                      en: English
```

### 如何打包成同款EXE文件
1. 打开命令行工具，切换到项目根目录。
2. 安装pyinstaller
   ```bash
   pip3 install pyinstaller
   ```
3. 运行打包命令
   ```bash
   pyinstaller.exe --upx-dir C:\upx --clean -D .\main.py -n MC_Resource_Extraction_tool --hide-console hide-early -i .\Logo.ico --uac-admin -y
   ```


## 使用方法

### 快速启动

1. 将项目克隆到本地或下载源码压缩包。
2. 打开命令行工具，切换到项目根目录。
3. 运行 `main.py` 文件：
   ```bash 
   python main.py
   ```

### 使用发行版 EXE 文件

对于一般用户，我们提供了一个打包好的发行版 EXE 文件，您可以直接下载并运行，无需安装 Python 或其他依赖库。

1. 下载 [发行版 EXE 文件](链接到EXE文件下载地址)。
2. 解压下载的压缩包。
3. 双击运行 `MC_Resource_Extraction_Tool.exe` 文件。
4. 按照界面上的提示进行操作即可。

### 操作步骤

1. **选择 Minecraft 文件夹**：程序会尝试从默认路径加载 `.minecraft` 文件夹。如果默认路径无效，您可以通过弹出的文件夹选择对话框手动选择正确的路径。
2. **选择资源版本**：从列出的资源版本中选择一个版本，点击“就这个版本了”按钮确认。
3. **选择要导出的文件**：在主界面上勾选您想要导出的资源文件，支持全选操作。
4. **确认并开始输出**：点击“确认并开始输出”按钮，选择目标文件夹后，程序会将选定的资源文件复制到目标文件夹。

## 目录结构
```text
MC_Resource_Extraction_Tool/ 
├── main.py # 主程序文件 
├── logs/ # 日志文件存放目录 
└── Logo.ico # 程序图标
```
## 注意事项

- 请确保对 `.minecraft` 文件夹有读取权限，对目标文件夹有写入权限。
- 如果遇到任何问题，请检查 `logs` 文件夹中的日志文件以获取更多信息。

## 贡献

欢迎提交 Pull Request 或 Issue 来帮助改进本项目。

## 许可证

本项目采用 [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html)，详情参见 LICENSE 文件。

---

如果您有任何疑问或需要进一步的帮助，请随时联系项目维护者。