安装

要求:

• Git
• .NET 10 SDK 或已配置用于 C# 应用程序开发的 Visual Studio

::: 注意 如果您想修改代码，并且是 C# 或编程新手，那么创建机器人一文中列出的教程是一个不错的起点。 :::

使用 Git 克隆

安装 Git

1. 创建一个你想要保留源代码的新文件夹
2. 然后打开它，按住 SHIFT 并右键点击 点击文件夹中空白的白色空间
3. 在上下文菜单中点击 Git Bash
4. 通过运行以下命令克隆 GitHub 仓库：

git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive

如果您克隆仓库时未使用 --recursive 选项，请运行：

git submodule update --init --recursive

5. 一旦仓库被克隆，您可以关闭 Git Bash 终端模拟器
6. 打开新克隆的文件夹

下载翻译资源（可选）

1. 在 Crowdin 上访问 MCC项目主页。
2. 您需要登录您的Crowdin帐户才能下载。
3. 点击您想要下载翻译的语言。
4. 查找 MinecraftClient -> 资源 -> 翻译 -> MCC 应用内文本
5. 点击行尾的•••按钮。
6. 点击下载并将文件保存到文件夹 MinecraftClient/Resources/ Translations/。
7. 查找 MinecraftClient -> Resources -> ConfigComments -> Comments in the settings file
8. 点击行尾的•••按钮。
9. 单击下载并将文件保存到文件夹/MinecraftClient/Resources/ConfigComments/
10. 找到 MinecraftClient -> Resources -> AsciiArt -> ASCII Arts (Please use fixed-width fonts for editing)
11. 点击行尾的•••按钮。
12. 点击下载并将文件保存到文件夹 MinecraftClient/Resources/AsciiArt/。
13. 如果您需要下载另一种语言的翻译，请前往第3步继续。

使用 Visual Studio 构建

1. 通过 Visual Studio 打开 MinecraftClient.sln
2. 在 解决方案资源管理器 中右键点击 MinecraftClient
3. 点击 属性
4. 打开 构建 标签页并选择配置 发布
5. 按 CTRL + S 关闭文件
6. 在 解决方案资源管理器 中右键点击 MinecraftClient
7. 点击 构建

如果构建成功，发布的可执行文件 MinecraftClient.exe 将位于 MinecraftClient/bin/Release/net10.0/win-x64/publish/ 目录下。

使用.NET手动构建，无需Visual Studio

1. 打开您克隆或下载的 Minecraft-Console-Client 文件夹
2. 打开 PowerShell (在空白处右键 并点击 打开 PowerShell或 在 资源管理器: 文件 -> 打开 Powershell)
3. 如果您尚未安装，请先安装 .NET 10 SDK。 目前在 Windows 上最简单的选项是：

使用 winget 安装 Microsoft.DotNet.SDK.10

4. 对于常规的本地构建，请运行以下命令：

dotnet build MinecraftClient.sln -c Release

5. 如果你需要一个与仓库 CI 流程一致的发布版二进制文件，请运行：

source tools/mcc-env.sh
mcc-publish --rid win-x64

6. 如有需要，请验证 SDK 安装：

dotnet --信息

如果发布步骤成功，发布的可执行文件 MinecraftClient.exe 将位于 MinecraftClient/bin/Release/net10.0/win-x64/publish/ 目录下。

要求：

• Git

  • Linux

  • 在 macOS 上安装 Git

• .NET 10 SDK

  • 在 Linux 上安装.NET
  • 在 Ubuntu 上安装 .NET
  • 在 macOS 上安装.NET

使用 Git 克隆

1. 打开终端并导航到您将存储 MCC 的文件夹
2. 通过运行以下命令递归克隆 GitHub 仓库：

git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive

3. 转到您克隆过的文件夹 (应该是 Minecraft-Console-Client)

4. 安装 .NET 10 SDK。

   • 在 Ubuntu 24.04 LTS 上，请使用内置的 Ubuntu 软件包源：

     sudo apt-get update && \
       sudo apt-get install -y dotnet-sdk-10.0

   • 在 macOS 上，通常的做法是从 .NET 下载页面使用官方安装程序。 为 Apple Silicon 选择 Arm64,为 Intel Mac 选择 x64。

