Axolotl Launcher（美西螈启动器）是一款免费、开源、跨平台的 Minecraft Java 版启动器，原生支持 Windows、macOS 与 Linux。它能一站式搜索、安装和更新来自 Modrinth 与 CurseForge 的模组、整合包、资源包和光影，并内置实例管理、多种账户认证与个性化外观。本文将带你从下载安装、首次打开，到创建并启动你的第一个 Minecraft 实例，全程不超过 10 分钟。

一、Axolotl 启动器能做什么？

先花 30 秒了解它的核心能力，之后操作会更有方向：

项目定位详见 README.md，官方下载渠道与安装说明也都在其中。

二、一键安装步骤：按系统选择安装包

前往官方 Releases 页面下载适合你系统的最新版安装包（各平台安装文件说明见 README.md 的"下载与安装"章节）：

Linux 用户还可以走包管理器快捷安装，例如 Arch（AUR）执行yay -S axolotl-launcher，Debian/Ubuntu 可通过官方 PPA 用apt安装，Nix 用户可直接添加 flake（参考 nix/axolotl.nix 与 README.md）。

已安装的老用户则无需手动下载：启动器内置 Tauri 签名校验机制，会在后台自动完成更新。

三、首次打开：新手引导带你认识界面

双击图标启动 Axolotl 后，首次运行会自动进入新手引导（Onboarding Tour），由一只粉色美西螈化身向导，逐站点亮界面各区域。你只需跟着提示点击即可，全部步骤定义在 onboardingConfig.ts 中，覆盖：

1. 首页：信息流首页由小组件构成（最近活动、游戏时长、实例、存档、服务器），右下角可自由拖拽编辑布局，也可切换"极简首页"。
2. 发现内容（Discover）：搜索整合包、模组、插件、资源包与光影的地方。
3. 皮肤选择器：集中管理 Minecraft 皮肤，此时不强制登录。
4. 账户：登录、切换账户、添加离线账户的入口。
5. 实验室（Lab）：内置工具集合，后面单独介绍。
6. 下载：所有安装与内容下载的"控制室"，进度、历史、错误、重试都留痕。
7. 设置：外观、语言、启动默认值、内容下载、隐私、更新策略都在这里。
8. 实例库（Library）：所有实例的"启动架"，可按整合包、服务器或自定义筛选。

提示：引导可随时跳过，之后在设置中也能随时重温各功能说明（引导实现见 OnboardingOverlay.vue）。

四、创建第一个Minecraft实例：自定义四步法

回到首页点击左侧+按钮，进入"创建新实例"页面。首次使用建议选择自定义（Custom）路线，流程只有四步：

第 1 步：取一个好认的名字

给实例起一个"未来的自己能一眼认出"的名称，例如"纯净生存"或"百格模组"。

第 2 步：选择引擎（Loader）

• Vanilla（原版）：不装任何模组，适合纯体验。
• Fabric / Forge / NeoForge：装模组前必须先选对引擎，模组兼容性看具体版本。

第 3 步：设定游戏版本

选择该实例使用的 Minecraft 版本号。注意"兼容性讲究具体"——模组合成包对版本非常敏感，照抄整合包要求的版本即可。

第 4 步：确认创建

点击确认后，启动器会自动开始下载游戏文件、Java 运行时等依赖，此时去下载中心查看进度即可。

除了自定义，你也可以选择导入已有实例或整合包，适合从旧启动器迁移的玩家。

五、配置Java运行环境与账户登录

Java 运行时

Minecraft 由 Java 驱动，启动器会在"设置 → Java 与性能"中统一管理 Java 运行时，并支持自动发现本机已安装的 Java。首次创建高版本实例时，若右下角弹出"Java 设置未推选"之类的提示，按指引在设置中为实例指定合适的 Java 版本即可（版本迁移相关能力见 packages/app-lib/ 中的启动器模块）。

账户登录

• 官方账户：在侧边栏账户入口登录 Mojang 官方账号，之后在线游戏即可使用。
• 离线账户：不想联网也能玩。打开侧边栏"正在扮演（Playing as）"添加离线 Minecraft 账户（首次可能需要先用官方账户在本机登录一次）。

六、实例启动前的最后一件事

实例创建完成后，打开实例详情页，你会看到头部的主控按钮：启动、停止、修复、配置、导出、打开目录。

启动前建议顺手检查两处：

• 内存分配：在实例设置中调整 JVM 内存（设置中也有"自动内存分配"选项，避免电脑被"炖熟"）。
• 实例备份：备份页可在实例关闭时对整个实例打快照，误删模组、手滑改配置都有后悔药。

一切就绪，点击启动——你的第一个 Minecraft 世界就开始加载了 🎉

七、进阶彩蛋：Axolotl 实验室

熟悉基本流程后，强烈建议逛一逛内置的Lab（实验室），全部本地运行、无需外部网站或账号（工具源码位于 apps/app-frontend/src/lab/）：

• 🗺️种子地图：输入种子或从实例读取，直接查看生物群系、结构与矿脉分布，进图前先找到钻石。
• 📐结构工坊：打开.litematic/.schem文件，3D 预览、测量、分层查看建筑图纸。
• 🧪配方生成器：选择 Java 版本、摆入材料，一键生成数据配方 JSON。
• 🌈渐变文字：编辑彩色文字并复制对应格式代码。

常见问题速查

Q：下载或安装卡住怎么办？打开"下载"页，进度、错误、重试、取消全部可视化，历史任务也能追溯，不会"神秘消失"。

Q：换了电脑如何迁移？在实例设置中使用"导出"功能打包实例文件，到新机器上选择"导入"即可。

Q：界面语言是英文？设置 → 语言 中切换，支持跟随系统与手动选择，同时可配置内容页翻译。

总结

按照本文的 5 步走完，你已经完成了 Axolotl 启动器新手入门的全部关键动作：下载安装 → 跟随引导熟悉界面 → 四步创建实例 → 配置 Java 与账户 → 启动游戏。后续想装模组、做整合包或备份存档，都在这同一个窗口里完成，无需再装第二个工具。祝你在方块世界里玩得开心！