【教程】从零开始克隆MTR仓库到本地并手动编译MTRMod

本教程转载自“CMBlog“ 【教程】从零开始手动编译MTRMod – CMBlog (cmbself.top)，作者Cmbself，转载至此时有改动。本教程随处都可能出现错误/不严谨之处，欢迎各位专业人士进行批评指出，将感激不尽。

" A8 U! b: F. g9 b注：MTRBBBS因未知原因在部分设备上可能无法显示出图片，请前往原帖查看。

0 C: \- ?4 H7 m5 n: q3 f本教程讲述了如何从Github克隆MTR 仓库到本地并编译源代码的方法。
; Q: R8 E  E# W# r- d) ]
为什么要从源代码编译Mod

• MTR的某些最新功能可能不会立即发布在测试版中，而是藏在Github的测试版分支里。因此，如果您想在预览版发布之前体验最新功能，就需要手动进行编译
• 您是出于开发或探索等某种目的而下载了源代码，需要将其构建成jar文件。
  % Y9 N( w$ p& f

0.先决条件

• Git（推荐为最新版）
• Java 8+
• Gradle（推荐为最新版）（可选）
  

接下来的内容中，我们会先引导你安装这些环境。

; F2 I8 Y8 c6 x$ q. ?' U1 p1.Java安装
1.1 如果您在个人电脑上玩Minecraft，您应该会有安装Java。所以这里不再赘述。如果您没有，这显然不太可能，请善用搜索引擎吧。

. W7 I! a2 \& k4 o7 a* a& F2.Git安装
2.1 访问Git官网的Windows版下载页面 并下载最新的64位版本。有时候，您可能需要使用某多线程下载器来加快下载速度。

3 D. z, E/ I' p* G: x
+ l$ ?$ w* Q8 J+ v) m4 w$ O  g- T* _
+ T# b% F, Z/ v/ x. ~备选下载方式1：https://github.com/git-for-windows/git/releases/latest Github
  B: E! S" P- E; _# ?5 ?& Z备选下载方式2：CNPM Binaries Mirror (npmmirror.com) 国内镜像 下载速度快
7 i+ H) L6 X) r0 v% U3 N2.2 下载完成后您将会得到一个可执行文件（.exe）。打开这个文件并执行安装，按照指引继续。它将会自动完成。‘
% [/ P5 B- Y0 \/ z3.Gradle安装（可选）
8 K: q4 k8 u* i# \  v2 w3.1 访问Gradle官方网站，点击主页的“Install Gradle”按钮，然后点击”releases page”链接即可到达下载页面。
* a% ^5 z5 k5 f+ z5 |( nhttps://gradle.org/
- `* g3 E: _3 h8 B+ t4 n
' n  e$ R- v, b0 G3.2 往下翻找到最新版，并选择”binary-only“下载选项。这样便会自动将gradle的压缩包下载到您的电脑上。
4 `' D% I! K* a8 x7 }3 Y
% Y7 y$ e( p) o) k7 D3.3 接着,用文件资源管理器在C盘创建一个新目录，例如C:\Gradle。将上一步下载到的压缩包放进去并解压到此文件夹中，结果如下：

8 P! {7 z3 e! }5 }9 Q3.4 回到桌面上。右键桌面的“此电脑”图标，点击“属性”，点击“高级系统设置”，然后点击”环境变量“

2 M  i  W, `+ D2 x1 v& D3.5 在”系统变量“处新增一个变量，填入以下内容（变量值替换为你3.3中的目录。），并点击”确定“以保存。
# Y5 v; ?3 u* L, s1 J2 `

1. GRADLE_HOME

复制代码

4 ^1 B, L' _( T: U0 c3.6 在“系统变量”列表里找到“Path”，双击打开编辑页面，新建一条，填入以下内容
9 T. z* Y3 v" d

! k9 q% X: `; q" F

1. %GRADLE_HOME%\bin

复制代码

至此，环境配置已经完成了。可以打开cmd并输入命令查看版本即为成功

1. gradle -version

复制代码

4.克隆仓库
( `' v; o3 K7 ~) d) ~) d! E4.1 首先查看仓库的Git地址（注意不要看错分支），复制。
) S% K  H* s3 V7 T
1 l# O1 H5 v; F1 F2 c* X: i' {

4.2 随意打开一个空的新文件夹，右键，点击“Git Bash Here”以在此处打开Git，在打开的命令行界面中输入以下内容，并回车。（xxxx处换成您在上一步复制的地址）静等完成即可。这一步会将MTR的仓库克隆到本地，请留意储存空间及网络环境等。

1. git clone xxxx

复制代码

4.2.1 如果上述方法不起作用 您可以在4.1处直接点击”Download ZIP”,并将下载到的文件解压到4.2的文件夹中。（这样反而更方便一些）

5.编译Mod
8 q  ]& B% {6 q+ C这里作者已经贴心的为我们提供了编译工具，我们只需要在终端执行命令进行编译即可。作者提供的编译命令如下：

1. gradlew build -PbuildVersion=<minecraft version>

复制代码

例如我们需要1.16.5版本的Mod，便可以
, b  V* _" G4 l) W5 F

1. gradlew build -PbuildVersion=1.16.5

复制代码

注意：如果您的网络环境较差，可能会失败。原因：需要从各类服务器在外国的网站上下载所需文件。或许您可以使用技术手段。


8 U/ v2 l1 x! c/ z8 F

支持！您的教程中有许多未被识别的代码 请您随即修正~

cmb，我想知道Mac怎么编译……

pokOS 发表于 2022-7-2 16:51
2 v# a# m. a1 x8 W. ?cmb，我想知道Mac怎么编译……

emmm 克隆源代码到本地后在终端执行命令，差不多的

问题是你翻开github伤mtr的存储库，点开Actions，翻开最新的action，你可以直接下到编译完的最新版啊

哎。。。这么有价值的帖子删掉太可惜，但是根据版规[2-3] 本版作为技术性版块，请勿发表无价值的主题和讨论。不建议发布过时、无创新、广为人知的内容，不允许发布可直接在Wiki找到的技巧或设计。帖子正文应简洁直白，逻辑清晰。创作教程类主题至少附上1张展示图或效果图。
. Y$ b6 \0 Q* x! k* B( F6 f( s您的图片全部被吞，请整改。

干活教程 推荐

GitHub上的源码都是最新的，我想要下载旧版本的源码怎么办？

chenxx 发表于 2025-5-3 14:34
1 ^) z( j% H+ w, U8 `  KGitHub上的源码都是最新的，我想要下载旧版本的源码怎么办？

, X* L' D; T5 b* o+ c" k+ V7 Z2 t用tag，不过tag也不是很全