Introversion

Preamble


Ok, so after having delved into a bit of modding in PA, I found the Lua API to be somewhat lacking. So, being the investigative sod that I am, I decompiled my copy of the game, and took a look for some, possibly undocumented Lua functions. While I did not find any undocumented ones (props to the wiki for that), I did find that there are a literal f**k-ton of C/C++ methods that heavily resemble already implemented Lua functions.

Just quickly, for those that aren't aware, Lua is pretty much a language designed to be implemented inside of another language, and provides an extensive interface to C/C++ particularly, hence why I'm even bringing C/C++ methods into this

Now, some of you are probably aware that finding nearby objects, entities and other in-game objects can be a real pain, the most often used (and only) function for doing this is [code single]Object.GetNearbyObjects()[/code], which is EXTREMELY in-accurate, and often leads to a lot of code that really shouldn't be necessary. As well as that, as far as I can tell, the only way to add room requirements, nearby objects e.t.c. is to override the corresponding .txt files from the game. This isn't efficient and can be infuriating at times.

I will give a list of all functions found, but am going to focus on a couple that seem like they'd be extremely helpful
PLEASE NOTE, AS THIS IS FROM DISASSEMBLED CODE, IT MAY BE INNACCURATE

World::GetRoom

This function allows one to get the pointer to the room containing a specific object
The syntax appears to be as follows


This means it takes a pointer to a Objectid constant.
It then seems to return a pointer to the room, which as far as I can tell, is an [code single]int[/code]
This would be immensely helpful for campaigns, grants and new rooms, as it'd allow for better context checking

World::GetObject
This function has 2 variants, one that takes 2 [code single]int[/code]'s, presumably x and y coordinates. The other variant takes a [code single]ObjectId[/code] pointer. The x, y variant would presumably return whatever object was present in that coordinate. The other presumably just returns a pointer to the [code single]WorldObject[/code] with the corresponding id. This would be great for sanbox mods, one example is True Sandbox Mod V2, which makes extensive use of the [code single]World::GetNearbyObjects()[/code] function to allow one to instantly create large sections of materials

Syntax is as follows


World::GetObjectsInRoom
This function is pretty much self-explanatory, apart from the fact that it returns a pointer to a [code single]FastList[/code] of the objects found

Please note that I'm really not sure on the arguments for this, it seems to take [code single]ObjectID[/code]'s even though I would of thought it'd take some sort of [code single]Room[/code] object pointer

This would be helpful for grant mods


World::ToggleLockdown and World::ToggleBangup
Self explanatory, but would be useful for modding
Both take no arguments

Entity namespace

Entity::ClearRouting
This would be great to stop Workers from getting stuck in corners for several minutes after placing mod objects

Final Notes
I haven't covered as many functions as I could have, but BBcode is a pain, and I'm sure theres a post size limit. Hope this helps people, and perhaps my suggestions will be implemented

List of Functions (Not all of them, that'd be too many. Full lists attached)


Full Lists
Unfortunately, I cant upload them directly, so heres a link to a gist
https://gist.github.com/MicroTransactionsMatterToo/4337df40304ddaa1078b28d0a2d40272