Initial commit: vip-custom-models plugin with documentation and config

2026-05-01 06:57:32 +03:00
commit 41307dbf82
3 changed files with 137 additions and 0 deletions
@@ -0,0 +1,88 @@
+# 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