Installation
TPScript ships as a source plugin with no prebuilt binary required - Unreal's build tool compiles it for you on first launch. It is tested on Unreal Engine 5.8 for Windows and macOS.
Requirements
- Unreal Engine 5.8 (tested; older 5.x versions generally work but 5.8 is the reference).
- A C++ project. Your project must have a
Source/folder (i.e. it must be a code project, not a pure Blueprint project). If yours is Blueprint-only, add a blank C++ class once to create theSource/folder. - A C++ toolchain for your platform (Visual Studio on Windows, Xcode or Clang on macOS).
Option A - From Fab / Epic Games Launcher (recommended)
- On Fab, click Add to get TPScript into your library.
- In the Epic Games Launcher, open Library → Fab Library.
- Find TPScript UE5 and click Install to Engine, picking your installed engine version.
- Open (or create) your C++ project.
- Go to Edit → Plugins, search for TPScript, and enable TPScript UE5.
- Restart the editor when prompted.
You'll now have a TPScript section in the Tools menu and a toolbar button in the Level Editor.
Option B - Manual (zip / source)
-
Download the
TpscriptUE5plugin folder (from the zip or this repo'sPlugins/directory). -
Copy the
TpscriptUE5folder into your project'sPlugins/directory:<YourProject>/Plugins/TpscriptUE5/...Source/YourProject.uproject -
Create a
TPScripts/folder in your project root if it doesn't exist. -
Open the project. The editor will detect the new plugin and compile it automatically.
-
Use the TPScript panel (Tools → Open TPScript Panel) or the Tools → Run Regeneration menu item to start generating.
Verifying it installed
After the editor loads, check for the TPScript entries under Tools in the main menu, and the TPScript tile in the «Play» toolbar. If you open Edit → Plugins you'll see TPScript UE5 listed as Enabled.
Uninstalling
- Close the editor first (required).
- Remove the plugin:
- Project install: delete
Plugins/TpscriptUE5. - Engine install: uninstall via the Epic Games Launcher (Fab Library).
- Project install: delete
- Your
.tpsfiles inTPScripts/are kept (they're just plain text). - Generated C++ lives in
Source/<Module>/TpsGeneratedandSource/TpscriptKit- these are safe to delete if you no longer need the generated gameplay.
The bundled demo module
The plugin ships with a demo module whose sources come from bundled corpus files, so the examples work out of the box - you can open the panel's Examples tab immediately without any setup. Copy an example into your own project's TPScripts/ folder to turn it into a real, editable mechanic.
Next step
Follow the Quick Start guide to write and regenerate your first actor.