LLM runs inside the game and takes its orders from a plain text file. An AI agent (or you, by hand) can read, search and change game memory, call the game's own functions and run Lua on the game thread while you play, with no restarts between experiments. Everything it writes is journaled and can be undone, and every game function it calls is logged.
It is a tool for people making mods. If you only want to play, you do not need it.
How it works
Write a commands.txt into %LOCALAPPDATA%\LinksLinkToMemory\ starting with batch <n> and one command a line. LLM runs it on the game thread and writes the output to results_<n>.txt; status.txt says what it is doing, and a file named stop ends whatever runs. The included Python driver (tools/llm.py) does all of that in one call. Nothing happens without a command file.
Commands
Memory: read, write (data or code, with readback), find (byte patterns with ?? wildcards across all memory), modfind (inside one module), dump (to a file), deref and ptr (follow pointer chains), regions, module and modread
Lua: eval (one line on the game thread) and run (a script from the scripts folder; a script can keep running every frame)
Safety net: journal and undo (every write, with the bytes it replaced), calls (every game function called, with its arguments), log on/off, and a timing line after every command
Chat: chat on/off (relay your own "hearsay" lines to the agent), chat say (a reply only you see), chat all (a real chat line every player sees)
Other: sleep, options (the mod manager options you ticked), tasks (background jobs: list or stop)
Script API
Scripts get memory reads and writes, typed readers (u8 to f64), the engine's hash maps, fingerprint-checked game function calls (a function whose code changed after a game update is never called), libraries with use(), files kept between sessions, background tasks, and HD2Runtime's API through runtime() when that mod is installed.
What the kit can do
Test weapons on real enemies
Spawn any enemy at your ping, up to 30 at once in rows: run enemies spawn trooper x10
Dummies stand still and never notice you, but still take damage, stagger, lose limbs and die. Switch them to passive, frozen or their normal AI whenever you like.
Calm the enemies already around you: run enemies mode dummy near 30
One of every enemy of a faction in rows: run enemy_line automatons
Enemies the mission did not bring are loaded first (solo, optional).
Run commands from the chat using the hearsay, no AI needed
Put a few commands in a text file and type hearsay command dummies (or hearsay c dummies) in the game chat. The answer shows up in your chat.
Examples included: dummies, calm, wild, a loadout switch, and a showcase.
Items and loadouts
Spawn any item in front of you by name, loading its model first if nobody brought it (solo, optional): run hd2_spawn portable hellbomb
Equip any primary, sidearm or throwable you own by name, as the armory does: run hd2_loadout primary liberator
Read and change your inventory, equip and drop slots, and hide, move or scale engine units.
Pings and pickups
See every player's pings: what each one marks, whose it is, and for an item, its exact entity and pickup state. Handy for bug reports.
Find backpacks and items around you with their pickup state, compare pickup records, and watch one live.
Find out what the game is doing
Census: everything within a radius of you, grouped by type and named (441 entity types: weapons, backpacks, enemies of every faction).
Actions: names every action you start, live (picking up, reloading, using a pack).
Watch a value every frame, or keep one held.
Stutter finder: frame times, which frames the mods' Lua ran long, and which mods took that time.
Package snapshots: what a mission has loaded, and the difference between two missions.
Talk with your squad
The agent can post real chat lines everyone sees. Other players' "hearsay" lines reach it as notes or questions, never as commands.
Demo scripts
The gun in your hand at three times its size, a backpack dropped and put on your back, and a ring of armed Portable Hellbombs (solo).
For mod makers
57 game addresses as code patterns, found again automatically after a game update (run hd2_resolve); a tool turns any address you find into a pattern of your own.
Tools to read the game's code from a dump: a disassembler, who references an address, who writes a field, and a crash dump reader that names the module and offset.
An offline test suite that runs LLM and every kit script against a fake game under the game's own LuaJIT.
A leak checker for your own releases (keys, personal paths, e-mail addresses, hidden image text).
README, a 10-step TUTORIAL with ready batches, and AGENTS.md: the rules and known traps, written for AI agents.
Requirements
Bingus Shared Loader
Optional: HD2Runtime (scripts can use its API)
Optional, for the tools and the driver: Python 3
Install
1. Install the mod zip with your mod manager, mod has som options so look at them.
2. Tick the options you want: LLM, Load missing models (solo), Hearsay commands.
3. Unpack the kit and copy its scripts and commands folders into %LOCALAPPDATA%\LinksLinkToMemory\
README.md and TUTORIAL.md in the kit explain the rest; AGENTS.md is written for AI agents.
ONLY "install Links-Link-to-Memory-x.x.x", "Links-Link-to-Memory-x.x.x-kit" contains the scripts and reading material for you or your AI, kit IS NOT A MOD.
Known limits
Spawned enemies cannot be despawned: kill them instead.
Enemies from another faction than the mission's may come without textures.
Enemy and model-loading spawns are solo only, unless you add together (other players may see stand-ins, and it is never allowed on the ship).
Sentries from stratagems cannot be spawned.
Credits
Bingus Shared Loader
HD2Runtime by skyeshade, for its research (names and tables)
Enemy Spawn Multiplier's documentation, for notes on the enemy director
MIT licence: use it, build on it, just mention it.
Use at your own risk: LLM changes a live online game's memory and CAN cause crashes.
It is a tool for people making mods. If you only want to play, you do not need it.
How it works
Write a commands.txt into %LOCALAPPDATA%\LinksLinkToMemory\ starting with batch <n> and one command a line. LLM runs it on the game thread and writes the output to results_<n>.txt; status.txt says what it is doing, and a file named stop ends whatever runs. The included Python driver (tools/llm.py) does all of that in one call. Nothing happens without a command file.
Commands
Memory: read, write (data or code, with readback), find (byte patterns with ?? wildcards across all memory), modfind (inside one module), dump (to a file), deref and ptr (follow pointer chains), regions, module and modread
Lua: eval (one line on the game thread) and run (a script from the scripts folder; a script can keep running every frame)
Safety net: journal and undo (every write, with the bytes it replaced), calls (every game function called, with its arguments), log on/off, and a timing line after every command
Chat: chat on/off (relay your own "hearsay" lines to the agent), chat say (a reply only you see), chat all (a real chat line every player sees)
Other: sleep, options (the mod manager options you ticked), tasks (background jobs: list or stop)
Script API
Scripts get memory reads and writes, typed readers (u8 to f64), the engine's hash maps, fingerprint-checked game function calls (a function whose code changed after a game update is never called), libraries with use(), files kept between sessions, background tasks, and HD2Runtime's API through runtime() when that mod is installed.
What the kit can do
Test weapons on real enemies
Spawn any enemy at your ping, up to 30 at once in rows: run enemies spawn trooper x10
Dummies stand still and never notice you, but still take damage, stagger, lose limbs and die. Switch them to passive, frozen or their normal AI whenever you like.
Calm the enemies already around you: run enemies mode dummy near 30
One of every enemy of a faction in rows: run enemy_line automatons
Enemies the mission did not bring are loaded first (solo, optional).
Run commands from the chat using the hearsay, no AI needed
Put a few commands in a text file and type hearsay command dummies (or hearsay c dummies) in the game chat. The answer shows up in your chat.
Examples included: dummies, calm, wild, a loadout switch, and a showcase.
Items and loadouts
Spawn any item in front of you by name, loading its model first if nobody brought it (solo, optional): run hd2_spawn portable hellbomb
Equip any primary, sidearm or throwable you own by name, as the armory does: run hd2_loadout primary liberator
Read and change your inventory, equip and drop slots, and hide, move or scale engine units.
Pings and pickups
See every player's pings: what each one marks, whose it is, and for an item, its exact entity and pickup state. Handy for bug reports.
Find backpacks and items around you with their pickup state, compare pickup records, and watch one live.
Find out what the game is doing
Census: everything within a radius of you, grouped by type and named (441 entity types: weapons, backpacks, enemies of every faction).
Actions: names every action you start, live (picking up, reloading, using a pack).
Watch a value every frame, or keep one held.
Stutter finder: frame times, which frames the mods' Lua ran long, and which mods took that time.
Package snapshots: what a mission has loaded, and the difference between two missions.
Talk with your squad
The agent can post real chat lines everyone sees. Other players' "hearsay" lines reach it as notes or questions, never as commands.
Demo scripts
The gun in your hand at three times its size, a backpack dropped and put on your back, and a ring of armed Portable Hellbombs (solo).
For mod makers
57 game addresses as code patterns, found again automatically after a game update (run hd2_resolve); a tool turns any address you find into a pattern of your own.
Tools to read the game's code from a dump: a disassembler, who references an address, who writes a field, and a crash dump reader that names the module and offset.
An offline test suite that runs LLM and every kit script against a fake game under the game's own LuaJIT.
A leak checker for your own releases (keys, personal paths, e-mail addresses, hidden image text).
README, a 10-step TUTORIAL with ready batches, and AGENTS.md: the rules and known traps, written for AI agents.
Requirements
Bingus Shared Loader
Optional: HD2Runtime (scripts can use its API)
Optional, for the tools and the driver: Python 3
Install
1. Install the mod zip with your mod manager, mod has som options so look at them.
2. Tick the options you want: LLM, Load missing models (solo), Hearsay commands.
3. Unpack the kit and copy its scripts and commands folders into %LOCALAPPDATA%\LinksLinkToMemory\
README.md and TUTORIAL.md in the kit explain the rest; AGENTS.md is written for AI agents.
ONLY "install Links-Link-to-Memory-x.x.x", "Links-Link-to-Memory-x.x.x-kit" contains the scripts and reading material for you or your AI, kit IS NOT A MOD.
Known limits
Spawned enemies cannot be despawned: kill them instead.
Enemies from another faction than the mission's may come without textures.
Enemy and model-loading spawns are solo only, unless you add together (other players may see stand-ins, and it is never allowed on the ship).
Sentries from stratagems cannot be spawned.
Credits
Bingus Shared Loader
HD2Runtime by skyeshade, for its research (names and tables)
Enemy Spawn Multiplier's documentation, for notes on the enemy director
MIT licence: use it, build on it, just mention it.
Use at your own risk: LLM changes a live online game's memory and CAN cause crashes.
