【MOD开发实例】Script Hook V For .NET（C#开发GTAV MOD）

陌．小皓

【前言】
目前国内研究、开发MOD的玩家并不多，但国内很多玩家其实是有编程基础的，楼主在编程方面也是个菜鸟，只是希望能有更多的人来研究、开发MOD。

【什么是 Script Hook V For .NET】
Script Hook V For .NET是国外玩家基于Script Hook V开发出来的一个asi脚本，该脚本可以使游戏支持读取使用.net语言（如：C#、VB）开发出来的脚本，Script Hook V For .NET是一个开源项目（开源是指源代码是公开的，任何人都可以下载到源代码，进行开发或修改），目前国外还有支持Lua的扩展，有兴趣的玩家可以自行上国外论坛获取。

【Script Hook V For .Net工作原理】
上面说过，其实Script Hook V For .NET就是一个.asi脚本脚本，游戏运行后Script Hook V会加载所有的asi脚本，加载了Script Hook V For .NET后，Script Hook V For .NET又会遍历游戏目录“scripts”文件夹下的所有后缀名为“.cs”、“.vb”、“.dl”脚本。（这里说个小知识，C#编译出来的DLL或EXE等并不像其他语言一样，编译出来的只是中间语言，类似JAVA，详情大家可以自行百度）

【原作者相关】
原贴地址：http://gtaforums.com/topic/78990 ... -script-hook-v-net/
github地址：https://github.com/crosire/scripthookvdotnet/releases

【准备工作】
1.首先请确保你安装了Microsoft .NET Framework 4.5和Microsoft Visual C++ Redistributable Package for Visual Studio 2013 (x64)；
2.下载Script Hook V，将压缩包内“bin”文件夹下的所有内容解压到你的游戏目录（该地址下载下来的Script Hook V附带了一个内置修改器，如果你不想要内置修改器，只需要把里面的“NativeTrainer.asi”删除即可）；
3.下载Script Hook V For .Net，将压缩包内的内容解压到你的游戏目录（该地址下载下来的Script Hook V For .NET附带了一个例子，如果你不要想，只需要把压缩包内“scripts”文件夹清空即可）。
这里我提供一个下载地址（点击下载），里面包含了最新的Script Hook V和Script Hook V For .Net下载好后把压缩包里所有内容解压到游戏目录下即可，完成这步就可以省略上面的2、3两步。

【其他说明】
1.C#是.net的主要语言，也是楼主比较熟悉的语言，所以下来的示例，会使用C#作为开发语言；
2.本文中所提到的MOD均为脚本类的，不是修改模型、资源等类型。

【开发示例】
首先准备好一个开发环境（IDE），这里楼主自己用的Visual Studio 2012，大家可以自行百度，2013、2012都可以，当然你也可以Notepad++之类的文本编辑软件，上面说过Script Hook V For .Net是可以直接加载后缀为.cs或.vb的脚本的。

接下来我们就开发一个按下某个快捷键，可以使主角周围车辆爆炸的脚本：

1.首先打开Visual Studio 2012，新建一个C#的类库项目，.NET Framework 版本改为4.5：




2.添加引用，引用ScriptHookVDotNet.dll




3.把不需要的引用可以删除掉；

4.下面是完整的代码，代码我都做了备注：
<

5.生成项目，生成好的项目会在你项目目录中


6.生成好后，把生成好的DLL复制到游戏目录下的“scripts”目录




7.进入游戏测试


测试成功，就说明OK了，在实际中如果测试失败，游戏目录下会有一个“ScriptHookVDotNet.log”文件，里面会有详细的日志。
【示例源码】
GTAV Script Example.zip (9.05 KB, 下载次数: 351)

2015-5-10 12:21 上传

点击文件名下载附件

【特别说明】
1.“GTA.Native.Function.Call”这个函数可以运行Native类的所有函数；
2.有部分Native类的函数Script Hook V For .NET的作者已经为我们封装好，可以直接调用，如果没有的就到Native类数据库查找就可以了。（Native类数据库：http://www.dev-c.com/nativedb/）

zsw117

ASI: Loading "H:\Grand Theft Auto V\ScriptHookVDotNet.asi"
     "ScriptHookVDotNet.asi" failed to load

