# NeteaseMCBlockModelConvert

**Repository Path**: cyanbukkit/NeteaseMCBlockModelConvert

## Basic Information

- **Project Name**: NeteaseMCBlockModelConvert
- **Description**: 网易我的世界开发者模型转换BlockBench插件版
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网易方块模型导出器 (Netease Block Model Exporter)

这是一个 Blockbench 插件，旨在帮助创作者将模型导出为网易 Minecraft (Bedrock) 方块几何体格式 (`netease:block_geometry`)。同时也支持导入该格式的模型进行编辑。

## 插件信息

- **版本**: 1.4.0
- **作者**: Trae AI Assistant
- **支持版本**: Blockbench 4.0.0 及以上

## 功能特性

- **导出模型**: 将当前模型导出为网易方块模型格式 (`.json`)。
    - 支持的 Blockbench 格式: Bedrock Model, Generic Model, Block Model。
    - 自动处理坐标偏移：将 Blockbench 原点 (0,0,0) 映射到 Minecraft 方块中心 (对应网易偏移量 [-8, 0, 8])。
- **导入模型**: 加载网易格式的 `.json` 模型文件到 Blockbench 中。
    - 自动解析骨骼 (Bones) 和立方体 (Cubes)。
    - 自动重建纹理贴图引用。

## 安装方法

1. 打开 Blockbench。
2. 点击菜单栏的 **File (文件)** -> **Plugins (插件)**。
3. 点击 **Load Plugin from File (从文件加载插件)**。
4. 选择本仓库中的 `netease_block_exporter.js` 文件。
5. 确认安装。

## 使用说明

### 导出模型
1. 确保你的模型格式是 Bedrock, Generic 或 Block Model。
2. 点击菜单栏的 **File (文件)** -> **Export (导出)** -> **导出网易方块模型**。
3. 选择保存位置并输入文件名。

### 导入模型
1. 点击菜单栏的 **File (文件)** -> **Import (导入)** -> **导入网易方块模型**。
2. 选择包含 `netease:block_geometry` 数据的 `.json` 文件。

## 注意事项

- 插件会自动处理坐标系的转换，无需手动调整模型位置。
- 纹理名称会尝试移除 `.png` 后缀，如果名称中不包含冒号，会自动添加 `custom:` 前缀。
- 仅支持标准的立方体 (Cube) 几何体，不支持网格 (Mesh) 或其他复杂几何体。

## 许可证

MIT License