5. 如果您想下载翻译资源，请查看下载翻译资源

6. For the repo's normal local development workflow, source the helper environment and build through mcc-build:

   source tools/mcc-env.sh
   mcc-build

7. If you specifically want the low-level manual .NET command instead of the MCC wrapper, run:

   dotnet build MinecraftClient.sln -c Release

8. 如果您想要一个与仓库 CI 流程一致的发布版二进制文件，请运行以下命令：

   • 在 Linux:

     source tools/mcc-env.sh
     mcc-publish --rid linux-x64

     注意

     如果您使用的是 ARM 架构的 Linux 系统、32 位 RHEL 系统或 Musl，请根据您的平台选择合适的 RID（参阅：https://learn.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids），并将 -r linux-x64 替换为相应的 RID，例如 -r linux-arm64。

   • 在 macOS:

     source tools/mcc-env.sh
     mcc-publish --rid osx-x64

     注意

     如果您使用的不是 Intel 芯片的 Mac，请根据您的处理器选择合适的 RID（详见：https://learn.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids），并将 -r osx-x64 替换为相应的 RID，例如 -r osx-arm64。

如果构建成功，编译后的二进制 MinecraftClient 将被输入：

• Linux：MinecraftClient/bin/Release/net10.0/linux-x64/publish/
• macOS：MinecraftClient/bin/Release/net10.0/osx-x64/publish/

你可以通过以下命令验证 SDK 的安装：

dotnet --信息

要求:

• Git
• Docker

1. 通过运行以下命令克隆 GitHub 仓库：

git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive

2. 导航到 Minecraft-Console-Client/Docker
3. 使用以下命令生成映像

docker build -t minecraft-console-client:latest .

使用 Docker启动容器：

如果你不需要挂载卷，可以省略 -v 参数。 保持音量开启状态，可以更方便地从主机编辑存储在 MinecraftClient.ini 中的 TOML 配置文件。
docker run -it -v <您机器上的挂载路径>:/opt/data minecraft-console-client:latest

现在您可以登录，客户端正在运行。

要脱离客户端，但仍然在后台按下： CTRL + P 然后在 CTRL + Q 之后运行。

若要重新附加，请使用 docker 附加 命令。

使用 docker-compose 启动容器：

默认情况下，容器的卷将映射到名为 data 的新文件夹中存储 docker-compose.yml 的文件夹。

如果您不想映射卷，则必须注释或删除整个卷部分：

#volumes:
#- './data:/opt/data'

请确保您在目录中 docker-compose.yml 在您尝试开始之前被存储。 如果你这样做，你可以启动容器：

docker-compose run MCC

请记住在使用后删除容器：

docker-compose down

如果您使用了 MinecraftClient.ini 并在其中填写了相关数据，就可以通过以下方式启动容器：

docker-compose up
docker-compose up -d # 以守护进程方式在后台运行

请注意，您将无法使用 docker-compose up 与客户端交互。 如果你想要这个功能，请使用第一个方法： docker-compose 运行 MCC。

如上文所述，您可以通过以下方式停止和移除容器

docker-compose down

Termux

**F-Droid（推荐）：**安装 F-Droid 应用商店，搜索“Termux”并安装。

**GitHub 发布页面：**前往 最新的 Termux GitHub 发布页面,下载文件名包含 universal 的 APK 文件（例如 termux-app_v...-debug_universal.apk），然后进行安装。

安装 Ubuntu

我们使用官方的 Termux 工具 proot-distro 来安装 Ubuntu。 它将为您设备的架构安装最新可用的 Ubuntu LTS 版本。

打开 Termux，并按顺序逐条执行以下命令：

1. pkg update
2. pkg upgrade
3. 安装 proot-distro

现在安装 Ubuntu：

proot-distro 安装 ubuntu

安装完成后，使用以下命令启动 Ubuntu：

proot-distro 登录 ubuntu

