---
title: CLI 参考
description: trident 命令行工具——从终端管理实例、模组、账户等。
---

## 安装

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

```bash
dotnet tool install --global TridentCore.Cli
```

## 全局选项

| 选项 | 说明 |
|--------|-------------|
| `--home <path>` | 覆盖数据目录 |
| `--json` | 以 JSON 格式输出结果 |
| `--no-interactive` | 禁用交互式提示 |
| `--verbose` / `--debug` | 增加输出详细程度 |

## 实例命令

### 创建实例

```bash
trident instance create my-modpack --version 1.21.4 --loader fabric
```

选项：
- `--version`——Minecraft 版本（必填）
- `--loader`——加载器名称：`fabric`、`forge`、`neoforge`、`quilt`

### 列出实例

```bash
trident instance list
```

### 查看实例详情

```bash
trident instance inspect my-modpack
```

显示版本、加载器、模组数量、部署状态等信息。

### 部署（构建）实例

```bash
trident instance build my-modpack
```

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

### 启动实例

```bash
trident instance run my-modpack
```

如有需要会先部署，然后启动 Minecraft。

### 导出整合包

```bash
trident instance export my-modpack --format modrinth --output ./release/
```

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

### 导入整合包

```bash
trident instance import ./my-pack.mrpack
```

自动检测格式。

### 删除实例

```bash
trident instance delete my-modpack
```

## 包命令

### 搜索模组

```bash
trident package search "sodium"
```

### 添加模组

```bash
trident package add modrinth:sodium
```

`purl` 格式为 `repository:project-id` 或 `repository:project-id@version-id`。

### 列出已安装的模组

```bash
trident package list --instance my-modpack
```

### 启用/禁用模组

```bash
trident package enable modrinth:sodium --instance my-modpack
trident package disable modrinth:sodium --instance my-modpack
```

### 查看可用版本

```bash
trident package version list modrinth:sodium
```

### 固定特定版本

```bash
trident package version set modrinth:sodium <version-file-id>
```

## 加载器命令

### 列出实例的加载器

```bash
trident loader list --instance my-modpack
```

### 更换加载器

```bash
trident loader set my-modpack --loader neoforge --version 21.4.0
```

## 账户命令

### 添加微软账户

```bash
trident account add
```

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

### 添加离线账户

```bash
trident account add-offline --username Steve
```

### 列出账户

```bash
trident account list
```

### 移除账户

```bash
trident account remove <uuid>
```

## 仓库命令

### 列出已配置的仓库

```bash
trident repository list
```

### 检查仓库状态

```bash
trident repository status
```

### 添加仓库

```bash
trident repository add my-repo https://api.example.com
```

## MCP 模式

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

```bash
trident --mcp
```

详见 [MCP 模式 →](/docs/advanced/mcp)。
