deidara
89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
# VIP Custom Models
|
|
|
|
Плагин VIP-моделей игроков для CS:GO серверов на SourceMod. Позволяет VIP-игрокам выбирать кастомные скины (агентов) через меню — выбор сохраняется через ClientPrefs и SQLite.
|
|
|
|
## Функции
|
|
|
|
- До **128 кастомных моделей** из конфига
|
|
- Ограничение по **команде** (T / CT / любая)
|
|
- Ограничение по **VIP-группе** (через VIP Core API)
|
|
- Сохранение выбора через **ClientPrefs** (cookies) и **SQLite** (storage-local)
|
|
- Автоматическое применение модели при спавне и смене команды
|
|
- Корректное восстановление **стандартных рук** при сбросе модели
|
|
- Умная загрузка файлов модели: `.mdl`, `.vvd`, `.dx90.vtx` и сопутствующие
|
|
- Поддержка блочного и строкового форматов списка downloads
|
|
- Интеграция с VIP-меню через `VIP_RegisterFeature`
|
|
|
|
## Зависимости
|
|
|
|
- [SourceMod](https://www.sourcemod.net/) 1.10+
|
|
- [ClientPrefs](https://wiki.alliedmods.net/Client_Preferences_%28SourceMod%29) (входит в SourceMod)
|
|
- [VIP Core](https://github.com/R1KO/VIP-Core) — плагин VIP-системы
|
|
|
|
## Установка
|
|
|
|
1. Скомпилировать `scripting/vip_custom_models.sp`
|
|
2. Положить `.smx` в `addons/sourcemod/plugins/`
|
|
3. Положить `configs/vip_custom_models.ini` в `addons/sourcemod/configs/`
|
|
4. Загрузить модели на сервер (в папку `models/`)
|
|
5. Перезапустить сервер или загрузить плагин: `sm plugins load vip_custom_models`
|
|
|
|
## Конфиг
|
|
|
|
Путь: `addons/sourcemod/configs/vip_custom_models.ini`
|
|
|
|
```
|
|
"VIP_CustomModels"
|
|
{
|
|
"Models"
|
|
{
|
|
"agent_01"
|
|
{
|
|
"name" "FBI Agent"
|
|
"model" "models/player/custom/fbi_agent.mdl"
|
|
"arms" "models/weapons/ct_arms_fbi_custom.mdl"
|
|
"team" "CT"
|
|
"groups" "*"
|
|
"downloads" "models/player/custom/fbi_agent.mdl;models/player/custom/fbi_agent.vvd"
|
|
}
|
|
"agent_02"
|
|
{
|
|
"name" "Elite Crew"
|
|
"model" "models/player/custom/elite_crew.mdl"
|
|
"arms" ""
|
|
"team" "T"
|
|
"groups" "VIP;PREMIUM"
|
|
"downloads"
|
|
{
|
|
"1" "models/player/custom/elite_crew.mdl"
|
|
"2" "models/player/custom/elite_crew.vvd"
|
|
"3" "models/player/custom/elite_crew.dx90.vtx"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Поля модели
|
|
|
|
| Поле | Описание |
|
|
|---|---|
|
|
| `name` | Отображаемое имя в меню |
|
|
| `model` | Путь к `.mdl` файлу |
|
|
| `arms` | Путь к модели рук (оставить пустым для стандартных) |
|
|
| `team` | `T`, `CT` или `ANY` |
|
|
| `groups` | VIP-группы через `;` или `*` для всех |
|
|
| `downloads` | Файлы для скачивания клиентами (строка через `;` или блок) |
|
|
|
|
## Команды
|
|
|
|
| Команда | Доступ | Описание |
|
|
|---|---|---|
|
|
| `!vmodel` / `sm_vmodel` | VIP | Открыть меню выбора модели |
|
|
| `!models` / `sm_models` | VIP | Открыть меню выбора модели |
|
|
| `!agents` / `sm_agents` | VIP | Открыть меню выбора модели |
|
|
|
|
## Версия
|
|
|
|
`1.2.0` — Автор: OpenAI
|