FootLib

模组

· 作者 Footdablit2310

这是我所有模组共用的类与 API

0 本站下载 0 关注 更新于 2 周前

最新 1.5.2.8 · 1.21.1 · NeoForge

一键开服(送7天)

FootLib

FootLib 是 Foot 系列模组所使用的 API 和工具库。 它提供了共享系统,例如:

  1. 货币定义(开发中)

  2. 汇率系统(开发中)

  3. 这也是我所有模组的共享 API(开发中)

版本控制

FootLib 使用四段式版本控制系统:

Overhaul.Major.Semi‑major.Patch/Hotfix/Minor‑tag

示例: 0.0.1.0 → 次大更新(第三位为 1)

各段含义

  • Overhaul
    破坏向后兼容性。 Overhaul 并不意味着大幅更新,而是意味着从此版本开始不再具备向后兼容性。

  • Major 新系统、新机制或重大扩展。

  • Semi‑major 显著的内容或系统添加。 不会破坏之前 API 的“大”小更新。

  • Patch / Hotfix / Minor 小型更新、错误修复、微功能或紧急修复。

预发布标签

-tag 可选的标签有很多,以下列出本项目使用的标签:

  • release: 稳定构建版,可以自由依赖。
  • beta: -alpha 代码的发布候选版/验证版。
  • alpha: 半稳定的实验性构建版。 以下显示的标签仅因不稳定性而仅在 GitHub 上提供:
  • nightly: 不稳定的实验性构建版。
  • dev: 开发分支。

重要提示

一个 Overhaul(1.x.x.x、2.x.x.x 等)将终止对所有先前 Foot 模组的支持。

这就是 FootLib 不使用 SemVer 的原因——SemVer 无法区分“普通大更新”与“破坏所有依赖性的 overhaul”。 FootLib 的版本控制明确了不兼容的原因。 不用担心,该模组仍在获取更新和新功能,我也恰好有更多项目构思,因此完成它们是关键

用法 Maven 仓库

repositories {
    maven { url = "https://api.modrinth.com/maven" }
}

Gradle (Groovy)

dependencies {
    implementation("maven.modrinth:footlib:${footlib_version}")
}

neoforge.mods.toml

[[dependencies.${mod_id}]]
    modId="footlib"
    type="required"
    versionRange="[min_version, max_version)"
    ordering="NONE"
    side="BOTH"
#在 min_version 和 max_version 填入实际版本号

希望将此模组作为依赖项的用户小贴士:

  1. 在设置 neoforge.mods.toml 时,通常应将 versionRange 设置为 [0.0.0.1, 1.0.0.0) 或 [1.0.0.0, 2.0.0.0),如果你需要非 overhaul 版本的某个功能,可以这样做:[0.2.5.4, 1.0.0.0)
  2. 除非你绝对确定多个 overhaul 版本能正常工作,否则只针对候选版本中最新的那个进行适配。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源