• 论坛

导航

  • 主页
  • 样式指南
  • 入门
    • 概述
    • Mod的结构
    • Forge更新检查器
      • 入门
      • 更新JSON的格式
    • 依赖管理
    • 调试分析器
  • 概念
    • Sides
    • 资源
    • 注册表
    • Jar签名
    • 国际化和本地化
  • 方块
    • 概述
    • 介绍方块状态
    • 方块互动
  • 动画 API
    • 概述
    • 骨骼
    • 动画状态机
    • 使用API
  • TileEntity
    • 概述
    • 特殊渲染器
  • 物品
    • 主页
    • 战利品表
  • 模型
    • 模型概述
    • 模型文件
    • 方块状态
      • 方块状态JSON概述
      • Forge方块状态JSON
    • 绑定模型到方块和物品
    • 彩色纹理
    • 物品属性概述
    • 高级模型(未翻译)
      • 高级模型介绍
      • IModel
      • IModelState and IModelPart
      • IBakedModel
      • Extended Blockstates
      • Perspective
      • ItemOverrideList
      • ICustomModelLoader
  • 渲染
    • TileEntityItemStackRenderer
  • 事件
    • 基本用法
  • 网络
    • 主页
    • 概述
    • SimpleImpl
    • 实体
  • 数据储存
    • 能力系统
    • World Saved Data
    • 拓展实体属性
    • Config注解
  • 工具
    • 合成
    • 矿物词典
    • 权限API
  • 效果
    • 音效
  • 惯例
    • 版本命名
    • 文件位置
    • 加载阶段
  • 参与Forge开发
    • 入门
    • PR指南

Forge更新检查器

Forge提供了一个可选的轻量级更新检查框架。它所做的只有检查mod的更新,如果任何mod有可用的更新,在主菜单的Mods按钮上和mod列表中将会显示一个闪光的图标,并会显示对应的更新日志。它并不会自动下载更新。

入门

你需要做的第一件事情是在 @Mod 注解中设定 updateJSON 的参数。它的值为一个有效的URL地址指向一个更新JSON文件。这个文件可以放在你的网页服务器中、GitHub上或是任何地方,只要保证mod的所有玩家都能访问这个文件即可。

更新JSON的格式

JSON本身的格式很简单,如下所示:

{
  "homepage": "<你的Mod主页/下载地址>",
  "<MC版本>": {
    "<Mod版本>": "<这个版本的更新日志>", 
    // 列出对应Minecraft版本的所有Mod版本,以及它们对应的更新日志
    ...
  },
  ...
  "promos": {
    "<MC版本>-latest": "<Mod版本>",
    // 这是填对应Minecraft版本的Mod的最新版本
    "<MC版本>-recommended": "<Mod版本>",
    // 这里填对应Minecraft版本的Mod的最新稳定版本
    ...
  }
}

这个JSON文件已经很清楚了,但要注意以下几点:

  • homepage 下的链接将会在mod有更新的时候显示给用户。
  • Forge使用了一个内部的算法来决定一个版本String是否比另一个更“新”。这个算法应该兼容大部分版本命名方式,如果你不确定你的命名方式是否被支持,请参见 ComparableVersion 类。我们强烈建议您使用语义化版本。
  • 更新日志String可以使用 \n 分行。一些人可能会选择仅包含一个简略的更新日志,并提供一个链接到完整的更新日志。
  • 手动输入这些东西可能会很麻烦。你可以设置一下 build.gradle,在构建的时候自动更新这个文件,Groovy有原生的JSON解析支持。这个就留给读者当做练习了。

你可以参考Charset和Botania Unofficial的例子构建你自己的JSON。

基于 MkDocs 使用自定义主题构建. 托管于 Read the Docs.
启用夜间模式