为什么我的会加载失败呢。
运行库也安装了

陌．小皓

zsw117 发表于 2015-5-10 11:33
ASI: Loading "H:\Grand Theft Auto V\ScriptHookVDotNet.asi"
     "ScriptHookVDotNet.asi" failed to lo ...

你游戏什么版本

哥兜兜有棉花糖

像楼主这样的教程贴越来越少了。同为C#的前排赞一个。我用的VS2013，也去试试

陌．小皓

我还在编辑帖子，有点乱，各位看官稍等下。

陌．小皓

基本的已经编辑完了，因为比较忙，可能写的比较乱，以后我后慢慢抽时间更新。

陌．小皓

哥兜兜有棉花糖 发表于 2015-5-10 11:57
像楼主这样的教程贴越来越少了。同为C#的前排赞一个。我用的VS2013，也去试试 ...

嗯嗯，我也前两天去国外论坛无意看到的，正好C#语法比较熟，脚本类的MOD都是调用的Native类的函数，熟悉Native类的话，开发就会比较快了。

张子玲

才学几个月的路过。。。

S_Sky

很给力                       

风轻花迟落

大神们越来越给力了~~~

zsw117

陌．小皓 发表于 2015-5-10 11:54
你游戏什么版本

之前5号，现在是4号档。
反正都不行，游戏也重装过了

陌．小皓

jeason1997 发表于 2015-5-10 13:15
可惜不会C#，目前就直接用C++开发ASI，不过调试速度非常慢，经常要测试一个新例子就要重启游戏一次。
还是L ...

这个也支持重载，按insert键可以重载。

陌．小皓

zsw117 发表于 2015-5-10 13:59
之前5号，现在是4号档。
反正都不行，游戏也重装过了

Microsoft .NET Framework 4.5 这个装了吗？

zsw117

陌．小皓 发表于 2015-5-10 14:05
Microsoft .NET Framework 4.5 这个装了吗？

有一个4.6，必须要4.5的吗，我之前装的是4.5的，也不行，后来在论坛里找了运行库集合，重装后就是4.6了

陌．小皓

zsw117 发表于 2015-5-10 14:31
有一个4.6，必须要4.5的吗，我之前装的是4.5的，也不行，后来在论坛里找了运行库集合，重装后就是4.6了
...

这个具体我也不知道原因了，它的日志只会提示加载失败，详细原因也不会提示。

langxicc

给力给力

喷子死妈

技术贴~~~~~~~~~~~~

Zuma

感谢分享

lvyan2015

支持一下

Fly2012cl

小编辛苦了 这种结合实例 按步骤讲解的教程 让人更加好理解啊 希望楼楼在努力下 多做几个教程 比如普通asi的

lulugan

有群吗大家一起研究

lulugan

错误        1        命名空间“System.Windows”中不存在类型或命名空间名称“Forms”(是否缺少程序集引用?)        C:\Users\long\AppData\Local\Temporary Projects\ClassLibrary1\Class1.cs        8        22        ClassLibrary1
错误        2        未能找到类型或命名空间名称“KeyEventArgs”(是否缺少 using 指令或程序集引用?)        C:\Users\long\AppData\Local\Temporary Projects\ClassLibrary1\Class1.cs        36        35        ClassLibrary1


直接用的是楼主给的代码。为什么会这样呢

陌．小皓

lulugan 发表于 2015-5-10 22:41
错误        1        命名空间“System.Windows”中不存在类型或命名空间名称“Forms”(是否缺少程序集引用?)        C:\Users\l ...

引用里添加一下用到的命名空间

531675508

dddddddddddddddddddddddddddd

dinghao379

楼主 我太爱你了，我就需要这种教程贴，一步一步简单易懂，希望能有后续的内容继续学习啊。

dinghao379

楼主能不能教教用C#怎么开发一个 像asi那样在游戏中的菜单界面呀。

longve382

可惜不会目前就直接用开发不过调试速度非常慢经常要测试一个新例子就要重启游戏一次

wrocklong008

不懂英文，搞个毛。我还买了一本2015visual studio 高级编程的书。结果里面都没有什么关于游戏的语言。编程。