Skip to content

10. 附录

本章提供 Litematica 使用过程中的各种参考资料,包括快捷键速查表、配置文件详解、版本兼容性信息、错误代码参考等实用信息。

⌨️ 快捷键速查表

主要功能快捷键

核心操作

快捷键功能说明
M打开主菜单Litematica主界面入口
M + C配置菜单详细设置选项
M + L投影列表管理已加载的投影
M + A区域选择创建新的选择区域
M + P放置配置投影放置设置
M + T工具模式切换不同工具模式

显示控制

快捷键功能说明
F3 + G切换渲染开启/关闭投影渲染
Alt + R切换渲染替代渲染切换键
Alt + I信息显示显示/隐藏投影信息
Alt + G网格显示显示/隐藏选择网格
Alt + O轮廓显示显示/隐藏投影轮廓

选择工具快捷键

区域选择

操作快捷键说明
设置位置1左键点击选择区域的第一个角点
设置位置2右键点击选择区域的第二个角点
扩展选择Ctrl + 滚轮扩大或缩小选择区域
移动选择Shift + 滚轮移动整个选择区域
精确调整方向键微调选择点位置

选择辅助

快捷键功能说明
Ctrl + A全选区域选择所有可见区域
Ctrl + D取消选择清除当前选择
Ctrl + Z撤销操作撤销上一步操作
Ctrl + Y重做操作重做已撤销的操作

投影操作快捷键

位置调整

快捷键功能说明
Page Up向上移动沿Y轴正方向移动投影
Page Down向下移动沿Y轴负方向移动投影
Home重置位置将投影重置到原始位置
End对齐玩家将投影对齐到玩家位置
Numpad +/-微调位置精细调整投影位置

旋转翻转

快捷键功能说明
Insert旋转投影顺时针旋转90度
Delete翻转投影沿选定轴翻转投影
Ctrl + R旋转菜单打开旋转选项菜单
Shift + R反向旋转逆时针旋转90度

材料与建造快捷键

材料管理

快捷键功能说明
L材料清单打开材料列表界面
Ctrl + L刷新清单重新计算材料需求
Alt + L导出清单导出材料清单到文件

建造辅助

快捷键功能说明
中键拾取方块自动选择对应方块
Ctrl + 中键拾取NBT包含NBT数据的方块拾取
F快速放置启用快速放置模式
G网格对齐启用网格对齐功能

自定义快捷键设置

设置方法

yaml
配置路径:
1. 按 M 键打开主菜单
2. 点击 "Generic" → "Open Config GUI"
3. 选择 "Hotkeys" 标签
4. 找到要修改的功能
5. 点击快捷键输入框
6. 按下新的快捷键组合
7. 点击 "Save" 保存设置

注意事项:
- 避免与游戏原生快捷键冲突
- 避免与其他模组快捷键冲突
- 使用容易记忆的组合键
- 可以使用修饰键 (Ctrl, Alt, Shift)

推荐自定义配置

yaml
高频操作:
- 材料清单: L (保持默认)
- 渲染切换: F3+G (保持默认)
- 投影菜单: P (保持默认)
- 区域选择: Ctrl+A (自定义)

建造辅助:
- 快速放置: F (自定义)
- 网格对齐: G (自定义)
- 旋转投影: R (自定义)
- 移动模式: Ctrl+M (自定义)

显示控制:
- 信息显示: I (自定义)
- 轮廓显示: O (自定义)
- 透明度调整: Ctrl+滚轮 (自定义)

⚙️ 配置文件详解

主配置文件结构

litematica.json 完整结构

