2. Litematica 的安装与配置

本章将详细介绍如何从零开始安装和配置 Litematica 模组，包括前置需求、下载安装步骤以及首次启动的基础设置。

📋 前置需求

系统要求

• 操作系统 - Windows 7+、macOS 10.12+、Linux
• Java 版本 - Java 17+ (推荐 Java 21)
• Minecraft 版本 - 1.12.2 或更高版本
• 内存要求 - 至少 4GB RAM (推荐 8GB+)

必需的模组加载器

Fabric (推荐)

Fabric 是目前 Litematica 的主要支持平台，具有以下优势：

• ✅ 轻量级 - 启动速度快，内存占用低
• ✅ 稳定性 - 更新频繁，bug 修复及时
• ✅ 兼容性 - 与大多数模组兼容良好

Quilt

Quilt 是 Fabric 的分支，完全兼容 Fabric 模组：

• ✅ 向后兼容 - 支持所有 Fabric 模组
• ✅ 增强功能 - 提供额外的开发者工具
• ✅ 社区驱动 - 开放的开发社区

Forge (部分支持)

某些版本的 Litematica 支持 Forge：

• ⚠️ 版本限制 - 仅部分版本可用
• ⚠️ 更新延迟 - 更新通常较慢
• ⚠️ 性能差异 - 可能存在性能问题

🔽 下载地址与版本选择

官方下载渠道

1. CurseForge (推荐)

网址：https://www.curseforge.com/minecraft/mc-mods/litematica
优势：
- 自动依赖检测
- 版本兼容性检查
- 官方认证安全
- 支持模组包管理

2. Modrinth

网址：https://modrinth.com/mod/litematica
优势：
- 现代化界面
- 快速下载速度
- 详细的版本信息
- 开源友好

3. GitHub Releases

网址：https://github.com/maruohon/litematica/releases
优势：
- 最新开发版本
- 详细的更新日志
- 源代码访问
- 问题反馈渠道

版本选择指南

根据 Minecraft 版本选择

Minecraft 1.21.x:
  - Litematica: 0.19.x+
  - Fabric API: 最新版
  - MaLiLib: 0.20.x+

Minecraft 1.20.x:
  - Litematica: 0.18.x
  - Fabric API: 0.92.x+
  - MaLiLib: 0.19.x

Minecraft 1.19.x:
  - Litematica: 0.17.x
  - Fabric API: 0.76.x+
  - MaLiLib: 0.18.x

Minecraft 1.18.x:
  - Litematica: 0.16.x
  - Fabric API: 0.46.x+
  - MaLiLib: 0.17.x

稳定版 vs 开发版

版本类型	特点	推荐用户
Release (稳定版)	经过充分测试，功能稳定	普通玩家、服务器使用
Beta (测试版)	新功能测试，可能有bug	高级用户、功能测试
Alpha (开发版)	最新功能，不稳定	开发者、尝鲜用户

🛠️ 安装步骤

步骤 1：安装 Java

# 检查当前 Java 版本
java -version

# 如果版本低于 17，需要更新 Java
# 推荐下载地址：
# - Oracle JDK: https://www.oracle.com/java/technologies/downloads/
# - OpenJDK: https://openjdk.org/
# - Adoptium: https://adoptium.net/

步骤 2：安装 Minecraft

确保你有正版 Minecraft Java 版账户，并安装了对应版本的游戏。

步骤 3：安装 Fabric Loader

使用 Fabric Installer (推荐)

1. 访问 https://fabricmc.net/use/installer/
2. 下载 Fabric Installer
3. 运行安装程序：

   - 选择 Minecraft 版本
   - 选择 Loader 版本 (使用最新稳定版)
   - 点击 "Install"

使用启动器安装

大多数第三方启动器都支持一键安装 Fabric：

• MultiMC - 右键实例 → Edit Instance → Version → Install Fabric
• PolyMC - 右键实例 → Edit → Version → Install Fabric
• Prism Launcher - 右键实例 → Edit → Version → Install Fabric
• ATLauncher - 实例设置 → Loaders → Fabric

步骤 4：下载必需模组

必需的依赖模组

1. Fabric API:
   - 下载地址: https://www.curseforge.com/minecraft/mc-mods/fabric-api
   - 作用: Fabric 模组的核心 API
   - 版本: 与 Minecraft 版本对应

2. MaLiLib:
   - 下载地址: https://www.curseforge.com/minecraft/mc-mods/malilib
   - 作用: Litematica 的核心依赖库
   - 版本: 与 Litematica 版本对应

3. Litematica:
   - 下载地址: https://www.curseforge.com/minecraft/mc-mods/litematica
   - 作用: 主要的投影模组
   - 版本: 根据需求选择

推荐的辅助模组

1. ModMenu:
   - 作用: 模组配置菜单
   - 下载: https://www.curseforge.com/minecraft/mc-mods/modmenu

2. Tweakeroo:
   - 作用: 游戏机制调整
   - 下载: https://www.curseforge.com/minecraft/mc-mods/tweakeroo

3. MiniHUD:
   - 作用: 信息显示 HUD
   - 下载: https://www.curseforge.com/minecraft/mc-mods/minihud

步骤 5：安装模组文件

找到 mods 文件夹

# Windows
%appdata%\.minecraft\mods

# macOS
~/Library/Application Support/minecraft/mods

# Linux
~/.minecraft/mods

复制模组文件

1. 将下载的 .jar 文件复制到 mods 文件夹
2. 确保所有依赖模组都已安装
3. 检查文件名，避免重复或冲突

