> ## Documentation Index
> Fetch the complete documentation index at: https://cs-lua.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# timer — Именованные

> Адресуются по имени, уникальному внутри плагина

# Именованные

Адресуются по имени, уникальному внутри плагина.

<h2 id="create">
  timer.create
</h2>

Заводит именованный таймер; повторный вызов заменяет старый.

```lua theme={null}
timer.create(name, seconds, fn[, opts])
```

### Аргументы

| # | имя       | тип          |                                   |
| - | --------- | ------------ | --------------------------------- |
| 1 | `name`    | string       | уникален внутри этого плагина     |
| 2 | `seconds` | number       | интервал, должен быть больше нуля |
| 3 | `fn`      | function     | обработчик                        |
| 4 | `opts`    | table \| nil | см. [Опции](#create-опции)        |

### Возвращает

Ничего.

<h3 id="create-опции">
  Опции
</h3>

| поле      | тип     |                                             |
| --------- | ------- | ------------------------------------------- |
| `once`    | boolean | сработать один раз вместо повтора           |
| `persist` | boolean | переживать смену карты; по умолчанию `true` |

### Пример

```lua theme={null}
timer.create("ads.chat", 60, show_message)
```

Замена вместо добавления — это то, что нужно таймеру, который заводится в теле
плагина: `lua_reload <plugin>` выполнит эту строку второй раз и не оставит
второй таймер.

### Смотри также

* [timer.destroy](named.md#destroy)

<h2 id="destroy">
  timer.destroy
</h2>

Снимает именованный таймер этого плагина.

```lua theme={null}
timer.destroy(name)
```

### Аргументы

| # | имя    | тип    |                            |
| - | ------ | ------ | -------------------------- |
| 1 | `name` | string | имя, под которым он создан |

### Возвращает

| тип       |                               |
| --------- | ----------------------------- |
| `boolean` | `true`, если такой таймер был |