json
{
  "configVersion": 1,
  "generic": {
    "betterRenderOrder": true,
    "easyPlaceFirst": false,
    "easyPlaceHoldEnabled": true,
    "easyPlaceMode": true,
    "easyPlaceModeMaxDistance": 6.0,
    "easyPlaceProtocolVersion": 3,
    "easyPlaceSwapItems": true,
    "executeRequireHoldingTool": true,
    "pickBlockEnabled": true,
    "pickBlockShulkers": true,
    "placementRestriction": false,
    "placementRestrictionTiedToFast": true,
    "renderLayers": true,
    "renderLayersIfOnlySchematic": false,
    "renderMaterialList": true,
    "renderSchematicVboUpload": true,
    "schematicBlockRenderLimit": 65536,
    "schematicRenderingEnabled": true,
    "toolItemEnabled": true,
    "toolRequiredEnabled": false
  },
  "visuals": {
    "overlayAlpha": 0.7,
    "overlayColor": 16777215,
    "schematicOverlayColorMissing": 255,
    "schematicOverlayColorWrong": 16711680,
    "schematicOverlayColorExtra": 16776960,
    "schematicOverlayModelOutline": true,
    "schematicOverlayModelSides": true,
    "schematicOverlayRenderThroughBlocks": false,
    "renderSchematicMaxDistance": 128.0
  }
}

重要配置项详解

基础功能配置

yaml
核心设置:
schematicRenderingEnabled: 
  - 类型: boolean
  - 默认值: true
  - 说明: 启用投影渲染功能

renderLayers:
  - 类型: boolean
  - 默认值: true
  - 说明: 启用分层渲染功能

schematicBlockRenderLimit:
  - 类型: integer
  - 默认值: 65536
  - 说明: 渲染方块数量限制
  - 建议: 性能较差时可降低到32768

renderSchematicMaxDistance:
  - 类型: double
  - 默认值: 128.0
  - 说明: 最大渲染距离(方块)
  - 建议: 根据性能调整64-256

放置辅助配置

yaml
简易放置:
easyPlaceMode:
  - 类型: boolean
  - 默认值: true
  - 说明: 启用简易放置模式

easyPlaceModeMaxDistance:
  - 类型: double
  - 默认值: 6.0
  - 说明: 放置距离限制
  - 建议: 根据需要调整3.0-10.0

pickBlockEnabled:
  - 类型: boolean
  - 默认值: true
  - 说明: 启用方块拾取功能

pickBlockShulkers:
  - 类型: boolean
  - 默认值: true
  - 说明: 拾取潜影盒内的物品

视觉效果配置

yaml
透明度设置:
overlayAlpha:
  - 类型: double
  - 范围: 0.0-1.0
  - 默认值: 0.7
  - 说明: 投影整体透明度

颜色设置:
schematicOverlayColorMissing:
  - 类型: integer (RGB)
  - 默认值: 255 (蓝色)
  - 说明: 缺失方块颜色

schematicOverlayColorWrong:
  - 类型: integer (RGB)
  - 默认值: 16711680 (红色)
  - 说明: 错误方块颜色

schematicOverlayColorExtra:
  - 类型: integer (RGB)
  - 默认值: 16776960 (黄色)
  - 说明: 多余方块颜色

性能优化配置

高性能配置

json
{
  "schematicBlockRenderLimit": 32768,
  "renderSchematicMaxDistance": 64.0,
  "renderSchematicVboUpload": false,
  "betterRenderOrder": false,
  "overlayAlpha": 0.5
}

高质量配置

json
{
  "schematicBlockRenderLimit": 131072,
  "renderSchematicMaxDistance": 256.0,
  "renderSchematicVboUpload": true,
  "betterRenderOrder": true,
  "overlayAlpha": 0.8,
  "schematicOverlayModelOutline": true,
  "schematicOverlayModelSides": true
}

平衡配置(推荐)

json
{
  "schematicBlockRenderLimit": 65536,
  "renderSchematicMaxDistance": 128.0,
  "renderSchematicVboUpload": true,
  "betterRenderOrder": true,
  "overlayAlpha": 0.7
}

📊 NBT格式详解

.litematic文件结构

根级标签结构

yaml
根标签 (Compound):
├── Version (Int): 格式版本号
├── MinecraftDataVersion (Int): MC数据版本
├── Metadata (Compound): 元数据信息
└── Regions (Compound): 区域数据

元数据结构详解

