⚙️utils

Usage:

utils.{function}

This table exposes various utility functions.

---

base64_encode

Function

Encode a string to Base64 format.

Arguments

Name	Type	Description
str	string	Source string.

Returns

Type	Description
string	Base64-encoded string.

Example

local enc = utils.base64_encode('Hello!'); -- SGVsbG8h

---

base64_decode

Function

Decode Base64-encoded string.

Arguments

Name	Type	Description
str	string	Base64-encoded string.

Returns

Type	Description
string	Source string.

Example

local dec = utils.base64_decode('SGVsbG8h'); -- Hello!

---

get_unix_time

Function

Returns current time as UNIX timestamp.

Arguments

None.

Returns

Type	Description
int	Timestamp.

Example

local ts = utils.get_unix_time();

---

murmur2

Function

Returns MURMUR2-hashed string.

Arguments

Name	Type	Description
str	string	Source string.

Returns

Type	Description
int	Hash.

Example

local hash = utils.murmur2('Hello');

---

fnv1a

Function

Returns FNV1A-hashed string.

Arguments

Name	Type	Description
str	string	Source string.

Returns

Type	Description
int	Hash.

Example

local hash = utils.fnv1a('Hello');

---

find_export

FunctionInsecure only

Returns an address to an export in an image.

Arguments

Name	Type	Description
mod	string	Image to look in.
exp	string	Export symbol.

Returns

Type	Description
int	Address, or 0 on failure.

Example

local message_box = utils.find_export('user32.dll', 'MessageBoxA');

---

find_pattern

FunctionInsecure only

Searches for a code pattern in an image.

Arguments

Name	Type	Description
mod	string	Image to search in.
pattern	string	Code pattern.

Returns

Type	Description
int	Address, or 0 on failure.

Example

local something = utils.find_pattern('engine2.dll', 'DE AD ? ? ? ? BE EF');

---

clipboard_get

FunctionInsecure only

Returns current clipboard content.

Arguments

None.

Returns

Type	Description
string	Clipboard content.

Example

local clip = utils.clipboard_get();

---

clipboard_set

FunctionInsecure only

Sets new clipboard content.

Arguments

Name	Type	Description
str	string	New content.

Returns

Nothing.

Example

utils.clipboard_set('Hello!');

---

array_to_string

Function

Converts an array of bytes into a string.

Arguments

Name	Type	Description
bytes	table	Array of bytes

Returns

Type	Description
string	The converted string

Example

-- Prints 'Hello world'
print(utils.array_to_string({72, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100}))

---

string_to_array

Function

Converts a string into an array of bytes (ASCII representation).

Arguments

Name	Type	Description
str	string	Text to be converted

Returns

Type	Description
table	The converted table

Example

-- Prints '72 105'
for _, v in ipairs(utils.string_to_array('Hi')) do
	print(v)
end

---

json_encode

Function

Encodes a lua table into JSON.

Arguments

Name	Type	Description
obj	table	Table to be converted

Returns

Type	Description
string	The JSON-encoded string

Example

-- Prints '{"text": "abc"}'
print(utils.json_encode({['text'] = 'abc'}))

---

json_decode

Function

Decodes a JSON string into a Lua table.

Arguments

Name	Type	Description
str	string	The JSON string

Returns

Type	Description
table	The decoded JSON object

Example

local obj = utils.json_decode("[1.0, \"Hello\", false]")

-- Prints '1 Hello false'
print(obj[1], obj[2], obj[3])

---

file_exists

Function

Returns whether a file exists or not. It is relative to your game/csgo folder.

Arguments

Name	Type	Description
path	string	Path to the file.

Returns

Type	Description
boolean	Whether the file exists or not

Example

if utils.file_exists('fatality/my_config.txt') then
    print('My custom configuration exists')
end

---

file_read

Function

Reads the contents of a file. It is relative to your game/csgo folder.

Arguments

Name	Type	Description
path	string	Path to the file.

Returns

Type	Description
table<number>	Contents of the file, in bytes

Example

if utils.file_exists('file.txt') then
    local contents = utils.array_to_string(utils.file_read('file.txt'))
    print(contents)
end

---

file_write

Function

Writes any contents to a file. It is relative to your game/csgo folder.

Arguments

Name	Type	Description
path	string	Path to the file.
contents	table<number>	Contents of the file, in bytes

Returns

Nothing.

Example

utils.file_write('file.txt', utils.string_to_array('Hello world'))