Compat API

模组

· 作者 FixerLink

通用兼容 API,可自动加载依赖此模组的模组集成、数据包和战利品修改。

5 本站下载 0 关注 更新于 7 个月前

最新 1.0.3 · 1.21.1 · Fabric

一键开服(送7天)

? 关于

Compat API 是一个轻量且通用的兼容性框架,适用于 fixerlink 打造的整个 “Compat” 生态系统——包括 Compat Delight、即将推出的 Compat Artifacts、Compat Decor,以及任何希望以简单、自动的方式添加跨模组集成的第三方模组。

无需硬编码兼容逻辑或手动管理数据包,Compat API 为你处理一切: 自动加载兼容代码、注入数据包、包装战利品修饰符(loot modifiers)、应用条件,并仅在所需模组已安装时启用集成。


? 功能

  • 智能 Compat 扫描器:仅从明确依赖 Compat API 的模组中加载集成。
  • 自动兼容代码加载: 检测 net.<owner>.<moid>.compats.<target> 中的兼容模块,并自动运行其 register、init 或 bootstrap 钩子。
  • 自动数据包注入: 将 data/<owner>/<modid>/compats/<target> 中的内容作为内置数据包加载——仅当目标模组存在时生效。
  • 通用战利品修饰符系统: 自动添加兼容条件并生成全局战利品修饰符列表。
  • 兼容性条件: 内置条件 compatapi:compat_enabled 确保集成安全加载,且仅在适当情况下启用。
  • 按目标配置开关: 每个兼容模块均可通过配置文件单独启用或禁用。
  • 安全且整洁的系统: 兼容错误不会导致游戏崩溃——它们会被记录并优雅地跳过。

? 描述

工作原理:

你只需安装 Compat API。 就这样。

如果某个模组依赖 Compat API 并包含兼容模块,该 API 将会:

  • 检测其兼容代码
  • 注入其兼容数据包
  • 包装其战利品修饰符
  • 应用条件
  • 并自动启用集成

如果目标模组缺失——兼容内容 simply 不会加载。无错误、无崩溃、无需手动设置。模组可以自由添加兼容文件夹和类——所有繁重工作都由 Compat API 完成。当然,每项集成都可通过配置文件进行切换。


? 附加信息

  • 不依赖 Compat API 的模组将被完全忽略
  • 所有集成仅在对应目标模组存在时加载
  • 兼容代码中的错误绝不会破坏游戏
  • 全自动系统:代码、数据包、条件、战利品修饰符
  • 支持数以千计的集成,仅需极少的样板代码

? 鸣谢

Compat API 由 fixerlink 开发,旨在为所有 Compat 系列模组 以及希望实现干净、模块化且自动化的跨模组集成的开发者提供一个通用标准。


欢迎提供反馈!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源