Plugins Manager 1.0.0
Автор: Radius
Описание:
Позволяет управлять списками плагинов прямо из консоли сервера или игрока. Пригодится в случаях когда нет возможности воспользоваться FTP.
Ускоряет работу скриптерам, избавляя от необходимости через FTP постоянно включать одни плагины и отключать другие. Имеет возможность создавать/удалять, включать/отключать, изменять списки плагинов в ручном режиме или в виде скриптов из команд (в том числе через rcon)
Особенности:
- возможность создавать/удалять plugins-*.ini файлы(см pm_set_ini и pm_rem_ini)
- возможность включать/отключать plugins-*.ini файлы(см pm_enable_ini и pm_disable_ini)
- возможность вывода в консоль содержимое текущего *.ini файла с широкими возможностями настройки (см pm_print)
- возможность просмотра списка плагинов в *.ini файле с широкими возможностями фильтрации (см pm_list)
- возможность добавить плагин в текущий список с широкими возможностями настройки (см pm_add)
- возможность удалить плагин по его имени или номеру позиции(см pm_remove)
- возможность включить плагин по его имени или номеру позиции(см pm_enable)
- возможность отключить плагин по его имени или номеру позиции(см pm_disable)
- возможность задать/удалить тег у плагина по его имени или номеру позиции(см pm_set_tag)
- возможность закомментировать (отключить) плагин (см pm_comment)
- возможность добавить/удалить комментарий с широкими возможностями настройки (см pm_add_comment и pm_rem_comment)
- команды поддерживают множественный wildcard * (в описании которых это указано)
- все квары и команды для удобства настраиваются в автоматически создаваемом конфигурационном файле 'addons/amxmodx/configs/plugins_manager.cfg'
Требования:
Настройки (из автоматически создаваемого конфигурационного файла 'plugins_manager.cfg'):
// pm_update_config - обновить (1) или нет (0) данный файл при смене карты
// Внимание: Текущие значения кваров (кроме команд), запишутся в обновленный файл
// Квар со значением 1 прописывается в консоли сервера
// После обновления квар сам вернется в значение 0
// Уровень логов
// 0 - выключено (OFF)
// 1 - предупреждения (WARN)
// 2 - информация (INFO)
// 3 - отладочная информация (DEBUG)
// 4 - подробная отладочная информация (TRACE)
// По умолчанию: "2"
pm_log_level "2"
// pm_set_ini - консольная команда, которая задает текущий *.ini файл со списком
// плагинов
// По умолчанию: 'addons/amxmodx/configs/plugins.ini' (зависит от значения
// amxx_plugins в core.ini)
// Формат команды:
// pm_set_ini ["filename"]
// filename - необязательный аргумент, в котором указывается путь к *.ini файлу
// относительно amxx_configsdir в core.ini. Если аргумент не задан или имеет
// пустое значение, то выставляется значение по умолчанию
// Внимание: Если файл не существует, то он создается автоматически
// pm_rem_ini - консольная команда, которая удаляет *.ini файл со списком
// плагинов
// Формат команды:
// pm_rem_ini "filename"
// filename - обязательный аргумент, в котором указывается путь к *.ini файлу
// относительно amxx_configsdir в core.ini
// pm_enable_ini - консольная команда, которая включает, ранее отключенный,
// *.ini файл со списком плагинов
// Формат команды:
// pm_enable_ini "filename"
// filename - обязательный аргумент, в котором указывается путь к *.ini файлу
// относительно amxx_configsdir в core.ini. Если файл не расположен в какой-то
// подпапке, то префикс 'plugins-' и расширение '.ini' можно не указывать
// Например: Если файл plugins-aes.ini, то можно указывать просто aes
// pm_disable_ini - консольная команда, которая отключает *.ini файл со списком
// плагинов, добавляя к имени префикс 'disabled_'
// Формат команды:
// pm_disable_ini "filename"
// filename - обязательный аргумент, в котором указывается путь к *.ini файлу
// относительно amxx_configsdir в core.ini. Если файл не расположен в какой-то
// подпапке, то префикс 'disabled_plugins-' и расширение '.ini' можно
// не указывать
// Например: Если файл disabled_plugins-aes.ini, то можно указывать просто aes
// pm_print - консольная команда, которая выводит в консоль содержимое текущего
// *.ini файла в соответствии с заданными условиями
// Формат команды:
// pm_print ["start_pos"] ["lines_num"]
// start_pos - необязательный аргумент, отвечающий за стартовую позицию вывода
// файла. Если аргумент не задан или имеет пустое значение, то стартовая
// позиция совпадает с началом файла.
// В качестве стартовой позиции может быть:
// номер строки - цифра начиная с 1
// процент от общего числа строк - цифра от 1 до 100 со знаком процента
// текст строки с поддержкой wildcard *
// Если номер строки или процент указать со знаком минус, то отсчет идет
// с конца файла в начало
// lines_num - необязательный аргумент, в котором указывается количество
// выводимых строк. Если аргумент не задан или имеет пустое значение, то
// вывод осуществляется до конца файла.
// Если количество указать со знаком минус, то выводятся строки не под
// стартовой позицией, а над ней
// pm_list - консольная команда, которая выводит список плагинов отвечающих
// заданным условиям
// Формат команды:
// pm_list ["filter_or_pos_number"] ["tag_filter"]
// filter_or_pos_number - необязательный аргумент, в котором указывается
// текст (с поддержкой wildcard *) или номер позиции плагина в качестве фильтра
// tag_filter - необязательный аргумент, в котором указывается тег плагина
// в качестве фильтра.
// Допустимые значения:
// debug - плагины запущенные в дебаг режиме
// disabled - отключенные плагины
// pm_add - консольная команда, которая добавляет плагин в текущий список
// плагинов в соответствии с заданными условиями
// Формат команды:
// pm_add "filename+" ["insert_pos"] ["filename_or_pos_number"]
// filename+ - обязательный аргумент, в котором указывается имя плагина
// вместе с расширением '.amxx' и опционально: тег и/или комментарий
// insert_pos - необязательный аргумент, который задает позицию вставки
// плагина. Если аргумент не задан или имеет пустое значение, то end
// используется в качестве значения по умолчанию.
// Допустимые значения:
// start - добавить в начало файла
// end - добавить в конец файла
// before - вставить перед плагином (выше)
// after - вставить после плагина (ниже)
// Внимание: Для значений before, after плагин указывается в аргументе
// filename_or_pos_number
// filename_or_pos_number - необязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list)
// Внимание: Используется только для insert_pos со значениями before и
// after
// pm_remove - консольная команда, которая удаляет плагин из текущего списка
// плагинов в соответствии с заданными условиями
// Формат команды:
// pm_remove "filename_or_pos_number"
// filename_or_pos_number - обязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list).
// Также можно удалять отключенные и закомментированные плагины
// pm_enable - консольная команда, которая включает отключенный плагин в текущем
// списке плагинов в соответствии с заданными условиями. Под отключенным
// понимается закомментированный плагин или плагин с тегом 'disabled'
// Формат команды:
// pm_enable "filename_or_pos_number"
// filename_or_pos_number - обязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list)
// pm_disable - консольная команда, которая отключает включенный плагин в текущем
// списке плагинов в соответствии с заданными условиями. Под включенным
// понимается незакомментированный плагин без тега 'disabled'
// Формат команды:
// pm_disable "filename_or_pos_number"
// filename_or_pos_number - обязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list)
// pm_set_tag - консольная команда, которая задает/удаляет тег у плагина
// отвечающего заданным условиям
// Формат команды:
// pm_set_tag "filename_or_pos_number" ["tag"]
// filename_or_pos_number - обязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list)
// tag - необязательный аргумент, в котором указывается тег плагина. Если
// аргумент не задан или имеет пустое значение, то тег удаляется.
// Допустимые значения:
// debug - запускает плагин в дебаг режиме
// disabled - отключает плагин
// pm_comment - консольная команда, которая позволяет закомментировать плагин
// Формат команды:
// pm_comment "filename_or_pos_number"
// filename_or_pos_number - обязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list)
// pm_add_comment - консольная команда, которая добавляет комментарий в
// соответствии с заданными условиями
// Формат команды:
// pm_add_comment "comment_text" ["comment_pos"] ["filename_or_pos_number"]
// comment_text - обязательный аргумент, в котором указывается текст
// комментария
// Внимание: Комментарий может быть мультистрочным. Используйте '^n' для
// указания конца строки. Символ комментария ';' добавляется в начало каждой.
// строки автоматически, включая первую строку.
// comment_pos - необязательный аргумент, который задает позицию вставки
// комментария. Если аргумент не задан или имеет пустое значение, то end
// используется в качестве значения по умолчанию.
// Допустимые значения:
// start - добавить в начало файла
// end - добавить в конец файла
// inline - добавить в конец строки c плагином
// before - вставить перед плагином (выше)
// after - вставить после плагина (ниже)
// Внимание: Для значений inline, before, after плагин указывается в аргументе
// filename_or_pos_number
// filename_or_pos_number - необязательный аргумент, в котором указывается
// имя плагина (с поддержкой wildcard *) или номер его позиции (см pm_list)
// Внимание: Используется только для comment_pos со значениями inline, before,
// after
// pm_rem_comment - консольная команда, которая удаляет комментарий из строки.
// Под комментарием понимается любой текст после символа ';'
// Формат команды:
// pm_rem_comment "search_line"
// search_line - обязательный аргумент, в котором указывается искомая строка
// с комментарием (с поддержкой wildcard *). Поиск производится по всей строке,
// включая имя плагина и его тег
// Внимание: Если аргумент содержит символ ';', то его необходимо заключить
// в двойные кавычки
// Внимание: Если строка начинается с символа комментария ';', то она удаляется
Последняя версия 1.0.0 (30 июл 2024г):