Polymerium\n\n\n\n

\n\n下一代 Minecraft 实例管理器，以全新思维重新定义游戏管理。\n\n\n\n\n\n\n\n\n\n📥 下载 • 📖 文档 • 🐛 报告问题 • 💡 功能建议\n\n

\n\n---\n\n## 🎮 体验 Polymerium 的实际效果\n\n

\n\n\n\n从启动到游戏，只需几秒钟 ⚡\n\n

\n\n---\n\n## 🌟 Polymerium 的独特之处\n\n> 传统的 Minecraft 启动器管理文件。Polymerium 管理体验。\n\nPolymerium 不是复制和存储每个实例的数千个模组文件，而是将您的游戏设置描述为轻量级元数据，并按需构建实际的游戏文件。这种革命性的方法带来了几个改变游戏规则的好处：\n\n### 🎯 智能资源管理\n\n- 零重复：多个实例共享相同的模组？磁盘上只存在一个副本\n- 符号链接魔法：文件被智能链接而非复制，节省数 GB 的存储空间\n- 即时切换：在几秒钟内切换完全不同的模组包\n\n### 📦 便携式游戏体验\n\n- 元数据驱动：您的整个游戏设置都包含在一个小小的配置文件中\n- 版本控制就绪：使用 Git 协作开发模组包\n- 真正的便携性：通过简单的文件传输分享您的确切游戏体验\n\n### 🔧 轻松维护\n\n- 完整性保证：每次部署都会验证文件的完整性和正确性\n- 依赖解析：自动处理模组依赖和冲突\n- 一键更新：无缝升级单个模组或整个模组包\n\n### 🎮 以玩家为中心的设计\n\n- 无需寻找 Java：配置一次 Java，到处可用\n- 账户灵活性：多个账户，每个都链接到特定实例\n- 干净卸载：通过删除两个文件夹完全移除 Polymerium\n\n---\n\n## ✨ 主要功能\n\n

\n

🏗️ 现代架构

\n\n- 🎨 Avalonia UI：美观、响应式的跨平台界面\n- 📋 元数据引擎：轻量级实例描述，每次都能完美重建\n- 🚀 部署系统：智能文件管理与完整性检查\n- 🔗 资源池：共享文件存储与符号链接分发\n\n

\n\n

\n

🌐 平台集成

\n\n- 🎟️ CurseForge 和 Modrinth：与主要模组仓库的原生集成\n- 📦 模组包发布：将您的实例导出为可分发的模组包\n- 📝 自动更新日志：为您的模组包版本生成文档\n\n

\n\n

\n

👨‍💻 开发者体验

\n\n- 📸 实例快照：保存和恢复完整的游戏状态\n- 📜 分层配置：将用户设置与核心游戏数据分离\n- 🔄 构建可重现性：从相同元数据进行相同部署\n\n

\n\n---\n\n## 开始使用\n\n### 前置要求\n\n> 需要 Windows 开发者模式\n>\n> Polymerium 使用符号链接进行高效的文件管理。启用开发者模式以允许在没有管理员权限的情况下创建符号链接。\n\n

\n

📋 如何启用开发者模式

\n\n#### Windows 11\n\n\n设置 → 系统 → 开发者选项 → 开发者模式\n\n\n#### Windows 10\n\n\n设置 → 更新和安全 → 开发者选项 → 开发者模式\n\n\n#### Windows 7/8\n\n\n请先升级到 Windows 10+ 😉\n\n\n

\n\n### 📥 安装\n\n> Polymerium 目前正在积极开发中。功能和界面可能在版本之间发生变化。\n\n**📥 下载** → 📂 解压 → 🚀 运行 → ⚙️ 设置\n\n1. 下载 GitHub Releases 的最新版本\n2. 安装 并运行 Polymerium-[arch]-Setup.exe\n3. 配置 设置向导配置您的第一个实例\n\n### 🚀 快速开始\n\n**🎮 创建** → 📦 添加内容 → 🔧 部署 → ▶️ 游戏\n\n1. 创建实例：定义您的 Minecraft 版本和模组加载器\n2. 添加内容：从 CurseForge 或 Modrinth 浏览和安装模组\n3. 部署：让 Polymerium 构建您的游戏文件\n4. 游戏：直接启动或导出为模组包\n\n---\n\n## 🏗️ 架构概览\n\n| 🛠️ 技术 | 📋 用途 | 🔗 集成 |\n|-----------------------------|----------------------------------------|------------------|\n| .NET 9.0 | 具有 C# 预览功能的最新运行时 | 核心平台 |\n| Avalonia 11 | 跨平台 XAML UI 框架 | 表示层 |\n| MVVM 模式 | 清晰的关注点分离 | 架构模式 |\n| 依赖注入 | 模块化、可测试的架构 | 服务管理 |\n| 响应式扩展 | 响应式数据处理 | 数据流 |\n\n