yaml
Metadata (Compound):
├── Name (String): 投影名称
├── Author (String): 作者信息
├── Description (String): 描述信息
├── RegionCount (Int): 区域数量
├── TimeCreated (Long): 创建时间戳
├── TimeModified (Long): 修改时间戳
├── TotalBlocks (Int): 总方块数
├── TotalVolume (Int): 总体积
└── EnclosingSize (Compound): 包围盒大小
    ├── x (Int): X轴大小
    ├── y (Int): Y轴大小
    └── z (Int): Z轴大小

区域数据结构

yaml
Regions (Compound):
└── [区域名称] (Compound):
    ├── Position (Compound): 位置信息
    │   ├── x (Int): X坐标
    │   ├── y (Int): Y坐标
    │   └── z (Int): Z坐标
    ├── Size (Compound): 尺寸信息
    │   ├── x (Int): X轴尺寸
    │   ├── y (Int): Y轴尺寸
    │   └── z (Int): Z轴尺寸
    ├── BlockStatePalette (List): 方块状态调色板
    ├── BlockStates (LongArray): 方块状态数据
    ├── Entities (List): 实体数据
    └── TileEntities (List): 方块实体数据

数据编码说明

方块状态编码

yaml
编码原理:
1. 调色板压缩存储
2. 每个唯一方块状态分配ID
3. 通过LongArray存储实际数据
4. 使用位压缩减少存储空间

数据计算:
- 位深度 = ceil(log2(调色板大小))
- 每个Long可存储 64/位深度 个方块
- 总Long数 = ceil(总方块数 / 每Long方块数)

坐标系统

yaml
坐标规范:
- X轴: 东为正,西为负
- Y轴: 上为正,下为负
- Z轴: 南为正,北为负
- 原点: 区域的参考点
- 支持负坐标值

文件格式版本

版本历史

版本号Litematica版本主要变化
60.18.x+支持1.21.x新方块
50.16.x-0.17.x支持1.19.x-1.20.x
40.14.x-0.15.x支持1.17.x-1.18.x
30.12.x-0.13.x支持1.15.x-1.16.x
20.10.x-0.11.x支持1.13.x-1.14.x
10.9.x及以下早期版本

🔗 版本兼容性矩阵

Minecraft版本支持

当前支持版本

MC版本Fabric版本Litematica版本MaLiLib版本支持状态推荐度
1.21.x0.15.x0.18.x0.19.x✅ 完全支持⭐⭐⭐⭐⭐
1.20.60.15.x0.17.x0.18.x✅ 完全支持⭐⭐⭐⭐⭐
1.20.40.14.x0.17.x0.18.x✅ 完全支持⭐⭐⭐⭐⭐
1.20.10.14.x0.16.x0.17.x✅ 完全支持⭐⭐⭐⭐
1.19.40.14.x0.15.x0.16.x✅ 完全支持⭐⭐⭐⭐
1.19.20.14.x0.14.x0.15.x✅ 完全支持⭐⭐⭐

历史版本支持

MC版本Litematica版本支持状态说明
1.18.x0.13.x⚠️ 有限支持不再更新,但可用
1.17.x0.12.x⚠️ 有限支持基础功能可用
1.16.x0.11.x⚠️ 有限支持建议升级
1.15.x0.10.x❌ 不再支持已停止维护
1.14.x0.9.x❌ 不再支持已停止维护
1.13.x0.8.x❌ 不再支持已停止维护
1.12.x0.7.x❌ 不再支持已停止维护

功能兼容性对比

核心功能支持

功能1.21.x1.20.x1.19.x1.18.x1.17.x
基础投影显示
简易放置模式
材料清单
多区域支持
分层显示⚠️
高级渲染⚠️⚠️

方块支持

方块类型1.21.x1.20.x1.19.x1.18.x1.17.x
基础方块
新增方块⚠️
复杂状态⚠️⚠️
实体数据⚠️

升级建议

版本选择建议

yaml
最新体验:
- 选择: Minecraft 1.21.x + Litematica 0.18.x
- 优势: 最新功能、最佳性能、持续更新
- 适合: 追求新功能的用户

