TerrariaHooks

VERALTET

TModloader 0.11+ enthält eine eigene Version von Terrariahooks / Monomod.

Bitte teilen Sie allen Mod -Entwicklern mit, die diese alte Version immer noch verwenden, um ihre Mods zu aktualisieren.

Terrariahooks

Lizenz: MIT

---

Das Haken -Rezept für Terrarie, was zu einem TML -Mod führt, von dem andere Mods abhängen können.

Mit Monomod gebaut.

Merkmale

Für Spieler

Dieser Mod ist ein Helfer für andere Mods. Installieren Sie es einfach, wenn ein Mod es braucht, es wird die Terrarie nicht selbst ändern.

Für Modder

• "Hook" jede willkürliche Methode, die Sie leicht wollen:

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 ;
}

Schauen Sie sich diesen Kern für ein erweitertes Beispiel an.

• Verwenden Sie "Hooks", um zu erkennen, wann eine Methode ausgeführt wird, ändern Sie die Art und Weise, wie sie ausgeführt wird, oder ersetzen Sie sie sogar.
  "Hooks" werden automatisch rückgängig gemacht, wenn Ihr Mod entlädt. Dies wird von Terrariahooks für Sie behandelt.

• Manipulieren Sie jede Methode zur Laufzeit über IL ... += (...) => {...} Verwenden Sie Cecil und viele Helfer.
  Besonderer Dank geht an Hühnerknochen für die tollen Ideen und das Feedback auf dem Weg!

• Verwenden Sie RunTimedetour, um Ihren vorhandenen "Methoden -Swapping" -Code schnell zu portieren.
  Beachten Sie, dass Sie Ihre Umwege beim Entladen rückgängig machen müssen.

Wenn Sie weitere Informationen benötigen, lesen Sie die Monomod Runimedetour Readme.

Anweisungen

Wenn Sie Terrariahooks in Ihrem Mod verwenden möchten:

• Laden Sie TerrariaHooks.dll von der neuesten Veröffentlichung herunter.
• Geben Sie es in Ihren Mod lib -Ordner.
• Fügen Sie es als Referenz in Visual Studio hinzu.
• Fügen Sie in Ihrem build.txt modReferences = TerrariaHooks hinzu
• Fügen Sie Ihre Haken in Ihre Mod Load hinzu.
• Terrariahooks werden Ihren Haken automatisch rückgängig machen, wenn Ihr Mod entlädt.

Terrariahooks selbst bauen

• git clone --recursive https://github.com/0x0ade/TerrariaHookGen.git
  • Alternativ können Sie das Monomod -Submodul manuell anziehen
• Aktualisieren Sie die Dateien in _input
  • Die in diesem Repo umverteilten Dateien werden abgezogen.
  • Die Dateien in diesem Verzeichnis werden bei jedem Auslauf automatisch entzogen.
• Bauen Sie die Lösung auf.
• Run ./TerrariaHookGen/bin/Debug/TerrariaHookGen.exe _input .
• Im Terraria -Verzeichnis run ./tModLoaderServer.exe -build 'path/to/TerrariaHooks' -eac

Dieses Repository überkomert die gesamte Prozedur. Es läuft auf:

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

Wenn Sie die beiden oben genannten Zeilen im Terraria -Verzeichnis (mit allen vorhandenen Abhängigkeiten) durchführen, erzeugt es TerrariaHooks.dll für Ihre Terraria.exe .

Der einzige Zweck dieses Repositorys besteht darin, den Prozess vollständig zu automatisieren und die Veröffentlichung TerrariaHooks.dll als TML -Mod zu ermöglichen.