跳到主要内容

lib-mod

在这一章,我将以《T88》这个lib-mod为例,向你讲述如何编写并使用属于自己的lib-mod。

当你写了不止一个mod的时候,你很有可能会发现你需要时不时的从之前的mod中复制代码到之后的mod——如果这些代码的数量达到了相当的程度,你可以选择将这些复用代码收集起来,整理为一个库模组,亦即lib-mod。

我们将借助CurseForge和CurseMaven来实现这一目的。

lib-mod本质上也是一个mod

所以,像平常一样,新建一个mod,取一个你想要的名字,构建,把你的共享代码写进去。

然后你需要在你的build.gradle中增加一行:

java {
...
withSourcesJar()
}

刷新项目,你会发现在build > jar旁边多出来一个sourcesJar。顾名思义,这个任务将会把你的mod打包为源代码Jar,而不是编译和混淆之后、可以在被MC加载的Jar。

在CurseForge上发布

然后你就可以把这个mod在CurseForge上发布了。请在上传jar文件之后,将source-jar也上传。

我建议你在项目介绍中写明类似如下的内容:

注意:如果你需要在游戏中使用此模组,请下载带“sources”后缀的版本!

Attention: If you want to install this mod to your game, do download the versions WITHOUT "sources" !

使用这个lib-mod

借助CurseMaven,我们可以方便地将CurseForge上的mod作为你自己mod的依赖。

在你的lib-mod首页,即Description一栏,你可以在右侧找到你的ProjectID

你的lib-mod在上传CurseForge,在Files一栏,分别点击对应的jar和source-jar,将鼠标悬停于Install旁的下拉菜单中的Download file,你就可以在浏览器下方显示的URL中查看它们的fileID了。

提示

即使你的mod jar暂时没有审核通过,你也可以照常查看并使用fileID

打开你需要使用lib-mod的mod,在build.gradle中增加:

//注意,这里不是在buildscript之下,而是build.gradle接近末尾处有单独的一块。
repositories {
maven {
url "https://cursemaven.com"
content { includeGroup "curse.maven" }
}
}

dependencies {
implementation fg.deobf("curse.maven:[lib-mod名称]-[ProjectID]:[jar的fileID]-sources-[source-jar的fileID]")
}

刷新项目,你应该就能在外部库列表里找到你自己的lib-mod了。

然后你还需要在mods.toml中告诉FML,你需要这个lib-mod:

# 在末尾添加如下内容
[[dependencies.你的modid]]
modId = "你依赖的lib-modid"
mandatory = true
versionRange = "[你依赖的lib-mod版本号下限,上限)" # 无上限则可以留空
ordering = "NONE"
side = "BOTH"
# 各项含义请参照原文件内的注释

更多内容可以参考CurseMaven的官方网站,https://www.cursemaven.com/


奇奇怪怪的注意事项

更灵活的使用方式

你可能会遇到这种情况:某个mod需要作一些修改,与此同时本地也需要修改另一个联动mod或者前置mod。

将前置mod不停地上传CurseFouge显然会很低效——但local maven什么的似乎又没有那个必要...你可以直接把前置mod的构建输出文件夹作为后置mod的依赖仓库,这样就能直接读取本地构建出来的jar了。

repositories {
...

flatDir {
dir 'D:/develop/t88/build/libs'
}
}

dependencies {
minecraft ...

implementation fg.deobf("blank:t88:0.4.+")

...
}

如上所示,通过指定前置mod的绝对路径,就可以方便地把对应的jar作为项目依赖了。

提示

你可以像上面一样,使用+号来绕过前置mod的版本号有后缀的情况。