F.A.Q. (Общая информация, Установка ядра, Установка модулей)

[R1KO]

1. Общая информация
   Плагин имеет модульную структуру. Это значит что основную работу выполняет ядро (Ссылка), а функционал выполняют модули (Ссылка).
   Ядро управляет всеми VIP-игроками, конфигами, базами данных, обрабатывает команды.
   
   На данный момент поддерживается 2 ветки плагина: версия 1.X.X и 3.X.X
   Версия 1.X.X работает с локальной базой KeyValues
   Версия 3.X.X работает с локальной базой SQL и удаленной базой MySQL
   
   
   Каждый модуль добавляет в систему свои возможности и имеет уникальное имя.
   Например, для модуля гравитации это "Gravity". Это значит что для доступа в группу нужно прописывать именно это имя (Если требуется), так же оно прописывается в файл перевода.
   Иногда этих имен может быть несколько либо вообще не быть (тогда модуль работает для всех VIP-игроков).
   
   Все файлы сохраняйте в кодировке UTF-8 Без BOM Редактором notepad++
   
2. Установка ядра
   1. Распаковать архив и раскидать файлы по папкам на сервере.
      
      Спойлер: Расположение файлов и их описание

      Путь: addons/sourcemod/data/vip/cfg/
      Файлы:
      users.ini - Файл с VIP-игроками
      groups.ini - Файл с VIP-группами
      times.ini - Файл с временем в админ-меню
      sort_menu.ini - Файл сортировки пунктов в VIP-меню
      
      Путь: addons/sourcemod/data/vip/info/
      Файлы:
      expired_info.txt - Файл с информацией о истекшем VIP-статусе
      no_access_info.txt - Файл с информацией об отсутствии VIP-статуса
      
      Путь: addons/sourcemod/data/vip/modules/
      Файлы:
      downloadlist.txt - Файл со списком файлов для загрузки клиентам.
      Конфиги модулей
      
      Путь: addons/sourcemod/plugins/vip/
      Файлы:
      VIP_Core.smx - Основной плагин-ядро.
      Модули.
      
      Путь: addons/sourcemod/scripting/include/
      Файлы:
      vip_core.inc - Библиотека для компиляции.
      
      Путь: addons/sourcemod/translations/
      Файлы:
      vip_core.phrases.txt - Файл перевода ядра.
      vip_modules.phrases.txt - Файл перевода модулей.
      
      Путь: cfg/vip/
      Файлы:
      vip_core.cfg - Файл с настройками ядра.
      Файлы с настройками модулей.
   2. Если хотите использовать MySQL базу, необходимо в databases.cfg прописать:
      
      "vip_core"
      {
          "driver"        "mysql"
          "host"            "ip"        // ip сервера где находится ваш mysql
          "database"        "vip"        // название базы данных
          "user"            "root"        // имя пользователя базы данных
          "pass"            "pass"        // пароль для этого пользователя
      }
      При использовании SQLite базы она будет храниться здесь: addons/sourcemod/data/sqlite/vip_core.sq3
   3. Настроить конфиг cfg/vip/VIP_Core.cfg
   4. Установить необходимые модули (см. пункт 3)
   5. Более глубокая и полная настройка:
      
      
      Спойлер: НАСТРОЙКА ИНФО

      Настраивается в addons/sourcemod/data/vip/info/:
      expired_info.txt - Файл с информацией о истекшем VIP-статусе
      no_access_info.txt - Файл с информацией об отсутствии VIP-статуса
      
      Зависит от sm_vip_info_show_mode
      Если равно 0:
      

      Вывод будет происходить построчно в чат.
      Цвета:
      {DEFAULT} - золотой
      {LIGHTGREEN} - салатовый
      {GREEN} - зеленый
      HTML цвета, например: #FFFFAA

      
      Если равно 1:
      

      Выводится будет построчно в меню.

      
      Если равно 2:
      

      Необходимо просто указывать ссылку на страницу, которую необходимо открыть.
      Например:
      http://mysite.com/vip_noaccess.html
      
      
      Спойлер: НАСТРОЙКА СОРТИРОВКИ МЕНЮ

      Настраивается в addons/sourcemod/data/vip/cfg/sort_menu.ini
      Вписываете в нужно порядке уникальные имена ф-й и подменю.
      Пример:
      

      HP
      Armor
      Money
      Speed

      Всё что не вписано в данный файл будет идти поле отсортированых пунктов в случайном порядке.
      
      
      Спойлер: Настройка groups.ini

      В группах секции отсутствуют.
      Каждый ключ – это имя группы.
      Параметры в ней такие же как и в индивидуальных правах.
      
      

      Спойлер: Пример groups.ini

      "VIP_GROUPS"
      {
          "vip1" // Имя группы
          {
              // Параметры
              "HP"            "120"    // Сколько хп будет при спавне
              "Armor"            "100"    // Сколько брони будет при спавне
              "Money"            "16000"    // Сколько денег будет при спавне
              "QuickDefuse"    "1"        // Включает опцию быстрого дефуза
              "Speed"            "1.3"    // Дает установленную скорость (1.0 - норма)
              "RegenHP"        "5"        // Сколько едениц хп в секунду будет восстанавливаться
              "RegenArmor"    "5"        // Сколько едениц брони в секунду будет восстанавливаться
          }
      
          "vip2" // Имя группы
          {
              // Параметры
              "HP"            "120"    // Сколько хп будет при спавне
              "Speed"            "1.3"    // Дает установленную скорость (1.0 - норма)
              "RegenHP"        "5"        // Сколько едениц хп в секунду будет восстанавливаться
              "RegenArmor"    "5"        // Сколько едениц брони в секунду будет восстанавливаться
          }
      }
      
      
      Спойлер: Пример times.ini

      "TIMES"
      {
          "0"    // Время в секундах
          {
              "ru"    "Навсегда"    // Отображение в меню
              "en"    "Permanent"    // Отображение в меню
          }
      
          "3600"    // Время в секундах
          {
              "ru"    "1 Час"    // Отображение в меню
          }
      
          "86400"    // Время в секундах
          {
              "ru"    "1 Сутки"    // Отображение в меню
          }
      
          "604800"    // Время в секундах
          {
              "ru"    "1 Неделя"    // Отображение в меню
          }
      
          "2592000"    // Время в секундах
          {
              "ru"    "1 Месяц"    // Отображение в меню
          }
      
          "15552000"    // Время в секундах
          {
              "ru"    "6 Месяцев"    // Отображение в меню
          }
      }
      
      
      Спойлер: Сортировки пунктов админ меню

      Для сортировки пунктов админ меню в addons/sourcemod/configs/adminmenu_sorting.txt добавьте
      

          "vip_admin"
          {
              "item"        "add_vip"
              "item"        "edit_vip"
              "item"        "del_vip"
              "item"        "list_vip"
              "item"        "reload_vip_players"
              "item"        "reload_vip_cfg"
          }