\n

📁 项目结构

\n\n\nPolymerium/\n├── 🎨 src/Polymerium.App/ # UI 应用程序层\n├── ⚙️ src/Polymerium.Trident/ # 核心业务引擎\n├── 🔗 submodules/ # 共享组件\n├── 📚 docs/ # 文档\n├── 🛠️ .kiro/steering/ # 开发指南\n└── 📦 Releases/ # 构建产物\n\n\n

\n\n---\n\n## 开发\n\n### 🔨 从源码构建\n\nbash\n# 克隆包含子模块\ngit clone --recursive https://github.com/d3ara1n/Polymerium.git\ncd Polymerium\n\n# 构建解决方案\ndotnet build\n\n# 以开发模式运行\n./Development.ps1\n\n\n

\n

🛠️ 开发命令

\n\npowershell\n# 开发模式\n./Development.ps1\n\n# 生产模式\n./Production.ps1\n\n# 构建和发布\n./Publish.ps1\n\n# 获取版本信息\ndotnet gitversion\n\n# 生成更新日志\ngit cliff\n\n\n

\n\n### 🤝 贡献\n\n我们欢迎贡献！请确保您的代码遵循既定的模式：\n\n| 方面 | 要求 |\n|-----------------------------|-------------------------------------------|\n| 🏗️ 架构 | 具有清晰关注点分离的 MVVM 模式 |\n| 💉 依赖注入 | 全程使用构造函数注入 |\n| 🔥 现代 C# | 利用最新的语言功能和模式 |\n| ✨ 代码风格 | 遵循 .editorconfig 指南 |\n\n> 查看我们的指导文档了解详细的项目指南和架构模式。\n\n---\n\n## 🖥️ 平台支持\n\n| 平台 | 状态 | 备注 |\n|------------------------------------------------------------------------------------------------------------|--------------------|--------------------------------------------|\n| | ✅ 稳定 | 主要平台，具有完整功能支持 |\n| | 🚧 进行中 | 核心功能正常工作 |\n| | 📋 计划中 | 未来发布目标 |\n\n---\n\n## 隐私与安全\n\nPolymerium 尊重您的隐私：\n\n- 无遥测：零数据收集或跟踪\n- 本地存储：所有数据都保留在您的机器上\n- 最小占用：干净卸载不留痕迹\n- 开源：透明、可审计的代码库\n\n---\n\n## 许可证\n\n本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。\n\n---\n\n## 📊 项目统计\n\n

\n\n\n\n\n\n

\n\n## 📚 参考资料与致谢\n\n

\n

🔗 技术参考

\n\n- Inside a Minecraft Launcher - 游戏启动过程和 Fabric/Quilt 部署\n- Tutorial: Writing a Launcher - 游戏启动过程指南\n- ForgeWrapper - Forge 集成参考\n- Microsoft Authentication Scheme - 身份验证实现\n\n

\n\n### 🙏 特别感谢\n\n- Minecraft 社区 - 为了令人难以置信的模组生态系统\n- Avalonia 团队 - 为了出色的跨平台 UI 框架\n- API 提供商 - CurseForge 和 Modrinth 提供的公共 API\n- 贡献者 - 每一个帮助 Polymerium 变得更好的人\n\n## 📄 许可证\n\n

\n\n\n\n本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。\n\n

\n\n---\n\n

\n\nPolymerium：为现代时代重新思考 Minecraft 实例管理 ✨\n\n由 Polymerium 团队用 ❤️ 制作\n\n

\n