v1.0.0

v1.0.0 (2026-08-03) 🎉 🎊 ✨

New Features | 新增功能

Multi-language Support | 多语言支持

• Supports 8 language UI (Simplified Chinese, Traditional Chinese Taiwan, Traditional Chinese Hong Kong, English US, English UK, Japanese, Korean, French) | 支持 8 种语言界面（简体中文、繁体中文台湾、繁体中文香港、English US、English UK、日本語、한국어、Français）

Language Detection & Config | 语言检测与配置

• config.json auto-regeneration based on current environment if missing | config.json 实时生成，检测到不存在时按当前环境自动重新生成

Texture Pack Loading Optimization | 材质包加载优化

• New Texturepack folder; place Minecraft .jar files directly to load vanilla textures | 新建 Texturepack 文件夹，支持直接放入 Minecraft .jar 文件读取原版材质
• Support resource pack files (.zip) with both block/ and blocks/ directory naming conventions | 支持材质包文件（.zip），兼容 block 和 blocks 两种目录命名

UI Texture Pack Selector | UI 材质包选择器

• Added texture (pack) selector in UI, reads texture names directly from jar/zip file names | UI 中新增材质(包)选择器，材质名字直接读取 jar/zip 文件名

Texture Preloading & Adaptive PX | 材质预加载与自适应像素

• Preload textures before preview, auto-detects block texture pixel size | 预览前预加载材质，自动检测方块材质 px 尺寸
• Adaptive rendering based on actual texture pixel size during preview | 预览渲染时根据材质实际像素尺寸自适应显示

Improvements | 改进与优化

Texture Reading Optimization | 材质读取优化

• Refactored texture reading logic for unified jar/zip path handling | 重构材质读取逻辑，支持 jar/zip 统一读取路径
• No extra pip packages required; uses Python built-in zipfile/io modules | 无需额外 pip 包，使用 Python 内置 zipfile/io 模块

Settings Expansion | 设置功能扩展

• Added "Default Texture Pack" option in Settings | 设置新增「默认材质包」配置项

Script Improvement | 脚本改进

• Clear cache script extended to remove pycache under component/ directory (recursive scan covers all subdirectories) | Clear cache 脚本增加删除 component/ 目录下 pycache 的支持（递归扫描覆盖所有子目录）

v1.0.0-pre3

v1.0.0-pre3 (2026-08-01)

New Features | 新增功能

Installation Scripts | 安装脚本

• Added install_dependencies.bat/sh for installing project dependencies | 添加 install_dependencies.bat/sh 用于安装项目依赖
• Added install_python.bat/sh for installing Python 3.14.6 | 添加 install_python.bat/sh 用于安装 Python 3.14.6
• Added one_click_install.bat/sh for one-click installation | 添加 one_click_install.bat/sh 用于一键安装
• Added clear_cache.bat/sh for cleaning up Python cache files | 添加 clear_cache.bat/sh 用于清理 Python 缓存文件
• Auto-detects existing Python installation and version | 自动检测已安装的 Python 版本
• • Created bash/Windows/ directory for all Windows scripts (.bat + .ps1) | 创建 bash/Windows/ 目录存放所有 Windows 脚本（.bat + .ps1）
• Created bash/Linux(Mac)/ directory for all Linux/macOS scripts (.sh) | 创建 bash/Linux(Mac)/ 目录存放所有 Linux/macOS 脚本（.sh）
• Supports Windows, macOS, and Linux with package manager auto-detection | 支持 Windows、macOS、Linux 及自动检测包管理器

Improvements | 改进与优化

Documentation Structure | 文档结构

• Restructured README.md with Documentation hierarchy | 重构 README.md 文档层级结构
• Added README and Changelog sections under Documentation | 在文档下添加 README 和 Changelog 分节
• Added Installation Scripts section to README.md with platform-specific script tables | 在 README.md 中添加安装脚本分节，含平台特定脚本表格

Directory Restructuring | 目录结构重构

• Created component/ directory for modular components | 创建 component/ 目录存放模块化组件
• Moved i18n.py to component/i18n.py | 将 i18n.py 移动至 component/i18n.py
• Moved preview.py to component/preview.py | 将 preview.py 移动至 component/preview.py
• Moved i18n/ directory to component/i18n/ | 将 i18n/ 目录移动至 component/i18n/
• Moved config.json to component/config.json | 将 config.json 移动至 component/config.json
• Created Documentation/ directory for documentation | 创建 Documentation/ 目录存放文档
• Moved README/ directory to Documentation/README/ | 将 README/ 目录移动至 Documentation/README/
• Moved CHANGELOG.md to Documentation/changelog/ | 将 CHANGELOG.md 移动至 Documentation/changelog/

Import Paths | 导入路径

• Updated all import paths to use new component structure | 更新所有导入路径以使用新的组件结构
• Modified ui.py, main.py, preview.py and i18n.py references | 修改 ui.py、main.py、preview.py 和 i18n.py 的引用

Documentation Updates | 文档更新

• Updated all README files with new directory structure | 更新所有 README 文件中的目录结构说明
• Added installation script documentation | 添加安装脚本相关文档
• Updated project structure diagrams | 更新项目结构示意图

Beta v1.0.0-pre2

v1.0.0-pre2 (2026-07-21)

New Features | 新增功能

System Font Support | 系统字体支持

