YSM Mapping API

模组

· 作者 sakuraimikoto33

一个依赖项 API,用于本地分析已安装的 Yes Steve Model 模组,并为集成模组提供经过验证的运行时映射。

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

需要前置:Yes Steve Model

最新 0.1.8 · 1.21.1 · NeoForge

一键开服(送7天)

YSM Mapping API

开发状态: YSM Mapping API 正在积极开发中。在稳定版本发布之前,可能会发生破坏性变更。

YSM Mapping API 是一个库和依赖模组,供其他与 Yes Steve Model (YSM) 集成的模组使用。

由于 YSM 的内部类、方法和字段已被混淆,基于硬编码运行时名称的集成可能不够稳健。在 Minecraft 启动期间,YSM Mapping API 会分析已安装的 YSM JAR 的字节码结构,并将经过验证的匹配项作为类型化的语义符号暴露给依赖模组。

本模组不会添加物品、方块、模型、菜单或独立的游戏玩法功能。 当另一个模组将 YSM Mapping API 列为必需依赖项时安装它。Yes Steve Model 需要单独安装,不包含在此模组中。

支持版本

  • 仅限 Minecraft 1.20.1

    • Fabric Loader 0.16.0 或更高版本
    • Forge 47.4.10 或更高版本
    • Java 17
  • 仅限 Minecraft 1.21.1

    • Fabric Loader 0.16.0 或更高版本
    • NeoForge 21.1.235 或更高版本
    • Java 21
  • 两个版本都需要 Yes Steve Model 2.6.0 或更高版本。

文件针对其特定的 Minecraft 版本和模组加载器。仅使用与您的确切环境匹配的 JAR。如果更新的 YSM 构建的结构无法验证,可能会导致个别符号未解析;该 API 不会猜测未知的映射。

本地缓存和设置

以下文件会自动生成:

config/ysm_mapping_api/
├─ settings.json
└─ mappings.json

mappings.json 存储上次成功分析的映射。当 YSM 和请求的符号集合未发生变化时,它将重复使用,并且仅在新分析成功完成后才会替换。

面向模组开发者

消费者模组在以下位置声明其所需的符号:

META-INF/ysm-mapping-api/requests-v1.json

初始化后,模组可以使用 YsmMappingApi.resolve(...) 解析类型化的映射,使用来自 YsmSymbols 的精选语义键,或定义特定于消费者的键。

Mixin 集成可以使用提供的插件和运行时引用映射器包装器以及源别名。当前的精选注册表涵盖了诸如 YSM 网络、客户端/服务器模型同步、模型和纹理访问、音频缓存、玩家和动画状态、装备钩子、骨骼和渲染器等领域。

清单文档和集成示例可在 源代码仓库 中找到。问题可以通过 问题跟踪器 报告。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源