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 版本和模组加载器。仅使用与您的确切环境匹配的 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 网络、客户端/服务器模型同步、模型和纹理访问、音频缓存、玩家和动画状态、装备钩子、骨骼和渲染器等领域。
清单文档和集成示例可在 源代码仓库 中找到。问题可以通过 问题跟踪器 报告。
YSM Mapping API
Development status: YSM Mapping API is under active development. Breaking changes may occur before a stable release.
YSM Mapping API is a library and dependency mod for other mods that integrate with Yes Steve Model (YSM).
Because YSM's internal classes, methods, and fields are obfuscated, integrations based on hard-coded runtime names can be fragile. During Minecraft startup, YSM Mapping API analyzes the bytecode structure of the installed YSM JAR and exposes verified matches to dependent mods as typed semantic symbols.
This mod does not add items, blocks, models, menus, or standalone gameplay features. Install it when another mod lists YSM Mapping API as a required dependency. Yes Steve Model is required separately and is not bundled.
Supported Versions
Files are specific to their Minecraft version and mod loader. Use only the JAR matching your exact environment. A newer YSM build may leave individual symbols unresolved if its structure cannot be verified; the API does not guess unknown mappings.
Local Cache and Settings
The following files are generated automatically:
config/ysm_mapping_api/
├─ settings.json
└─ mappings.json
mappings.json stores the last successfully analyzed mappings. It is reused when YSM and the set of requested symbols have not changed, and is replaced only after a new analysis completes successfully.
For Mod Developers
Consumer mods declare their required symbols in:
META-INF/ysm-mapping-api/requests-v1.json
After initialization, mods can resolve typed mappings with YsmMappingApi.resolve(...), use curated semantic keys from YsmSymbols, or define consumer-specific keys.
Mixin integrations can use the supplied plugin and runtime reference-mapper wrapper with source aliases. The current curated registry covers areas such as YSM networking, client/server model synchronization, model and texture access, audio caches, player and animation state, equipment hooks, bones, and renderers.
Manifest documentation and integration examples are available in the source repository. Problems can be reported through the issue tracker.
评论 0
登录后参与评分
还没有评论,来抢沙发吧