scripthookvdotnet

社區腳本鉤v .net（SHVDN）

這是基於Alexander Blade的C ++ Scripthook的Grand Theft Auto V的ASI插件，該插件允許在遊戲中以任何.NET語言編寫的腳本運行。

問題頁面應主要用於錯誤報告和重點增強想法。一般而言，與GTA V腳本有關的問題，在討論頁面或專門針對此目的的論壇上更好。

要求

• Alexander Blade的C ++腳本鉤V V
• .NET框架≥4.8
• Visual C ++可用於Visual Studio 2019 x64的重新分佈

下載

可以從“發行”頁面下載穩定的構建。您需要在可以更改內部結構的同一版本的檔案中使用ASI文件和API的DLL文件，而無需通知。
如果您使用的是遊戲版本v1.0.3258.0或更高版本，請夜間使用夜間版本nightly.89或更高版本（有關夜間版本的詳細信息，請參見下文），或將游戲降級到v1.0.3179. 0或更早！ v3.6.0和v3.5.1與遊戲版本v1.0.3258.0及以後的遊戲版本有兼容性問題！

對於較新的版本，請查看夜間構建。您不必登錄Github即可下載夜間版本。
以下是您在使用夜間版本時應該注意的一些筆記（來自v3.6.0）：

• RAW腳本的默認API版本從V2更改為V3。
  • 對於用戶：如果您的原始腳本不使用文件名表示API版本表示法，則需要在夜間版本中指定。您可以通過在擴展名稱之前添加點和版本號來指定API版本（例如Script.cs to Script.2.cs ）。
• .INI設置已更改。您應該使用每晚發布的.INI文件。 SHVDN當前不會添加丟失的設置。
• 添加了針對V2 API構建的腳本的警告消息，該腳本不像V3 ONE那樣維護，並且不會具有任何新功能。這並不意味著V2 API甚至不會在不久的將來獲得新遊戲更新的兼容性修復。打印這些消息是為了敦促用戶要求腳本作者遷移到V3 API。
• 某些腳本可能無法依靠遊戲過程的主線程（用於遊戲邏輯）。
  • 這是因為我們必須使用除主線程以外的專用線程以避免使用Scripthookv的光纖，因此用戶不會與使用Try-Catch塊的Rage Plugin Hook和C ++腳本存在關鍵的兼容性問題。儘管我們仍在搜索如何通過在遊戲過程中掛接函數在主遊戲線程中shvdn tick的方法，但我們尚未找到一個。

對於腳本開發人員，請注意，新的夜間構建中包含的新API，但在任何穩定版本中都不包含在不通知的情況下會發生更改，因此不建議將其中的任何一個用於腳本的公共/生產構建。換句話說，除非您構建腳本來測試一些新的API，否則您應該根據穩定版本構建腳本，而不是夜間版本，因此您不會意外使用任何穩定版本中不可用的內容。針對夜間版本構建腳本可能會使腳本無法按照SHVDN版本的意圖工作，這與它們構建的版本不同！

安裝

• 除了README.txt和2個文件夾外，從zip文件中將所有文件中的所有文件提取到遊戲文件夾中。
  • Docs文件夾中的XML文件僅作為腳本開發人員的API文檔提供。
• 更新時，請始終確保至少將所有ASI和.DLL文件更新在一起！如果您挑選它們，將不會提供支持，這會導致問題！以下文件是您必須一起更新的文件：
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

貢獻

您需要Visual Studio 2019或更高版本才能打開項目文件和提取到 /SDK的腳本掛鉤SDK。

歡迎對該項目的任何貢獻，建議使用GitHub拉的請求。

執照

ScripthookvDotnet主要根據ZLIB許可證的條款分發。有關詳細信息，請參見許可證和版權。