⚙️Utilities

utils namespace

Random values

random_int

utils.random_int(0, 100)

Parameter	Datatype	Description
min	number	minimum number to generate
max	number	maximum number to generate

Returns:

Value	Datatype
random number	number

random_float

utils.random_float(0, 100)

Parameter	Datatype	Description
min	number	minimum number to generate
max	number	maximum number to generate

Returns:

Value	Datatype
random number	number

Memory

find_interface

utils.find_interface("client.dll", "VClient018")

Parameter	Datatype	Description
module_name	string	name of module
interface_name	string	name of interface followed by its version number

Returns:

Value	Datatype
interface address or nil on failure	number - nil

find_pattern

utils.find_pattern("client.dll",  "8B 3D ? ? ? ? 85 FF 74 47") + 2

Parameter	Datatype	Description
module_name	string	name of module
pattern	string	IDA style pattern. ? indicates wildcard

Returns:

Value	Datatype
pattern address or nil on failure	number - nil

flags

utils.flags(render.font_flag_outline, render.font_flag_shadow)

Parameter	Datatype	Description
flag	number	flags to combine with the bitwise OR operator
...	number	any other flags

Timers

new_timer

local timer = utils.new_timer(100, function()
    print("This will be called every 100ms")
end)
timer:start()

Parameter	Datatype	Description
rate	number	the rate in which the function will be called (in milliseconds)
function_to_call	function	function to be called

Returns:

Value	Datatype
timer object	utils.timer

run_delayed

utils.run_delayed(100, function()
    print("This will be called after 100ms")
end)

Parameter	Datatype	Description
delay	number	the delay to wait before calling the function (in milliseconds)
function_to_call	function	function to be called

HTTP

http_get

utils.http_get("https://pastebin.com/raw/FT1aRqq8", "Accept: */*", function(response)
    print(response)
end)

Parameter	Datatype	Description
url	string	url to send the request to
headers	string	http headers
function_to_call	function	callback with response

http_post

utils.http_post("https://reqbin.com/echo/post/json", "Content-Type: application/json", 
[[body: "{"id": 12345,}"]], 
function(response)
  print(response)
end)

Parameter	Datatype	Description
url	string	url to send the request to
headers	string	http headers
body	string	post body
function_to_call	function	callback with response

Json

json_decode

local json_data = 
[[
{
  "value": 1,
  "color": "pink"
}
]]
local json_decoded = utils.json_decode(json_data)

Parameter	Datatype	Description
json_data	string	string of json data

Returns:

Value	Datatype
json data as lua table	table

json_encode

local table = 
{
    value = 1,
    color = "pink"
}
local json_string = utils.json_encode(table)

Parameter	Datatype	Description
lua_table	table	a lua table to be encoded into json

Returns:

Value	Datatype
lua table as a json string	string

Trace ray

trace

utils.trace(math.vec3(0, 0, 0), math.vec3(100, 100, 100), -1)

Parameter	Datatype	Description
from	math.vec3	starting point
to	math.vec3	ending point
skip_index	number	index to skip or -1 for all players

Returns

Value	Datatype
trace info	trace_t

trace_bullet

utils.trace_bullet(7, math.vec3(0, 0, 0), math.vec3(100, 100, 100))

Parameter	Datatype	Description
item_definition_index	number	weapon's item definition index to use for tracing
from	math.vec3	starting point
to	math.vec3	ending point

Returns:

Value	Datatype
damage	number
trace info	trace_t

scale_damage

utils.scale_damage(30, 7, 0, player:get_prop("m_ArmorValue"), player:get_prop("m_bHasHeavyArmor"), player:get_prop("m_bHasHelmet"))

Parameter	Datatype	Description
damage	number	damage to scale
item_definition_index	number	weapon's item definition index to use for calculating damage
hit_group	number	hit group to scale with
armor	number	their armor level
heavy_armor	boolean	do they have heavy armor
helmet	boolean	do they have a helmet

Returns:

Value	Datatype
damage	number

Console

print_console

utils.print_console("red text", render.color("#FF0000"))

Parameter	Datatype	Description	Default value
text	string	text to print	❌
color	render.color	color	white

print_dev_console

utils.print_dev_console("text")

Parameter	Datatype	Description
text	string	text to print

error_print

utils.error_print("error")

Parameter	Datatype	Description
text	string	text to print

Encryption

aes256_encrypt

local encryption = utils.aes256_encrypt("abcdefg", "we woo we woo")

Parameter	Datatype	Description
key	string	key to also used for decryption
data	string	string to encrypt

Returns:

Value	Datatype
encrypted data	string

aes256_decrypt

local encryption = utils.aes256_encrypt("abcdefg", "we woo we woo")
local data = utils.aes256_decrypt("abcdefg", encryption)

Parameter	Datatype	Description
key	string	key to also used for encryption
data	string	encrypted string

Returns:

Value	Datatype
data	string

base64_encode

local encoded = utils.base64_encode("AAAAAAA")

Parameter	Datatype	Description
data	string	data to encode

Returns:

Value	Datatype
encoded data	string

base64_decode

local encoded = utils.base64_encode("AAAAAAA")
local data = utils.base64_decode(encoded)

Parameter	Datatype	Description
encoded data	string	data from base64_encode

Returns:

Value	Datatype
data	string

Miscellaneous

load_file

utils.load_file("path")

Parameter	Datatype	Description
path	string	path to file

Returns:

Value	Datatype
file_contents	binary string

Note:

Path starts at csgo.exe's file location.

get_weapon_info

utils.get_weapon_info(1)

Parameter	Datatype	Description
item_definition_index	number	weapons item definition index

Returns:

Value	Datatype
table with the weapons info	utils.weapon_info

get_rtt

utils.get_rtt()

Returns:

Value	Datatype
round trip time to server	number

world_to_screen

local x, y = utils.world_to_screen(0, 0, 100)
if x then
    render.rect_filled(x, y, 1, 1, render.color("#FFFFFF"))
end

Parameter	Datatype	Description
x	number	3D x world position
y	number	3D y world position
z	number	3D z world position

Returns:

Value	Datatype
x screen pos or nil on failure	number - nil
y screen pos or nil on failure	number - nil

Usage:

Converts world coordinates to screen coordinates.

set_clan_tag

utils.set_clan_tag("fatal")

Parameter	Datatype	Description
new_tag	string	string to set clantag to

get_time

utils.get_time()

Returns:

Value	Datatype
time information	table

Table structure:

Value	Datatype	Description
year	number	current year
month	number	month (1 - 12)
year_day	number	day (1 - 366)
month_day	number	day (1 - 31)
week_day	number	day (1 - 7)
hour	number	hour (1 - 23)
min	number	minute (1 - 59)
sec	number	second (0 - 60) including leap second

get_unix_time

utils.get_unix_time()

Returns:

Value	Datatype
unix timestamp	number