memory

The memory namespace contains functions that allow addons to access the game client memory in multiple ways.

Functions exposed by this namespace are accessed via the prefix: hook.memory.

Functions

get_base

Returns the base address of a loaded module.

1number hook.memory.get_base(name);

If name is nil or an empty string, then the game.dll module is used by default.

get_size

Returns the size of a loaded module.

1number hook.memory.get_size(name);

If name is nil or an empty string, then the game.dll module is used by default.

protect

1boolean, number hook.memory.protect(addr, size, protection);

Sets the memory protection of the given address.

unprotect

1boolean, number hook.memory.unprotect(addr, size);

Sets the memory protection of the given address to PAGE_EXECUTE_READWRITE.

alloc

Allocates memory within the process and returns the address to where it was allocated at. (Uses VirtualAlloc to allocate memory.)

1number|nil hook.memory.alloc(size);

dealloc

Deallocates memory that was previously allocated via alloc.

1boolean hook.memory.dealloc(addr);

find

Scans for a pattern of bytes within the given module.

1number hook.memory.find(name, pattern, offset, count);

If name is nil or an empty string, then the game.dll module is used by default.

1number hook.memory.find(base, size, pattern, offset, count);

If base and size are both 0, then the game.dll module is used by default.

read_int8

Reads a value from memory. (int8)

1number hook.memory.read_int8(addr);

read_int16

Reads a value from memory. (int16)

1number hook.memory.read_int16(addr);

read_int32

Reads a value from memory. (int32)

1number hook.memory.read_int32(addr);

read_int64

Reads a value from memory. (int64)

1number hook.memory.read_int64(addr);

read_uint8

Reads a value from memory. (uint8)

1number hook.memory.read_uint8(addr);

read_uint16

Reads a value from memory. (uint16)

1number hook.memory.read_uint16(addr);

read_uint32

Reads a value from memory. (uint32)

1number hook.memory.read_uint32(addr);

read_uint64

Reads a value from memory. (uint64)

1number hook.memory.read_uint64(addr);

read_float

Reads a value from memory. (float)

1number hook.memory.read_float(addr);

read_double

Reads a value from memory. (double)

1number hook.memory.read_double(addr);

read_array

Reads an array of bytes from memory.

1table|nil hook.memory.read_array(addr, size);

read_string

Reads a string from memory.

1string|nil hook.memory.read_string(addr, size);

read_literal

Reads a string literal from memory.

1string|nil hook.memory.read_literal(addr, size);

write_int8

Writes a value to memory. (int8)

1hook.memory.write_int8(addr, value);

write_int16

Writes a value to memory. (int16)

1hook.memory.write_int16(addr, value);

write_int32

Writes a value to memory. (int32)

1hook.memory.write_int32(addr, value);

write_int64

Writes a value to memory. (int64)

1hook.memory.write_int64(addr, value);

write_uint8

Writes a value to memory. (uint8)

1hook.memory.write_uint8(addr, value);

write_uint16

Writes a value to memory. (uint16)

1hook.memory.write_uint16(addr, value);

write_uint32

Writes a value to memory. (uint32)

1hook.memory.write_uint32(addr, value);

write_uint64

Writes a value to memory. (uint64)

1hook.memory.write_uint64(addr, value);

write_float

Writes a value to memory. (float)

1hook.memory.write_float(addr, value);

write_double

Writes a value to memory. (double)

1hook.memory.write_double(addr, value);

write_array

Writes an array of values to memory.

1hook.memory.write_array(addr, value);

write_string

Writes a string to memory.

1hook.memory.write_string(addr, str, size);

If size is not given, then the length of the string is automatically determined.