feat: Add TerraSharp for Terraria and tModLoader
This commit is contained in:
VAC committed
commit
58eb32c7ed
70 files changed
+8678
No files matched your search
@@ -0,0 +1,70 @@
|
||||
<div align="center">
|
||||
|
||||
# TerraSharp
|
||||
|
||||
TSharp / T#
|
||||
|
||||
An internal cheat menu for Terraria and tModLoader.
|
||||
|
||||
<img src="https://img.shields.io/badge/Language-C%23-f44c7c?style=flat-square" alt="C#">
|
||||
<img src="https://img.shields.io/badge/Platform-Windows-0078d4?style=flat-square" alt="Windows">
|
||||
<img src="https://img.shields.io/badge/Terraria-1.4.5-4c9c4c?style=flat-square" alt="Terraria 1.4.5">
|
||||
<img src="https://img.shields.io/badge/tModLoader-Supported-4c9c4c?style=flat-square" alt="tModLoader supported">
|
||||
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="MIT License"></a>
|
||||
|
||||
<img src="assets/menu.png" alt="TerraSharp Player menu in Terraria with ESP enabled">
|
||||
|
||||
[Features](#features) · [Getting started](#getting-started) · [Auto-load](#auto-load) · [Acknowledgements](#acknowledgements)
|
||||
|
||||
</div>
|
||||
|
||||
## Features
|
||||
|
||||
- God mode, infinite health and mana, auto potions, flight and movement controls.
|
||||
- Predictive aimbot, auto attack, shot preview and kill aura.
|
||||
- Item and buff browsers, infinite items, instant break and auto fishing.
|
||||
- ESP, health bars, projectile paths and potion vision effects.
|
||||
- Time, weather and event controls, plus saved waypoints with teleportation.
|
||||
|
||||
Hotkeys are rebindable. Settings, ESP colors and window positions save automatically; waypoints are saved per world.
|
||||
|
||||
Mostly intended for single player. Changes to NPCs and the world only affect your client in multiplayer.
|
||||
|
||||
## Getting started
|
||||
|
||||
To build from source, you'll need:
|
||||
|
||||
- Terraria or tModLoader installed. The build script skips games missing from the configured paths; tModLoader is optional.
|
||||
- The .NET 8 SDK, plus the .NET Framework 4.8 Developer Pack for Terraria builds.
|
||||
- Visual Studio 2022 or newer with the C++ build tools.
|
||||
- XNA Framework 4.0 for Terraria builds, installed with the game.
|
||||
|
||||
Set `TerrariaDir` and `TModLoaderDir` in `Directory.Build.props` to your game folders. The build and auto-load scripts use these paths. Environment variables with the same names also work.
|
||||
|
||||
1. Run `build.bat` from the project folder. The files go into `bin\`.
|
||||
2. Start Terraria or tModLoader, then run `bin\TerraSharp.Injector.exe`.
|
||||
3. Press `Insert` to open the menu. You can change this on the Keys tab.
|
||||
|
||||
The same injector works with both games. Keep it beside the DLLs produced by the build.
|
||||
|
||||
## Auto-load
|
||||
|
||||
You can also have the menu load when the game starts. Close the game, run `autoload.bat` and choose Install.
|
||||
|
||||
For Terraria, the script installs the DLL and adds its AppDomainManager entries to the existing game configuration. Uninstall removes those entries and the DLL while preserving other settings. Installation stops if another AppDomainManager is already configured. A game verify/update on Steam may remove the configuration; run the installer again if the menu stops loading.
|
||||
|
||||
For tModLoader, the script prints a launch option to paste into Steam under **Properties > General > Launch Options**. Steam also uses `autoload.bat` as the Windows launcher: it sets `DOTNET_STARTUP_HOOKS`, preserves any existing hooks and runs Steam's game command. Keep the project folder in place while using this option. When updating from an earlier version, run Install again and replace the launch option. Remove the option to stop auto-loading. It does not appear in tModLoader's mod list.
|
||||
|
||||
## Settings
|
||||
|
||||
Settings save to `TerraSharp.json` in the game's save folder:
|
||||
|
||||
- Terraria: `Documents\My Games\Terraria\TerraSharp.json`
|
||||
- tModLoader: `Documents\My Games\Terraria\tModLoader\TerraSharp.json`
|
||||
|
||||
For development with the game running, use `build-and-inject.bat`. It builds and reloads the menu, with logging to `%TEMP%\terrasharp.log`, and opens a live log viewer: gray for information, dark gray for debug messages, yellow for warnings, and red for errors. Repeated builds reuse the viewer. You can also open it with `build-and-inject.bat log`. Closing the viewer leaves the game running.
|
||||
|
||||
## Acknowledgements
|
||||
|
||||
- [glennf](https://www.unknowncheats.me/forum/members/5262305.html) for his [GVoid Terraria External Trainer](https://www.unknowncheats.me/forum/other-mmorpg-and-strategy/756815-terraria-external-v1-4-5-6-a.html).
|
||||
- [MonoMod developers](https://github.com/MonoMod/MonoMod) for RuntimeDetour, which handles the runtime hooks.
|
||||
Reference in new issue
Block a user