【Mod开发实例】利用Script Hook RDR2 用C++ 为荒野大镖客2 制作脚本Mod 实现“传送到坐标点”

◕小莫◕

前排小广告：
如果您对游戏Mod的制作感兴趣，并且愿意与广大玩家一起分享快乐，欢迎加入我们的3DM MOD组：https://mod.3dmgame.com/Team

距离上一篇的【Mod开发实例】利用 ScriptHook RDR2.NET 用C#为荒野大镖客2 制作脚本Mod 貌似已经过去一年了吧，确实鸽的挺久的了（虽然我压根也没说会有续篇）

这次我们来用C++为荒野大镖客2来编写脚本。

成品
源码地址：https://github.com/3DMXM/TestModForAsiAtRDR2
生成后的Mod： TestModForAsi.asi (91 KB, 下载次数: 69)

2020-12-7 15:41 上传

点击文件名下载附件

准备工作：
- 安装 Visual Studio：https://visualstudio.microsoft.com/zh-hans/  以下简称“VS”
- RDR2 NativeDB 库 ：https://mod.3dmgame.com/NativeDB
- 下载Script Hook RDR2 SDK：http://www.dev-c.com/rdr2/scripthookrdr2


注意：
在安装Visual Studio的时候，请确定安装了C++工具包，至少需要安装一下工具：
- 使用C++的桌面开发
- Windows 10 SDK （任意版本）
- MSVC （任意版本）
- C++ 通用平台工具（任意版本）


（如果漏装了，可以重新运行“Visual Studio Installer”进行安装）




创建项目：


虽然我很想这样从0开始创建项目，但是这样创建后的配置起来特别麻烦，不仅要手动修改生成类型、预设头、链入lib，还要修改入口函数等等一些特别复杂的东西，所以我决定直接在SDK中的Pools.sln项目的基础上进行修改。


将SDK中的文件Pools项目复制出来，然后重命名，接着将SDK中的“inc”和“ilb”也复制过来，



然后改一下“script.h”、“main.cpp”中的引用文件路径

除此之外，还需要设置 项目->属性 中的

1.常规中的“Windows SDK 版本”和“平台工具集”修改


2.“配置器”->“命令行”->“其他选项” 中 ScriptHookRDR2.lib  的路径


全部准备好后，按F6启动生成项目，如果提示生成成功，那么准备工作就算完成了


开始编写：
打开“script.cpp”文件，删除不必要的代码，只留下“ScriptMain()” “main()” 函数，“update()”函数中的所有内容全部删除，大概是这个样子：


现在，我们来开始实现按“F9”然后在主角传送到地图上的标记点，所以，我们需要先判断用户是否按下按键：
引入SDK中“NativeTrainer” 里面的“keyboard.cpp”和“keyboard.h”文件
修改“main.cpp”中的代码为
<


回到“script.cpp”文件中
先引入
<
回到“update()”函数，先来判断玩家是否按下F9
键盘键值表参考：
[imghide]https://mod.3dmgame.com/static/upload/mod/202012/MOD5fcdc857daa52.png[/imghide]

<

接下来我们需要判断地图上是否有标记点，
查阅NativeDB 库可找到RADAR::IS_WAYPOINT_ACTIVE() [路径点是否激活]，返回BOOL类型
直接写入if即可
<

接下来是获取标记点的坐标位置，
查阅NativeDB 库可找到RADAR::GET_WAYPOINT_COORDS_3D() [获取路径点的3D坐标]，返回Vector3
直接新建变量接入即可
<

然后是传送玩家了，
查询NativeDB 库可找到ENTITY::SET_ENTITY_COORDS(Entity entity, float xPos, float yPos, float zPos, BOOL xAxis, BOOL yAxis, BOOL zAxis, BOOL clearArea) [设置实体坐标]，无返回值

这样有点复杂，需要来慢慢的解释：

第一个参数，Entity entity是实体，也就是需要传送的实体，我们是传送玩家，所以需要获取玩家的实体，同时，也要判断，如果玩家在马上或者载具上，那么就连同马和载具一起传送，所以，获取实体的代码是：
<

第二~第四个参数，float xPos, float yPos, float zPos 是传送后的坐标，我们上面已经获取到标记点的3D坐标，所以直接用
<
就可以了

第五~第七个参数，BOOL xAxis, BOOL yAxis, BOOL zAxis 这3个参数意义暂时不明，不过AB大佬给的值是 “0,0,1“”，我们也一样用0,0,1就行了
第八个参数BOOL clearArea，传递一个BOOL值，是否清空区域，我们这里用FALSE即可。


接下来还有一步，为了避免在传送的时候出现在高空或地底，我们还需要获取标记点的地面Z轴
查阅NativeDB 库可以找到GAMEPLAY::GET_GROUND_Z_FOR_3D_COORD(float x, float y, float z, float* groundZ, BOOL unk) [获取3D坐标中Z轴的地面位置]
我们可以这样写：
<

至此，我们的功能就完成了，进游戏，添加一个标记点，然后按F9，即可直接传送到标记点，快捷键可修改IsKeyDown()中的值即可，

完整代码：
<

wellemon

受教了，C++ niubi

hqhq1972

支持小莫大神

ksda2684

好家伙，还是想看到从0开始创建项目

MAXICAN

没想到来3DM还可以学习编程

08ms

6666666666666

丿艺丨

你好，我想请问下用c++写的asi和c#写的dll有啥区别，比如多了些api啥的
还是说只是语言不同，库都是一样的

AKKxxx

请问成品下载可以直接丢根目录用吗，有无效果

zaishuoba1

66666666666666666

丿艺丨

大哥，最新的nativeDB网站打不开

◕小莫◕

丿艺丨 发表于 2022-4-13 12:58
你好，我想请问下用c++写的asi和c#写的dll有啥区别，比如多了些api啥的
还是说只是语言不同，库都是一样的 ...

只是语言不同，库都是一样的，
但我个人觉得，C++的拓展性和效率都要比C#要高

再笑我打你

谢谢分享thankyou