---
title: 使用命令行进行无头实例管理
description: 在服务器或 CI/CD 环境中使用 trident 命令行管理 Minecraft 实例 —— 无需图形界面。
---

## 使用场景

- **CI/CD 流水线** —— 每次提交时自动构建并导出整合包。
- **专用服务器** —— 在无头 Linux 服务器上管理游戏实例。
- **自动化脚本** —— 批量创建、配置和部署实例。
- **AI 智能体工作流** —— 使用 MCP 模式让 AI 以编程方式管理实例。

## 安装

### 作为 .NET 全局工具

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

### 独立二进制文件

从 NuGet 下载或从源码构建。CLI 是一个独立的 .NET 应用程序 —— 无需图形界面依赖。

## 基本工作流

### 创建并部署实例

```bash
# 创建一个 Fabric 1.21.4 实例
trident instance create my-pack --version 1.21.4 --loader fabric

# 添加模组
trident package add modrinth:sodium
trident package add modrinth:lithium
trident package add modrinth:ferrite-core
trident package add modrinth:fabric-api

# 部署
trident instance build my-pack
```

### 导出用于分发

```bash
# 导出为 Modrinth 整合包
trident instance export my-pack --format modrinth --output ./releases/

# 导出为 CurseForge 整合包
trident instance export my-pack --format curseforge --output ./releases/
```

### 非交互模式

使用 `--no-interactive` 跳过所有提示 —— CI/CD 必需：

```bash
trident instance create my-pack --version 1.21.4 --loader fabric --no-interactive
trident package add modrinth:sodium --no-interactive
trident instance build my-pack --no-interactive
```

### JSON 输出

使用 `--json` 以便于程序化处理：

```bash
# 以 JSON 格式列出实例
trident instance list --json

# 搜索模组并通过管道传递给 jq
trident package search "sodium" --json | jq '.[].purl'
```

## CI/CD 示例：GitHub Actions

```yaml
name: Build Modpack
on:
  push:
    tags: ['v*']

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Trident CLI
        run: dotnet tool install --global Trident.Cli

      - name: Build and Export
        run: |
          trident instance import ./my-pack.zip --no-interactive
          trident instance build my-pack --no-interactive
          trident instance export my-pack \
            --format modrinth \
            --output ./release/ \
            --no-interactive

      - name: Upload Release
        uses: softprops/action-gh-release@v1
        with:
          files: ./release/*.mrpack
```

## MCP 模式用于自动化

启动 MCP 服务器，以供 AI 智能体或程序化访问：

```bash
trident --mcp
```

服务器通过 stdio 通信，使用模型上下文协议（Model Context Protocol）。任何兼容 MCP 的客户端都可以连接并使用 30 多个工具来管理实例。

完整工具列表与使用示例请参阅 [MCP 模式 →](/docs/advanced/mcp)。

## 自定义数据目录

使用 `--home` 指定不同的数据目录。详见 [自定义数据目录 →](/docs/guides/custom-data-directory)。

```bash
trident --home /opt/minecraft-data instance list
```

这适用于：
- 并行运行多个配置
- 在脚本中指定特定的数据目录
- 将 CI 构建与个人数据隔离