【Mod开发实例】利用 ScriptHook RDR2.NET 用C#为荒野大镖客2 制作脚本Mod 实现“超级跳”和“修改时间”

19年写的一篇文章，突然发现还没在博客上发，来补一下；

源码：https://github.com/3DMXM/TestModForNetAtRDR2

准备工作：

- 首先下载Community ScriptHook RDR2 .NET：Mod站 | GitHub
- Script Hook RDR2 SDK：http://www.dev-c.com/rdr2/scripthookrdr2
- 然后下载Visual Studio：https://visualstudio.microsoft.com/zh-hans/
- .NET Framework 4.8或其以上版本：https://dotnet.microsoft.com/download/thank-you/net48-developer-pack
- 准备资料 RDR2 NativeDB：https://mod.3dmgame.com/NativeDB

新建项目：

打开Visual Studio，新建项目，选择Visual C# ->类库（NET Framework），框架选择.NET Framework 4.8，名称自定义

右键“引用”，选择“添加引用”，将ScriptHook RDR2 .NET里面的“ScriptHookRDRNetAPI.dll”这个文件引用进来

文件引用完成完毕之后，添加几个引用：

using System.Windows.Forms;
using RDR2;
using RDR2.UI;
using RDR2.Native;
using RDR2.Math;

添加进去之后，我们会发现一个报错

是因为我们创建项目的时候没有引用System.Windows.Forms这个东西，我们手动引用一下：

现在错误就消失了，接下来我们将自带的“Class1”改成“Main : Script”，这样我们就可以直接使用“ScriptHookRDRNetAPI”的函数了，接下来我们在里面开始写代码：

 public class Main : Script
    {
        public Main()   //入口函数
        {
            //KeyDown是ScriptHookRDRNetAPI中自带的函数，用于监听按键的按下事件
            //这句的意思是如果有按键按下则执行函数“OnKeyDown”
            KeyDown += OnKeyDown;

            //Tick是ScriptHookRDRNetAPI中自带的函数，用于勾住游戏
            //这句的意思是将函数“OnTick”注入到游戏中，并且每过“Interval”毫秒进行检测一次
            Tick += OnTick;

            //Interval是检测间隔，单位毫秒
            Interval = 1;
        }
        bool ModOn = false; //给Mod设置一个开关
        private void OnTick(object sender, EventArgs e)
        {
            Player player = Game.Player;    //获取玩家
            if (ModOn)  //如果
            {
                //Function.Call是ScriptHookRDRNetAPI中的函数，用于执行动作
                //Hash.SET_SUPER_JUMP_THIS_FRAME中的“SET_SUPER_JUMP_THIS_FRAME”是 Script Hook RDR2 SDK 中的内容
                //具体赋值内容可以参考 Script Hook RDR2 SDK 的“natives.h”文件
                // SET_SUPER_JUMP_THIS_FRAME(Player player) 是Script Hook RDR2 SDK中超级跳的功能，true是启动
                Function.Call(Hash.SET_SUPER_JUMP_THIS_FRAME, player, true);
            }
        }
        private void OnKeyDown(object sender, KeyEventArgs e)
        {
            if (e.KeyCode == Keys.C)    //判断按下的键是否是“C”键，定义启动按键
            {
                ModOn = !ModOn; //给Mod开关赋值一个反值，如果开就关，如果关就开
            }
           
        }

    }

这样，我们的“超级跳”的功能就实现了，接下来我们再来写一个“修改时间”的功能，先在Script Hook RDR2 SDK 的“natives.h”文件中找到修改时间的代码：

static void ADD_TO_CLOCK_TIME(int hours, int minutes, int seconds) { invoke(0xAB7C251C7701D336, hours, minutes, seconds); }

简单说一下：
- “SET_CLOCK_TIME”是设置时间
- “ADD_TO_CLOCK_TIME”是添加时间，传递的全是整数，可正可负

使用ScriptHook RDR2 .NET要修改时间就是

Function.Call(Hash.ADD_TO_CLOCK_TIME, 1, 0, 0, true);        //加一小时
Function.Call(Hash.ADD_TO_CLOCK_TIME, -1, 0, 0, true);        //减一小时

逻辑研究明白之后，我们来想想要怎么操作， 我们就使用键盘的 ↑和↓键来修改时间吧，

我们两个按键，操作的内容是一样的，只有一个值不一样，我们可以将它们写到一个方法里面：

private void changeTime(int time)
        {
            Function.Call(Hash.ADD_TO_CLOCK_TIME, time, 0, 0, true);
        }

然后在按键监控的方法OnKeyDown来进行判断是否按下 ↑和↓键：

if (e.KeyCode == Keys.Up)
            {
                changeTime(1);
            }
            if (e.KeyCode == Keys.Down)
            {
                changeTime(-1);
            }

现在，我们修改时间的功能也已经实现了，将项目生成，

然后，将\bin\Debug\TestModForNet.dll放到游戏目录中的“scripts”文件夹中，没有自己新建一个
别忘了安装原版的ScriptHook RDR2 .NET和Script Hook RDR2

进游戏按C、↑、↓ 键就可以实现我们要的功能了