Основным файлом настроек является файл
amxmodx/configs/plugins/VipModular/Vips.json.
Также, настройки привилегий можно хранить в нескольких файлах в папке
amxmodx/configs/plugins/VipModular/Vips/. Название файла любое, главное - расширение
.json. Структура та же.
Можно использовать любой из вариантов или оба сразу. Файл Vips.json читается в первую очередь, а какой-либо порядок чтения файлов из папки Vips не гарантируется.
Корневой массив
Элементами корневого массива являются обьекты, содержащие поля Access и Modules.
Поле Access должно содержать одну или более проверок, привязанных к игроку.
Если проверка одна, она может быть указана как обьект, вместо массива.
Может являться ссылкой на файл. Как массив, так и элементы массива.
Поле Modules содержит один или более модулей, которые будут выданы игроку, если он прошёл все проверки из поля Access.
Если модуль один, он может быть указан как обьект, вместо массива.
Может являться ссылкой на файл. Как массив, так и элементы массива.
Список доступных типов проверок может быть расширен специальными плагинами-расширениями с приставкой L.
Типы проверок деляться на две подгруппы: Привязанные к игрокам и свободные.
- Проверки, привязанные к игрокам не могут быть использованы в конфигах, не применяемых к игрокам, например, в глобальных настройках модулей.
- Свободные проверки могут использоваться в любых списках проверок.
Модули
Проверки - обьект, выдаваемый игроку и выполняющий при этом некоторые действия, определённые плагином-расширением.
Список доступных модулей может быть расширен специальными плагинами-расширениями с приставкой M.
<ModuleName> - название модуля. Определяется плагином-расширением, регистрирующим модуль.
<ParamX> - какой-либо параметр модуля. Названия и типы параметров определяются плагином-расширением, добавляющим модуль.
Настройка активности модулей
За настройку активации модулей отвечает плагин
VipM-ModulesLimiter. Если данные настройки не используются, его можно отключить, в таком случае все модули всегда будут активны.
Файл настроек активности модулей:
amxmodx/configs/plugins/VipModular/Modules.json.
Modules - список названий модулей, к которым будут применяться ограничения.
Limits - ограничения, применяемые для активации модуля.
Принцип работы
Попытка активации всех используемых модулей запускается после полной загрузки системы привилегий.
Если хоть одно ограничение из поля Limits выполняется, модули из поля Modules будут активны. Если модуль не упоминается в этом файле, он будет активен всегда.
Активируются только те модули, которые хотя бы раз встречаются в настройках привилегий