TurtleLib 是 kroet.net 为 Fabric 和 NeoForge 提供的一款小型 Minecraft 模组辅助库。它本身不添加任何游戏内容、物品或设置;PermaClicker 和 TradeShuffler 等模组使用它来实现共享的技术部分,例如版本更新检查。
玩家快速入门 ?
- 下载适用于你的加载器(Fabric 或 NeoForge)和 Minecraft 版本的 TurtleLib 文件。
- 将其放入
mods文件夹中,与需要它的模组放在一起。 - 启动游戏。
如果缺少 TurtleLib 或版本过旧,游戏在启动时会显示所需的版本号。Modrinth App 和 CurseForge 等启动器会自动作为依赖项安装它。
共同更新 ⚠️
TurtleLib 2.0.0 与基于 TurtleLib 1.x 构建的模组不兼容,这些模组无法在其下运行。请连同需要它的模组一起更新 TurtleLib(例如 PermaClicker 2.0.0)。
TurtleLib 提供的功能 ✨
- 更新检查 (
UpdateChecker):在 Modrinth 和 CurseForge 上查找模组的最新版本,可根据发布渠道(稳定版 / 测试版 / Alpha 版)、加载器和 Minecraft 版本进行筛选 - 版本比较 (
VersionComparator):可靠地比较版本号,如2.0.0、2.1.0-beta.2或1.4.0+26.3 - 基于同一共享代码库,在 Fabric 和 NeoForge 上行为一致
更新检查与隐私 ?
TurtleLib 本身不会连接任何外部服务。只有当某个模组使用其更新检查功能时,该模组才会查询 api.modrinth.com(Modrinth,官方 API)和 api.cfwidget.com(CFWidget,一个镜像 CurseForge 数据的非官方第三方服务)。每个模组都在其自己的页面上记录了发送的数据以及如何关闭检查功能。
安装了 Mod Menu(Fabric)的情况下,Mod Menu 也可能在 Modrinth 上检查 TurtleLib 本身的更新;该检查在 Mod Menu 自身的设置中进行配置。
源代码 ?️
源代码、构建说明以及开发者文档(包括用于编译你自己的模组的 TurtleLib 核心 jar 包)可在 GitHub 获取。
TurtleLib is a small helper library for Minecraft mods by kroet.net on Fabric and NeoForge. It adds no gameplay, items or settings of its own; mods such as PermaClicker and TradeShuffler use it for shared technical parts like their update check.
Quick start for players ?
- Download the TurtleLib file for your loader (Fabric or NeoForge) and Minecraft version.
- Put it into the
modsfolder, next to the mods that require it. - Start the game.
If TurtleLib is missing or too old, the game names the required version when it starts. Launchers such as the Modrinth App and CurseForge install it automatically as a dependency.
Update together ⚠️
TurtleLib 2.0.0 is not compatible with mods built for TurtleLib 1.x, and those mods do not run with it. Update TurtleLib together with the mods that require it (e.g. PermaClicker 2.0.0).
What TurtleLib provides ✨
- Update check (
UpdateChecker): finds the newest version of a mod on Modrinth and CurseForge, filtered by release channel (Stable / Beta / Alpha), loader and Minecraft version - Version comparison (
VersionComparator): compares version numbers such as2.0.0,2.1.0-beta.2or1.4.0+26.3reliably - the same behavior on Fabric and NeoForge, from one shared code base
Update check & privacy ?
TurtleLib does not connect to anything on its own. Only when a mod uses its update check does that mod query api.modrinth.com (Modrinth, official API) and api.cfwidget.com (CFWidget, an unofficial third-party service that mirrors CurseForge data). Each mod documents on its own page what it sends and how to turn the check off.
With Mod Menu installed (Fabric), Mod Menu may also check TurtleLib itself for updates on Modrinth; that check is configured in Mod Menu's own settings.
Source code ?️
Source code, build instructions and the developer documentation (including the core jar for compiling your own mod against TurtleLib) are available on GitHub.
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
下载 TurtleLib
TurtleLib 2.0.0 是一次破坏性更新版本,面向模组开发者:新的包名、MIT 许可证、重写的更新检查器,以及不再提供翻译辅助工具。玩家只需将 TurtleLib 与依赖它的模组一同更新即可。
兼容性
- 新包名: 所有类已从
com.github.hrobasti.turtlelib移至net.kroet.turtlelib;基于 TurtleLib 1.x 构建的模组必须更新,无法在 2.0.0 上运行。 - 一同更新: 仅在与需要它的模组(例如 PermaClicker 2.0.0)一起安装时安装 TurtleLib 2.0.0。
- 移除辅助工具:
LangLoader和MessageService已移除;模组现在使用 Minecraft 自带的语言文件进行翻译。 - UpdateChecker API: 构造函数包含渠道、Minecraft 版本和加载器;结果列表会按平台列出最新版本及其链接,并附带错误原因。
新功能
- 核心 JAR: 每个版本现在都包含
TurtleLib_x.y.z_core.jar,用于编译针对 TurtleLib 的模组;它不应放入mods/文件夹。
修复
- 版本比较: 前导
v、构建元数据(如+26.3)和预发布编号(如beta.2)现在可以正确比较。 - 更新检查: 当某个平台不可达时不再失败,能正确读取 CurseForge 的结果,并且仅统计给定加载器和 Minecraft 版本的发布版本。
- NeoForge 警告: NeoForge 日志中不再出现“deprecated logoFile”警告。
其他
- Mod Menu: Mod Menu 现在也可以检查 TurtleLib 的更新。
- 模组详情: 更新了 Mod Menu 和 NeoForge 模组列表中的描述、图标和链接。
- MIT 许可证: TurtleLib 现已采用 MIT 许可证(此前为 Apache-2.0)。
- 从源码构建: 仓库现在可以独立构建,无需开发工作区。
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