ScriptHookVDotNetEnhanced Progress

[Chiheb-Bacha]

I'll be sharing progress updates about SHVDNE here. Feel free to ask me questions or make suggestions.

[Norn-0]

Hey, thanks for taking the time to do this. You should try posting about this on a GTA V mods discord server, so you can get suggestions from people with experience in this kind of thing so your work is smooth.

[Chiheb-Bacha]

That's a great idea, I'll do that. Although the biggest constraint is time, as the amount of changes and additions is massive, mainly NativeMemory.cs, but some other classes might be affected. In the version I use for testing, i pretty much deleted everything from NativeMemory.cs, added a couple of functions to convert GUIDs to Ptrs and Ptrs to GUIDs, and went through every single class to remove any dependency on NativeMemory.cs and ended up with a very minimal API, and mainly used Function.Call in my scripts. I'll be prioritizing some functionality over the other now in order to have an MVP that i can share soon, afterwards I'll work on providing the full API, as well as adding even more stuff. At that stage, everyone else can contribute by completing the TODOs I'll leave in the code, that's why I'm not trying to rush the release, since I want to make it well organized so that future additions can be done easily.

[Chiheb-Bacha]

Small update: I have underestimated the scope of this Port when I thought I'd be done in a couple of days 😅, but I'm surely making progress. Currently, the biggest challenge (in addition to the amount of changes) is having to reimplement functions that are inlined in Enhanced but not in Legacy. In Legacy, these only required a pattern scan to get the address of the function, and a delegate in order to be able to call this function, but in Enhanced, they are not a standalone function anymore, but rather inlined inside other functions, and so they have to be reimplemented. For those interested, you can look at s_getPtfxAddressFunc as an example.
In Enhanced, i have to find its internals:

address = MemScanner.FindPatternBmh("89 f1 0f 28 ce e8 ? ? ? ? 0f 28 b4");
if (address != null)
{
    address = (byte*)(*(int*)(address + 6) + address + 10);
    s_PtfxHashTableCount = *(uint*)(*(int*)(address + 50) + address + 54);
    s_PtfxHashTableBuckets = *(ulong*)(*(int*)(address + 72) + address + 76);
}

and then use them to reimplement it, but I'm currently not 100% sure about some details like a vfunc call at 0x28 of the vtable of the passed entity that verifies if its a valid entity as i haven't done it before, but I'll get it to work :).

I'll let you know once everything is ready, but expect it to take a bit longer than we initially hoped for.

[RusLanParty]

You're doing God's work. Wish I was competent enough to help with the memory stuff. If I'll see anything that I can help with, I definetely will.

[Chiheb-Bacha]

Update: I have successfully reimplemented the checks for s_getPtfxAddress. It took so long because i had to understand how to do it, now the others should be much quicker :D.
Essentially i ran into problems passing the wrong arguments, passing the wrong number of arguments, using the Address of the entity instead of the handle.
Maybe this will be useful to someone in the future: Calling a vfunc of an entity on the same frame where you create it will crash the game.
Also disassembly is your friend, the decompiled code failed to show me a function pointer passed to the vfunc as the second argument, which resulted in it always returning 0.
Im also currently learning a lot of things while doing this, so this feels exciting haha.
On to the next thing 🚀.

Edit: This keeps coming back to haunt me. Calling a vfunc of an entity on the same frame it is created has nothing to do with crashing the game, i missed yet another argument 🥲. This is good news, since having to time the call would have been very unstable (even if FPS-based). Also the address returned for the ptfx is mostly 0 (Not for the entity which can be obtained using s_getScriptEntity, but for the ptfx itself). I'll test it on Legacy to see if that's the case there too.

Last Edit for this i promise 😂: I finally got it to work and return the correct address every time. At least i learned alot trying to get it to work.

[Chiheb-Bacha]

Update: I've done great progress so far, yet I still have many patterns to cover. A realistic estimate for when I'm done is around 10 days give or take (including testing). After that I will publish everything in a beta state so that you can help me iron out any bugs that might have slipped through.

Edit: The published version would cover 100% of the API that shvdn has for legacy, and potentially add some functionality, hence why it wasn't a quick release.

[RusLanParty]

The published version would cover 100% of the API that shvdn has for legacy, and potentially add some functionality, hence why it wasn't a quick release.

