# :-: Mod信息
***
你的mod需要更改信息,總得像樣點吧~
#### **文章導航:**
[TOC]
***
### **1.build.gradle**
在工程文件夾下,你可以找到一個叫 **`build.gradle`** 的文件(除非你刪了),這個文件很重要,與你的mod構建有關。下面我們看看有那些地方需要更改:
(其實這個文件中的注釋已經很明確了,翻譯即可,使用這里只說一些必要的更改)
~~~java
version = '1.0'
group = 'com.yourname.modid'
archivesBaseName = 'modid'
~~~
這些代碼位于大概16~18行可以找到,下面我會告訴大家這些都是什么意思:
* **version = '1.0'** :模組的[版本號](https://baike.baidu.com/item/%E7%89%88%E6%9C%AC%E5%8F%B7/7674145?fr=aladdin)(版本的標識號,[Maven的版本號規則](https://cwiki.apache.org/confluence/display/MAVENOLD/Versioning),[語義化版本](https://semver.org/lang/zh-CN/))。
* **group = 'com.yourname.modid'** :這是[GroupID](https://blog.csdn.net/iteye\_19209/article/details/82655261?utm\_medium=distribute.pc\_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.channel\_param&depth\_1-utm\_source=distribute.pc\_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.channel\_param),請遵循[命名規則](https://docs.oracle.com/javase/specs/jls/se6/html/packages.html#7.7)([Maven](http://maven.apache.org/guides/mini/guide-naming-conventions.html))。
* **archivesBaseName = 'modid'** :這個關聯到你最后導出的Jar文件名,直譯過來是“歸檔基本名稱”。
了解了意思,大家就應該知道要填什么了吧!
>[info] version = ' [這里填模組版本號] '
> group = ' [填GroupID,要根據你的文件夾填,在工程文件夾(MDK)下的src\main\java下] '
> archivesBaseName = ' [填模組ID] '
> * **group**:java文件夾下你可以找到`com\example\examplemod`,這是默認的,但我建議重命名為`com\[作者名]\[模組ID]`(這個不是一個文件夾的名稱,在com下的example文件夾重命名為[作者名],重命名后這個文件夾下的examplemod重命名為模組ID),比如我填的是`com.tangguo.pe`(每個文件夾名之間用點隔開)。tangguo就是我的名字,pe就是我的模組ID的縮寫。那么我的文件夾名就是`com\tangguo\pe`
> * **模組ID是什么**:該模組的唯一標識符,不要填寫出英文字母與一些半角符號(_)外的其他字符(空格替換為下劃線)。必須全小寫字母且不得超過64個字符。</p>
> ***(除了模組的本地化外都不要寫中文與特殊字符)***
下面是我的`build.gradle文件(局部)`:
~~~java
version = '0.0.1'
group = 'com.tangguo.pe'
archivesBaseName = 'power_engineering'
~~~
***
### **2.mods.toml**
上面的是構建相關,這里為mod信息的配置文件。
位于`工程文件夾\src\main\resources\META-INF`下的`mods.toml`文件。
那么如何填寫呢?很簡單,只要翻譯好“#”號后的文本就可以了(對,“#”后的文本都無效,就是注解),因為那是此配置項的信息,它告訴你怎么填。
>**FledgeXu的Neutrino教程中:**
>`mods.toml`是我們mod信息的配置文件,在這里我們可以修改我們mod的名字,介紹等內容。其中有許多配置項,如果一個配置項的注釋里含有`#mandatory`說明這個配置項是必須的,如果注釋里寫的的是`#optional`,說明這個配置項是可選的,你可以在配置項前面加上`#`來注釋掉這個配置項。
> | 配置項 | 作用 |
> | :-: | :-: |
> | modLoader | 規定mod的Loader,大部分情況下不需要修改 |
> | loaderVersion | 規定了mod運行的Forge版本,大部分情況下不需要修改 |
> | issueTrackerURL | 可選,你的Mod Bug提交地址,按需修改 |
> | modId | 必填,這里需要填入你的`modId`,和代碼中的要保持一致 |
> | version | 必填,一般情況下保持默認即可 |
> | displayName | 必填,顯示名稱,你的mod在Mod界面的顯示名稱 |
> | updateJSONURL | 可選,你的mod的更新鏈接 |
> | displayURL | 可選,你的mod介紹網頁的鏈接 |
> | logoFile | 可選,你的Mod的Logo |
> | credits | 可選,你的Mod的致謝名單 |
> | authors | 可選,你的mod的作者名單 |
> | description | 必填,你的mod在mod界面的介紹 |
下面是我的mods.toml文件:
~~~toml
modLoader="javafml" # 規定mod的Loader
loaderVersion="[31,)" # 規定了mod運行的Forge版本
[[mods]]
modId="power_engineering" # 必填,這里需要填入你的modId,和代碼中的要保持一致
version="0.0.1" # 必填,版本號
displayName="Power Engineering Mod" # 必填,顯示名稱,你的mod在Mod界面的顯示名稱
authors="Tangguo" # 可選,你的mod的作者名單
description="Power-Engineering for Minecraft 1.15.2 ." # 必填,你的mod在mod界面的介紹
# 其中的的注釋并不需要填入,順便說我的刪除了一些不必要的配置項,如依賴。
~~~
打開游戲看看你的mod列表吧!
如果你想寫多行的介紹(description)可以試試下面:
`mods.toml文件(局部):`
~~~toml
description="""
Power-Engineering for Minecraft 1.15.2 .
Thank you for downloading.
"""
# 之間放介紹文本,兩邊各用3個引號包起來
~~~
***
這樣,就完成了,**其中的modid要與代碼中的保持一致哦**~
下一章會講解主類的編寫。
