Skip to content

Bisquit-Host/Pyzh-Craft

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

956 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PyzhCraft

๐Ÿš€ Pyzh Craft

โœจ A modern Minecraft launcher for macOS โœจ

Pyzh Craft Swift

QQ Group Discord

License: AGPL v3 latest-release macOS Homebrew Contributors

๐ŸŒ Website โ€ข ๐Ÿ’พ Download โ€ข ๐Ÿ“š Documentation

๐Ÿ‡ฌ๐Ÿ‡ง English | ๐Ÿ‡จ๐Ÿ‡ณ ็ฎ€ไฝ“ไธญๆ–‡ | ๐Ÿ‡ญ๐Ÿ‡ฐ ็น้ซ”ไธญๆ–‡


Supported platforms

  • macOS 14+

๐ŸŽฏ Overview

Pyzh Craft is a native macOS Minecraft launcher ๐ŸŽ built with SwiftUI, offering a streamlined and efficient gaming experience. Designed for modern macOS systems, it provides comprehensive mod loader support, Microsoft account authentication, and intuitive game management.

PyzhCraft Screenshot
PyzhCraft Screenshot

โœจ Key Features

๐Ÿงฉ Core Functionality

  • ๐Ÿ”„ Multi-version Minecraft Support - ARM: 1.13+, Intel: untested
  • ๐Ÿ” Microsoft Account Authentication - Secure OAuth integration with device code flow
  • ๐Ÿงฐ Mod Loader Support - Fabric, Quilt, Forge, and NeoForge with automatic installation
  • ๐Ÿ“ฆ Resource Management - One-click installation of mods, datapacks, shaders, and resource packs

๐Ÿ’ป User Experience

  • ๐ŸŽจ Native macOS Design - SwiftUI-based interface following Apple Human Interface Guidelines
  • ๐ŸŒ Multi-language Support - Localized interface with flag indicators
  • ๐Ÿ—‚๏ธ Smart Path Management - Finder-style breadcrumb navigation with auto-truncation of long paths
  • โšก Performance Optimization - Efficient caching and memory management mechanisms

โš™๏ธ Advanced Configuration

  • โ˜• Java Management - Per-profile Java path configuration with automatic version detection
  • ๐Ÿง  Memory Allocation - Visual range slider for Xms/Xmx parameter settings
  • ๐Ÿ”ง Custom Launch Parameters - JVM and game argument customization

๐Ÿ“‹ System Requirements

  • ๐Ÿ’ป macOS: 14.0 or later
  • โ˜•๏ธ Java: 8 or later (for Minecraft runtime)

๐Ÿ“ฅ Installation

๐Ÿบ Using Homebrew Tap (Recommended)

# Method 1: One-command install
brew install --cask suhang12332/swiftcraftlauncher/swift-craft-launcher

# Method 2: Add Tap then install
brew tap suhang12332/swiftcraftlauncher
brew install --cask swift-craft-launcher

๐Ÿ’ก Tip: We created a dedicated Homebrew Tap for Pyzh Craft

๐Ÿ’พ Pre-built Release

Download the latest version from GitHub Releases.

โš ๏ธ Note: The current available downloads are test versions. Stable releases are coming soon.

โ“ Frequently Asked Questions

Please visit FAQ

๐Ÿ”จ Build from Source

  1. โฌ Clone the repository

    git clone https://github.com/suhang12332/Swift-Craft-Launcher.git
    cd Swift-Craft-Launcher
  2. ๐Ÿ› ๏ธ Open in Xcode

    open PyzhCraft.xcodeproj
  3. ๐Ÿš€ Build and run using Xcode (โŒ˜R)

Build Requirements:

  • Xcode 13.0+
  • Swift 5.5+

๐Ÿงช Technical Architecture

Component Technology
๐ŸŽจ UI Framework SwiftUI
๐Ÿ’ป Language Swift
๐Ÿ”„ Reactive Programming Combine
๐Ÿ“ฑ Target Platform macOS 14.0+

๐Ÿ“œ License

This project is licensed under the GNU Affero General Public License v3.0. See LICENSE for details.

Additional Terms: This project includes additional terms requiring source attribution and prohibiting the use of the same software name. See:

๐Ÿค Community & Support

๐ŸŒŸ Contributing

We welcome contributions! Please see our Contributing Guidelines for details on:

  • Code style and standards
  • Pull request process
  • Issue reporting guidelines

๐Ÿ™ Acknowledgments

Special thanks to the following projects that have contributed to this launcher:

  • Archify - Universal binary optimization tool for macOS applications

๐ŸŽฎ Made with โค๏ธ for the Minecraft community

About

Native macOS Minecraft launcher built with SwiftUI

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Languages

  • Swift 100.0%