> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selvut.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Learn how to write scripts for Selvut.

Selvut scripts are `.lua` files loaded from the client scripts folder. Each file becomes a toggle module in the Scripts category and can define settings, commands, timers, event callbacks, and game logic through the scripting API.

## Where Scripts Live

Put scripts in:

```text theme={null}
~/.minecraft/selvut/scripts
```

Use the `.lua` extension. Reload scripts in game with:

```text theme={null}
;scripts reload
```

## Minimal Script

```lua theme={null}
Script.name("Hello Script")
Script.description("Small test script.")

Script.on("enable", function()
  Chat.log("Hello from Selvut")
end)
```

When loaded, this appears as a module in the Scripts category. Enabling it prints a client-side chat message.
