TerrariaHooks

OBSOLETO

O TmodLoader 0.11+ inclui sua própria versão do Terrariahooks / Monomod.

Por favor, diga a todos os desenvolvedores de mod que ainda usam esta versão antiga para atualizar seus mods.

Terrariahooks

Licença: MIT

---

"Receita" Hookgen para Terraria, resultando em um mod da TML da qual outros mods podem depender.

Construído com monomod.

Características

Para jogadores

Este mod é um ajudante para outros mods. Basta instalá -lo se um mod precisar, ele não mudará a Terraria por conta própria.

Para modders

• "Gancho" qualquer método arbitrário que você desejar facilmente:

On . Terraria . Player . CheckMana += ( orig , player , amount , pay , blockQuickMana ) => {
	// We can either make this act as a method replacement
	// or just call our code around the original code.

	// Let's double the mana cost of everything.
	// We can pass on custom values.
	bool spendable = orig ( player , amount * 2 , pay , blockQuickMana ) ;

	// ... but give back half of it if it was spent.
	if ( spendable && pay ) {
		player . statMana += amount / 2 ;
	}

	// We can return custom values.
	return spendable ;
}

Para um exemplo estendido, dê uma olhada nessa essência.

• Use "ganchos" para detectar quando um método é executado, altere como ele é executado ou até substitui -o.
  Os "ganchos" são automaticamente desfeitos sempre que o seu mod descarrega. Isso é tratado por terrariahooks para você.

• Manipular qualquer método no tempo de execução via IL ... += (...) => {...} usando o Cecil e muitos ajudantes.
  Agradecimentos especiais aos ossos de galinha pelas ótimas idéias e feedback ao longo do caminho!

• Use o RunTimedETour para portar rapidamente o código "Método de troca" existente.
  Observe que isso exige que você desfaça seus desvios na descarga.

Se você precisar de mais informações, leia o Monomod RunTimedETour ReadMe.

Instruções

Se você quiser usar terrariahooks em seu mod:

• Faça o download TerrariaHooks.dll do último lançamento.
• Coloque -o na sua pasta Mod lib .
• Adicione -o como uma referência no Visual Studio.
• Em seu build.txt , adicione modReferences = TerrariaHooks
• Adicione seus ganchos no seu método Load mod.
• Terrariahooks desfazerá automaticamente seu gancho quando o seu mod descarregar.

Construindo Terrariahooks você mesmo

• git clone --recursive https://github.com/0x0ade/TerrariaHookGen.git
  • Como alternativa, puxe o submódulo Monomod manualmente
• Atualize os arquivos em _input
  • Os arquivos redistribuídos neste repositório são despojados.
  • Os arquivos nesse diretório serão removidos automaticamente em cada execução.
• Construir a solução.
• Run ./TerrariaHookGen/bin/Debug/TerrariaHookGen.exe _input .
• No diretório Terraria, Run ./tModLoaderServer.exe -build 'path/to/TerrariaHooks' -eac

Esse repositório supercomplica todo o procedimento. Tudo se resume a:

./MonoMod.RuntimeDetour.HookGen.exe --private Terraria.exe TerrariaHooksPre.dll
./ILRepack.exe /out:TerrariaHooks.dll TerrariaHooksPre.dll MonoMod. * .dll MonoMod.exe

Ao executar as duas linhas acima no diretório Terraria (com todas as dependências presentes), ele gera TerrariaHooks.dll para o seu Terraria.exe .

O único objetivo deste repositório é automatizar completamente o processo e permitir a publicação TerrariaHooks.dll como um mod da TML.