模组简介

这款REFramework Direct2D是专门面向《怪物猎人:荒野》模组开发者打造的底层功能扩展插件,它基于原版REFramework框架开发,新增了一套完整的Direct2D脚本API接口,能够为各类overlay类叠加层模组提供更稳定的渲染底层支持。普通玩家本身无法直接通过该插件获得游玩内容的修改,但只要你后续安装的各类界面增强、实时信息显示类第三方模组依赖这个API组件,就必须提前部署本插件才能让对应模组正常运行。相比原本REFramework自带的原生绘制方案,它针对文本、图形渲染做了大量针对性优化,尤其适合需要在游戏画面上层展示自定义内容的功能模组调用,大幅降低模组作者开发相关功能的门槛。

功能要点

  • 内置完整的Direct2D脚本API,为模组开发者提供标准化的图形绘制调用接口,无需自行适配底层渲染逻辑
  • 原生支持Unicode字体渲染,无需额外挂载字体文件即可正常显示各类非系统默认编码的文字内容,避免自定义界面出现乱码问题
  • 支持自定义更新刷新率,可根据模组需求调整叠加层内容的刷新频率,无需强制以游戏满帧速率运行,大幅降低多余绘制带来的性能开销
  • 提供独立的图片资源加载与绘制能力,模组作者可直接调用接口导入自定义纹理素材,在游戏画面指定位置完成渲染展示
  • 优化了错误捕获机制,在调用绘制接口的模组脚本内部出现运行错误时,不会直接引发游戏进程卡死,仅会输出对应错误提示方便开发者排查问题
  • 调整Lua回调执行时机到游戏原生BeginRendering阶段,避免叠加层画面被游戏原生渲染层遮挡,保证自定义界面的显示层级符合预期

前置依赖

运行本插件必须提前安装1.5.4版本及以上的REFramework工具,低于该版本的REFramework无法兼容本模组的新增调用逻辑,会导致插件加载失败或触发游戏异常。原文未给出的其余关联适配说明以压缩包内附带的文档为准。

安装方法

首先获取压缩包REFramework-D2D.zip,将压缩包完整解压后,找到内部自带的reframework/文件夹,将该文件夹整体复制到《怪物猎人:荒野》的游戏根目录下。复制完成后需要手动核对两个核心文件的路径是否正确:首先确认reframework-d2d.dll文件处于游戏目录下的/reframework/plugins/子文件夹中,其次确认reframework-d2d.lua文件处于游戏目录下的/reframework/autorun/子文件夹中。若两个文件的放置路径出现偏差,插件将无法被REFramework正常识别加载。

兼容性与注意事项

本插件作为底层API扩展组件,本身不会修改任何游戏的原生玩法、数值或资源,安装后不会对游戏原版内容产生任何显性改变,本身不具备任何单独的游玩功能。它仅作为依赖资源供其他模组调用,普通玩家如果没有安装需要该组件支持的overlay类模组,单独安装本插件不会获得任何额外效果。安装时注意不要覆盖你之前已经存放在对应reframework文件夹内的其他插件文件,避免原本运行正常的REFramework第三方插件被误替换引发异常。插件本身不会修改游戏的存档数据,不会触发游戏的反作弊相关校验,只要你使用的REFramework本体版本符合要求,即可在游戏的所有游玩模式下正常运行。

常见问题

  • 单独安装本插件之后游戏内没有任何新内容出现是正常情况吗?完全正常,本插件本身是供其他模组调用的底层API资源,只有安装了依赖它的上层功能模组后,才能看到对应的自定义界面效果。
  • 如果放置文件后插件无法加载要怎么排查?首先检查你当前使用的REFramework版本是否达到1.5.4的最低要求,再核对两个核心dll、lua文件是否放置到了指定的对应子目录下,路径错误是最常见的加载失败原因。
  • 本插件会增加游戏的运行占用吗?它本身的资源消耗极低,而且支持自定义刷新频率,即使长期后台运行也不会对游戏的帧数表现产生可感知的负面影响,反而使用它的上层模组能通过刷新率限制获得比旧方案更低的性能开销。
  • 升级本插件新版本时需要删除旧版本文件吗?直接将新版压缩包内的reframework/文件夹覆盖到游戏目录替换对应旧版dll和lua文件即可,不需要额外修改其他配置内容。