稳定使用:
- 选择: Minecraft 1.20.4 + Litematica 0.17.x
- 优势: 稳定可靠、兼容性好、资源丰富
- 适合: 注重稳定性的用户

兼容优先:
- 选择: Minecraft 1.19.4 + Litematica 0.15.x
- 优势: 广泛兼容、成熟稳定
- 适合: 服务器环境或团队协作

升级路径

yaml
从旧版本升级:
1. 备份当前配置和投影文件
2. 更新Minecraft到目标版本
3. 更新Fabric Loader
4. 更新Fabric API
5. 更新MaLiLib
6. 更新Litematica
7. 测试功能正常性
8. 迁移配置和数据

注意事项:
- 逐步升级,不要跨太多版本
- 测试重要功能
- 保留旧版本备份
- 关注社区反馈

❌ 错误代码参考

常见错误代码

文件相关错误

错误代码错误信息可能原因解决方案
LIT001文件加载失败文件损坏或格式错误重新下载文件或使用备份
LIT002版本不兼容MC版本与Mod版本不匹配更新到匹配版本
LIT003NBT解析错误文件结构损坏使用NBT编辑器修复
LIT004文件权限错误文件访问权限不足检查文件权限设置

渲染相关错误

错误代码错误信息可能原因解决方案
LIT101渲染初始化失败显卡驱动问题更新显卡驱动
LIT102内存不足投影过大或内存分配不足增加内存分配或减小投影
LIT103VBO创建失败OpenGL版本过低更新显卡驱动或降低渲染质量
LIT104着色器编译错误显卡不支持某些功能禁用高级渲染功能

功能相关错误

错误代码错误信息可能原因解决方案
LIT201简易放置失败权限不足或服务器限制联系管理员或使用手动模式
LIT202方块拾取失败创造模式权限不足切换到创造模式
LIT203区域选择失败选择范围过大减小选择范围
LIT204配置保存失败文件系统权限问题检查文件夹权限

调试信息解读

日志级别说明

yaml
日志级别:
[TRACE]: 详细追踪信息 (开发调试用)
[DEBUG]: 调试信息 (问题诊断用)
[INFO]:  一般信息 (正常运行状态)
[WARN]:  警告信息 (可能的问题)
[ERROR]: 错误信息 (功能异常)
[FATAL]: 致命错误 (程序崩溃)

关键日志标识

yaml
重要标识:
[Litematica]: Litematica模组相关
[MaLiLib]: MaLiLib库相关
[Fabric]: Fabric加载器相关
[Minecraft]: 游戏核心相关

错误定位:
1. 查找错误发生时间
2. 确定错误来源模组
3. 分析错误类型和原因
4. 查看相关的堆栈跟踪

📈 性能基准测试

测试环境规格

推荐配置

yaml
硬件要求:
CPU: Intel i5-8400 / AMD Ryzen 5 2600 或更高
GPU: GTX 1060 6GB / RX 580 8GB 或更高
RAM: 8GB DDR4 或更高
存储: SSD 推荐

软件环境:
操作系统: Windows 10/11, macOS 10.14+, Linux
Java版本: OpenJDK 17 或更高
Minecraft: 最新稳定版
显卡驱动: 最新版本

最低配置

yaml
硬件要求:
CPU: Intel i3-6100 / AMD FX-6300
GPU: GTX 750 Ti / RX 560
RAM: 4GB DDR4
存储: 机械硬盘可用

软件环境:
操作系统: Windows 7+, macOS 10.12+
Java版本: OpenJDK 8 或更高
注意: 性能可能受限

性能测试结果

帧率性能测试

投影规模方块数量推荐配置FPS最低配置FPS优化建议
微型<500120+60+无需优化
小型500-2000100-12045-60降低渲染距离
中型2000-1000060-10025-45调整透明度
大型10000-5000030-6015-25分层显示
巨型50000+15-30<15分段加载

内存使用测试

