Lua scripting

Tempest.Scripting is a Lua 5.4 runtime that the launcher injects into Paladins alongside V2 mods. It gives a script live access to the game's UnrealScript object model without a UDK project, a compiler, or any hard-coded offsets.

With it a mod can:

• read and write any property of any object through the game's own reflection data
• call any UnrealScript or native function
• hook functions before or after they run, change their arguments, or cancel them
• construct objects, spawn actors, and iterate arrays and maps
• add console commands and key bindings
• share values with other Lua mods

Scripts reload while the game runs, so iteration is edit, save, reload.

How it fits with Tempest

A Lua mod is a regular Tempest mod: a folder with a manifest.toml and a scripts/ directory, packed into a .tempest file with the CLI and installed through the launcher. The runtime itself, Tempest.Scripting64.dll, is installed the same way, once; the launcher injects it at launch and it then runs the scripts of every enabled mod. Script mods do not bundle the DLL.

my-first-mod/
  manifest.toml
  scripts/
    main.lua
    lib/helpers.lua      loaded with require("lib.helpers")

Each mod runs in its own sandbox. Globals a script sets stay private to its mod; the API, the standard library, and the shared table are visible to all.

Supported game version

The runtime targets the Paladins 8.1 Win64 client. Engine addresses are found by signature scanning at startup, and game-class layouts are read from live reflection, so a new patch mostly means re-checking a handful of signatures rather than every offset. Other versions are not supported.

Where to go next

• Getting started walks through a first mod, the console, reloading, and editor completion.
• Concepts explains objects, hooks, threads, and the sandbox.
• The API reference: tempest, objects and containers, console and input, memory.
• Cookbook has copy-paste recipes.
• Limitations and troubleshooting lists what does not work and how to read the log.