CurseForge

ferium modpack add project_id

project_id 是模组包的项目 ID。例如，Fabulously Optimized 的项目 ID 是 396246。您可以在右侧边栏的“关于项目”部分顶部找到项目 ID。
要添加 Fabulously Optimized，您应该运行 ferium modpack add 396246。

升级模组

[!WARNING] 如果在设置输出目录时输出目录不为空，ferium 将建议创建备份。
如果包含您希望保留的任何文件，请执行此操作。

现在，在添加所有模组后，运行 ferium upgrade 以将它们全部下载到您的输出目录。默认情况下为 .minecraft/mods，其中 .minecraft 是默认的 Minecraft 资源目录。如果您使用 Mojang 的启动器并使用默认资源目录进行游戏，则无需担心此问题。您可以在创建配置文件期间选择自定义输出目录或稍后更改。

如果 ferium 无法下载模组，它将以红色打印其名称并尝试给出原因。它将继续下载您的其他模组，并以错误退出。

[!TIP] 升级时，任何 ferium 未下载的文件将被移动到输出目录中的 .old 文件夹。
有关添加 ferium 无法下载的模组的信息，请参阅用户模组。

升级模组包

[!WARNING] 如果在设置输出目录时输出目录中的 mods 和/或 resourcepacks 文件夹不为空，ferium 将建议创建备份。
如果包含您希望保留的任何文件，请执行此操作。

在添加您的模组包后，运行 ferium modpack upgrade 以将模组包下载到输出目录。默认为 .minecraft，这是默认的 Minecraft 资源目录。如果您使用 Mojang 的启动器并使用默认资源目录进行游戏，则无需担心此问题。您可以在添加模组包时选择自定义输出目录，或者 稍后更改。

如果 ferium 下载模组失败，它将以红色打印模组名称并尝试给出原因。它将继续下载其他模组，并以错误退出。

[!CAUTION] 如果您选择安装模组包覆盖，升级时现有配置可能会被覆盖。

管理模组

您可以通过运行 ferium list 列出当前配置文件中的所有模组。如果您想了解有关它们的更多信息，可以使用 ferium list -v 或 ferium list --verbose。

您可以使用 ferium remove 删除任何模组；只需使用空格键选择您想要删除的模组，然后完成后按回车键。您也可以提供要删除的模组的名称或 ID 作为参数。

[!IMPORTANT] 模组名称和 GitHub 仓库标识符不区分大小写。
包含空格的模组名称必须用引号括起来（ferium remove "ok zoomer"）或空格应该被转义（通常为 ferium remove ok\ zoomer，但取决于 shell）。

检查覆盖

如果某些模组应该与您的游戏版本和模组加载器兼容，但 ferium 没有下载它，如果您认为这是一个错误，请 创建一个问题。

如果您怀疑作者未指定兼容版本或模组加载器，您可以在添加单个模组时使用 --ignore-game-version 和/或 --ignore-mod-loader 标志来禁用游戏版本或模组加载器检查，或者在配置文件中将特定模组的 check_game_version 和/或 check_mod_loader 设置为 false。

例如，Just Enough Items 没有指定旧版本 Minecraft（如 1.12.2）的模组加载器。在这种情况下，您可以通过运行 ferium add 238222 --ignore-mod-loader 来添加 JEI，以禁用模组加载器检查。
您也可以在配置中手动禁用模组加载器（和/或游戏版本）检查，如下所示

{
    "name": "Just Enough Items (JEI)",
    "identifier": {
        "CurseForgeProject": 238222
    },
    "check_mod_loader": false
}

管理模组包

添加

添加模组包时，您将配置以下内容

• 输出目录
  • 默认为 .minecraft，这是默认的 Minecraft 资源目录。如果您使用 Mojang 的启动器并使用默认资源目录进行游戏，则无需担心此问题。
• 是否安装模组包覆盖

[!TIP] 您也可以将这些设置作为标志提供，以避免脚本等交互性

[!NOTE] Ferium 将自动切换到新添加的模组包

配置

您可以通过运行 ferium modpack configure 在之后配置这些相同的设置。同样，您可以将这些设置作为标志提供。

管理

您可以通过运行 ferium modpack list 或 ferium modpacks 来列出您已添加的所有模组包。
使用 ferium modpack switch 切换到不同的模组包。
使用 ferium modpack remove 移除模组包，并选择您想要移除的模组包。

配置文件

创建

您可以通过运行 ferium profile create 并指定以下内容来创建配置文件：

• 输出目录
  • 默认值为 .minecraft/mods，其中 .minecraft 是默认的 Minecraft 资源目录。如果您使用 Mojang 的启动器并使用默认资源目录，则无需担心此问题。
• 配置文件名称
• Minecraft 版本
• 模组加载器

如果您想从另一个配置文件复制模组，请使用 --import 标志。您也可以直接提供配置文件名称给标志，如果您不想显示配置文件选择器。

[!注意] Ferium 将自动切换到新创建的配置文件

[!TIP] 您也可以将这些设置作为标志提供，以避免脚本等交互性

配置

您可以通过运行 ferium profile configure 在之后配置相同的设置。同样，您也可以将这些设置作为标志提供。

管理

您可以通过运行 ferium profile 或 ferium profile info 获取当前配置文件的信息，以及通过运行 ferium profiles 或 ferium profile list 获取您拥有的所有配置文件的信息。
使用 ferium profile switch 切换到不同的配置文件。
使用 ferium profile delete 并选择您想要删除的配置文件来删除配置文件。

功能请求

如果您想提出功能请求，请检查 问题跟踪器 以查看该功能是否已被添加或计划中。如果没有，创建一个新问题。

开发

首先，您需要 Rust 工具链，包括 cargo、rustup 等。您可以使用 rustup 安装这些工具。如果您愿意，可以手动运行 cargo 命令，但建议使用仓库中的 justfile 配置。 just 是一个命令运行器，基本上是 make 的一个更好版本。

要构建项目并将其安装到您的 Cargo 二进制目录，请克隆项目并运行 just install。如果您想用于测试目的，请 添加夜间工具链 并运行 just（别名为 just install-dev），这有一些优化可以使编译更快。

您可以使用 cargo test 运行集成测试，使用 cargo clippy 进行代码审查，并使用 just clean 删除所有构建和测试工件。

如果您想了解如何为特定目标（例如 Linux ARM）进行交叉编译或其他信息，例如所需的发展库，请查看 工作流程文件。
如果您仍有疑问，请随时 创建一个讨论，我会尽力帮助您。