scripthookvdotnet

Community script gancho v .net (shvdn)

Este es un complemento ASI para Grand Theft Auto V, basado en el Scripthook C ++ de Alexander Blade, que permite ejecutar scripts escritos en cualquier idioma .NET en el juego.

La página de problemas debe usarse principalmente para informes de errores e ideas de mejora enfocadas. Las preguntas relacionadas con las secuencias de comandos GTA V en general, están mejor en la página de discusiones o en foros dedicados a este propósito.

Requisitos

• C ++ Script Hook V por Alexander Blade
• Marco .NET ≥ 4.8
• Visual C ++ redistribuible para Visual Studio 2019 x64

Descargas

Las compilaciones estables se pueden descargar desde la página de lanzamientos. Debe usar el archivo ASI y los archivos DLL para API en un archivo de la misma versión que la estructura interna se puede cambiar sin previo aviso.
Si está utilizando la versión del juego V1.0.3258.0 o posterior, use la versión nocturna nightly.89 o posterior (vea a continuación los detalles de la versión nocturna), o degrade el juego a V1.0.3179.0 o anterior! v3.6.0 y v3.5.1 Tienen un problema de compatibilidad con la versión del juego v1.0.3258.0 y versiones de juego posteriores!

Para construcciones más nuevas, consulte las construcciones nocturnas. No tiene que iniciar sesión en GitHub para descargar lanzamientos nocturnos.
Estas son algunas de las notas que debe tener en cuenta al usar una versión nocturna (de V3.6.0):

• La versión API predeterminada para scripts RAW se cambia de V2 a V3.
  • Para los usuarios : si tiene scripts sin procesar sin una notación de versión API por nombre de archivo, deberá especificar en versiones nocturnas. Puede especificar una versión API agregando un punto y un número de versión justo antes del nombre de la extensión (por ejemplo, Script.cs a Script.2.cs ).
• La configuración .ini se cambia. Debe usar el archivo .ini que proviene de una versión nocturna. SHVDN no agrega la configuración faltante actualmente.
• Se agregan mensajes de advertencia para los scripts construidos contra la API V2, que no se mantiene tan mantenida como la V3 y no tendrá ninguna característica nueva. Esto no significa que la API V2 ni siquiera recibirá correcciones de compatibilidad para nuevas actualizaciones de juegos en el futuro cercano . Estos mensajes se imprimen para instar a los usuarios a pedir a los autores de script que migren a la API V3.
• Es posible que algunos scripts no estén funcionando que dependan del hilo principal del proceso del juego (para la lógica del juego).
  • Esto se debe a que tuvimos que usar un hilo dedicado que no sea el hilo principal para evitar usar la fibra de Scripthookv, por lo que los usuarios no tendrán problemas de compatibilidad cruciales con el gancho del complemento de ira y los scripts C ++ que usan bloques de prueba de prueba. Aunque todavía estamos buscando cómo hacer que Shvdn tick en el hilo del juego principal conecte una función en el proceso del juego, no hemos encontrado uno.

Para los desarrolladores de script, tenga en cuenta que las nuevas API incluidas en las nuevas compilaciones nocturnas, pero no incluidas en ninguna versiones estables, están sujetas a cambios sin previo aviso, por lo que no es aconsejable utilizar ninguna de ellas para construcciones públicas/de producción de sus guiones. En otras palabras, debe construir sus scripts contra versiones estables, pero no versiones nocturnas a menos que construya sus scripts para probar algunas de las nuevas API agregadas en versiones nocturnas, por lo que no usará accidentalmente nada que no esté disponible en ninguna versiones estables. ¡La construcción de guiones contra versiones nocturnas puede hacer que los guiones no funcionen como se pretende en versiones SHVDN diferentes de las versiones contra las que están construidas!

Instalación

• Extraiga todos los archivos en la carpeta raíz del archivo zip en la carpeta de su juego excepto para README.txt y las 2 carpetas.
  • Los archivos XML en la carpeta Docs se proporcionan únicamente como documentación de API para desarrolladores de scripts.
• Cuando actualice, ¡siempre asegúrese de actualizar al menos todos los archivos ASI y .dll juntos! ¡No se proporcionará soporte si los recoges y eso causa problemas! Los siguientes archivos son los que debe actualizar juntos:
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

Que contribuye

Necesitará Visual Studio 2019 o más para abrir el archivo del proyecto y el Script Hook v SDK extraído en /SDK.

Cualquier contribución al proyecto es bienvenida, se recomienda utilizar solicitudes de extracción de GitHub.

Licencia

ScripthookVDotnet se distribuye principalmente bajo los términos de la licencia ZLIB. Vea la licencia y los derechos de autor para más detalles.