入门
安装
在 Windows、macOS 或 Linux 上下载、安装和设置 Polymerium。
Last updated on
下载
从 GitHub Releases 下载适合你平台的最新版本。
| 平台 | 文件 |
|---|---|
| Windows x64 | Polymerium-win-Setup.exe |
| Linux x64 | Polymerium.AvaloniaImage |
| macOS ARM | Polymerium-osx-Setup.pkg |
每个平台使用其标准的安装程序格式。运行它并按照提示操作。
macOS：PKG 安装提示
由于 PKG 安装包未经 Apple 开发者证书签名，macOS Gatekeeper 可能会阻止安装并提示「安装包已损坏」。解决方法：
- 右键点击
.pkg文件，选择 打开。 - 如果仍然无法打开，在终端中移除隔离标记：
xattr -d com.apple.quarantine Polymerium-osx-arm64-Setup.pkg- 再次打开
.pkg文件，按照安装向导操作即可。
这是一次性操作。后续版本可能会切换为 DMG 分发，届时将不再出现此问题。
Windows：启用开发者模式
Polymerium 使用符号链接在实例之间共享模组文件，无需重复存储。在 Windows 上，创建符号链接需要启用 开发者模式。
- 打开 设置 → 系统 → 面向开发者
- 打开 开发者模式 开关
- 确认提示
这是一次性设置。这不会影响安全性 — 它只是允许你的用户账号创建符号链接，这是 macOS 和 Linux 的默认行为。
macOS 和 Linux 用户不需要任何特殊配置 — 符号链接开箱即用。
首次启动：首次启动向导
当你第一次打开 Polymerium 时，首次启动向导（OOBE）会引导你完成以下步骤：
- 欢迎与功能 — 快速了解 Polymerium 能做什么。
- 权限检查 — Polymerium 测试是否可以在其数据目录中创建符号链接。如果在 Windows 上失败，你需要启用开发者模式（见上文）。
- 快速设置 — 可选地配置 Java 路径和语言。
- 隐私 — 选择是否向 Sentry 发送崩溃报告和启动心跳。
- 完成 — 你准备好创建第一个实例了。
安装内容在哪里
新安装的 Polymerium 按平台分别存放配置、应用数据、缓存文件和实例：
- 配置（Config） ——
settings.json - 数据（Data） —— 持久化数据库（
persistence.sqlite.db）与首次运行标记 - 缓存（Cache） —— HTTP 缓存（
cache.sqlite.db）、崩溃报告缓存，以及共享缓存：模组文件、游戏资源、Java 运行时（分别位于packages/、assets/、runtimes/） - 实例（Instances） —— 你的 Minecraft 实例
| 类别 | Windows | Linux | macOS |
|---|---|---|---|
| 配置 | %APPDATA%\Polymerium | ~/.config/polymerium | ~/Library/Application Support/dev.dearain.Polymerium |
| 数据 | %LOCALAPPDATA%\Polymerium | ~/.local/share/polymerium | （同配置） |
| 缓存（HTTP + 崩溃报告） | %TEMP%\Polymerium | ~/.cache/polymerium | ~/Library/Caches/dev.dearain.Polymerium |
| 缓存（共享：模组/资源/运行时） | %TEMP%\Trident | ~/.cache/trident | ~/Library/Caches/dev.dearain.trident |
| 实例 | %LOCALAPPDATA%\Trident\instances | ~/.local/share/trident/instances | ~/Library/Application Support/dev.dearain.trident/instances |
如果已有
~/.trident/旧根目录，Polymerium 会继续沿用，不会自动搬迁文件。移动或删除旧文件前，请查看兼容与迁移。如需指定其他根目录，参见自定义数据目录。
下一步
现在 Polymerium 已经运行，创建你的第一个实例 →