⚙️ 第一次启动后的基础设置

启动游戏并验证安装

检查模组加载

1. 启动 Minecraft
2. 在主菜单查看是否有 "Mods" 按钮
3. 点击 "Mods" 检查 Litematica 是否在列表中
4. 确认版本号正确

验证功能可用性

进入游戏世界后：
1. 按 M 键打开 Litematica 菜单 (默认快捷键)
2. 检查是否能正常显示界面
3. 尝试加载一个测试投影文件

基础配置设置

打开配置菜单

方法 1: 游戏内按 M 键 → Generic → Open Config GUI
方法 2: ModMenu → Litematica → Configure
方法 3: 直接编辑配置文件 (.minecraft/config/litematica/)

重要配置项目

1. 渲染设置

Visuals:
  schematicOverlay: true          # 启用投影显示
  schematicOverlayModelOutline: true    # 显示方块轮廓
  schematicOverlayModelSides: true      # 显示方块面
  schematicOverlayRenderThroughBlocks: false  # 透视显示
  overlayAlpha: 0.8               # 投影透明度 (0.0-1.0)

2. 快捷键设置

Hotkeys:
  openGuiMainMenu: M              # 打开主菜单
  openGuiMaterialList: L          # 打开材料清单
  openGuiSchematicPlacements: P   # 打开投影放置菜单
  openGuiSettings: COMMA          # 打开设置菜单
  toggleAllRendering: F3+G        # 切换所有渲染

3. 功能开关

Generic:
  betterRenderOrder: true         # 改进渲染顺序
  highlightBlockInInv: true       # 高亮库存中的方块
  materialListSlotsPerRow: 9      # 材料清单每行槽位数
  pickBlockEnabled: true          # 启用方块选择功能

创建第一个投影

快速测试流程

1. 建造一个简单结构

   - 在创造模式中建造一个 5x5x5 的简单房子
   - 使用基础方块 (石头、木头等)

2. 选择区域

   - 按 M 键打开菜单
   - 选择 "Area Editor"
   - 点击 "New Area"
   - 使用工具选择建筑区域

3. 保存为投影

   - 在 Area Editor 中点击 "Save Schematic"
   - 输入文件名 (例如: "my_first_house")
   - 选择保存位置
   - 点击确认保存

4. 加载投影测试

   - 移动到其他位置
   - 按 M 键 → Load Schematics
   - 选择刚才保存的文件
   - 调整位置并确认放置

🔧 常见安装问题与解决方法

问题 1：模组无法加载

症状

• 游戏启动后看不到 Litematica
• 没有 "Mods" 按钮
• 控制台显示错误信息

解决方案

检查项目:
1. Java 版本是否正确 (需要 Java 17+)
2. Fabric Loader 是否安装成功
3. Fabric API 版本是否匹配
4. MaLiLib 是否安装
5. 模组文件是否放在正确位置

解决步骤:
1. 重新下载对应版本的模组
2. 删除 .minecraft/mods 中的旧版本文件
3. 确认依赖关系正确
4. 重启游戏

问题 2：版本不兼容

症状

• 游戏崩溃或无法启动
• 模组显示红色错误状态
• 依赖关系警告

解决方案

版本对应关系:
Minecraft 1.21.x → Fabric API 最新 → MaLiLib 0.20.x → Litematica 0.19.x
Minecraft 1.20.x → Fabric API 0.92.x → MaLiLib 0.19.x → Litematica 0.18.x

解决步骤:
1. 查看官方兼容性列表
2. 下载正确版本的依赖模组
3. 使用模组管理器自动解决依赖
4. 创建独立的模组配置文件

问题 3：性能问题

症状

• 游戏帧率下降
• 投影显示卡顿
• 内存使用过高

解决方案

优化设置:
1. 降低投影透明度
2. 禁用不必要的渲染效果
3. 减少同时加载的投影数量
4. 调整渲染距离

配置调整:
visuals:
  schematicOverlayRenderThroughBlocks: false
  overlayAlpha: 0.6
  maxSchematicSize: 1000000

问题 4：快捷键冲突

症状

• 快捷键无响应
• 与其他模组功能冲突
• 无法打开 Litematica 菜单

解决方案

检查冲突:
1. 打开游戏设置 → 控制
2. 查看键位绑定冲突
3. 重新分配快捷键

推荐快捷键设置:
- 主菜单: M 键
- 材料清单: L 键  
- 投影菜单: P 键
- 设置菜单: 逗号键

📁 配置文件详解

主要配置文件位置

.minecraft/config/litematica/
├── litematica.json              # 主配置文件
├── hotkeys.json                 # 快捷键配置
└── schematic_placements.json   # 投影放置记录

配置文件备份

# 备份配置文件
cp -r .minecraft/config/litematica/ ./litematica_backup/

# 恢复配置文件
cp -r ./litematica_backup/* .minecraft/config/litematica/

---

📝 本章小结

通过本章的学习，你应该已经成功安装并配置了 Litematica 模组。关键要点包括：

1. 正确的依赖关系 - Fabric API + MaLiLib + Litematica
2. 版本匹配 - 确保所有模组版本兼容
3. 基础配置 - 合理设置渲染和快捷键选项
4. 问题排查 - 掌握常见问题的解决方法

下一章预告 📖
在下一章中，我们将深入了解 .litematic 文件格式，包括 NBT 结构、文件组成以及与其他格式的区别。

💡 安装小贴士

建议创建专门的模组配置文件，这样可以轻松在不同的模组环境之间切换，避免版本冲突问题。