3. Установка модулей
   1. Распаковать архив и разложить файлы по папкам на сервере.
   2. Дописать фразы в файл перевода модулей addons/sourcemod/translations/vip_modules.phrases.txt (Написано в описании к каждому модулю. Если отсутствует - пропустите этот пункт)
   3. Настроить конфиг модуля. Находится addons/sourcemod/data/vip/modules/ (Написано в описании к каждому модулю. Если отсутствует - пропустите этот пункт)
   4. Прописать нужным VIP-группам параметры, которые добавляет модуль. Находится addons/sourcemod/data/vip/cfg/groups.ini (Написано в описании к каждому модулю. Если отсутствует - пропустите этот пункт)
   5. После запуска модуля, будет создан конфиг. Находится cfg/vip/ (Написано в описании к каждому модулю. Если отсутствует - пропустите этот пункт)
   СПИСОК МОДУЛЕЙ

 

[R1KO]

Пример установки модуля:
Установим модуль Модуль плагина - [VIP] Respawn
Установка

1. Распаковываем архив и разкладываем файлы по папкам на сервере.
2. Дописывем фразы в файл перевода модулей addons/sourcemod/translations/vip_modules.phrases.txt
   
   
   
   Добавляем:
   
   
3. Настроить конфиг модуля - Пропускаем.
4. Прописать нужным VIP-группам параметры, которые добавляет модуль:
   
   
   
   Добавляем:
   
   
5. После запуска модуля, будет создан конфиг.- Пропускаем.