Are you saying old scripts will work as is?

[Chiheb-Bacha]

Depending on the API they use, it would require minimal to no changes. I will be dropping v2, as well as methods marked as obsolete in v3 (you already get warnings in VS if you use them). So script developers would have to reference the new dll and replace any obsolete method calls with the right ones (for example Notification.Show replaced by Notification.PostTicker).

[Chiheb-Bacha]

Almost done. Was traveling during the weekend so i couldn't get much work done. If everything goes well, i should finish all the patterns tomorrow :). Then i'll adapt the pool structs because their struct layout was shifted, and I'll start the testing. I'll then look into the configuration stuff, since apparently i can use the same assembly name and versioning, so that even old abandoned mods would work as is , given that they don't use any memory patterns themselves. In the case they do, you could either ask their developer (or if it's you) to update them, and if they can't find them and I have time, i could help out with that. I'll talk more about that in the release.

Edit: In the first release, I'll release v2 (if it works) and v3 for compatibility reasons as mentioned, so that all scripts work, and that would be the last release for v2/v3 (except for potential fixes for NativeMemory.cs), then I'll start working on a v4 which adds more functionality : a lot more pools that i found (i'll have to reverse their items tho to understand what they are and how they are used), as well as other stuff. Although I'll be working with a slower pace on v4, since uni is almost back.

[helrazzrr]

Man, It's awesome news. I'm really looking forward for that release. I cant wait for mods on enhanced. :D Cheers.

[Chiheb-Bacha]

Starting the testing phase now. Adapted the pool structs, shifting them by 0x08 as every access I've seen in enhanced was shifted by 0x08 compared to legacy, but still not sure if all fields remain the same. I'll check that out through testing.

Edit: Will also revisit the first pattern that i've done on the first days, since i know much more now than back then. I also hardcoded the obfuscation keys they used for the fwBasePool pointers when i first started the project, I'll come back to those and get them dynamically.

[Chiheb-Bacha]

Had to do some debugging as the game was crashing after story mode loaded. The culprit was indeed the stuff I've done on the first days of the project ^^. Now it's fixed. Now onto more testing. I'll log all offsets to see if they're correct. I'll also do some testing on the pools, and more stuff. As you can see in the picture, DLC car despawning is successfully patched. As i mentioned in some earlier post, I'm currently traveling, so expect me to finish testing and release shvdne in like 2 days, just so no/not many bugs get shipped.

[Chiheb-Bacha]

A mod i wrote like a year ago works fine (including LemonUI), and i didn't have to add shvdne as a reference. so i believe old mods can be used as is, as long as they don't use memory patterns of their own. However, i seemed to have made a mistake with FwBasePool, since i get an error when trying to get their element count. It'll take some testing to fix but shouldn't be anything crazy. I'll have time to fix it on saturday, as I will be very busy tomorrow. Also, the game is crashing whenever i type Reload() in the console, but I'm not sure why. Will fix that by then too. All in all, I'm almost done. So expect a full release in the next few days.

[EverythingSuckz]

Thank you so much for your efforts!

[Chiheb-Bacha]

Allright i finally got some time to work on this, and I already found out why accessing the pools crashes scripts. It's because I'm doing the deobfuscation of the pool pointers wrong (pools are one of the first things I've done when i started ^^). Already fixed it for the pedPool and will now do the same for the other pools.

[Chiheb-Bacha]

So i reimplemented all the pools correctly now, but I Still have to fix pool management. The crash upon Reload() is also fixed now, however, if i have a paused script and i attempt to Reload(), the game crashes and this is the relevant part of the log :

[13:46:34] [INFO] Unloading script domain ...
[13:46:34] [WARNING] Aborted script gtaMod2.gtaMod2.
bei System.Threading.Monitor.ObjWait(Boolean exitContext, Int32 millisecondsTimeout, Object obj)
bei System.Threading.SemaphoreSlim.WaitUntilCountOrTimeout(Int32 millisecondsTimeout, UInt32 startTime, CancellationToken cancellationToken)
bei System.Threading.SemaphoreSlim.Wait(Int32 millisecondsTimeout, CancellationToken cancellationToken)
bei System.Threading.SemaphoreSlim.Wait() bei SHVDN.Script.Wait(Int32 ms) bei SHVDN.Script.MainLoop()

If anyone could try to reproduce this on legacy and report back, that would be great, so that I know if it's something on my end, or something already present in shvdn. The way I have it set up : a script (gtaMod2) with the attribute : [ScriptAttributes(NoDefaultInstance = true)] is started by another script (gtaMod) using gtaMod2.gtaMod2 loader = InstantiateScript<gtaMod2.gtaMod2>(); and pauses itself (this.Pause()). When I use the command Reload() in the console, while gtaMod2 is paused, the game crashes with the above-mentioned Warning.

I will also test this myself on another laptop on legacy once im done with pool management, but if anyone can do it by then, it would be nice.

Edit: The crash is indeed related to some functions i implemented at the start. Im trying to fix them now.
Edit: i also got the pool management working. Im having some problems with s_entityPosFunc, as well as some other stuff. But I'll get it to work too.

[Chiheb-Bacha]

12 Hours later. I fixed it all :D. Had to do some back-breaking debugging. One of the annoying bugs was caused by a wrong offset, using 0x20 for fwBasePool->itemSize instead of 0x1C. Now I can reload the scripts, i can iterate over pools, and almost every thing is tested and working. I'll do more testing on the other things now, since pools are working (only tested pedPool, but it is of the same type as other pools (except for vehiclePool) and i checked all the other pool pointers and they are correct). Technically i could release SHVDNE tomorrow evening, sort of a beta release where small bugs might still occur, and you'd have to report them to me so that i can fix them. After that, I will release it for public use, and you could start telling players that your mods support enhanced (doing that with the beta will mean both script developers and myself will be flooded with bug reports ^^).

[Chiheb-Bacha]

Allright. I spent the whole day fixing some bugs and making sure everything worked well. I Also added 1 pool for now : pickupObjectPlacementPool, which you can iterate over to get all the pickups on the map. The class PickupObjectPlacement that I added only has a Position attribute for now that you can get, but i'll add more stuff to it in future releases (like pickup type and so on).

I also identified a couple more pools that could be interesting, and will be added in future releases, as well as more features.

Now given that i had to make some changes that could affect Legacy, I'll just need to do 1 more test on Legacy to make sure nothing broke.

Had to delay the release a bit again, but I'm just making sure everything goes well. In some hours, when I wake up, I'll do the last bits of testing and then finally release SHVDNE.

As an unrelated note, the Turbo attribute on the Vehicle class isn't currently used properly. For the value set to take effect, first of all the car needs the turbo mod toggled, as well as 3 memory patches to instructions that write to the Turbo, since it's being overwritten many times a second.

[Chiheb-Bacha]

Annnnd released :)
You can find it here. Please try to test as many features as possible and let me know if anything goes wrong (it would be great if you could compare with shvdn to see if it's something I introduced, or something already present)

[ardekpelkka-source]

Bro my game closes immediately after copying the files idk if I'm doing something wrong?

[Chiheb-Bacha]

well that't definitely not supposed to happen. Could you tell me more? Are you running enhanced? Could you tell me what's in the log files? asiloader.log to see if ScriptHookVDotNet.asi loaded or not. ScriptHookV.log to see if there is anything wrong there. and ScriptHookVDotNet.log to see if maybe patterns wern't found? (although they should be).

[Chiheb-Bacha]

Another question is, if you are on enhanced, is your game named GTA5_Enhanced.exe or something else? And what scripts are you running? are they yours? if so, do they contain Memory Patterns from Legacy? if not yours, could you check if they contain memory pattern from legacy?

And does anyone else have the same issue? Because I didn't have any crashes on a second laptop. So could you be accessing something from one of yours scripts that is causing that problem? if so, it would be great if you could debug that. If it happens onTick or in a constructor, start by eliminating things from there and see if it persists.

[ardekpelkka-source]

Yeso bro im running the enhanced version im attaching photos of what you asked for. I don't know if it's a problem that's only happening to me.

[ardekpelkka-source]

I see that for some reason it won't let me upload photos. I'll leave it written here:

Pd: I'm not running any scripts right now, I don't have a scripts folder created yet..

scripthookVdonet.log
[05:15:17] [DEBUG] Loading API from .\ScriptHookVDotNet2.dll ...
[05:15:17] [DEBUG] Loading API from .\ScriptHookVDotNet3.dll ...
[05:15:17] [DEBUG] Initializing NativeMemory members...

asiloader.log
// GTA V ENHANCED ASI LOADER (build Mar 22 2025)
// (C) Alexander Blade 2025
LIB: "C:\Windows\system32\xinput1_4.dll" => 00007FFF8FAC0000
API: "DllMain" => 00007FFF8FAC1BC0
API: "XInputGetState" => 00007FFF8FAC2EC0
API: "XInputSetState" => 00007FFF8FAC3300
API: "XInputGetCapabilities" => 00007FFF8FAC29F0
API: "XInputEnable" => 00007FFF8FAC2290
API: "XInputGetBatteryInformation" => 00007FFF8FAC27B0
API: "XInputGetKeystroke" => 00007FFF8FAC2CD0
API: "XInputGetAudioDeviceIds" => 00007FFF8FAC2340
API: "XINPUT1_4_100" => 00007FFF8FAC3040
API: "XINPUT1_4_101" => 00007FFF8FAC3440
API: "XINPUT1_4_102" => 00007FFF8FAC2190
API: "XINPUT1_4_103" => 00007FFF8FAC3180
API: "XINPUT1_4_104" => 00007FFF8FAC2690
API: "XINPUT1_4_108" => 00007FFF8FAC2B30
LOADER: Loading *.asi plugins

[Chiheb-Bacha]

I can't tell if the loader didn't load the .asi plugins successfully or shvdne had a problem with memory patterns. Are these logs complete?

I'll go get some sleep now, since I haven't slept in over 24 Hours xD, when I'm back I'll assist you in resolving the issue. I hope some other people could also tell us whether they are facing the same issue

EDIT: just crossed my mind, delete the args.txt that you get with scriptHookV, and disable battle eye from the Rockstar launcher.

[ardekpelkka-source]

You deserve it brother, thank you very much for trying to help me despite the long work🙏

[ardekpelkka-source]

I'm also running it on a cracked version of the game, do you think that could be the problem?

[Chiheb-Bacha]

ahh that's probably the problem then. I believe ScriptHookV doesn't work on cracked versions, and probably terminates the game if the license check fails. Allthough I'm not sure since all supported mods require a licensed copy of the game.

[ardekpelkka-source]

ScriphookV It works for me and hasn't given me any problems, but what about ScriptHookV.net, I've tried with previous versions that did the same thing, but I assumed it was because they only worked with legacy and not with enhanced :(

[DrakeTheWolf]

Can you please update to 3.7 API version? My downloaded scripts are for SHVDN3 3.7, but yours seems to currently have the 3.6 API.

[DrakeTheWolf]

@Chiheb-Bacha Can you help me maybe? why EAI ( https://www.gta5-mods.com/scripts/enable-all-interiors-wip#description_tab ) is crashing the game as soon as load into a story savegame? Is it due to a specific request from the script itself or the enhanced edition? Logs are clean, meaning there are no errors. All the other scripts I've loaded work (even those from the same developer). But without the interiors, it's simply not worth it to use them :D

[Chiheb-Bacha]

Hey, I'll test it myself. It could be that it uses memory patterns of its own and would have to be updated by the dev. I see it's not open source, so it would be nice to get in contact with the dev. I see in the description, he urges users to set a reload key, so maybe he relies on that for something? If yes, then that would explain things, since I disabled that hotkey for now, as it causes the game to lag. I'll get back to you once i have something. In the meantime, you could ask the dev if he could test his script for compatibitliy with Enhanced, as he seems to be actively developing new mods.

[Chiheb-Bacha]

@DrakeTheWolf I'm already in talks with HKH191 to resolve this. I tried to run EAI myself, and it doesn't crash the game itself, but the script. It seems it tries to access some hardcoded paths but can't. When that is fixed, we shall do more compatibility tests and I'll let you know.

[DrakeTheWolf]

@Chiheb-Bacha Thanks for your efforts

[Chiheb-Bacha]

@DrakeTheWolf Welcome :).

HK191 sent me a working version of EAI, so problems should be resolved in the next version of it. Just wait for him to release it. he still has to go through other mods to make them compatible.