scripthookvdotnet

Community Script Hook v .net (shvdn)

Dies ist ein ASI-Plugin für Grand Theft Auto V, das auf dem C ++-Scripthook von Alexander Blade basiert, mit dem Skripte in einer .NET-Sprache im Spiel ausgeführt werden können.

Die Seite "Themen" sollte in erster Linie für Fehlerberichte und fokussierte Verbesserungsideen verwendet werden. Fragen zu GTA V Scripting im Allgemeinen sind auf der Seite der Diskussionen oder in Foren, die diesem Zweck gewidmet sind, besser dran.

Anforderungen

• C ++ Skript Hook V von Alexander Blade
• .NET Framework ≥ 4,8
• Visual C ++ Neuverteilbar für Visual Studio 2019 x64

Downloads

Die stabilen Builds können von der Seite "Releases" heruntergeladen werden. Sie müssen die ASI -Datei und die DLL -Dateien für APIs in einem Archiv derselben Version wie die interne Struktur ohne Vorankündigung ändern.
Wenn Sie die Spielversion V1.0.3258.0 oder höher verwenden, verwenden Sie die nächtliche Version nightly.89 oder höher (siehe unten für nächtliche Versionsdetails) oder das Spiel auf v1.0.3179.0 oder früher herabstufen! v3.6.0 und v3.5.1 haben ein Kompatibilitätsproblem mit der Spielversion V1.0.3258.0 und spätere Spielversionen!

Für neuere Builds schauen Sie sich die nächtlichen Builds an. Sie müssen sich nicht bei GitHub anmelden, um nächtliche Veröffentlichungen herunterzuladen.
Hier sind einige der Notizen, die Sie bei der Verwendung einer nächtlichen Version (ab V3.6.0) wissen sollten:

• Die Standard -API -Version für RAW -Skripte wird von V2 auf V3 geändert.
  • Für Benutzer : Wenn Sie RAW -Skripte ohne API -Versionsnotation nach Dateinamen haben, müssen Sie in nächtlichen Versionen angeben. Sie können eine API -Version angeben, indem Sie kurz vor dem Erweiterungsnamen einen Punkt und eine Versionsnummer hinzufügen (z. B. Script.cs zu Script.2.cs ).
• Die Einstellungen für .ini werden geändert. Sie sollten die .ini -Datei verwenden, die aus einer nächtlichen Veröffentlichung stammt. SHVDN fügt derzeit keine fehlenden Einstellungen hinzu.
• Warnmeldungen werden für Skripte hinzugefügt, die gegen die V2 -API erstellt wurden, die nicht so gepflegt ist wie die V3 -Einrichtung und keine neuen Funktionen haben. Dies bedeutet nicht, dass die V2 -API in naher Zukunft nicht einmal Kompatibilitätskorrekturen für neue Spiel -Updates erhalten wird. Diese Nachrichten werden gedruckt, um die Benutzer aufzufordern, die Skriptautoren zu bitten, in die V3 -API zu migrieren.
• Einige Skripte funktionieren möglicherweise nicht, die auf den Hauptfaden des Spielprozesses (für die Spiellogik) beruhen.
  • Dies liegt daran, dass wir einen anderen dedizierten Thread als den Haupt-Thread verwenden mussten, um die Verwendung von ScriptHookv-Fasern zu vermeiden, sodass Benutzer keine entscheidenden Kompatibilitätsprobleme mit RAGE-Plugin-Hook- und C ++-Skripten haben, die Try-Catch-Blöcke verwenden. Obwohl wir immer noch suchen, wie SHVDN im Hauptspiel -Thread durch die Anschlüsse einer Funktion im Spielprozess tickt, haben wir keine gefunden.

Für Skriptentwickler beachten Sie bitte, dass neue APIs, die in neuen nächtlichen Builds enthalten sind, jedoch nicht in stabilen Versionen enthalten sind, ohne vorherige Ankündigung geändert werden können. Daher ist es nicht ratsam, eine davon für öffentliche/produktionliche Builds Ihrer Skripte zu verwenden. Mit anderen Worten, Sie sollten Ihre Skripte gegen stabile Versionen erstellen, aber nicht abends Versionen, es sei denn, Sie erstellen Ihre Skripte, um einige der neuen APIs in nächtlichen Versionen zu testen, sodass Sie in stabilen Versionen versehentlich nichts mehr verwenden. Das Erstellen von Skripten gegen nächtliche Versionen kann Skripte nicht wie in shvdn -Versionen beabsichtigt funktionieren als die Versionen, gegen die sie aufgebaut sind!

Installation

• Extrahieren Sie alle Dateien im Stammordner aus der ZIP -Datei in Ihren Spielordner mit Ausnahme von README.txt und den 2 Ordnern.
  • Die XML -Dateien im Ordner Docs werden ausschließlich als API -Dokumentation für Skriptentwickler bereitgestellt.
• Wenn Sie aktualisieren, stellen Sie immer sicher, dass Sie mindestens alle ASI- und .dll -Dateien gemeinsam aktualisieren! Es wird keine Unterstützung gewährt, wenn Sie sie kehren und das verursacht Probleme! Die folgenden Dateien sind diejenigen, die Sie gemeinsam aktualisieren müssen:
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

Beitragen

Sie benötigen Visual Studio 2019 oder höher, um die Projektdatei zu öffnen, und den in /sdk extrahierten Skript -Hook V SDK.

Alle Beiträge zum Projekt sind begrüßt. Es wird empfohlen, Github Pull -Anfragen zu verwenden.

Lizenz

ScriptHookvdotnet wird hauptsächlich unter den Bedingungen der ZLIB -Lizenz verteilt. Weitere Informationen finden Sie unter Lizenz und Urheberrecht.