scripthookvdotnet

Gancho de script da comunidade v .Net (shvdn)

Este é um plug-in ASI para Grand Theft Auto V, com base no scripthook C ++ de Alexander Blade, que permite a execução de scripts escritos em qualquer idioma .NET no jogo.

A página de problemas deve ser usada principalmente para relatórios de bugs e idéias de aprimoramento focado. Perguntas relacionadas ao Script GTA V Em geral, estão melhor na página de discussões ou em fóruns dedicados a esse fim.

Requisitos

• C ++ Script Hook V de Alexander Blade
• .NET Framework ≥ 4,8
• Visual C ++ Redistribuível para Visual Studio 2019 x64

Downloads

As compilações estáveis ​​podem ser baixadas na página de lançamentos. Você precisa usar o arquivo ASI e os arquivos DLL para APIs em um arquivo da mesma versão que a estrutura interna pode ser alterada sem aviso prévio.
Se você estiver usando a versão do jogo v1.0.3258.0 ou posterior, use a versão noturna nightly.89 ou mais tarde (veja abaixo para obter detalhes noturnos da versão) ou faça o downgrade do jogo para v1.0.3179.0 ou anterior! v3.6.0 e v3.5.1 têm um problema de compatibilidade com a versão do jogo v1.0.3258.0 e versões posteriores do jogo!

Para construções mais recentes, confira as construções noturnas. Você não precisa entrar no Github para baixar lançamentos noturnos.
Aqui estão algumas das notas que você deve estar ciente ao usar uma versão noturna (da v3.6.0):

• A versão da API padrão para scripts brutos é alterada de V2 para V3.
  • Para usuários : se você tiver scripts brutos sem uma notação da versão da API por nome do arquivo, precisará especificar em versões noturnas. Você pode especificar uma versão da API adicionando um número de pontos e um número de versão antes do nome da extensão (por exemplo, Script.cs ao Script.2.cs ).
• As configurações .ini são alteradas. Você deve usar o arquivo .ini que vem de uma liberação noturna. O shvdn não adiciona configurações ausentes atualmente.
• As mensagens de aviso são adicionadas para scripts construídos contra a API V2, que não é tão mantida quanto a V3 e não terá novos recursos. Isso não significa que a API V2 não estará recebendo correções de compatibilidade para novas atualizações de jogos em um futuro próximo . Essas mensagens são impressas para instar os usuários a pedir aos autores do script que migrassem para a API V3.
• Alguns scripts podem não estar funcionando que dependam do tópico principal do processo de jogo (para a lógica do jogo).
  • Isso ocorre porque tivemos que usar um thread dedicado que não seja o thread principal para evitar o uso da fibra do Scripthookv, para que os usuários não tenham problemas cruciais de compatibilidade com o gancho de plug-in de raiva e os scripts C ++ que usam blocos de tentativa. Embora ainda estejamos procurando como fazer com que o shvdn marque no tópico principal do jogo, conectando uma função no processo de jogo, não encontramos um.

Para desenvolvedores de scripts, observe que novas APIs incluídas em novas construções noturnas, mas não incluídas em nenhuma versões estáveis, estão sujeitas a alterações sem aviso prévio; portanto, não é aconselhável usar nenhuma delas para compilações públicas/de produção de seus scripts. Em outras palavras, você deve criar seus scripts contra versões estáveis, mas não versões noturnas, a menos que você crie seus scripts para testar algumas das novas APIs adicionadas nas versões noturnas, para que você não use acidentalmente nada disponível em versões estáveis. Construir scripts contra versões noturnas pode fazer com que os scripts não funcionem como pretendido nas versões shvdn diferentes das versões em que são construídas!

Instalação

• Extraia todos os arquivos na pasta root do arquivo zip para a pasta do jogo, exceto para README.txt e as 2 pastas.
  • Os arquivos XML na pasta Docs são fornecidos apenas como documentação da API para desenvolvedores de scripts.
• Ao atualizar, sempre certifique -se de atualizar pelo menos todos os arquivos ASI e .dll juntos! Nenhum apoio será fornecido se você o escolher e isso causar problemas! Os arquivos a seguir são os que você deve atualizar juntos:
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

Contribuindo

Você precisará do Visual Studio 2019 ou superior para abrir o arquivo do projeto e o gancho de script v SDK extraído em /sdk.

Quaisquer contribuições para o projeto são bem -vindas, é recomendável usar solicitações de puxão do GitHub.

Licença

O scripthookvdotnet é distribuído principalmente sob os termos da licença ZLIB. Consulte Licença e direitos autorais para obter detalhes.