既然我们的目的只是跑起来，那就直接上干货。

学习目标：

  • 学会使用模版，了解json语言的结构

json结构

什么叫语法？

英语有语法，汉语有语法，只有遵循语法别人才能听懂你要表达什么，同理，想要游戏理解你的模组也需要遵循一定的语法。

  1. {
  2.   "键1": "这是字符串，里面都是字符",
  3.   "键2": 114514,
  4.   "键3": true,
  5.   "键4": [
  6.     "第一个字符串",
  7.     "第二个字符串"
  8.   ],
  9.   "键5": {
  10.     "对象内键1": "字符串",
  11.     "对象内键2": [
  12.       "括号可以任意嵌套",
  13.       1919810
  14.     ]
  15.   }
  16. }

这一段代码概括了json所有的语法。

  • 一个json文件首尾需要大括号，里面的内容严格**区分大小写**；
  • 内部是一个一个“键名: 键值”的结构，叫做键值对，中间必须有冒号，冒号必须用英文符号；
  • 每个键值对或值之间需要用逗号或换行隔开，最后一个不需要！
  • 键名就是正常的名字，可用双引号扩上；
  • 键值可以是字符串、数字或true/false，也可以是中括号（列表）和大括号（对象）；
  • 字符串可以用英文双引号扩起来，比如“abc” “你好，世界”；
  • 数字和true/flase不需要双引号，比如 1 0.114 true；
  • 中括号内不是“键名: 键值”，每一个值也是刚才的五种（字符串、数字、true/false、列表、对象）；
  • 大括号里是“键名: 键值”，所以回头看看第一条你就明白为什么一个文件里全是键值对了。

上面部分语法并不严格或无关紧要，但这就像正式与非正式文体一样，正规场合总是需要严格遵守以上语法的。

模版

  1. {
  2.   "name": "shifan",
  3.   "displayName": "示范模组",
  4.   "author": "[orange]硫缺铅[]",
  5.   "description": "这是一个示例",
  6.   "version": "0.1",
  7.   "minGameVersion": "137"
  8. }

首先我们需要给模组取一个气派的名字：如果你不会取名，“xx工业”、“xx模组”、“xx拓展”、“更多xx”并不土气，而且十分简单。

  • displayName是模组显示在模组管理器内的名字，可以用英文；
  • name是模组的英文名，英文名可以不必很洋气，如果你做不到把xx准确的翻译成英文，你一是可以询问他人“如何取xx模组的英文名”，也可以直接用拼音。无论如何，务必只使用二十六个小写字母，空格用连字符替代。
  • author是作者，填上你的大名；
  • description是简介，想写什么就写什么，但是不要换行，想换行的位置可以用\n，这样在游戏内\n处就会显示为换行。
  • version是版本号，可能你会问我这是数字为什么需要双引号（心里暗骂我退钱）。但是如果我告诉你可以写“0.0.1a”呢？
  • minGameVersion是最低游戏版本，由于模组的接口每个大版本都会变化，所以为了防止兼容性问题每个大版本都会限制这个的值，目前v7alpha要求最低136；

如何使用模版

  • 首先，找个好地方，最好是你在文件管理器里好找的地方，建立一个文件夹。
  • 然后思考模组的名称，把文件夹的名字设置为模组的名字
  • 接下来，新建mod.json文本文件（不是文件夹！），将上述内容复制进去，并修改键值达到你想要的效果

打包并测试

在此之后，压缩这个文件夹并导入游戏，如果一切正常，则代表你完成了本章的学习。