安装 .NET

首先，更新 Ubuntu 的软件包列表并安装几个工具：

apt update -y && apt upgrade -y

安装 wget、curl、nano -y

然后使用微软官方安装脚本安装 .NET 10.0：

wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 10.0

现在请将 .NET 添加到你的 PATH 环境变量中，以便在未来的会话中也能正常使用。 打开 .bashrc：

nano ~/.bashrc

使用Page Down键滚动到文件底部，添加一个空行，然后粘贴以下内容：

export DOTNET_ROOT=$HOME/.dotnet
export PATH=$PATH:$HOME/.dotnet:$HOME/.dotnet/tools

使用 CTRL + X 保存文件，输入 Y，然后按 Enter 键。 然后应用更改：

source ~/.bashrc

通过运行以下命令来验证安装：

dotnet --version

你应该会看到一个类似 10.0.xxx 的版本号。

安装MCC

最后，我们可以安装 MCC。

让我们创建一个用于存放 MCC 的文件夹：

创建目录 MinecraftConsoleClient
进入 MinecraftConsoleClient 目录

下载适用于 ARM64 的最新 MCC 二进制文件：

wget -O MinecraftClient \
  "$(curl -s https://api.github.com/repos/MCCTeam/Minecraft-Console-Client/releases/latest \
    | grep 'browser_download_url.*linux-arm64'" \
    | cut -d '"' -f 4)"

可执行的：

chmod +x 我的世界客户端

并使用以下命令运行：

./MinecraftClient

安装后

下次打开 Termux 时，请使用以下命令启动 Ubuntu：

proot-distro 登录 ubuntu

然后使用 ./MinecraftClient 运行 MCC。

要阻止MCC运行，您可以按 CTRL + C

要编辑配置/设置，您需要一个文本编辑器，我们推荐使用Nano。 如果您遵循了上面的安装步骤，您应该熟悉，如果不熟悉，请查阅 本教程。

为了下载文件，您可以使用我们已安装的 wget 文件，只需运行：

wget your_link_here（上面有示例，下面有一个视频教程）。

另外，这里有一些 Linux 教程，供刚接触它的人使用：

• ExplainingComputer 的 Linux 终端介绍
• Linux Crash Course - nano (command-line text editor) by Learn Linux TV
• Linux Crash Course - 学习Linux TV wget 命令
• Linux Basics：怎么通过 webpwized 解压缩文件（tar, gzip）by webpwnized

您有两个选项：

• 购买VPS
• 免费获取AWS EC2 VPS （12个月免费试用）

购买VPS

如果您不想将您的信息提供给亚马逊或者没有借记卡，您可以购买自己的 VPS。

我需要什么硬件来运行管理MCC？

MCC 运行起来并不昂贵，因此它基本上可以在任何硬件上运行，如果您只运行 MCC，则无需在 VPS 上花费大量资金，请选择最便宜的选择。

在哪里获得VPS?

一些可靠和廉价的主机服务提供商（按价格/业绩分类）：

• E-Trail

  最低价格: 2.50 欧元/月

  注意

  如果在选择时下拉菜单中没有 Ubuntu 24.04 LTS，您可能需要稍后重新安装，或者联系客服协助完成。

• OVH Cloud

  最低价格: 3.57 欧元/月

• Hetzner Cloud

  最低价格: 4.51 欧元/月

• Digital Ocean

  最低价格: 4 欧元/月

• Contabo

  最低价格: 7 欧元/月

  更好的VPS能够托管多个应用程序，4个CPU内核和8 GB RAM，200 GB SSD

您也许想要寻找更好的交易。

AWS EC2 VPS

注册 AWS 并输入您所有的账单信息和电话号码。

完成后，您可以继续 设置 Amazon VPS。

当您注册并打开 AWS Console点击页面顶部的搜索字段并搜索： EC2

单击启动实例按钮。

用您您喜欢的名称填写 名称 字段。

在应用和操作系统镜像中，选择当前的 Ubuntu Server 24.04 LTS 镜像。 具体的 AWS 标签可能会因版本发布而略有不同。

