A next-generation Minecraft instance manager that thinks differently about game management.
๐ ไธญๆไป็ป โข ๐ฅ Download โข ๐ Documentation โข ๐ Report Bug โข ๐ก Request Feature
From launch to gameplay in seconds โก
Traditional Minecraft launchers manage files. Polymerium manages experiences.
| Generation | Management Focus | Representative Approach |
|---|---|---|
| 1st Gen | ๐ Versions | "Version Isolation" mechanism |
| 2nd Gen | ๐ฆ Instances | Isolated game environments with copied resources |
| 3rd Gen | ๐งฌ Metadata | Declarative configuration with on-demand deployment |
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:
- 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
- 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
- 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
- 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
- ๐จ 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
- ๐๏ธ CurseForge & Modrinth: Native integration with major mod repositories
- ๐ฆ Modpack Publishing: Export your instances as distributable modpacks
- ๐ Automatic Changelogs: Generated documentation for your modpack versions
- ๐ธ 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
Important
Windows Developer Mode Required
Polymerium uses symbolic links for efficient file management. Enable Developer Mode to allow symlink creation without administrator privileges.
Settings โ System โ For developers โ Developer Mode
Settings โ Update & Security โ For developers โ Developer Mode
Upgrade to Windows 10+ first ๐ฅ
Note
Polymerium is currently in active development. Features and UI may change between releases.
๐ฅ Download โ ๐ Extract โ ๐ Run โ โ๏ธ Setup
- Download the latest release from GitHub Releases
- Run installer
Polymerium-[arch]-Setup.exe - Follow the setup wizard to configure your first instance
๐ฎ Create โ ๐ฆ Add Content โ ๐ง Deploy โ
- Create Instance: Define your Minecraft version and mod loader
- Add Content: Browse and install mods from CurseForge or Modrinth
- Deploy: Let Polymerium build your game files
- Play: Launch directly or export as a modpack
| ๐ ๏ธ Technology | ๐ Purpose | ๐ Integration |
|---|---|---|
| .NET 10.0 | Latest runtime with C# preview features | Core platform |
| Avalonia 11 | Cross-platform XAML UI framework | Presentation layer |
| MVVM Pattern | Clean separation of concerns | Architecture pattern |
| Dependency Injection | Modular, testable architecture | Service management |
| Reactive Extensions | Responsive data handling | Data flow |
Polymerium/
โโโ ๐ docs/ # Documentation
โโโ ๐จ src/Polymerium.App/ # UI application layer
โโโ ๐ submodules/ # Shared components
โโโ ๐ฆ Releases/ # Build artifacts# Clone with submodules
git clone --recursive https://github.com/d3ara1n/Polymerium.git
cd Polymerium
# Build the solution
dotnet build
# Run in development mode
./Development.ps1# Development mode
./Development.ps1
# Production mode
./Production.ps1
# Build and publish
./Publish.ps1
# Get version info
dotnet gitversion
# Generate changelog
git cliffWe welcome contributions! Please ensure your code follows the established patterns:
| Aspect | Requirement |
|---|---|
| ๐๏ธ Architecture | MVVM pattern with clear separation of concerns |
| ๐ Dependency Injection | Use constructor injection throughout |
| ๐ฅ Modern C# | Leverage latest language features and patterns |
| โจ Code Style | Follow the .editorconfig guidelines |
We use resx for localization. If you want to contribute to the translation, you can edit the Resources.resx file in
src/Polymerium.App/Properties and add your language file in the same directory. Rider and Visual Studio have built-in
editors for resx files.
| Platform | Status |
|---|---|
 |
โ Stable |
 |
โ Stable |
 |
๐ Planned |
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
This project is licensed under the MIT License - see the LICENSE file for details.
- 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
- 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
This project is licensed under the MIT License - see the LICENSE file for details.
Polymerium: Rethinking Minecraft instance management for the modern era โจ
Made with โค๏ธ by the Polymerium team