自定义mod信息

从这节起我们就会开始正式的写我们mod了！

更新Mappings

Forge的Mapping系统正在迁移的过程中，关于mapping文件的内容等MMS系统发布之后将会更新，我们目前使用的版本是20200916-1.16.2

我们需要将build.gradle下的mappings channel: 'snapshot', version: '20200514-1.16’修改为mappings channel: 'snapshot', version: '20200916-1.16.2’。

image-20200928114420876

然后点击右侧Gradle面板的重新导入按钮，重新导入项目，因为build.gradle文件非常的重要，请注意不要改错。

image-20200928114634037

这个过程可能会涉及下载文件（但不会很多），有出现错误的可能性，出错了请检查你的build.gradle内容有没有填错，然后多试几次。

配置

首先我们选中java文件夹下所有的目录和文件，然后右键删除Java包下的默认类。

image-20200928164532729

然后再右键新建立一个包

在默认情况下你的包名应该是你的域名的倒写，因为我不想用自己的域名举例子，所以这里我填入的内容是com.tutorial.boson。

image-20200928164952860

image-20200928165013147

image-20200928165047184

创建完成以后右击创建一个Java类，名字叫做Boson，请注意大小写，在默认情况下Java的类名遵循「帕斯卡命名法」。

image-20200928165137663

这个Boson就是我们Mod的主类。

接下来创建一个Utils类，用来放置一些全局的常量。

创建完成后目录树如下：

java
└── com
    └── tutorial
        └── boson
            ├── Boson.java
            └── Utils.java

接下来我们去Utils类里定义一下我们的modid，那么什么是你的modId呢？modId就是你mod名字的唯一标识符，请注意modId和你的mod名字不是同一个东西，它不允许大写字母，也不允许空格等内容。在这里我们选用的modId是boson。

public class Utils {
    public static final String MOD_ID = "boson";
}

然后进入Boson在类名的上方添加一个@Mod()注解，里面加入我们之前定义好的modid。添加完成后内容如下:

import net.minecraftforge.fml.common.Mod;

@Mod(Utils.MOD_ID)
public class Boson {
}

接下来我们需要去修改处于resources/META-INF下的mods.toml。在默认情况下IntelliJ是没有对Toml文件语法高亮的，如果你需要像我一样的语法高亮可以去安装一个Toml插件。

mods.toml是我们mod信息的配置文件，在这里我们可以修改我们mod的名字，介绍等内容。其中有许多配置项，如果一个配置项的注释里含有#mandatory说明这个配置项是必须的，如果注射里写的的是#optional，说明这个配置项是可选的，你可以在配置项前面加上#来注释掉这个配置项。

配置项作用
modLoader规定mod的Loader，大部分情况下不需要修改
loaderVersion规定了mod运行的Forge版本，大部分情况下不需要修改
license必填，这里填入的是你的Mod许可证
issueTrackerURL可选，你的Mod Bug提交地址，按需修改
modId必填，这里需要填入你的modId，和代码中的要保持一致
version必填，一般情况下保持默认即可
displayName必填，显示名称，你的mod在Mod界面的显示名称
updateJSONURL可选，你的mod的更新链接
displayURL可选，你的mod介绍网页的链接
logoFile可选，你的Mod的Logo
credits可选，你的Mod的致谢名单
authors可选，你的mod的作者名单
description必填，你的mod在mod界面的介绍

接下剩下的都是依赖，Forge官方的例子已经写的很清楚了，这里我们不多加说明

我修改完的mods.toml如下:

modLoader="javafml" 
loaderVersion="[34,)" 
license="GNU GPLv3"
[[mods]]
modId="boson" 
version="${file.jarVersion}" 
displayName="Boson"
authors="FledgeShiu" 
description='''
This is Boson, the 1.16 Modding tutorial example mod.
'''

现在我们已经修改完我们的mod信息了，现在让我打开游戏。

image-20200928170338998

可以看见我们的Mod已经出现了！