> ## 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.

# Quickstart

> Create, reload, and test a first Selvut script.

## Create A File

Create a file in:

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

Add this:

```lua theme={null}
Script.meta({
  name = "Hello Selvut",
  description = "First Selvut script."
})

local message = Setting.text("Message", {
  description = "Message printed by the script.",
  default = "Hello from Selvut"
})

Script.on("enable", function()
  Chat.log(message.get())
end)

Script.command("hello", {
  description = "Print the configured greeting.",
  usage = "hello"
}, function()
  Chat.log(message.get())
end)
```

## Reload Scripts

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

The module appears under the Scripts category.

## Common Shape

```lua theme={null}
Script.meta({ name = "Name", description = "What it does." })

local enabled = Setting.bool("Enabled", {
  description = "Controls whether the script does work.",
  default = true
})

local function doWork()
  if not enabled.get() then return end
end

Script.on("tick", function()
  doWork()
end)

Script.on("disable", function()
  Script.stopAllTasks()
end)
```