投影规模推荐配置内存最低配置内存优化建议
微型100-200MB50-100MB无需调整
小型200-500MB100-300MB基础优化
中型500MB-1GB300-600MB内存监控
大型1-2GB600MB-1GB增加分配
巨型2GB+1GB+专业配置

性能优化建议

根据硬件配置优化

yaml
高端配置 (RTX 3070+):
- 渲染距离: 256方块
- 方块限制: 131072
- VBO渲染: 启用
- 高级效果: 全部启用

中端配置 (GTX 1060级别):
- 渲染距离: 128方块
- 方块限制: 65536
- VBO渲染: 启用
- 高级效果: 选择性启用

低端配置 (GTX 750Ti级别):
- 渲染距离: 64方块
- 方块限制: 32768
- VBO渲染: 禁用
- 高级效果: 禁用

🤝 社区贡献指南

参与开源项目

GitHub贡献流程

yaml
贡献步骤:
1. Fork项目仓库
2. 创建功能分支
3. 进行代码修改
4. 编写测试用例
5. 提交Pull Request
6. 参与代码审查
7. 合并到主分支

分支命名规范:
- feature/功能名称
- bugfix/问题描述
- docs/文档更新
- refactor/重构说明

代码贡献规范

yaml
代码规范:
- 遵循项目代码风格
- 添加适当的注释
- 编写单元测试
- 更新相关文档

提交信息格式:
type(scope): description

类型:
- feat: 新功能
- fix: 错误修复
- docs: 文档更新
- style: 代码格式
- refactor: 重构
- test: 测试相关

翻译贡献

翻译项目参与

yaml
翻译流程:
1. 加入翻译团队
2. 认领翻译任务
3. 使用翻译工具
4. 提交翻译内容
5. 参与审校工作

翻译规范:
- 保持术语一致性
- 符合目标语言习惯
- 注意上下文语境
- 定期更新翻译

质量控制:
- 多人交叉审校
- 社区反馈收集
- 定期质量检查
- 持续改进优化

本地化贡献

yaml
本地化内容:
- 界面文本翻译
- 帮助文档翻译
- 错误信息翻译
- 教程内容翻译

文化适应:
- 考虑文化差异
- 调整表达方式
- 本地化示例
- 适应使用习惯

社区支持

帮助他人

yaml
支持方式:
- 回答论坛问题
- 分享使用经验
- 制作教程内容
- 报告软件问题

质量标准:
- 准确的信息
- 清晰的表达
- 耐心的态度
- 建设性的建议

内容创作

yaml
创作类型:
- 视频教程
- 图文指南
- 建筑作品
- 工具开发

分享平台:
- YouTube / Bilibili
- GitHub / Gitee
- 社区论坛
- 个人博客

📜 法律声明

版权信息

软件版权

yaml
Litematica:
- 作者: masa (Matias Hiltunen)
- 许可证: LGPL-3.0
- 版权: © 2018-2024 masa
- 权利: 保留所有权利

MaLiLib:
- 作者: masa (Matias Hiltunen)
- 许可证: LGPL-3.0
- 版权: © 2018-2024 masa
- 权利: 保留所有权利

文档版权

yaml
本教程文档:
- 内容: 社区贡献和整理
- 用途: 教育和学习目的
- 分发: 允许自由分享
- 修改: 允许在保留署名的情况下修改

引用规范:
- 保留原作者信息
- 标注内容来源
- 遵守相关许可证
- 尊重知识产权

免责声明

使用风险

yaml
风险提示:
- 本教程内容仅供学习参考
- 使用过程中的任何问题,作者不承担责任
- 用户应根据实际情况谨慎使用
- 遵守相关法律法规和服务器规则

责任限制:
- 不保证内容的完全准确性
- 不承担因使用导致的损失
- 不对第三方内容负责
- 保留修改和更新的权利

合规使用

yaml
使用要求:
- 遵守软件许可证条款
- 尊重他人的知识产权
- 不用于商业用途 (除非获得授权)
- 遵守当地法律法规

禁止行为:
- 恶意传播或修改
- 用于非法用途
- 侵犯他人权益
- 违反服务器规则

