A modern, free open-source Minecraft launcher for Windows and Linux
YNG Client is a sleek, modern Minecraft launcher built with Electron and Node.js. Featuring Microsoft OAuth2 authentication, automatic version management, and a flashy, clean interface that rivals commercial Minecraft clients. Built by the community, for the community.
- Microsoft OAuth2 integration for official Minecraft accounts
- Offline mode for development and testing
- Secure token storage and management
- Automatic Minecraft version detection and downloading
- Support for Release, Snapshot, and Beta versions
- Smart caching and update system
- One-click version switching
- Configurable Java memory allocation (up to 16GB)
- Custom JVM arguments support
- Optimized game directory management
- Background downloads with progress tracking
- Flashy, clean design with animated backgrounds
- Sidebar navigation with smooth transitions
- Glassmorphism effects and modern card layouts
- Platform support indicators (Windows ✅, Linux ✅, macOS ⏳)
- Real-time notifications and progress tracking
- Windows ✅ Full support
- Linux ✅ Full support
- macOS ⏳ Maybe in the future (but Mac is the worst OS 😉)
- Node.js 18+
- npm or yarn
- Java 8+ (for Minecraft)
-
Clone the repository
git clone https://github.com/YNG-Client/Client.git cd YNG-Client -
Install dependencies
npm install
-
Start the application
npm start
# For Windows
npm run build:win
# For Linux
npm run build:linux
# For all platforms
npm run build- Login: Click "Sign in with Microsoft" to authenticate with your Minecraft account
- Select Version: Choose your preferred Minecraft version from the dropdown
- Configure Settings: Adjust memory allocation and game directory if needed
- Launch: Click the "Launch Minecraft" button to start playing!
- 🏠 Home: Quick launch with version selector and user profile
- 📦 Versions: Browse and manage all Minecraft versions
- ⚙️ Settings: Configure memory, Java args, and directories
- ℹ️ About: View launcher info and feature details
- Memory Allocation: Adjust RAM usage (512MB - 16GB)
- Java Arguments: Add custom JVM parameters
- Game Directory: Choose where Minecraft files are stored
- Version Filtering: Show/hide snapshots and beta versions
- Keep Launcher Open: Option to close launcher when game starts
- Auto Updates: Automatic launcher update notifications
- Authentication: Microsoft OAuth2 or offline mode
YNG Client/
├── src/
│ ├── main/ # Main Electron process
│ │ ├── auth-manager.js # Microsoft OAuth2 authentication
│ │ ├── minecraft-manager.js # Version management & downloads
│ │ └── launcher-manager.js # Game launching logic
│ └── renderer/ # Frontend interface
│ ├── index.html # Modern UI with sidebar navigation
│ ├── styles.css # Flashy CSS with animations
│ └── app.js # Frontend application logic
├── package.json
└── README.md
- Frontend: HTML5, CSS3 (Grid/Flexbox, Custom Properties, Animations), Vanilla JavaScript
- Backend: Electron 27.0.0, Node.js 20.x
- Authentication: Microsoft Identity Platform (OAuth2)
- Design: Inter font, Glassmorphism, Dark theme, Gradient backgrounds
GPU Process Crashes on Windows
- The launcher includes automatic workarounds for GPU-related crashes
- If issues persist, try updating your graphics drivers
Authentication Fails
- Ensure you have a valid Minecraft account
- Check your internet connection
- Try restarting the launcher
Game Won't Launch
- Verify Java is installed and accessible
- Check game directory permissions
- Ensure sufficient disk space for downloads
We welcome contributions from the community! This is a free, open-source project built for everyone.
- 🐛 Report bugs on GitHub Issues
- 💡 Suggest features and improvements
- 🔧 Submit pull requests for bug fixes or new features
- 📚 Help improve documentation
- 🎨 Contribute UI/UX improvements
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
This project is licensed under the MIT License - completely free and open-source.
- Mojang Studios for creating Minecraft
- Microsoft for Xbox Live authentication services
- Electron team for the cross-platform framework
- Open Source Community for inspiration and support
- Why Would We Need ANOTHER client? You don't you should NOT need another client VS the base minecraft client.... BUT microsoft dose not care about the looks or performance even MOST major clients don't saying Hey! Let me spend 20$ for a FUCKING CAPE.
- How can the client be open source BUT Connect to the YNG Client API? We care about security and have the API source code limited to 2 people @KoopaCode & @iakzs you connect to it using our API url setup via the /src/main/src/main/config.js file!
- Will the API ever be open source? Depends aslong as we continue the development we WONT release the source for the API. If the development ever stops we WILL release the API & or update the client to have the API built in & or make it setup to play without the API
- Can I OPT out of using the YNG API? Kinda? We are working on making a documentation so YOU can create you're OWN api! and set the new API endpoint in the settings tab. We plan to setup a OPT out of auto updates and YNG Client API option SOON!
- How do the YNG Client Capes work? We create capes on our Appwrite DB and upload to there bucket and the client will check if the signed in user was granted the said cape!
- What DO we store in our API? We Store 1. UUID 2. Username 3. Granted Capes 4, Client Version! Everything else is disgraded and not synced to our Appwrite
🎮 YNG Client - Free Open Source Minecraft Launcher 🎮
Built with ❤️ for the Minecraft community
Windows ✅ | Linux ✅ | macOS ⏳