Initial commit: arcane-round-end-music plugin with documentation and config

2026-05-01 06:57:29 +03:00
commit 26b2bc3b48
3 changed files with 513 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Arcane Round End Music
+
+Плагин для воспроизведения музыки в конце раунда на CS:GO серверах с SourceMod.
+
+## Функции
+
+- Музыка играет автоматически в конце каждого раунда
+- Каждый игрок может **включить/выключить** музыку персонально
+- Регулировка **громкости** от 0% до 100% (шаг 10%)
+- Настройки сохраняются через **ClientPrefs** (cookies)
+- Поддержка до **128 треков**, воспроизведение по очереди
+
+## Зависимости
+
+- [SourceMod](https://www.sourcemod.net/) 1.10+
+- [ClientPrefs](https://wiki.alliedmods.net/Client_Preferences_%28SourceMod%29) (входит в SourceMod)
+
+## Установка
+
+1. Скомпилировать `scripting/arcane_round_end_music.sp`
+2. Положить `.smx` в `addons/sourcemod/plugins/`
+3. Положить `configs/arcane_round_end_music.cfg` в `addons/sourcemod/configs/`
+4. Загрузить аудиофайлы в `sound/arcanegame/music/` на сервере
+5. Прописать треки в конфиге
+6. Перезапустить сервер или загрузить плагин: `sm plugins load arcane_round_end_music`
+
+## Конфиг
+
+Путь: `addons/sourcemod/configs/arcane_round_end_music.cfg`
+
+```
+"RoundEndMusic"
+{
+    "songs"
+    {
+        "1"
+        {
+            "title"    "Название трека"
+            "file"     "arcanegame/music/track.mp3"
+        }
+    }
+}
+```
+
+> Путь к файлу указывается **относительно папки `sound/`**, без неё.
+
+## Команды
+
+| Команда | Доступ | Описание |
+|---|---|---|
+| `!res` / `sm_res` | Все игроки | Открыть меню управления музыкой |
+| `sm_res_reload` | Admin (generic) | Перезагрузить список треков из конфига |
+| `sm_res_test` | Admin (generic) | Воспроизвести тестовый трек |
+
+## Версия
+
+`1.3` — Автор: Codex