# Utilities

### Random values <a href="#random-values" id="random-values"></a>

#### random\_int <a href="#random_int" id="random_int"></a>

utils.random\_int(0, 100)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| min                                                                                     | number                                                                                 | minimum number to generate                                                                |
| max                                                                                     | number                                                                                 | maximum number to generate                                                                |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| random number                                                                       | number                                                                                 |

#### random\_float <a href="#random_float" id="random_float"></a>

utils.random\_float(0, 100)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| min                                                                                     | number                                                                                 | minimum number to generate                                                                |
| max                                                                                     | number                                                                                 | maximum number to generate                                                                |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| random number                                                                       | number                                                                                 |

### Memory <a href="#memory" id="memory"></a>

#### find\_interface <a href="#find_interface" id="find_interface"></a>

utils.find\_interface("client.dll", "VClient018")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| module\_name                                                                            | string                                                                                 | name of module                                                                            |
| interface\_name                                                                         | string                                                                                 | name of interface followed by its version number                                          |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| interface address or nil on failure                                                 | number - nil                                                                           |

#### find\_pattern <a href="#find_pattern" id="find_pattern"></a>

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

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| module\_name                                                                            | string                                                                                 | name of module                                                                            |
| pattern                                                                                 | string                                                                                 | ​[IDA](https://hex-rays.com/ida-pro/) style pattern. ? indicates wildcard                 |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| pattern address or nil on failure                                                   | number - nil                                                                           |

#### flags <a href="#flags" id="flags"></a>

utils.flags(render.font\_flag\_outline, render.font\_flag\_shadow)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​                     |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| flag                                                                                    | number                                                                                 | flags to combine with the [bitwise OR](https://www.cprogramming.com/tutorial/bitwise_operators.html) operator |
| ...                                                                                     | number                                                                                 | any other flags                                                                                               |

### Timers <a href="#timers" id="timers"></a>

#### new\_timer <a href="#new_timer" id="new_timer"></a>

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

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| rate                                                                                    | number                                                                                 | the rate in which the function will be called (in milliseconds)                           |
| function\_to\_call                                                                      | function                                                                               | function to be called                                                                     |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| timer object                                                                        | ​[utils.timer](https://jewls.gitbook.io/fatality-api/documentation/datatypes/timer)​   |

#### run\_delayed <a href="#run_delayed" id="run_delayed"></a>

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

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| delay                                                                                   | number                                                                                 | the delay to wait before calling the function (in milliseconds)                           |
| function\_to\_call                                                                      | function                                                                               | function to be called                                                                     |

### HTTP <a href="#http" id="http"></a>

#### http\_get <a href="#http_get" id="http_get"></a>

utils.http\_get("<https://pastebin.com/raw/FT1aRqq8>", "Accept: \*/\*", function(response)print(response)end)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| url                                                                                     | string                                                                                 | url to send the request to                                                                |
| headers                                                                                 | string                                                                                 | ​[http headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)​               |
| function\_to\_call                                                                      | function                                                                               | callback with response                                                                    |

#### http\_post <a href="#http_post" id="http_post"></a>

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

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| url                                                                                     | string                                                                                 | url to send the request to                                                                |
| headers                                                                                 | string                                                                                 | ​[http headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)​               |
| body                                                                                    | string                                                                                 | post body                                                                                 |
| function\_to\_call                                                                      | function                                                                               | callback with response                                                                    |

### Json <a href="#json" id="json"></a>

#### json\_decode <a href="#json_decode" id="json_decode"></a>

local json\_data =\[\[{"value": 1,"color": "pink"}]]local json\_decoded = utils.json\_decode(json\_data)

|                                                                                         |                                                                                        |                                                                                           |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| json\_data                                                                              | string                                                                                 | string of json data                                                                       |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| json data as lua table                                                              | table                                                                                  |

#### json\_encode <a href="#json_encode" id="json_encode"></a>

local table ={value = 1,color = "pink"}local json\_string = utils.json\_encode(table)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| lua\_table                                                                              | table                                                                                  | a lua table to be encoded into json                                                       |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| lua table as a json string                                                          | string                                                                                 |

### Trace ray <a href="#trace-ray" id="trace-ray"></a>

#### trace <a href="#trace" id="trace"></a>

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

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| from                                                                                    | ​[math.vec3](https://jewls.gitbook.io/fatality-api/documentation/datatypes/vec3)​      | starting point                                                                            |
| to                                                                                      | ​[math.vec3](https://jewls.gitbook.io/fatality-api/documentation/datatypes/vec3)​      | ending point                                                                              |
| skip\_index                                                                             | number                                                                                 | index to skip or -1 for all players                                                       |

**Returns**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| trace info                                                                          | ​[trace\_t](https://jewls.gitbook.io/fatality-api/documentation/datatypes/trace_t)​    |

#### trace\_bullet <a href="#trace_bullet" id="trace_bullet"></a>

utils.trace\_bullet(7, math.vec3(0, 0, 0), math.vec3(100, 100, 100))

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| item\_definition\_index                                                                 | number                                                                                 | weapon's item definition index to use for tracing                                         |
| from                                                                                    | ​[math.vec3](https://jewls.gitbook.io/fatality-api/documentation/datatypes/vec3)​      | starting point                                                                            |
| to                                                                                      | ​[math.vec3](https://jewls.gitbook.io/fatality-api/documentation/datatypes/vec3)​      | ending point                                                                              |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| damage                                                                              | number                                                                                 |
| trace info                                                                          | ​[trace\_t](https://jewls.gitbook.io/fatality-api/documentation/datatypes/trace_t)​    |

#### scale\_damage <a href="#scale_damage" id="scale_damage"></a>

utils.scale\_damage(30, 7, 0, player:get\_prop("m\_nArmor"), player:get\_prop("m\_bHasHeavyArmor"), player:get\_prop("m\_bHasHelmet"))

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 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](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| damage                                                                              | number                                                                                 |

### Console <a href="#console" id="console"></a>

#### print\_console <a href="#print_console" id="print_console"></a>

utils.print\_console("red text", render.color("#FF0000"))

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​        | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Default value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| text                                                                                    | string                                                                                        | text to print                                                                             | ❌                                                                                           |
| color                                                                                   | ​[render.color](https://jewls.gitbook.io/fatality-api/documentation/namespaces/render#color)​ | color                                                                                     | white                                                                                       |

#### print\_dev\_console <a href="#print_dev_console" id="print_dev_console"></a>

utils.print\_dev\_console("text")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| text                                                                                    | string                                                                                 | text to print                                                                             |

#### error\_print <a href="#error_print" id="error_print"></a>

utils.error\_print("error")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| text                                                                                    | string                                                                                 | text to print                                                                             |

### Encryption <a href="#encryption" id="encryption"></a>

#### aes256\_encrypt <a href="#aes256_encrypt" id="aes256_encrypt"></a>

local encryption = utils.aes256\_encrypt("abcdefg", "we woo we woo")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| key                                                                                     | string                                                                                 | key to also used for decryption                                                           |
| data                                                                                    | string                                                                                 | string to encrypt                                                                         |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| encrypted data                                                                      | string                                                                                 |

#### aes256\_decrypt <a href="#aes256_decrypt" id="aes256_decrypt"></a>

local encryption = utils.aes256\_encrypt("abcdefg", "we woo we woo")local data = utils.aes256\_decrypt("abcdefg", encryption)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| key                                                                                     | string                                                                                 | key to also used for encryption                                                           |
| data                                                                                    | string                                                                                 | encrypted string                                                                          |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| data                                                                                | string                                                                                 |

#### base64\_encode <a href="#base64_encode" id="base64_encode"></a>

local encoded = utils.base64\_encode("AAAAAAA")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| data                                                                                    | string                                                                                 | data to encode                                                                            |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| encoded data                                                                        | string                                                                                 |

#### base64\_decode <a href="#base64_decode" id="base64_decode"></a>

local encoded = utils.base64\_encode("AAAAAAA")local data = utils.base64\_decode(encoded)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| encoded data                                                                            | string                                                                                 | data from base64\_encode                                                                  |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| data                                                                                | string                                                                                 |

### Miscellaneous <a href="#miscellaneous" id="miscellaneous"></a>

#### load\_file <a href="#load_file" id="load_file"></a>

utils.load\_file("path")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| path                                                                                    | string                                                                                 | path to file                                                                              |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| file\_contents                                                                      | binary string                                                                          |

**Note:**

Path starts at csgo.exe's file location.

#### get\_weapon\_info <a href="#get_weapon_info" id="get_weapon_info"></a>

utils.get\_weapon\_info(1)

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​                                           |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| item\_definition\_index                                                                 | number                                                                                 | weapons [item definition index](https://jewls.gitbook.io/fatality-api/documentation/datatypes/weapon_info#item-definition-indexes)​ |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​            |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| table with the weapons info                                                         | ​[utils.weapon\_info](https://jewls.gitbook.io/fatality-api/documentation/datatypes/weapon_info)​ |

#### get\_rtt <a href="#get_rtt" id="get_rtt"></a>

utils.get\_rtt()

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| round trip time to server                                                           | number                                                                                 |

#### world\_to\_screen <a href="#world_to_screen" id="world_to_screen"></a>

local x, y = utils.world\_to\_screen(0, 0, 100)if x thenrender.rect\_filled(x, y, 1, 1, render.color("#FFFFFF"))end

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| x                                                                                       | number                                                                                 | 3D x world position                                                                       |
| y                                                                                       | number                                                                                 | 3D y world position                                                                       |
| z                                                                                       | number                                                                                 | 3D z world position                                                                       |

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 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 <a href="#set_clan_tag" id="set_clan_tag"></a>

utils.set\_clan\_tag("fatal")

| ​[Parameter](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| new\_tag                                                                                | string                                                                                 | string to set clantag to                                                                  |

#### get\_time <a href="#get_time" id="get_time"></a>

utils.get\_time()

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| time information                                                                    | table                                                                                  |

**Table structure:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Description](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 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 <a href="#get_unix_time" id="get_unix_time"></a>

utils.get\_unix\_time()

**Returns:**

| ​[Value](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ | ​[Datatype](https://jewls.gitbook.io/fatality-api/documentation/namespaces/utilities)​ |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| ​[unix timestamp](https://www.unixtimestamp.com/)​                                  | number                                                                                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fecality-api.gitbook.io/docs/documentation/namespaces/utilities.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.