[MD]
# ⛏ MC Until工具箱（MC Until）
> 一款专为 Java 版玩家打造的离线桌面工具箱，集合命令生成、数据查询、数据包辅助等功能于一体。
---
## 📖 简介
**MC Until工具箱** 是一款面向 Minecraft Java 版玩家的综合性桌面工具集，旨在解决日常游戏中频繁查阅 Wiki、手写 NBT、拼凑命令等繁琐操作。所有功能完全离线可用，不依赖浏览器，不依赖服务器，打开即用。
无论是生存玩家想快速生成 `/give` 指令，还是地图作者想批量查询方块 ID，或是数据包开发者需要生成合成配方 JSON，都能在这里找到趁手的工具。
---
## ✨ 功能一览
### 🆕 数据包工具
#### 📋 合成配方 (Recipe) 生成器
一键生成数据包标准的合成配方 JSON。
- 支持 **有序合成** (crafting_shaped) 和 **无序合成** (crafting_shapeless)
- **点击合成格 → 弹出搜索面板 → 点击物品选择**，无需手记物品 ID
- 网格支持 1×1 到 3×3 自定义大小，系统自动生成符号映射
### 🎮 命令生成器
#### 🗡 /give 物品命令生成器
- 选择目标（@p / @a / @r / @s / @e / 自定义玩家名）
- 可直接读取物品生成器中保存的预设（自带 NBT）
- 数量调节 1~64，一键复制
#### 🧟 /summon 实体命令生成器
- 读取实体生成器保存的预设
- 坐标设置：当前位置 (`~ ~ ~`) 或自定义坐标（绝对/相对）
- 支持追加额外 NBT
- 支持生成数量（AreaEffectCloud 等多实体场景）
#### ✨ /effect 状态效果命令生成器
- 搜索全部状态效果（含中文译名）
- 设置等级（0-255）、持续时间（秒或无限）
- 隐藏粒子选项
- 同时输出命令与 SNBT（可用于 ActiveEffects）
#### 🔮 /enchant 附魔命令生成器
- 搜索全部附魔（含中文译名）
- 等级自动限制在该附魔的最大等级内
- 生成标准 `/enchant` 命令
---
### 🛠 编辑器生成器
#### 🎁 物品生成器
可视化编辑物品 NBT，所见即所得。
- **附魔编辑**：搜索魔咒并添加，可设等级 1~255
- **属性修改**：攻击伤害/最大生命值/移动速度等 10 种属性，可设数值、操作模式、生效槽位
- **自定义名称 & Lore**：支持 16 色 + 粗体/斜体/下划线/删除线，实时预览 JSON 文本
- **能破坏 / 能放置于**：搜索方块添加到 CanDestroy / CanPlaceOn 列表
- **隐藏标签**：附魔/属性/能否破坏/能否放置等提示的显隐控制
- **不可破坏**：基础属性独立开关
- **预设管理**：保存/载入/重命名/删除，存储于本地文件，重启不丢失
#### 🧟 实体生成器
生成实体 SNBT，供 /summon 命令使用。
- 选择实体（搜索中文名或 ID）
- **属性修改**：生命值/伤害/速度等 9 项，各自独立启用
- **实体标志**：发光、清除AI、无敌、不会消失、惯用左手、禁止声音、无重力、允许滑翔
- **额外设置**：持续着火秒数、最大氧气刻数、拾取策略
- **骑乘实体**：选择已保存的实体预设，自动生成嵌套 Passengers NBT
- **预设管理**：保存/载入/重命名/删除，存储于本地文件
- 保存预设后自动重置，便于连续生成
---
### 🔍 数据查询工具
#### 📦 7 个 ID 查询器
| 查询器 | 数据量 | 用途 |
|--------|--------|------|
| 方块 ID | 全部方块 | 搜索方块的命名空间 ID |
| 物品 ID | 全部物品 | 搜索物品的命名空间 ID |
| 实体 ID | 全部实体 | 搜索实体的命名空间 ID |
| 状态效果 ID | 全部效果 | 搜索效果的命名空间 ID |
| 魔咒 ID | 全部附魔 | 搜索附魔的命名空间 ID |
| 生物群系 ID | 全部群系 | 搜索群系的命名空间 ID |
| 结构 ID | 全部结构 | 搜索结构的命名空间 ID |
**特性**：
- 实时搜索，支持中文名和 ID
- 完全匹配优先展示
- 结构查询器空关键词时按变体分组显示
- 全部查询器支持「WIKI」按钮，一键跳转中文 Minecraft Wiki
#### 💾 level.dat 查看器
- 打开 Java 版存档的 level.dat 文件
- 查看与编辑全部字段
- 悬停查看字段说明
- 保存时自动创建 `.bak` 备份
#### 🌐 server.properties 生成器
- 编辑和生成 Java 版服务器配置文件
- 支持导入现有配置
- 切换 **原版 / Paper** 服务端类型
- Paper 独有字段有视觉标识
- 一键复制或保存
---
### 🎨 辅助工具
#### 🌈 颜色/格式化码工具
- 支持 **Java 版 / 基岩版** 双版本切换
- Java 版：16 种颜色 + 6 种格式代码
- 基岩版：29 种颜色（含材质色）+ 4 种格式代码
- 点击颜色方块或格式按钮即可将 § 代码插入文本
- 实时预览渲染效果
- 支持 §k 混淆文字的随机字符动画
- §r 重置样式
---
## 🎯 版本支持
顶栏左上角提供版本选择器，当前默认版本为 **1.19 – 1.20.4**。
| 版本区间 | 状态 |
|----------|------|
| 1.13 及以下 | 即将支持 |
| 1.14 – 1.16 | 即将支持 |
| 1.16 – 1.19 | 即将支持 |
| **1.19 – 1.20.4** | ✅ 已支持（默认） |
| 1.20.5+（堆叠组件） | 即将支持 |
> ⚠️ **说明**：仅有命令类工具区分版本，其它工具（ID 查询、level.dat 等）全版本通用。
> ⚠️ 可能出现部分较新版本的方块/生物/实体，在你的选择版本里不存在。
---
## 🖼 界面预览
- 采用 **Unifont 像素字体**，还原 Minecraft 经典像素风格
- 黑底金边的主色调，配合 4px 像素阴影，复刻游戏内 GUI 质感
- 侧边栏按分类折叠，未开发工具标注「开发中」
- 所有弹窗均为程序内置像素风格，不使用系统原生弹窗
---
## 📥 下载与使用
### 系统要求
- **操作系统**：Windows 10 / 11（需内置 WebView2 运行时，Win10 2004+ 和 Win11 已预装）
- **磁盘空间**：约 50MB
### 使用方式
1. 下载 `MC Until工具箱.exe`
2. 双击运行
3. 开始使用！
> 💡 如果运行时报 WebView2 相关错误，请安装 [WebView2 Runtime](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/)
---
## 🔄 更新日志
### v1.0.0（2026-08-04）首个正式发布版本
#### 🆕 数据包工具
- 「合成配方 (Recipe)」JSON 生成器 —— 支持有序合成和无序合成
- 点击合成格弹出搜索面板，与物品 ID 查询器交互一致
- 网格支持 1-3 行 × 1-3 列自定义大小，系统自动生成符号映射
- 支持 1.21+ 组件格式
#### 🆕 命令生成器
- /effect 状态效果、/enchant 附魔、/summon 实体、/give 物品
#### 🆕 编辑器生成器
- 实体生成器（属性/标志/骑乘/拾取策略）
- 物品生成器（附魔/属性/名称/Lore/CanDestroy/CanPlaceOn/隐藏标签）
#### 🆕 数据查询工具
- level.dat 查看器、server.properties 生成器、7 个 ID 查询器
- 全部查询器支持 WIKI 跳转
#### ✨ 辅助工具
- 颜色/格式化码工具（Java/基岩双版本）
- 更新日志、反馈入口
#### 🐛 问题修复
- 修复 /summon 命令格式、NBT 括号、装备槽索引错位等问题
- 修复预设持久化、弹窗样式、合成配方空格符号等问题
- 修复 level.dat 备份、ID 查询排序、颜色代码混淆等问题
---
## 📧 反馈与建议
发现 Bug、有功能建议、或想交流使用心得？欢迎反馈：
- **邮箱**：xiaojiyanfz2022@163.com
- **程序内**：顶栏「💬 反馈」按钮可一键复制邮箱
📌 反馈时建议注明：使用的版本号、操作系统、问题截图或重现步骤。
---
## 📜 许可协议
本工具为免费开源性质，仅供学习交流使用。
Minecraft 是 Mojang Studios 的商标，本工具与 Mojang Studios 无任何关联。
---
**⭐ 如果这个工具对你有帮助，欢迎在论坛点赞支持！**
[/MD]
