fmemory

A simple node add-on powered by gmem for reading/writing memory in a given process on GNU/Linux.

---

more info:

features:

- get process id through process name
- get module base address through module name
- memory reading
- memory writing

todo:

- get call address of a function
- vector3d and vector2d support _(read, write)_
- shellcode execution _(maybe)_
- high privileges helpers
- signature reader/scanner

🚧 more to come..

installing:

Since this is a Node addon, you'll need cmake-js, node-addon-api, and a C++ compiler (GCC or clang).

To install this addon simply type: npm install fmemory

if you get an error related to cmake-js, make sure that node.js is updated to the latest version and also make sure that cmake-js is installed globally and node-addon-api is installed as well. (It doesnt need to be installed globally)

usage:

The usage is pretty straight-forward.

Here's how:

const fmemory = require("fmemory");
// or import fmemory from "fmemory";

const localPlayerControllerAddress = 0xDEADBEEF;
const hPawn = 0x123;
const flFlashAlpha = 0x321;

const main = (() => {
  // get process id
  const processID = fmemory.getProcessID("cs2")

  // get engine module base address
  const clientModuleBaseAddress = fmemory.getModuleBaseAddr("libclient.so", processID)
  
  // another way to get the module base address
  // const clientModuleBaseAddress = fmemory.getModuleBaseAddrProcName("libclient.so", "cs2") 

  // local player pawn pointer
  const pLocalPLayer = fmemory.readMemory(localPlayerControllerAddress + hPawn, fmemory.POINTER)

  // disable flashbang
  if (pLocalPLayer) {
    fmemory.writeMemory(pLocalPLayer + flFlashAlpha, 0.0 /* <- value */, fmemory.FLOAT)
  }
})()

NOTE: This works with Wine/Proton as well. (fmemory still needs improvements on this area, but it works.)

documentation:

When using writeMemory or readMemory functions, you will need to tell the data type parameter.

It can either be a string:

"int32", "uint32", "int64",
"uint64", "long", "ulong", 
"short", "float", "double", 
"byte", "char", "uchar",
"bool" "string", "pointer"

Or you can use one of the constants provided by the library:

fmemory.INT, fmemory.UINT, fmemory.INT64,
fmemory.UINT64, fmemory.LONG, fmemory.ULONG, 
fmemory.SHORT, fmemory.FLOAT, fmemory.DOUBLE,
fmemory.BYTE, fmemory.CHAR, fmemory.UCHAR,
fmemory.BOOL, fmemory.STRING, fmemory.POINTER

---

fmemory is available under the MIT License