对于 Instance type 选择 t2.micro。

对于 **Key pair (login) ** 点击 ** Create new key pair ** 并命名它 VpsRoot，保留其余设置为默认设置并点击 ** Create key pair **这将生成一个将自动下载的 RSA 私钥。

对于 ** Network settings ** 请检查以下复选框：

• Allow SSH traffic from (Anywhere)
• Allow HTTPs traffic from the internet
• Allow HTTP traffic from the internet

对 Storage 输入 30。

最后， 查看 Summary 确认一切都与教程一致，您将不会被收取费用，然后点击 Launch instance。 一旦您点击了按钮，这个实例需要几分钟时间才能启用并运行。

一旦实例启动并运行，前往它的详细信息并复制 Public DNS v4 IP 。

您现在需要登录，转到您的文件夹，保存您已经生成和下载的私钥（请确保您为它创建一个新的文件夹）不保留在下载文件夹中，右键点击空的白色空间（不在文件上），如果您在Windows上点击 Git Bash here， 在 mac OS 和 Linux 上点击 Open Terminal（或任何名称）。

要使用 SSH 登录，您将使用以下命令：

ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>

示例：

ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com

如果您提供了正确的信息，您应该会收到 Welcome to Ubuntu 20.04.5 LTS 消息。

现在您可以继续 Creating a new user

当您订购VPS时，很可能您会被要求提供 root 帐户名称和密码， 如果是的话，请将帐户命名为 root 并给它一个您选择的密码。

其他选项是，一旦设置完成，您将在电子邮件中获取您的登录信息。

获取 root 登录账号信息后，Windows 系统需要安装 Git Bash,而 macOS 或 Linux 系统则需要安装 ssh。

如果你在 Windows 打开 Git Bash，在 mac OS 和 Linux 上打开 终端 并输入以下命令：

ssh <username>@<ip>

示例：

ssh root@142.26.73.14

端口示例：

ssh -p 2233 root@142.26.73.14

一旦你登录，如果你的提供商已经设置了一个 Linux 提示和欢迎消息，你应该会看到。

一旦您登录到您的 VPS 后，您需要创建一个新的用户并给予它访问 SSH 的权限。

在这个教程中，我们将使用 mcc 作为将运行MCC的用户帐户的名称。

要创建一个名为 mcc 的新用户，请执行以下命令：

sudo useradd mcc -m

现在我们需要给它设置一个密码，执行以下命令，输入密码并确认它：

sudo passwd mcc

现在我们需要给予我们的用户帐户的管理员权限：

sudo usermod -aG sudo mcc

现在我们要把它设置成 bash：

sudo chsh mcc -s /bin/bash

现在我们需要登录 mcc 用户：

su mcc

出现询问提示时请输入密码。

导航到 mcc 用户主目录：

cd ~

创建一个新的 .ssh 目录：

mkdir .ssh

输入：

cd .ssh

创建一个新的空文件，名字是 authorized_key:

touch authorized_keys

不要关闭 Git bash/终端模拟器。

在您的电脑上，创建一个新文件夹，存储您将要用来登录到用户账户的 SSH 密钥。

打开文件夹，然后右键单击空的白色空间（不在文件上）， 如果您在Windows上点击 Git Bash here，在 mac OS 和 Linux 上点击 打开终端（或它被叫做什么）。

输入以下命令：

ssh-keygen -t RSA -b 4096

输入要输入的密钥文件的名称： MCC_key，按下Enter。

当被问到一个 passphrase时，请输入您选择的密码并确认它。 如果你把它写在一张纸上，请确保它的强度和你可以记住它。

这将生成一个私钥和一个公钥，您可以用它来登录 VPS 作为您创建的用户。

现在打开 MCC_Key.pub 文件，由您选择的文本编辑器并将其内容复制到剪贴板。

返回 Git Bash/Terminal 模拟器并执行以下命令：

sudo apt install nano -y

这将在您的 VPS 上安装 Nano 编辑器。

现在我们需要让您的 VPS 上的 SSH 服务知道你新生成的 SSH 密钥对。

