ContentsTweaker (for Mindustry)

一个内容包加载器的像素工厂MOD
A Mindustry MOD to dynamically load Contents Patch

功能 Features

• 接受服务器指令，为加载下张地图时，更换指定的内容补丁
• Receive Info from Server, load special Contents Patch when join server or change map.
• 为其他MOD提供接口，提供动态加载内容补丁的能力
• Provide API for other mods, provide feature to dynamically load Contents Patch

内容补丁 Definition for Contents Patch

一个(h)json文件，可以修改游戏内所有物品的属性
A (h)json file. According to it modify all contents property.

客户端将会自动加载config/contents-patch/default.(h)json文件(如果存在)，
并且根据地图信息或服务器指令，加载补丁(如果不存在，会自动从服务器下载)
Client will auto load patch in config/contents-patch/default.(h)json (if exists)
And will load patch according to map info or server command.(May auto download patch for server)

示例 Exmaple

{
  //ContentType
  block: {
    //Content name
    "copper-wall-large": {
      //Property to modify
      //Value is format of origin json
      "health": 1200
    },
    "phase-wall": {
      "chanceDeflect": 0,
      "absorbLasers": true
    },
    "force-projector": {
      "shieldHealth": 2500
    },
    "lancer": {
      "shootType.damage": 30,
      "requirements": [
        "copper/10",
        "lead/100"
      ]
    },
  },
}

你也可以单行声明key:value形式(Since v2) Or you can define it in single line like

"block.copper-wall-large.health" : 1200

网络协议 Protocal

• map tag: ContentsPatch
  地图所需patch列表 List of patch names
  例(For example): flood;patchA;xxxx
• map tag: CT@{name}
  Patch内容. The Content of patch
• C->S ContentsLoader|version 发送版本信息，可用来判断是否安装Mod (示例版本号: 2.0.1 or beta-99) Send version, also for checking installation. (version example: 2.0.1 or beta-99)
• S->C ContentsLoader|loadPatch
  命令客户端加载一个补丁(传递参数: 仅name)
  command client to load a patch (param only name)
• C-> ContentsLoader|requestPatch
  客户端找不到时，向服务器请求patch(传递参数: 仅name)
  send when client not found this patch locally (param only name)
• S->C ContentsLoader|newPatch
  命令客户端加载一个新补丁，通常作为requestPatch的回复，或动态Patch如UIExt相关(传递参数: name & content) Command client to load a patch, normally as respond of requestPatch (params: name & content)
  • 约定,若名字$开头视为可变patch, 否则应该为不可变patch Conventionally, if name start with $, see it as mutable patch, don't cache it in client

通常来说，补丁名应该为其内容的hash，方便客户端进行缓存. Normally patch's name should be a hash of content, which can be cached currently.

安装 Setup

安装Release中的MOD即可(多人游戏兼容)
Install mod in Release(multiplayer compatible)