SparkyAPI

适用于所有 SparkyNox 即将推出和已构建模组的库模组

基础库

SparkyAPI

一个轻量级的客户端库,专为 SparkNox 模组打造。SparkyAPI 本身不会添加任何功能——它提供一个共享的基础框架(包括配置处理、事件钩子、HUD 渲染、按键绑定管理以及实用工具函数),供 ZoroCrystal 等其他 SparkNox 模组在此基础上构建。

如果你曾使用过 Fabric API、Cloth Config 或 PlaceholderAPI,应该很容易理解——只需安装一次,所有依赖它的模组就能正常运行。

内部功能:

  • 配置系统——将 JSON 配置文件保存并加载到 .minecraft/config/sparky/,若文件不存在则使用合理的默认值。
  • 事件总线——共享的刻事件(PLAYER_TICK、CLIENT_TICK),让依赖模组无需各自注册监听器。
  • HUD 辅助器——无需样板代码即可注册持久的屏幕文字行、绘制方块、带轮廓的面板以及带阴影的文字。
  • 按键绑定管理器——通过单一调用注册按键绑定,并自动处理按键逻辑。
  • 实用工具集——常用辅助函数,如查找快捷栏/物品栏中的物品、检查延迟、计算距离等。

SparkyAPI 专为 Fabric 1.21.4 构建,仅客户端使用,本身不影响游戏玩法。它的存在纯粹是为了让依赖模组更轻量、更一致、更易于维护。

如果某个模组提示需要 SparkyAPI,那么就是这个模组了。🔧