2024.07.29 update: there currently exists in the works a SourceMod handle which is designed to replace pseudo addresses. It is currently not available in vanilla SourceMod.
This is a temporary extension that provides a int64_t enum struct, containing the fields low and high in their respective order, respecting little-endianness. Provided is a few basic arithmetic natives, alongside addressing natives - the main point of this extension. These addressing natives provide basic addressing functionality within 64-bit SourceMod plugins, which may be necessary following the eventual transition of Team Fortress 2 from 32-bit to 64-bit.
The following addressing natives are exposed:
- LoadFromAddress64
- StoreToAddress64
- FromPseudoAddress
- ToPseudoAddress
- GetEntityAddress64
Pseudo-addressing was a feature implemented in SourceMod's API as a consequence of SourcePawn only providing 32-bit cells. Pseudo addresses allocate 6 bits as an index, with the following 26 bits being a relative address. The index (0-63) is used in an internal table, which provides the absolute address to a virtual page referenced by the desired index. The relative address is added onto this, which is then used to create a complete address.
The limitations of pseudo addresses are very quickly met as the internal pseudo address manager is not actually per plugin, but rather for the entire SourceMod runtime as a whole. It is very easy to run out of indexes, therefore you will have to practically restart the server. Anything to do with memory allocation will also be met with issues fast.
You can either compile the extension yourself with AMBuild, or head over to the releases tab. Place the contents of the addons folder into your addons folder. You will want to take the include addons/sourcemod/scripting/include/smaddress64.inc and use it in your plugin development environment, in order to interface with the natives and the int64_t enum struct.
See addons/sourcemod/csripting/smaddress64-test.sp for some basic example code.