scripthookvpy3k icon indicating copy to clipboard operation
scripthookvpy3k copied to clipboard

An ASI plugin for Grand Theft Auto V which allows running scripts written in Python 3 in game.

Script Hook V Py3k

This is an ASI plugin for Grand Theft Auto V that allows you to execute Python 3 scripts in game by using the Script Hook V from Alexander Blade.

Features

  • All native functions accessible
  • Scripts run as lightweight asynchronous tasks
  • High level requirement functions can be chained and waited for
  • All the fancy Python packages out there can be used and...
  • Dependencies will be installed automatically

Download

Prebuilt binaries can be found on the releases page.

Installation

  1. Install the Script Hook V
  2. Install Python 3.5.0 for Windows x64
  3. Copy the contents of the downloaded archive into your GTA V game folder

Writing Scripts

To get started on writing scripts, head over to this wiki page.

Contributing

All contributions are warmly welcomed. Below are a few hints to the entry points of the code and a link to our to do list.

Entry Points

  • Py3kWrapperStart in wrapper.cpp is the entry point for the C++ part of the plugin
  • _init in the gta module is the entry point for the Python part of the plugin

Todo

See TODO.md.

Building

If you want to build the ASI plugin yourself, you'll need:

  1. Visual Studio 2013
  2. The Script Hook V SDK which has to be extracted into /sdk after downloading
  3. SWIG Version >= 3.0.5 which has to be extracted into /swig after downloading
  4. Python 3.5.0 for AMD64/EM64T/x64. Using the x86 version will not work!
  5. Open the project file and build the solution in Release configuration