Skip to content

scripthookvdotnet/scripthookvdotnet

Repository files navigation

Community Script Hook V .NET (SHVDN)

NuGet Build Status License

This is an ASI plugin for Grand Theft Auto V, based on the C++ ScriptHook by Alexander Blade, which allows running scripts written in any .NET language in-game.

The issues page should be primarily used for bug reports and focused enhancement ideas. Questions related to GTA V scripting, in general, are better off in Discussions page or forums dedicated to this purpose, like gta5-mods.com.

Requirements

Downloads

The stable builds can be downloaded from the Releases page. You need to use the ASI file and the DLL files for APIs in an archive of the same version as the internal structure can be changed without notice.

For newer builds, check out the Nightly Builds. You don't have to sign in to GitHub to download nightly releases.

For script developers, please note that new APIs included in new nightly builds but not included in any stable versions are subject to change without notice, so it is not advisable to use any of them for public/production builds of your scripts.

Installation

  • Extract all the files in the root folder from the zip file into your game folder except for README.txt and the 2 folders.
    • The XML files in the Docs folder are provided solely as API documentation for script developers.

Contributing

You'll need Visual Studio 2019 or higher to open the project file and the Script Hook V SDK extracted into /sdk.

Any contributions to the project are welcomed, it's recommended to use GitHub pull requests.

License

ScriptHookVDotNet is primarily distributed under the terms of the zlib license. See LICENSE and COPYRIGHT for details.