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

# res

> Прекеш ресурсов карты

# res

Прекеш ресурсов карты.

Ресурсы объявляются один раз в теле плагина — модуль проигрывает список на
каждой карте сам, поэтому таймингов прекеша здесь нет.

<h2 id="sound">
  res.sound
</h2>

Регистрирует звук для прекеша.

```lua theme={null}
res.sound(path)
```

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

| # | имя    | тип    |                          |
| - | ------ | ------ | ------------------------ |
| 1 | `path` | string | путь от `cstrike/sound/` |

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

Ничего.

### Пример

```lua theme={null}
res.sound("items/9mmclip1.wav")
```

### Лимит 512 слотов

У GoldSrc жёсткий предел: 512 слотов на звуки и 512 на модели. Переполнение не
возвращает ошибку — движок падает с `Host_Error`, и сервер умирает.

Модуль считает занятые слоты и отказывает **до** переполнения: ресурс не
прекешится, плагин-виновник отключается, его хендлеры и таймеры снимаются, в
`lua_list` он помечается `[FAILED]`. Сервер продолжает работать.

Запас смотрится через [`lua_precache`](../console.md).

<Warning>
  Движок принимает прекеш только в момент загрузки карты, поэтому
  вызов идёт в теле плагина, а не в обработчике. Вызов при уже
  загруженной карте запоминает ресурс и вводит его со следующей.
</Warning>

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

* [p:play\_sound](../players/messages.md#play_sound)

<h2 id="model">
  res.model
</h2>

Регистрирует модель для прекеша.

```lua theme={null}
res.model(path)
```

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

| # | имя    | тип    |                    |
| - | ------ | ------ | ------------------ |
| 1 | `path` | string | путь от `cstrike/` |

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

Ничего.

### Пример

```lua theme={null}
res.model("models/w_backpack.mdl")
```

### Лимит 512 слотов

У GoldSrc жёсткий предел: 512 слотов на звуки и 512 на модели. Переполнение не
возвращает ошибку — движок падает с `Host_Error`, и сервер умирает.

Модуль считает занятые слоты и отказывает **до** переполнения: ресурс не
прекешится, плагин-виновник отключается, его хендлеры и таймеры снимаются, в
`lua_list` он помечается `[FAILED]`. Сервер продолжает работать.

Запас смотрится через [`lua_precache`](../console.md).

<Warning>
  Движок принимает прекеш только в момент загрузки карты, поэтому
  вызов идёт в теле плагина, а не в обработчике. Вызов при уже
  загруженной карте запоминает ресурс и вводит его со следующей.
</Warning>

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

* [e:model](../ents/entity.md#model)