memorynative tier
Read, write and scan game memory; exists only with "Raw memory access" on in the Scripting tab.
Functions
memory.module_base
memory.module_base([name]) -> integer| Name | Type | Description |
|---|---|---|
| nameoptional | string | Like "hw.dll"; omitted means game exe. Default nil. |
Base address of a loaded module.
Returns base address, 0 if not loaded
memory.module_size
memory.module_size([name]) -> integer| Name | Type | Description |
|---|---|---|
| nameoptional | string | Omitted means the game exe. Default nil. |
Size of a module's mapped image.
Returns image bytes, 0 if not loaded
memory.find_pattern
memory.find_pattern(module, pattern) -> integer | nil| Name | Type | Description |
|---|---|---|
| module | string | Loaded module to scan. |
| pattern | string | Spaced hex bytes, ? or ?? wildcards. |
Scans a module for a byte signature, like "55 8B EC ?? 83".
Returns first match address, or nil
- Bytes need spaces: "8BEC" is read as one byte, EC.
- Slow on big modules; cache the result.
memory.read_int
memory.read_int(addr) -> integer | nil| Name | Type |
|---|---|
| addr | integer |
Reads a signed 32-bit integer.
Returns nil if unreadable
Every read checks the page: bad addresses return nil, never crash.
memory.read_uint
memory.read_uint(addr) -> integer | nil| Name | Type |
|---|---|
| addr | integer |
Reads an unsigned 32-bit integer.
Returns nil if unreadable
memory.read_short
memory.read_short(addr) -> integer | nil| Name | Type |
|---|---|
| addr | integer |
Reads a signed 16-bit integer.
Returns nil if unreadable
memory.read_byte
memory.read_byte(addr) -> integer | nil| Name | Type |
|---|---|
| addr | integer |
Reads an unsigned byte.
Returns 0 to 255, nil if unreadable
memory.read_float
memory.read_float(addr) -> number | nil| Name | Type |
|---|---|
| addr | integer |
Reads a 32-bit float.
Returns nil if unreadable
memory.read_double
memory.read_double(addr) -> number | nil| Name | Type |
|---|---|
| addr | integer |
Reads a 64-bit double.
Returns nil if unreadable
memory.read_ptr
memory.read_ptr(addr) -> integer | nil| Name | Type |
|---|---|
| addr | integer |
Reads a 32-bit pointer, for pointer chains.
Returns nil if unreadable
memory.read_bytes
memory.read_bytes(addr, count) -> string | nil| Name | Type | Description |
|---|---|---|
| addr | integer | |
| count | integer | 1 to 1048576 (1 MiB). |
Copies a memory block into a Lua string.
Returns raw bytes, or nil
nil if count is out of range or any byte is unreadable.
memory.read_string
memory.read_string(addr [, maxlen]) -> string| Name | Type | Description |
|---|---|---|
| addr | integer | NUL-terminated string address. |
| maxlenoptional | integer | 1 to 65536, else 256. Default 256. |
Reads a C string up to the NUL or maxlen.
Returns never nil
An unreadable address returns "", same as an empty string.
memory.write_int
memory.write_int(addr, value) -> boolean| Name | Type | Description |
|---|---|---|
| addr | integer | |
| value | integer | Truncated to 32 bits. |
Writes a 32-bit integer.
Returns false if not writable
Writes never change protection; use memory.protect for code and read-only data.
memory.write_short
memory.write_short(addr, value) -> boolean| Name | Type | Description |
|---|---|---|
| addr | integer | |
| value | integer | Truncated to 16 bits. |
Writes a 16-bit integer.
Returns true if written
memory.write_byte
memory.write_byte(addr, value) -> boolean| Name | Type | Description |
|---|---|---|
| addr | integer | |
| value | integer | Truncated to 8 bits. |
Writes one byte.
Returns true if written
memory.write_float
memory.write_float(addr, value) -> boolean| Name | Type |
|---|---|
| addr | integer |
| value | number |
Writes a 32-bit float.
Returns true if written
memory.write_double
memory.write_double(addr, value) -> boolean| Name | Type |
|---|---|
| addr | integer |
| value | number |
Writes a 64-bit double.
Returns true if written
memory.write_bytes
memory.write_bytes(addr, data) -> boolean| Name | Type | Description |
|---|---|---|
| addr | integer | |
| data | string | Raw bytes, like "\x90\x90". |
Copies a byte string into memory, for patches.
Returns true if written
All or nothing: false if any byte is not writable.
memory.alloc
memory.alloc(size) -> integer | nil| Name | Type | Description |
|---|---|---|
| size | integer | Bytes, rounded up to pages. |
Allocates executable read/write memory.
Returns zeroed RWX address, or nil
Never freed, even on unload; allocate once and reuse.
memory.protect
memory.protect(addr, size, prot) -> integer | nil| Name | Type | Description |
|---|---|---|
| addr | integer | Start address. |
| size | integer | Bytes. |
| prot | integer | A memory.PAGE_* constant. |
Changes page protection, usually to patch code then restore.
Returns previous protection, or nil
Whole pages, unguarded: no-access on a game page crashes.
Constants
| Name | Value | Description |
|---|---|---|
| memory.PAGE_NOACCESS | 1 | Any access faults. |
| memory.PAGE_READONLY | 2 | |
| memory.PAGE_READWRITE | 4 | |
| memory.PAGE_EXECUTE | 16 | Execute only. |
| memory.PAGE_EXECUTE_READ | 32 | Normal code. |
| memory.PAGE_EXECUTE_READWRITE | 64 | For patching code. |