请确保您在 /home/mcc/.ssh 文件夹中，您可以通过执行以下操作确认：

pwd

如果它没有输出到 /home/mcc/.ssh，请导航到它：

cd /home/mcc/.ssh

现在您需要打开 authorized_keys 文件与 nano 编辑器：

nano authorized_keys

现在点击右键将 MCC_Key.pub 复制的内容粘贴到 nano 编辑器。

使用 CTRL + O保存文件，按下Enter，然后用 CTRL + X 退出它。

现在我们需要配置SSHD服务，让我们使用生成的 SSH 密钥登录， 为此，我们需要使用 nano 编辑 /etc/ssh/sshd_config

sudo nano /etc/ssh/sshd_config

找到 #Pubkeyauthentication 是 行，并删除 # 前面以取消对该行的注释。

然后找到 #authorizedKeysFile .sh/authorized_keys .ssh/authorized_keys2 行，并删除 # 以取消对该行的注释。

此外，为了更好的安全，你可以做以下工作：

• 将 PermitRootLogin 设置为 yes
• 将 端口 更改为您选择的数值（22-65000）（请确保至少是 2 位数字并避免其他应用使用的共同端口如: 21/80/35/8080/3000 等...)
• 删除了 # 并将其设置为 yes 以此取消注释 #PasswordAuthority（这将禁用密码登录，您将只能使用SSH密钥登录！)

使用 CTRL + O保存文件，按下Enter，然后使用 CTRL + X 关闭它。

现在我们需要重启 SSHD 服务：

sudo systemctl restart sshd

让我们检查一切是否正常工作:

sudo systemctl status sshd

如果所有的配置都应该是原来的配置，你应该把 activity（运行） 看作是服务状态。

如果没有，请重新打开配置文件并检查错误。

按 q 退出日志模式。

使用 exit 命令从 mcc 用户注销，``然后通过再次输入 exit 从 root ubuntu 用户注销。

现在我们可以使用我们的私有 MCC_Key 文件登录用户。

命令：

ssh -i <path to the MCC_Key private key> mcc@<ip here>

示例：

ssh -i MCC_Key mcc@3.71.108.69

如果一切正确，您应该看到一个 Linux 提示和欢迎消息，如果您的提供商已经设置。

您可以使用 whoami 查看您的用户名。

现在您可以安装 .NET 10 SDK 和 MCC 了。

登录您已经创建的用户。

更新系统软件包和软件包管理库：

sudo apt update -y && sudo apt upgrade -y

在 Ubuntu 24.04 LTS 上，微软官方文档指出，.NET 可直接从 Ubuntu 软件源中获取，因此无需再添加旧版的 Microsoft .NET 10 软件源。 使用以下命令安装 SDK：

sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-10.0

你可以通过以下命令验证安装：

dotnet --信息

运行下面的命令来检查一切是否正确安装：

dotnet

您应该看到：

Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.

如果您没有看到此输出，并且安装未成功，请尝试其他方法。

如果一切顺利，你现在就可以安装 MCC 了。

既然你已经安装了 .NET SDK 并拥有一个用户账号，请安装 screen 工具。 如果你希望在关闭 SSH 会话后 MCC 仍能继续运行，就需要用到它。

你也可以通过这个 YouTube 教程了解 screen 命令。

要安装 screen 执行以下命令：

sudo apt install screen -y

现在您可以安装 MCC：

• 下载源码
• 从源码构建
• 使用 Docker 运行（不需要 屏幕 命令）

怎么使用 screen 命令？

要启动屏幕，请输入：

screen -S mcc

现在您将进入屏幕，现在您可以启动 MCC 并从屏幕中分离。

要从屏幕上分离，请按 CTRL + A + D。

要重新连接/返回到屏幕，请执行以下命令：

screen -r mcc

如果您意外关闭了 SSH 会话而没有从屏幕分离，它可能仍然被绑定，要分离它使用：

screen -d mcc

要列出屏幕，您可以使用：

screen -ls

要停止 MCC，您可以点击 CTRL + D（几次）。