使用命令行进行无头实例管理

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

上次更新

使用场景

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

安装

作为 .NET 全局工具

dotnet tool install --global Trident.Cli

独立二进制文件

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

基本工作流

创建并部署实例

# 创建一个 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

导出用于分发

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

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

非交互模式

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

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 以便于程序化处理：

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

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

CI/CD 示例：GitHub Actions

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 智能体或程序化访问：

trident --mcp

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

完整工具列表与使用示例请参阅 MCP 模式 →。

自定义数据目录

使用 --home 指定不同的数据目录。详见自定义数据目录 →。

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

这适用于：

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