ScriptHookV .NET Core V1.1

Mart 10, 2023 - 19:50

0 91

Created with the goal to upgrade ScriptHookV .NET to latest .NET Core runtime, while maintaing compatability with previous versions.

Requirements:
An asi loader and Alexander Blade’s ScriptHookV

Installation:
Extract ScriptHookVDotNetCore.asi to your game root. That’s all.

For developers:
Create a .NET 7 class library project.
Install the nuget package and start writing scripts like you would in SHVDN.
Copy the compiled dll in the native folder inside the output directory (important! File size should be larger than 4 mb) to GTAROOT\CoreScripts folder.
Press End to unload all scripts, Home to reload.

Note
This project is a seperate asi plugin that only depends on ScriptHookV. It provides a new way to write scripts in latest .NET version, it does not replace SHVDN, the latter is still needed to run the scripts that’re built against it. Existing scripts will continue to work as long as you have SHVDN installed.

Experimental, might have bugs/crash

Changelog:

v1.1.0
– Fixed issue in source generator that causes duplicated script loading under some circumstances (#2)
– Added in-game console, press F6 to open by default, configurable through the ini file. The console is not as powerful as that of SHVDN, only commands registered by scripts can be executed as it’s impossible to dynamically compile and execute code in NativeAOT. To expose a function as command, mark it with GTA.ConsoleCommand attribute, most primitives and class that implements IConvertible can be converted and passed as parameters.
– Fixed an error that causes random crash probaly due to the use of fiber switching and GC by reintrducing dedicated script thread, performance degration is expected. To get better performance, mark the script class with [ScriptAttribute(NoScriptThread = true)] like those in the base script, but beware that Script.Yield() and Script.Wait() will throw an exception running in such mode.
– Save time for memory scanning each time a module is loaded by reusing NativeMemoryStruct
– Added NativeInvoker class, which allows easy and intuitive native function calling with strong-typed parameters and comments

Credits:

Sardelka
Alexander Blade for his ScriptHookV
crosire and all contributors of ScriptHookV .NET.
Basically all scripting API are from ScriptHookV .NET, with some modifications to adapt to new runtime.

Önceki Mod