Polymerium

🎮 Experience Polymerium in Action

🌟 What Makes Polymerium Different

Traditional Minecraft launchers manage files. Polymerium manages experiences.

🚀 The Evolution of Minecraft Launchers

Polymerium is a third-generation launcher. Instead of copying and storing thousands of mod files for each instance, Polymerium describes your game setup as lightweight metadata and builds the actual game files on-demand. This revolutionary approach brings several game-changing benefits:

🎯 Smart Resource Management

• Zero Duplication: Multiple instances sharing the same mods? Only one copy exists on disk
• Symlink Magic: Files are intelligently linked, not copied, saving gigabytes of storage
• Instant Switching: Change between completely different modpacks in seconds

📦 Portable Game Experiences

• Metadata-Driven: Your entire game setup fits in a tiny configuration file
• Version Control Ready: Use Git to collaborate on modpack development
• True Portability: Share your exact game experience with a simple file transfer

🔧 Effortless Maintenance

• Integrity Guaranteed: Every deployment validates file completeness and correctness
• Dependency Resolution: Automatically handles mod dependencies and conflicts
• One-Click Updates: Upgrade individual mods or entire modpacks seamlessly

🎮 Player-Focused Design

• No Java Hunting: Configure Java once, works everywhere
• Account Flexibility: Multiple accounts, each linked to specific instances
• Clean Uninstall: Remove Polymerium completely by deleting two folders

✨ Key Features

🏗️ Modern Architecture

• 🎨 Avalonia UI: Beautiful, responsive interface that works across platforms
• 📋 Metadata Engine: Lightweight instance descriptions that rebuild perfectly every time
• 🚀 Deployment System: Intelligent file management with integrity checking
• 🔗 Resource Pooling: Shared file storage with symlink distribution

🌐 Platform Integration

• 🎟️ CurseForge & Modrinth: Native integration with major mod repositories
• 📦 Modpack Publishing: Export your instances as distributable modpacks
• 📝 Automatic Changelogs: Generated documentation for your modpack versions

👨‍💻 Developer Experience

• 📸 Instance Snapshots: Save and restore complete game states
• 📜 Layered Configuration: Separate user settings from core game data
• 🔄 Build Reproducibility: Identical deployments from the same metadata

Getting Started

📥 Installation

Before downloading, check the note for your platform:

Settings → System → For developers → Developer Mode

Settings → Update & Security → For developers → Developer Mode

Upgrade to Windows 10+ first 💥

已有 Mirror酱 CDK？前往 Mirror酱 高速下载

📥 Download -> 🚀 Run -> ⚙️ Setup

1. Download the package for your platform
2. Run the installer or executable
3. Follow the setup wizard to configure your first instance

🚀 Quick Start

🎮 Create → 📦 Add Content → 🔧 Deploy → ▶️ Play

1. Create Instance: Define your Minecraft version and mod loader
2. Add Content: Browse and install mods from CurseForge or Modrinth
3. Deploy: Let Polymerium build your game files
4. Play: Launch directly or export as a modpack

🏗️ Architecture Overview

📁 Project Structure

Polymerium/
├── 📖 website/                # Documentation & project site
├── 🎨 src/                    # Application source code
├── 🔗 submodules/             # Embedded third-party project sources
├── 📝 notes/                  # Internal notes
├── 📜 changelogs/             # Version changelogs
├── 🛠️ scripts/                # Build & publish scripts
├── 🖼️ assets/                 # Screenshots and media
└── 📋 plans/                  # Planning documents

🖥️ Platform Support

Platform	Status
	✅ Stable
	✅ Stable
	✅ Stable

Privacy & Security

Polymerium respects your privacy:

• Minor Telemetry: Collect least necessary data for debugging
• Local Storage: All data stays on your machine
• Minimal Footprint: Clean uninstall leaves no traces
• Open Source: Transparent, auditable codebase

License

This project is licensed under the MIT License - see the LICENSE file for details.

📊 Project Statistics

📚 References & Acknowledgments

🔗 Technical References

• Inside a Minecraft Launcher - Game launch process and Fabric/Quilt deployment
• Tutorial: Writing a Launcher - Game launch process guide
• ForgeWrapper - Forge integration reference
• Microsoft Authentication Scheme - Authentication implementation

🙏 Special Thanks

• Minecraft Community - For the incredible modding ecosystem
• Avalonia Team - For the excellent cross-platform UI framework
• API Providers - CurseForge and Modrinth for their public APIs
• Contributors - Everyone who helps make Polymerium better

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.