> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: Script Files
description: How a Neverlose CS:GO script is structured, where it lives, and how to create one.
icon: file-code
sidebar_position: 1
---

# Script Files

A Neverlose script is a **single Lua file** that the cheat loads at runtime. There are no extension folders, no manifest, and no build step — one `.lua` file is the whole script.

<Note>
  This is the main difference from CS2, where a script is a folder with an `extension.json` manifest and multiple modules. On CS:GO it's just one file.
</Note>

## Where scripts live

Scripts are stored on disk in the `nl` folder inside your game directory:

```plaintext lines=false
…/Counter-Strike Global Offensive/nl
```

<Note>
  There's no need to back up your scripts — they are automatically synchronized and stored on the Neverlose servers.
</Note>

## Creating a script

Create and manage scripts from the **Lua** tab in the cheat menu — press to add a new script, give it a name, and it's added to the list ready to edit. The `nl` folder is kept in sync for you; you don't add scripts by dropping files into it manually.

## The entry point

When a script is enabled, the cheat runs the file top to bottom **once**. You don't write a loop — instead you register callbacks on [events](/csgo/api-reference/namespaces/events), and the cheat calls them for you:

```lua
-- Runs once when the script is enabled.
print("loaded")

-- Runs every frame, because it's registered on the paint event.
events.paint:set(function()
    render.text(1, vector(10, 30), color(255, 255, 255), nil, "Hello, World!")
end)
```