📝 更新日志

文档版本历史

v1.0.0 (2024-01-01)

yaml
初始版本:
- 完成基础章节编写
- 建立文档结构框架
- 提供核心功能介绍
- 包含基础安装指南

内容覆盖:
- Litematica概述
- 安装配置指南
- 基本操作教程
- 常见问题解答

v1.1.0 (2024-02-01)

yaml
功能扩展:
- 添加高级功能章节
- 完善故障排除指南
- 增加性能优化建议
- 补充工具资源信息

改进内容:
- 更详细的配置说明
- 更多实用技巧
- 更完整的错误处理
- 更丰富的资源链接

v1.2.0 (2024-03-01)

yaml
内容优化:
- 更新版本兼容性信息
- 添加NBT格式详解
- 完善快捷键说明
- 增加社区资源

质量提升:
- 修正错误信息
- 优化文档结构
- 改进代码示例
- 增强可读性

计划更新

v1.3.0 (计划中)

yaml
新增内容:
- 视频教程链接集成
- 交互式操作指南
- 更多实战案例
- 移动端适配优化

改进计划:
- 多语言版本支持
- 搜索功能增强
- 用户反馈系统
- 自动更新机制

v1.4.0 (长期规划)

yaml
未来发展:
- AI辅助教程生成
- 虚拟现实演示
- 云端同步功能
- 社区互动平台

技术升级:
- 响应式设计优化
- 性能进一步提升
- 无障碍访问支持
- 国际化标准遵循

🙏 致谢

特别感谢

核心贡献者

yaml
masa (Matias Hiltunen):
- Litematica的创作者和主要维护者
- MaLiLib核心库的开发者
- 为Minecraft建筑社区做出的杰出贡献
- 持续的技术支持和功能改进

Fabric团队:
- 提供优秀的模组开发平台
- 快速的版本更新支持
- 完善的开发工具和文档
- 活跃的开发者社区

社区贡献者

yaml
翻译贡献者:
- 各语言版本的翻译志愿者
- 本地化适配工作者
- 文档校对和审核人员
- 持续的维护和更新工作

内容贡献者:
- 教程内容的创作者
- 技术文档的编写者
- 问题解答的提供者
- 经验分享的贡献者

技术支持者:
- Bug报告和测试人员
- 功能建议的提出者
- 代码审查的参与者
- 技术讨论的活跃者

社区支持

平台支持

yaml
GitHub:
- 提供代码托管和协作平台
- 支持开源项目的发展
- 便利的问题追踪和管理
- 强大的版本控制功能

CurseForge:
- 模组分发和下载平台
- 用户反馈和评价系统
- 版本管理和更新通知
- 广泛的用户覆盖

各大论坛和社区:
- MCBBS, MinecraftForums等
- 提供交流和讨论平台
- 知识分享和问题解答
- 建筑作品展示空间

教育支持

yaml
教育机构:
- 支持Minecraft教育应用
- 推广建筑设计教学
- 培养创意思维能力
- 促进技术技能发展

内容创作者:
- YouTube, Bilibili等平台的UP主
- 制作高质量的教学视频
- 分享实用的建筑技巧
- 推广工具的使用方法

📝 结语

本附录提供了使用 Litematica 过程中可能需要的各种参考信息。这些资料将帮助你:

  1. 快速查找 - 通过快捷键速查表快速找到需要的操作
  2. 深度配置 - 通过配置文件详解优化使用体验
  3. 问题诊断 - 通过错误代码参考快速定位问题
  4. 版本选择 - 通过兼容性矩阵选择合适的版本组合
  5. 性能优化 - 通过基准测试数据调整最佳设置

感谢你完成了这个完整的 Litematica 教程!希望这份指南能够帮助你在 Minecraft 建筑创作的道路上走得更远。

记住:建筑的魅力不仅在于工具的熟练使用,更在于创意的无限发挥。 🏗️✨

💡 持续学习

技术在不断发展,建议定期关注官方更新和社区动态,保持学习的热情,与时俱进!