CLI 参考

Last updated on

安装

CLI（trident）是一个独立项目，需要单独安装为 .NET 工具：

dotnet tool install --global TridentCore.Cli

CLI 与桌面应用可通过 TRIDENT_HOME 或 ~/.trident.home 使用同一个实例主目录，但 CLI 的账号、仓库及设置单独存储。路径选择参见自定义数据目录。

trident instance create --name "My Modpack" --identity my-modpack --version 1.21.1 --loader net.fabricmc:0.16.10

选项：

当前 CLI 校验要求提供 --name、--version，以及实例标识（--identity 或 --id）。
--loader 接受加载器 ID 和版本组成的 LURL，例如 net.fabricmc:0.16.10。用 trident loader list 查看支持的 ID。

trident instance list

trident instance inspect --instance my-modpack

显示实例配置和包信息。

trident instance build --instance my-modpack

运行完整的部署管道。等同于在 GUI 中点击"Deploy"。

trident instance run --instance my-modpack --username Steve

先部署，再使用 CLI 中的账号或指定的离线用户名启动 Minecraft。CLI 的账号存储与桌面应用分开。

trident instance export --instance my-modpack --format modrinth --author Steve --output ./my-modpack.mrpack

支持的格式：trident、curseforge、modrinth、multimc。

trident instance import ./my-pack.mrpack

自动检测格式。

trident instance delete --instance my-modpack

trident package search --repository modrinth "sodium"

trident package add --instance my-modpack pref://modrinth/aC3cM3Vq

Pref 格式为 pref://repository/project-id 或 pref://repository/project-id@version-id。请使用搜索结果返回的 Pref，而非显示名称。

trident package list --instance my-modpack

trident package enable --instance my-modpack pref://modrinth/aC3cM3Vq
trident package disable --instance my-modpack pref://modrinth/aC3cM3Vq

trident package version list pref://modrinth/aC3cM3Vq

trident package version set --instance my-modpack pref://modrinth/aC3cM3Vq@9I21YYxf

trident loader list

trident loader set --instance my-modpack net.fabricmc:0.16.10

trident account add --type microsoft

在终端中启动设备代码流（Device Code Flow）。

trident account add --type offline --username Steve

trident account list

trident account remove --uuid 00000000-0000-0000-0000-000000000000

trident repository list

trident repository status

trident repository add --label my-repo --driver modrinth --endpoint https://api.modrinth.com

启动 MCP 服务器用于 AI Agent 集成：

trident --mcp