基本信息
我的世界Java版本
平台
Windows
详情信息
许可证 MIT
发布于 2 months ago
更新于 2 months ago
Polymerium
🎮 体验 Polymerium 的实际效果
🌟 Polymerium 的独特之处
传统的 Minecraft 启动器管理文件。Polymerium 管理体验。
Polymerium 不是复制和存储每个实例的数千个模组文件,而是将您的游戏设置描述为轻量级元数据,并按需构建实际的游戏文件。这种革命性的方法带来了几个改变游戏规则的好处:
🎯 智能资源管理
- 零重复:多个实例共享相同的模组?磁盘上只存在一个副本
- 符号链接魔法:文件被智能链接而非复制,节省数 GB 的存储空间
- 即时切换:在几秒钟内切换完全不同的模组包
📦 便携式游戏体验
- 元数据驱动:您的整个游戏设置都包含在一个小小的配置文件中
- 版本控制就绪:使用 Git 协作开发模组包
- 真正的便携性:通过简单的文件传输分享您的确切游戏体验
🔧 轻松维护
- 完整性保证:每次部署都会验证文件的完整性和正确性
- 依赖解析:自动处理模组依赖和冲突
- 一键更新:无缝升级单个模组或整个模组包
🎮 以玩家为中心的设计
- 无需寻找 Java:配置一次 Java,到处可用
- 账户灵活性:多个账户,每个都链接到特定实例
- 干净卸载:通过删除两个文件夹完全移除 Polymerium
✨ 主要功能
🏗️ 现代架构
- 🎨 Avalonia UI:美观、响应式的跨平台界面
- 📋 元数据引擎:轻量级实例描述,每次都能完美重建
- 🚀 部署系统:智能文件管理与完整性检查
- 🔗 资源池:共享文件存储与符号链接分发
🌐 平台集成
- 🎟️ CurseForge 和 Modrinth:与主要模组仓库的原生集成
- 📦 模组包发布:将您的实例导出为可分发的模组包
- 📝 自动更新日志:为您的模组包版本生成文档
👨💻 开发者体验
- 📸 实例快照:保存和恢复完整的游戏状态
- 📜 分层配置:将用户设置与核心游戏数据分离
- 🔄 构建可重现性:从相同元数据进行相同部署
开始使用
前置要求
[!IMPORTANT] 需要 Windows 开发者模式
Polymerium 使用符号链接进行高效的文件管理。启用开发者模式以允许在没有管理员权限的情况下创建符号链接。
📋 如何启用开发者模式
Windows 11
设置 → 系统 → 开发者选项 → 开发者模式
Windows 10
设置 → 更新和安全 → 开发者选项 → 开发者模式
Windows 7/8
请先升级到 Windows 10+ 😉
📥 安装
[!NOTE] Polymerium 目前正在积极开发中。功能和界面可能在版本之间发生变化。
📥 下载 → 📂 解压 → 🚀 运行 → ⚙️ 设置
- 下载 GitHub Releases 的最新版本
- 安装 并运行
Polymerium-[arch]-Setup.exe
- 配置 设置向导配置您的第一个实例
🚀 快速开始
🎮 创建 → 📦 添加内容 → 🔧 部署 → ▶️ 游戏
- 创建实例:定义您的 Minecraft 版本和模组加载器
- 添加内容:从 CurseForge 或 Modrinth 浏览和安装模组
- 部署:让 Polymerium 构建您的游戏文件
- 游戏:直接启动或导出为模组包
🏗️ 架构概览
🛠️ 技术 | 📋 用途 | 🔗 集成 |
---|---|---|
.NET 9.0 | 具有 C# 预览功能的最新运行时 | 核心平台 |
Avalonia 11 | 跨平台 XAML UI 框架 | 表示层 |
MVVM 模式 | 清晰的关注点分离 | 架构模式 |
依赖注入 | 模块化、可测试的架构 | 服务管理 |
响应式扩展 | 响应式数据处理 | 数据流 |
📁 项目结构
Polymerium/
├── 🎨 src/Polymerium.App/ # UI 应用程序层
├── ⚙️ src/Polymerium.Trident/ # 核心业务引擎
├── 🔗 submodules/ # 共享组件
├── 📚 docs/ # 文档
├── 🛠️ .kiro/steering/ # 开发指南
└── 📦 Releases/ # 构建产物
开发
🔨 从源码构建
# 克隆包含子模块
git clone --recursive https://github.com/d3ara1n/Polymerium.git
cd Polymerium
# 构建解决方案
dotnet build
# 以开发模式运行
./Development.ps1
🛠️ 开发命令
# 开发模式
./Development.ps1
# 生产模式
./Production.ps1
# 构建和发布
./Publish.ps1
# 获取版本信息
dotnet gitversion
# 生成更新日志
git cliff
🤝 贡献
我们欢迎贡献!请确保您的代码遵循既定的模式:
方面 | 要求 |
---|---|
🏗️ 架构 | 具有清晰关注点分离的 MVVM 模式 |
💉 依赖注入 | 全程使用构造函数注入 |
🔥 现代 C# | 利用最新的语言功能和模式 |
✨ 代码风格 | 遵循 .editorconfig 指南 |
[!TIP] 查看我们的指导文档了解详细的项目指南和架构模式。
🖥️ 平台支持
平台 | 状态 | 备注 |
---|---|---|
✅ 稳定 | 主要平台,具有完整功能支持 | |
🚧 进行中 | 核心功能正常工作 | |
📋 计划中 | 未来发布目标 |
隐私与安全
Polymerium 尊重您的隐私:
- 无遥测:零数据收集或跟踪
- 本地存储:所有数据都保留在您的机器上
- 最小占用:干净卸载不留痕迹
- 开源:透明、可审计的代码库
许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
📊 项目统计
📚 参考资料与致谢
🔗 技术参考
- Inside a Minecraft Launcher - 游戏启动过程和 Fabric/Quilt 部署
- Tutorial: Writing a Launcher - 游戏启动过程指南
- ForgeWrapper - Forge 集成参考
- Microsoft Authentication Scheme - 身份验证实现
🙏 特别感谢
- Minecraft 社区 - 为了令人难以置信的模组生态系统
- Avalonia 团队 - 为了出色的跨平台 UI 框架
- API 提供商 - CurseForge 和 Modrinth 提供的公共 API
- 贡献者 - 每一个帮助 Polymerium 变得更好的人
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
Polymerium:为现代时代重新思考 Minecraft 实例管理 ✨
由 Polymerium 团队用 ❤️ 制作