{"id":34530879,"url":"https://github.com/d3ara1n/polymerium","last_synced_at":"2026-04-24T05:02:22.735Z","repository":{"id":65957679,"uuid":"587816508","full_name":"d3ara1n/Polymerium","owner":"d3ara1n","description":"🐿️ A next-generation Minecraft instance manager that thinks differently about game management","archived":false,"fork":false,"pushed_at":"2026-04-19T09:02:55.000Z","size":121881,"stargazers_count":88,"open_issues_count":3,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-19T11:12:44.804Z","etag":null,"topics":["avalonia","csharp","dotnet","fabric","forge","launcher","minecraft","modpack","modrinth","quilt","xaml"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/d3ara1n.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs/README.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-01-11T16:50:30.000Z","updated_at":"2026-04-19T09:02:59.000Z","dependencies_parsed_at":"2026-02-04T05:07:55.390Z","dependency_job_id":null,"html_url":"https://github.com/d3ara1n/Polymerium","commit_stats":null,"previous_names":[],"tags_count":79,"template":false,"template_full_name":null,"purl":"pkg:github/d3ara1n/Polymerium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3ara1n%2FPolymerium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3ara1n%2FPolymerium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3ara1n%2FPolymerium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3ara1n%2FPolymerium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/d3ara1n","download_url":"https://codeload.github.com/d3ara1n/Polymerium/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3ara1n%2FPolymerium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32209897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T03:15:14.334Z","status":"ssl_error","status_checked_at":"2026-04-24T03:15:11.608Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avalonia","csharp","dotnet","fabric","forge","launcher","minecraft","modpack","modrinth","quilt","xaml"],"created_at":"2025-12-24T05:36:55.964Z","updated_at":"2026-04-24T05:02:22.724Z","avatar_url":"https://github.com/d3ara1n.png","language":"C#","readme":"# Polymerium\n\n![Polymerium](https://socialify.git.ci/d3ara1n/Polymerium/image?description=1\u0026font=Jost\u0026forks=1\u0026issues=1\u0026language=1\u0026name=1\u0026owner=1\u0026pattern=Overlapping%20Hexagons\u0026pulls=1\u0026stargazers=1\u0026theme=Auto)\n\n\u003cdiv align=\"center\"\u003e\n\n**A next-generation Minecraft instance manager that thinks differently about game management.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![.NET 10.0](https://img.shields.io/badge/.NET-10-5C2D91?style=for-the-badge\u0026logoColor=white)](https://dotnet.microsoft.com/)\n[![Avalonia](https://img.shields.io/badge/Avalonia-12-3355FF?style=for-the-badge\u0026logoColor=white)](https://avaloniaui.net/)\n[![C#](https://img.shields.io/badge/C%23-14-239120?style=for-the-badge\u0026logoColor=white)](https://learn.microsoft.com/en-us/dotnet/csharp/)\n[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=for-the-badge\u0026color=00b0aa\u0026labelColor=000000\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K\u0026logoColor=ffffff)](https://zread.ai/d3ara1n/Polymerium)\n\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/8516e3e1a3994d138a1adc537d7c6ecd)](https://app.codacy.com/gh/d3ara1n/Polymerium/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![CodeFactor](https://www.codefactor.io/repository/github/d3ara1n/polymerium/badge)](https://www.codefactor.io/repository/github/d3ara1n/polymerium)\n\n[🌐 中文介绍](https://github.com/d3ara1n/Polymerium/blob/main/README.zh.md) • [📥 Download](https://github.com/d3ara1n/Polymerium/releases) • [📖 Documentation](https://github.com/d3ara1n/Polymerium/wiki) • [🐛 Report Bug](https://github.com/d3ara1n/Polymerium/issues) • [💡 Request Feature](https://github.com/d3ara1n/Polymerium/issues)\n\n\u003c/div\u003e\n\n---\n\n## 🎮 Experience Polymerium in Action\n\n\u003cdiv align=\"center\"\u003e\n\n[![Screenshot](assets/screenshots/overview.avif)](#-experience-polymerium-in-action)\n\n*From launch to gameplay in seconds* ⚡\n\n\u003c/div\u003e\n\n---\n\n## 🌟 What Makes Polymerium Different\n\n\u003e **Traditional Minecraft launchers manage files. Polymerium manages experiences.**\n\n### 🚀 The Evolution of Minecraft Launchers\n\n| Generation  | Management Focus | Representative Approach                             |\n|-------------|------------------|-----------------------------------------------------|\n| **1st Gen** | 📁 Versions      | \"Version Isolation\" mechanism                       |\n| **2nd Gen** | 📦 Instances     | Isolated game environments with copied resources    |\n| **3rd Gen** | 🧬 Metadata      | Declarative configuration with on-demand deployment |\n\n**Polymerium is a third-generation launcher.** Instead of copying and storing thousands of mod files for each instance,\nPolymerium describes your game setup as lightweight metadata and builds the actual game files on-demand. This\nrevolutionary approach brings several game-changing benefits:\n\n### 🎯 **Smart Resource Management**\n\n- **Zero Duplication**: Multiple instances sharing the same mods? Only one copy exists on disk\n- **Symlink Magic**: Files are intelligently linked, not copied, saving gigabytes of storage\n- **Instant Switching**: Change between completely different modpacks in seconds\n\n### 📦 **Portable Game Experiences**\n\n- **Metadata-Driven**: Your entire game setup fits in a tiny configuration file\n- **Version Control Ready**: Use Git to collaborate on modpack development\n- **True Portability**: Share your exact game experience with a simple file transfer\n\n### 🔧 **Effortless Maintenance**\n\n- **Integrity Guaranteed**: Every deployment validates file completeness and correctness\n- **Dependency Resolution**: Automatically handles mod dependencies and conflicts\n- **One-Click Updates**: Upgrade individual mods or entire modpacks seamlessly\n\n### 🎮 **Player-Focused Design**\n\n- **No Java Hunting**: Configure Java once, works everywhere\n- **Account Flexibility**: Multiple accounts, each linked to specific instances\n- **Clean Uninstall**: Remove Polymerium completely by deleting two folders\n\n---\n\n## ✨ Key Features\n\n### 🏗️ Modern Architecture\n\n- 🎨 **Avalonia UI**: Beautiful, responsive interface that works across platforms\n- 📋 **Metadata Engine**: Lightweight instance descriptions that rebuild perfectly every time\n- 🚀 **Deployment System**: Intelligent file management with integrity checking\n- 🔗 **Resource Pooling**: Shared file storage with symlink distribution\n\n### 🌐 Platform Integration\n\n- 🎟️ **CurseForge \u0026 Modrinth**: Native integration with major mod repositories\n- 📦 **Modpack Publishing**: Export your instances as distributable modpacks\n- 📝 **Automatic Changelogs**: Generated documentation for your modpack versions\n\n### 👨‍💻 Developer Experience\n\n- 📸 **Instance Snapshots**: Save and restore complete game states\n- 📜 **Layered Configuration**: Separate user settings from core game data\n- 🔄 **Build Reproducibility**: Identical deployments from the same metadata\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n\u003e [!IMPORTANT]\n\u003e **Windows Developer Mode Required**\n\u003e\n\u003e Polymerium uses [symbolic links](https://www.wikiwand.com/en/Symbolic_link) for efficient file management. Enable\n\u003e Developer Mode to allow symlink creation without administrator privileges.\n\n#### 📋 How to Enable Developer Mode\n\n##### Windows 11\n\n```\nSettings → System → For developers → Developer Mode\n```\n\n##### Windows 10\n\n```\nSettings → Update \u0026 Security → For developers → Developer Mode\n```\n\n##### Windows 7/8\n\n```\nUpgrade to Windows 10+ first 💥\n```\n\n### 📥 Installation\n\n\u003e [!NOTE]\n\u003e Polymerium is currently in active development. Features and UI may change between releases.\n\n| Platform | Package | Direct Download |\n| --- | --- | --- |\n| Windows x64 | Installer | [Download](https://github.com/d3ara1n/Polymerium/releases/latest/download/Polymerium-win-Setup.exe) |\n| Linux x64 | AppImage | [Download](https://github.com/d3ara1n/Polymerium/releases/latest/download/Polymerium.AppImage) |\n| macOS Apple Silicon | PKG installer | [Download](https://github.com/d3ara1n/Polymerium/releases/latest/download/Polymerium-osx-Setup.pkg) |\n\n[已有 Mirror酱 CDK？前往 Mirror酱 高速下载](https://mirrorchyan.com/zh/projects?rid=Polymerium\u0026channel=Polymerium_setup\u0026source=github-readme)\n\n**📥 Download** -\u003e **🚀 Run** -\u003e **⚙️ Setup**\n\n1. **Download** the package for your platform\n2. **Run** the installer or executable\n3. **Follow** the setup wizard to configure your first instance\n\n### 🚀 Quick Start\n\n**🎮 Create** → **📦 Add Content** → **🔧 Deploy** → **▶️ Play**\n\n1. **Create Instance**: Define your Minecraft version and mod loader\n2. **Add Content**: Browse and install mods from CurseForge or Modrinth\n3. **Deploy**: Let Polymerium build your game files\n4. **Play**: Launch directly or export as a modpack\n\n---\n\n## 🏗️ Architecture Overview\n\n| 🛠️ Technology           | 📋 Purpose                              | 🔗 Integration       |\n|--------------------------|-----------------------------------------|----------------------|\n| **.NET 10.0**            | Latest runtime with C# preview features | Core platform        |\n| **Avalonia 11**          | Cross-platform XAML UI framework        | Presentation layer   |\n| **MVVM Pattern**         | Clean separation of concerns            | Architecture pattern |\n| **Dependency Injection** | Modular, testable architecture          | Service management   |\n| **Reactive Extensions**  | Responsive data handling                | Data flow            |\n\n### 📁 Project Structure\n\n```sh\nPolymerium/\n├── 📚 docs/                   # Documentation\n├── 🎨 src/Polymerium.App/     # UI application layer\n├── 🔗 submodules/             # Shared components\n└── 📦 Releases/               # Build artifacts\n```\n\n---\n\n## Development\n\n### 🔨 Building from Source\n\n```sh\n# Clone with submodules\ngit clone --recursive https://github.com/d3ara1n/Polymerium.git\ncd Polymerium\n\n# Build the solution\ndotnet build\n\n# Run in development mode\n./Development.ps1\n```\n\n### 🛠️ Development Commands\n\n```sh\n# Development mode\n./Development.ps1\n\n# Production mode\n./Production.ps1\n\n# Build and publish\n./Publish.ps1\n\n# Get version info\ndotnet gitversion\n\n# Generate changelog\ngit cliff\n```\n\n### 🤝 Contributing\n\nWe welcome contributions! Please ensure your code follows the established patterns:\n\n| Aspect                      | Requirement                                    |\n|-----------------------------|------------------------------------------------|\n| 🏗️ **Architecture**        | MVVM pattern with clear separation of concerns |\n| 💉 **Dependency Injection** | Use constructor injection throughout           |\n| 🔥 **Modern C#**            | Leverage latest language features and patterns |\n| ✨ **Code Style**            | Follow the .editorconfig guidelines            |\n\nWe use `resx` for localization. If you want to contribute to the translation, you can edit the `Resources.resx` file in\n`src/Polymerium.App/Properties` and add your language file in the same directory. Rider and Visual Studio have built-in\neditors for resx files.\n\n---\n\n## 🖥️ Platform Support\n\n| Platform                                                                                                   | Status         |\n|------------------------------------------------------------------------------------------------------------|----------------|\n| ![Windows](https://img.shields.io/badge/Windows-10+-0078D6?style=flat-square\u0026logo=windows\u0026logoColor=white) | ✅ **Stable**   |\n| ![Linux](https://img.shields.io/badge/Linux-AppImage-FCC624?style=flat-square\u0026logo=linux\u0026logoColor=black)  | ✅ **Stable**   |\n| ![macOS](https://img.shields.io/badge/macOS-ARM64-000000?style=flat-square\u0026logo=apple\u0026logoColor=white)     | ✅ **Stable**   |\n\n---\n\n## Privacy \u0026 Security\n\nPolymerium respects your privacy:\n\n- **Minor Telemetry**: Collect least necessary data for debugging\n- **Local Storage**: All data stays on your machine\n- **Minimal Footprint**: Clean uninstall leaves no traces\n- **Open Source**: Transparent, auditable codebase\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 📊 Project Statistics\n\n[![Star History Chart](https://api.star-history.com/svg?repos=d3ara1n/Polymerium\u0026type=Date)](https://www.star-history.com/#d3ara1n/Polymerium\u0026Date)\n\n![Repobeats Analytics](https://repobeats.axiom.co/api/embed/594b206d199e6aae83226e6b7b834f6896322858.svg \"Repobeats analytics image\")\n\n## 📚 References \u0026 Acknowledgments\n\n### 🔗 Technical References\n\n- [Inside a Minecraft Launcher](https://ryanccn.dev/posts/inside-a-minecraft-launcher) - Game launch process and\n  Fabric/Quilt deployment\n- [Tutorial: Writing a Launcher](https://minecraft.fandom.com/zh/wiki/%E6%95%99%E7%A8%8B/%E7%BC%96%E5%86%99%E5%90%AF%E5%8A%A8%E5%99%A8) -\n  Game launch process guide\n- [ForgeWrapper](https://github.com/ZekerZhayard/ForgeWrapper) - Forge integration reference\n- [Microsoft Authentication Scheme](https://wiki.vg/Microsoft_Authentication_Scheme) - Authentication implementation\n\n### 🙏 Special Thanks\n\n- **Minecraft Community** - For the incredible modding ecosystem\n- **Avalonia Team** - For the excellent cross-platform UI framework\n- **API Providers** - CurseForge and Modrinth for their public APIs\n- **Contributors** - Everyone who helps make Polymerium better\n\n## 📄 License\n\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fd3ara1n%2FPolymerium.svg?type=large\u0026issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fd3ara1n%2FPolymerium?ref=badge_large\u0026issueType=license)\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE.txt) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Polymerium: Rethinking Minecraft instance management for the modern era** ✨\n\nMade with ❤️ by the Polymerium team\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd3ara1n%2Fpolymerium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd3ara1n%2Fpolymerium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd3ara1n%2Fpolymerium/lists"}