Плагин является мощным средством управления голосовым чатом на сервере с помощью кваров, админской затычки (Gag) и Mute для игроков.
Отличительные особенности плагина: широкие возможности настройки и объединение всех функций связанных с голосовым чатом в одном плагине с целью увеличения их производительности и согласованности.
Особенности:
возможность в Mute меню заглушать только мертвых игроков (чтобы не отвлекали еще живых)
данные о том кто к кому применил Mute сохраняются на время указанное в кваре gm_mute_data_storage_time
плагин поддерживает ReApi и автоматически определяет его наличие
возможность выбора голосовых каналов через меню (квар gm_voice_channel_menu)
возможность запретить админам снимать Gag, наложенный другим админом (квар gm_remove_only_own_gag)
консольная команда amx_gag, которая позволяет наложить Gag на играющих или отключившихся игроков из консоли сервера или админа (см. описание консольной команды amx_gag)
широкие возможности настройки с помощью кваров (см. квары)
возможность админам прослушивать весь чат всегда или будучи мертвым (квар gm_admin_listen_mode)
возможность задать время в течение которого можно дать инфу после смерти (квар gm_can_speak_after_death_delay)
функция Auto-Gag, которая ограничивает игроку доступ к голосовому чату, если против него написали /mute необходимое число человек
возможность настроить причины Gag'а (см. описание консольной команды gm_add_template)
возможность настроить сроки Gag'а (см. описание консольной команды gm_add_time)
данные Gag'а сохраняются в файл gag.vault по steamid и ip, также присутствует самоочистка от устаревших записей
имеется API для разработчиков (см gag_me.inc)
все квары и команды для удобства настраиваются в автоматически создаваемом конфигурационном файле 'addons/amxmodx/configs/gag_me.cfg'
автоматически создаваемый словарь мультиязычности 'addons/amxmodx/data/lang/gag_me.txt'
Настройки (из автоматически создаваемого конфигурационного файла 'gag_me.cfg'):
// Уровень дебаг-логов. 0 - отключено // По умолчанию: "0" gm_debug_level "0"
// Время в течении которого можно дать инфу после смерти. // Если условие в кваре 'gm_min_alive_players_listen_dead' выполняется, то игнорируется // По умолчанию: "5.0" gm_can_speak_after_death_delay "5.0"
// Минимальное количество живых игроков необходимое чтобы слышать мертвых // По умолчанию: "5" gm_min_alive_players_listen_dead "5"
// При значении 1 мертвые будут слышать мертвых игнорируя команду игрока, при 0 - будет зависеть от команды игрока и квара 'gm_player_listen_enemy' // По умолчанию: "1" gm_dead_listen_dead "1"
// При значении 1 игрок будет слышать врага, при 0 - не будет слышать (влияет квар 'gm_min_alive_players_listen_dead') // По умолчанию: "1" gm_player_listen_enemy "1"
// Значения: 1 - админа слышат все и он слышит всех, 2 - админа слышат все и он слышит всех если он мертв или в наблюдателях, 3 - если админ жив и имеются другие мертвые админы, то работает как режим 2, иначе как 1 // Если значение 0, то функция отключена // По умолчанию: "2" gm_admin_listen_mode "2"
// При значении 1 - отключается функциональность всех кваров в которых присутствует слово 'listen' // По умолчанию: "0" gm_ignore_listen_cvars "0"
// Отношение числа игроков, написавших /mute к общему числу игроков для срабатывания Auto-Gag // 0.3 - означает 30% от общего числа игроков присутствующих на сервере // Если значение 0, то функция отключена // По умолчанию: "0.3" gm_auto_gag_ratio "0.3"
// Промежуток времени (в секундах) между сообщениями, после истечения которого сообщение чата не считается флудом // При значении 0 функция отключена // По умолчанию: "1.8" gm_chat_flood_time "1.8"
// Максимальное количество предупреждений о флуде, после которых последует Auto-Gag // При значении 0 функция отключена // По умолчанию: "5" gm_chat_flood_max_warnings "5"
// Время (в секундах), через которое будут сброшены предупреждения о флуде чата, при условии что игрок не получил за это время доп. предупреждений // При значении 0 функция отключена // По умолчанию: "300.0" gm_chat_warnings_reset_time "300.0"
// Куда будут писаться логи: значение 0 - в стандартный лог AMX Mod X 'addons/amxmodx/logs', значение 1 - в подпапку 'addons/amxmodx/logs/gag_me' // По умолчанию: "1" gm_log_type "1"
// Время (в секундах), через которое заткнутый игрок снова сможет попросить прощения // По умолчанию: "60.0" gm_apologize_delay "60.0"
// RGB цвет и XY координаты HUD сообщения после смерти о том что живые больше не слышат мертвых // По умолчанию: "220 160 0 | -1.0 0.36" gm_after_death_hud_msg "220 160 0 | -1.0 0.36"
// RGB цвет и XY координаты HUD сообщения игроку о том что к нему применен Gag // По умолчанию: "220 50 50 | -1.0 0.36" gm_after_gag_hud_msg "220 50 50 | -1.0 0.36"
// Флаги доступа для игроков, которые будут обладать иммунитетом от Gag // По умолчанию: "a" gm_immunity_flags "a"
// Флаги доступа для админов, которые смогут использовать Gag меню // По умолчанию: "d" gm_access_flags "d"
// Флаги доступа для админов, которые смогут использовать Gag меню и применять Gag к игрокам с иммунитетом // По умолчанию: "l" gm_high_access_flags "l"
// Флаги доступа для игроков, которые смогут говорить в голосовой вип канал // По умолчанию: "t" gm_vip_flags "t"
// Флаги доступа для игроков, которые смогут использовать команду чата '/mute' // По умолчанию: "all" gm_mute_access_flags "all"
// Админы могут снимать только свой (1) или любой (0) Gag // По умолчанию: "1" gm_remove_only_own_gag "1"
// Время хранения данных (в секундах) о заткнутых игроках с помощью Gag (по умолчанию месяц) // Во избежание снятия гага, должно быть равно максимальному сроку // По умолчанию: "2592000" gm_data_storage_time "2592000"
// Время хранения данных (в секундах) о заткнутых игроках с помощью Mute (по умолчанию сутки) // По умолчанию: "86400" gm_mute_data_storage_time "86400"
// Определяет будут (1) или нет (0) заткнутые игроки слышать друг друга (общаться голосом в своем канале) // По умолчанию: "1" gm_gagged_hear_each_other "1"
// Путь к файлу звука (wav или mp3), который будет проигрываться игроку если у него нет доступа к микрофону, чату, при флуде. // Если квар пустой, то звук не проигрывается // По умолчанию: "buttons/button2.wav" gm_no_access_sound "buttons/button2.wav"
// Время (в секундах) через которое будет показано уведомление о возможности заткнуть игрока при условии что кто-то говорит в микрофон // По умолчанию: "60.0" gm_mute_advert_delay "60.0"
// Смогут (1) или нет (0) игроки использовать меню выбора голосового канала // По умолчанию: "0" gm_voice_channel_menu "0"
// Формат команды: gm_add_template "текст причины" ["тип Gag'а"] ["время в минутах"] ["текстовое обозначение"] // "текст причины" - обязательный параметр, отвечающий за причину Gag'а. Может быть задан в виде текста или // ключа словаря мультиязычности (multilang dictionary) // "тип Gag'а" - необязательный параметр, отвечающий за тип Gag'а, который будет автоматически подставляться // "время в минутах" - необязательный параметр, отвечающий за то, будет ли у причины фиксированное время (не нужно выбирать время вручную) // "текстовое обозначение" - необязательный параметр, отвечающий за текстовое обозначение параметра <время в минутах>. // Может быть задан в виде текста или ключа словаря мультиязычности (multilang dictionary) // Если не указан, то автоматически подставится значение из предыдущего параметра // Например: gm_add_template "Микрофон с 18 лет" "vc" "43200" "1 месяц"
// Формат команды: gm_add_time "время в минутах" "текстовое обозначение" // "текстовое обозначение" - обязательный параметр, отвечающий за текстовое обозначение параметра <время в минутах>. // Может быть задан в виде текста или ключа словаря мультиязычности (multilang dictionary)
gm_add_template "<текст причины>" ["<тип Gag'а>"] ["<время в минутах>"] ["<текстовое обозначение>"] - серверная команда для добавления причин Gag'а и создания шаблонов для автоматической подстановки параметров.
"текст причины" - обязательный параметр, отвечающий за причину Gag'а. Может быть задан в виде текста или ключа словаря мультиязычности (multilang dictionary)
тип Gag'а - необязательный параметр, отвечающий за тип Gag'а, который будет автоматически подставляться
время в минутах - необязательный параметр, отвечающий за то, будет ли у причины фиксированное время (не нужно выбирать время вручную в меню)
текстовое обозначение - необязательный параметр, отвечающий за текстовое обозначение параметра время в минутах. Может быть задан в виде текста или ключа словаря мультиязычности (multilang dictionary). Если не указан, то автоматически подставится значение из предыдущего параметра
gm_add_time "<время в минутах>" "<текстовое обозначение>" - серверная команда для добавления сроков Gag'а.
"время в минутах" - обязательный параметр, отвечающий за время Gag'а
"текстовое обозначение" - обязательный параметр, отвечающий за текстовое обозначение параметра <время в минутах>. Может быть задан в виде текста или ключа словаря мультиязычности (multilang dictionary)
Внимание: Добавленные причины и сроки не сохраняются, поэтому команды прописываются в gag_me.cfg и добавление происходит оттуда каждый раз автоматически.
amx_gag "" "<тип Gag'а>" "<время Gag'а в секундах>" "<причина Gag'а>" - консольная команда, которая применяет Gag и может быть вызвана как из консоли сервера, так и консоли игрока.
тип Gag'а - обязательный параметр, который указывает какие чаты будут заблокированы.
amx_ungag "" - консольная команда, которая снимает Gag и может быть вызвана как из консоли сервера, так и консоли игрока. Снять Gag можно по ip или steam_id, достаточно указать что-то одно, второй идентификатор плагин найдет самостоятельно.
в общем или командном чате: /mute [ник игрока | часть ника игрока | all] - команда чата, открывающая Mute меню и отключающая/включающая голос игрока/игроков. После команды через пробел можно указать: ник (или часть ника) - отключается/включается голос отдельного игрока, all - отключается/включается голос всех игроков
в общем или командном чате: /gag - команда чата, открывающая Gag меню
Допустимые значения для типа Gag'а: v - голосовой (от слова voice), c - текстовый (от слова chat), t - командный модификатор (от слова team). Для одновременной блокировки голосового и текстового чатов, необходимо указывать оба значения, например: vc. Для блокировки возможности общаться с командой противника используется командный модификатор (t) и соответствующее значение блокируемого чата.
Последние изменения от 23 ноя 2021 г.:
Добавлено:
добавлена поддержка возможности добавлять команды чата в список исключений, который будет работать в плагинах использующих Plugins Core pc_add_to_chat_white_list "text"
text - текст, который будет добавлен в список исключений чата
