FootLib
FootLib 是 Foot 系列模组所使用的 API 和工具库。 它提供了共享系统,例如:
-
货币定义(开发中)
-
汇率系统(开发中)
-
这也是我所有模组的共享 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 填入实际版本号
希望将此模组作为依赖项的用户小贴士:
- 在设置 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)
- 除非你绝对确定多个 overhaul 版本能正常工作,否则只针对候选版本中最新的那个进行适配。
FootLib
FootLib is the API and utility library used by the Foot‑series mods. It provides shared systems such as:
-
Currency definitions (WIP)
-
Exchange‑rate systems (WIP)
-
This is also the shared API for ALL of my mods (WIP)
Versioning
FootLib uses a four‑segment versioning system:
Overhaul.Major.Semi‑major.Patch/Hotfix/Minor‑tag
Example: 0.0.1.0 → Semi‑major update (1 in the third position)
Meaning of each segment
-
Overhaul
Backward compatibility breaks. Overhaul does not mean big update, it means there is no backward compatibility from this point. -
Major New systems, new mechanics, or major expansions.
-
Semi‑major Significant content or system additions. Big‑minor updates that don’t break previous API.
-
Patch / Hotfix / Minor Small updates, bugfixes, micro‑features, or emergency fixes.
Pre‑release tags
-tag There are a lot of tags to choose from so let me show you the tags used for this project:
- release: A stable build which should be able to be depended on freely.
- beta: A release candidate/validation of -alpha code.
- alpha: A semi-stable experimental build. The tags shown below this are only available on GitHub due to their unstable nature:
- nightly: An unstable experimental build.
- dev: Development branch.
Important Note
An Overhaul (1.x.x.x, 2.x.x.x, etc.) ends support for all previous Foot mods.
This is why FootLib does not use SemVer — SemVer cannot express the difference between a major update and a update which breaks all dependencies overhaul. FootLib’s versioning makes the reason for incompatibility explicit. DON'T WORRY THIS MOD IS STILL GETTING UPDATES AND NEW FEATURES, I ALSO JUST HAPPEN TO HAVE MORE PROJECTS IN MIND SO GETTING THEM COMPLETED IS KEY
Usage Maven Repo
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"
#Put an actual version in min_version and max_version
Protips for those looking to have a dependency with this mod:
- When setting you neoforge.mods.toml then usually you want to set the versionRange to [0.0.0.1, 1.0.0.0) or [1.0.0.0, 2.0.0.0) and if you need a feature from non-overhaul versions then you can do something like this: [0.2.5.4, 1.0.0.0)
- Unless you are absolutely sure that several overhaul versions work, only target the newest out of your candidates.
下载 FootLib
下载 FootLib
下载 FootLib
下载 FootLib
下载 FootLib
下载 FootLib
下载 FootLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FootLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 FootLib
下载 FootLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
添加了新的 VoxelShapeRotationUtil。
稳定了所有代码并移除了数据生成(datagen)。
更新日志链接 刚刚添加了 SoundEvent 注册功能。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