• Now supports reading fonts installed on the system automatically | 自动读取系统已安装的字体
• No longer required to place font files in the ttf/ directory | 无需将字体文件放在ttf/目录
• Users just need to install fonts by double-clicking font files | 用户只需双击字体文件安装即可
• Searches system font directories on Windows, macOS, and Linux | 支持Windows、macOS、Linux系统字体目录

Preview Window | 预览窗口

• Added file list view showing all generated .litematic files | 添加文件列表视图显示所有生成的投影文件
• Double-click any file to open a new preview window | 双击文件打开新的预览窗口
• Two preview modes available: | 两种预览模式：
  • Map Art Preview: Shows pixel-based map art (default) | 地图画预览：显示像素化地图画（默认）
  • 2D Build Preview: Shows blocks with textures, supports mouse drag and zoom | 建造预览(2D)：显示带材质的方块，支持鼠标拖拽和缩放

Texture Support | 材质支持

• Preview renders using Minecraft texture files from assets/minecraft/textures/block | 使用Minecraft材质文件进行预览渲染
• Users can copy the assets folder from Minecraft jar file to the project root | 用户可从Minecraft jar文件复制assets文件夹到项目根目录
• Supports textures for concrete, wool, carpet, and terracotta blocks | 支持混凝土、羊毛、地毯、陶瓦材质
• Falls back to solid colors if textures are not available | 材质不可用时回退到纯色渲染

Settings Menu (设置) | 设置菜单

• Added Settings menu item in the top menu bar | 在顶部菜单栏添加设置菜单项
• Click Settings to directly open settings dialog | 点击设置直接打开设置窗口
• Language menu separated into independent menu item | 语言菜单独立为栏中的一个项
• Settings and Language menu items show both Chinese and English | 设置和语言菜单项显示中英文
• New settings dialog for configuring: | 新增设置对话框，可配置：
  • Default block type (Concrete by default) | 默认方块类型（默认混凝土）
  • Default preview mode (Map Art by default) | 默认预览方式（默认地图画）
  • Default font (Empty by default) | 默认字体（默认无）
• Settings are saved to config.json file | 设置保存到config.json文件
• config.json contains both settings and language configuration | config.json包含设置和语言配置两部分

Improvements | 改进与优化

UI Layout | UI布局

• Replaced preview area with generated files list | 将预览区域替换为生成文件列表
• Generated files list shows existing .litematic files on startup | 启动时自动加载已有的投影文件
• Files are added to the list as they are generated | 文件生成时自动添加到列表

File Management | 文件管理

• Settings are persisted between sessions | 设置在会话间持久化保存
• Font list now includes both system fonts and custom ttf/ directory fonts | 字体列表包含系统字体和自定义ttf/目录字体

Documentation Updates | 文档更新

• Updated Chinese documentation README/README zh_cn.md | 更新中文文档
• Updated English documentation README/README en.md | 更新英文文档
• Added changelog.md | 添加更新日志

Beta v1.0.0-pre1

v1.0.0-pre1 (2026-07-19)

New Features | 新增功能

Graphical User Interface | 图形界面

• Added GUI built with PyQt6 | 新增基于PyQt6的图形界面
• Supports font selection, text input, color selection, symbol selection | 支持字体选择、文字输入、颜色选择、符号选择
• Real-time log output display | 实时日志输出显示

Internationalization Support | 国际化支持

• Added i18n framework supporting Chinese and English | 新增i18n框架，支持中文和英文
• Auto-detects system language on first launch | 首次启动自动检测系统语言
• Language can be switched from the top-right corner | 界面右上角支持切换语言

Color Selection Panel | 颜色选择面板

• 16 Minecraft concrete colors as visual buttons, click to select color | 16个Minecraft混凝土颜色可视化按钮，点击选择

Symbol Selection Panel | 符号选择面板

• Categorized common symbols (punctuation, quotes, parentheses, math symbols, etc.) | 分类展示常用符号（标点、引号、括号、数学符号等）
• Click symbols to insert directly into input field | 点击符号直接插入输入框

Clear Log Button | 清除日志按钮

• Added clear log button at the top of log area | 日志区域顶部新增清除日志按钮
• One-click to clear log content | 一键清空日志内容

Improvements | 改进与优化

Project Refactoring | 项目重构

• Separated core logic into main.py | 将核心逻辑分离到main.py
• GUI separated into ui.py | 图形界面独立为ui.py
• i18n framework separated into i18n.py | 国际化框架独立为i18n.py
• Translation files stored in i18n/ directory | 翻译文件统一存放于i18n/目录

Directory Structure | 目录结构

• Auto-creates ttf/, litematic/ directories on startup | 运行时自动创建ttf/、litematic/目录
• README documents stored in README/ directory | README文档统一存放于README/目录

CLI Mode Removed | 命令行模式移除

• No longer provides command-line functionality | 不再提供命令行功能
• Must be launched via ui.py | 只能通过ui.py启动程序

Log Optimization | 日志优化

• Simplified log output format, removed redundant information | 简化日志输出格式，移除冗余信息

Documentation Updates | 文档更新

• Updated Chinese documentation README/README zh_cn.md | 更新中文文档
• Added English documentation README/README en.md | 新增英文文档
• Updated project structure and usage instructions | 更新项目结构说明和使用方法

Alpha v3.2.5

（这也言周？）