Swift Craft Launcher

现代化的 macOS Minecraft 启动器

官网 • 下载 • 文档

简体中文 | 繁體中文 | English

---

项目概述

Swift Craft Launcher 是一款采用 SwiftUI 构建的原生 macOS Minecraft 启动器，提供流畅高效的游戏体验。专为现代 macOS 系统设计，集成全面的模组加载器支持、Microsoft 账户认证和直观的游戏管理功能。

核心特性

基础功能

• 多版本 Minecraft 支持 - ARM: 1.19+，Intel: 未测试
• Microsoft 账户认证 - 安全的 OAuth 集成，支持设备代码流程
• 模组加载器支持 - Fabric、Quilt、Forge 和 NeoForge，自动安装
• 资源管理 - 一键安装模组、数据包、光影和资源包

用户体验

• 原生 macOS 设计 - 基于 SwiftUI，遵循 Apple 人机界面指南
• 多语言支持 - 本地化界面，支持国旗标识
• 智能路径管理 - Finder 风格的面包屑导航，自动截断长路径
• 性能优化 - 高效的缓存和内存管理机制

高级配置

• Java 管理 - 每个配置文件独立的 Java 路径配置，版本自动检测
• 内存分配 - 可视化范围滑块设置 Xms/Xmx 参数 (即将推出)
• 自定义启动参数 - JVM 和游戏参数自定义 (即将推出)

系统要求

• macOS: 14.0 或更高版本
• Java: 8 或更高版本（用于 Minecraft 运行时）

安装方式

使用 Homebrew Tap (推荐)

# 方法 1：一键安装
brew install --cask suhang12332/swiftcraftlauncher/swift-craft-launcher

# 方法 2：添加 Tap 后安装
brew tap suhang12332/swiftcraftlauncher
brew install --cask swift-craft-launcher

💡 提示: 我们为 SwiftCraft Launcher 创建了专用的 Homebrew Tap

预编译版本

从 GitHub Releases 下载最新版本。

⚠️ 注意: 当前可下载的版本均为测试版本，稳定版本即将发布。

从源码构建

1. 克隆仓库

   git clone https://github.com/suhang12332/Swift-Craft-Launcher.git
   cd Swift-Craft-Launcher

2. 在 Xcode 中打开

   open SwiftCraftLauncher.xcodeproj

3. 构建并运行 使用 Xcode (⌘R)

构建要求：

• Xcode 13.0+
• Swift 5.5+

技术架构

组件	技术
UI 框架	SwiftUI
开发语言	Swift
响应式编程	Combine
目标平台	macOS 14.0+

开源协议

本项目采用 GNU Affero General Public License v3.0 开源协议。详细信息请查看 LICENSE 文件。

社区与支持

• 官方 QQ 群: 1057517524
• 问题反馈: GitHub Issues
• 功能建议: GitHub Discussions

参与贡献

我们欢迎各种形式的贡献！请查看我们的 贡献指南 了解以下内容：

• 代码风格和标准
• Pull Request 流程
• 问题报告指南

致谢

特别感谢以下项目对本启动器的贡献：

• Archify - macOS 应用程序通用二进制优化工具

---

为 Minecraft 社区用心制作 ❤️