Initial commit: arcane-advertisement plugin with documentation and config

2026-05-01 06:57:30 +03:00
commit d86431a40c
3 changed files with 644 additions and 0 deletions
@@ -0,0 +1,105 @@
+# ARCANEGAME Advertisement
+
+Плагин рекламных объявлений для CS:GO серверов на SourceMod. Показывает объявления в чат, по центру экрана, в hint-блоке и HUD.
+
+## Функции
+
+- Периодический показ объявлений по таймеру (настраиваемый интервал)
+- Поддержка 4 каналов вывода: **Chat**, **Center**, **Alert (hint)**, **HUD**
+- До **128 объявлений** в очереди, показ по кругу
+- Поддержка **цветовых тегов** в чате: `{GREEN}`, `{RED}`, `{BLUE}`, `{OLIVE}` и др.
+- Поддержка **информационных тегов**: `{MAP}`, `{NEXTMAP}`, `{PL}`, `{TIME}`, `{DATE}`, `{IP:PORT}`, `{TIMELEFT}`, `{SERVERNAME}`, `{TIC}`, `{ADMINSONLINE1}`, `{ADMINSONLINE2}`
+- Красивые названия карт через словарь `Названия карт`
+- Живая перезагрузка конфига без рестарта
+
+## Зависимости
+
+- [SourceMod](https://www.sourcemod.net/) 1.10+
+- [mapchooser](https://wiki.alliedmods.net/Mapchooser_%28SourceMod%29) или nextmap (только для тега `{NEXTMAP}`)
+
+## Установка
+
+1. Скомпилировать `scripting/arcane_advertisement.sp`
+2. Положить `.smx` в `addons/sourcemod/plugins/`
+3. Положить `configs/reklama.ini` в `addons/sourcemod/configs/`
+4. Перезапустить сервер или загрузить плагин: `sm plugins load arcane_advertisement`
+
+## Конфиг
+
+Путь: `addons/sourcemod/configs/reklama.ini`
+
+```
+"Реклама"
+{
+    "Таймер объявлений"    "25"
+
+    "Названия карт"
+    {
+        "de_dust2"    "Dust II"
+        "de_mirage"   "Mirage"
+    }
+
+    "Список объявлений"
+    {
+        "1"
+        {
+            "Chat"    "{GREEN}[ARCANEGAME]{DEFAULT} Добро пожаловать на сервер!"
+            "Center"  "Добро пожаловать!"
+        }
+        "2"
+        {
+            "Chat"    "{GREEN}[INFO]{DEFAULT} Карта: {MAP} | Игроков: {PL}"
+        }
+        "3"
+        {
+            "HUD"
+            {
+                "text"      "arcanegame.ru | {MAP}"
+                "x"         "-1.0"
+                "y"         "0.85"
+                "color"     "0 255 100 200"
+                "holdTime"  "25"
+            }
+        }
+    }
+}
+```
+
+## Цветовые теги (только для поля `Chat`)
+
+| Тег | Цвет |
+|---|---|
+| `{DEFAULT}` | Белый |
+| `{GREEN}` | Зелёный |
+| `{RED}` | Красный |
+| `{BLUE}` | Синий |
+| `{OLIVE}` | Оливковый |
+| `{PURPLE}` | Фиолетовый |
+| `{GRAY}` | Серый |
+| `{LIME}` | Лаймовый |
+
+## Информационные теги
+
+| Тег | Значение |
+|---|---|
+| `{MAP}` | Текущая карта (с учётом словаря) |
+| `{NEXTMAP}` | Следующая карта |
+| `{PL}` | Количество живых игроков |
+| `{TIME}` | Текущее время `HH:MM:SS` |
+| `{DATE}` | Текущая дата `DD.MM.YYYY` |
+| `{IP:PORT}` | IP и порт сервера |
+| `{TIMELEFT}` | Оставшееся время карты |
+| `{SERVERNAME}` | Имя сервера (hostname) |
+| `{TIC}` | Тикрейт сервера |
+| `{ADMINSONLINE1}` | Онлайн-админы через запятую |
+| `{ADMINSONLINE2}` | Онлайн-админы каждый с новой строки |
+
+## Команды
+
+| Команда | Доступ | Описание |
+|---|---|---|
+| `sm_reklama_reload` | Root | Перезагрузить конфиг рекламы |
+
+## Версия
+
+`1.0.0` — Автор: deidara