Как изменить язык sourcemod

SourceMod, так же как и его предшественник AMX Mod X, содержит встроенный Multi-Lingual Translation layer («ML»). Система ML является одной из дополнительных SourceMod систем, предназначенная для повышения гибкости платформы, насколько это возможно. Она полностью поддерживает UTF-8.

Введение

Система SourceMod ML базируется на следующих терминах:

• Языки: Предварительно заданные языки перевода устанавливаются в configslanguages.cfg. Если язык перевода отсутствует в этом файле, он не может быть переведен до тех пор, пока не будет добавлен в этот файл и обновлена кэш-память переводов.
• Фразы/Ключи перевода: Короткие, общие ключевые фразы, используемые для определения набора переводов. Они находятся в конфигурационных файлах в папке translations. Они называются файлы перевода.
• Переводы: Содержат фразы текста перевода для данного языка. Они находятся в файлах перевода.

Примечание: Переводы и Фразы, чувствительны к регистру.

Формат файла

Многоязычный формат файлов перевода содержится в стандартной конфигурационной форме от Valve. Она состоит из одного главного раздела, «Phrases», который содержит любое число имен подразделов. Каждый подраздел определяется одним именем Фразы, и не могут иметь в себе подразделы. Они обладают следующими свойствами:

• Ключ: «#format»
  • Значение: Разделенные запятыми, пары индексов и форматов
• Ключ: Двух символьный код языка.
  • Значение: Языковой перевод строки.

Пример:

"Phrases"
{
	"Welcome"
	{
		"en"		"Welcome to SourceMod"
		"ru"		"Добро пожаловать в SourceMod"
	}
}

В приведенном выше примере, два перевода определяется по имени фразы «Welcome» — одна для английского, и одна для русского языка. Вместе с тем, рассмотрим фразу, которая может вставлять определенные слова, как в этом примере:

"Phrases"
{
	"Pants"
	{
		"en"		"pants"
		"ru"		"трусы"
	}
	//НЕПРАВИЛЬНЫЙ ПРИМЕР: "Frenzzy трусы горят!"
	"OnFire_plural"
	{
		"en"		"%s's %s are on fire!"
		"ru"		"%s %s горят!"
	}
}

В приведенном Выше примере, порядок слов изменился. Фраза на английском вставляет объект первым, а фраза на русском предписывает объект вторым. На русском языке фраза должна выглядеть следующим образом: Трусы Frenzzy горят!. Это создает проблему для скриптов, которые всегда просматривают формат параметров в одном порядке. Чтобы решить эту проблему, было введено свойство #format. Оно предопределяет порядок формата параметров. Пример:

"Phrases"
{
	//Пример: "Трусы Frenzzy горят!"
	"OnFire_plural"
	{
		"#format"	"{1:s},{2:s}"
		"en"		"{1}'s {2} are on fire!"
		"ru"		"{2} {1} горят!"
	}
	//Пример: "Привет, Frenzzy!"
	"Hello"
	{
		"#format"	"{1:s}"
		"en"		"Hello, {1}"
		"ru"		"Привет, {1}"
	}
}

Формат строки состоит из разделов которые разделяются запятыми, а каждый раздел заключен в скобках. Каждый раздел имеет индекс и спецификатор формата, которые разделяются двоеточиями. Спецификаторы формата следуют общим правилам форматирования, однако в настоящее время, они поддерживаются только в следующих видах:

• d/i: Отображение десятичных/целых значений
• x: Отображение шестнадцатеричных значений
• f: Отображение числа с плавающей точкой
• s: Отображение строки
• c: Отображение символов (поддерживается UTF-8)

Заметим, что в настоящее время специальный формат типа «%T» не допускает внутри языка перевод строки.

Использование в плагине

Плагины должны вызывать функцию LoadTranslations на каждый файл с переводом, который они хотят использовать. Если это не будет сделано, то никакие переводы работать не будут, даже если другой плагин загрузил те же самые файлы. Это поможет предотвратить конфликты фраз между плагинами.

Примечание: языковые файлы загружаться после каждой смены карты (mapchange). Даже если плагин будет перезагружен, кэшированный перевод файлов остается до следующей карты.

Встроенный перевод работает в любых формат-классовых функциях. Вводится новый спецификатор формата ‘%T’, который указывает формат вставки определенного перевода фразы. В отличие от всех других спецификаторов формата, он требует как минимум двух параметров:

• 1-ый параметр: Строка, содержащая фразу для перевода.
• 2-ой параметр: Одно из следующих:
  • Постоянная LANG_SERVER, которая определяет язык перевода по умолчанию.
  • Константа player ID, которая определяет язык перевода установленный игроком.
• 3-ий параметр и больше: Вывод во фразе спецификаторов формата, если это необходимо.

Примерами являются:

new String:name[32], String:buffer[128];
GetClientName(client, name, sizeof(name));
PrintToChat(client, "[SourceMod] %T", "Hello", client, name);
Format(buffer, sizeof(buffer), "[SourceMod] %T", "Hello", LANG_SERVER, name);

Формат параметров в отдельности:

• «Hello»: Фраза для перевода.
• client/LANG_SERVER: Кто получит перевод фразы.
• name: The «Hello» phrase requires one string, so this will appear in the translated phrase.

Наконец, существует вторая форма однострочного перевода, используя ‘%t’. Она допускается только в функциях, которые действуют непосредственно на одного или нескольких клиентов. Она исключает второй параметр, и использует указанного клиента. Пример:

PrintToChat(client, "[SourceMod] %t", "Hello", name);

Как видно из этого примера, Мы не должны указывать индекс клиента больше, чем один раз. Таким образом, как правило, более удобны для использования ограниченные версии ‘%t’ в функциях, таких как PrintToChat. Однако, в функциях, которые не «управляют игроком», таких, как Format или PrintToServer, может быть использован только ‘%T’.

Настройка звука при нажатие в sourcemod меню на кнопки 

Настраивается в дополнительном конфигурационном файле addons/sourcemod/configs/core.cfg. 

Пример: sm_menu_sounds 1 (по стандарту)

Промежуток времени между различными голосованиями 

Пример: sm_vote_delay 30 (по стандарту)

Формат времени, который будет отображен игрокам на сервере. 

12-часовой формат %m/%d/%Y — %I%M%S %p 

Пример: sm_datetime_format «%m/%d/%Y — %H%M%S» (по стандарту)

Команда определяет как в Sourcemod’e должны определяться уровни иммунитета для администраторов. 

0) Игнорировать иммунитет уровней (за исключением определенной группы иммунитеты). 

1) Защита администраторов с высокими флагами доступа от более низких. 

2) Защищать админов от друг друга с равными флагами доступа. 

3) Тоже что и 2 пункт, но при этом администраторы без иммунитета могут влиять друг на друга. 

Пример: sm_immunity_mode 1 (по стандарту)

Команда корректирует системное время на сервере. (Значение либо 1, либо 2) 

Пример: sm_time_adjustment 0 (по стандарту)

Защита от флуда , при отправке сообщений чаще чем настройка sm_flood_time сообщения в чате игрока будут блокироваться. 

Пример: sm_flood_time 0.75 (по стандарту)

Настройка отвечает за зарезервированне слоты на сервере. К примеру значение 

0) При подключении игрока к резервному слоту, с сервера не будет не кто кикнут. 

1) При подключении к резервному слоту будет кикнут игрок, чей пинг больше всех или кто в спектаторах. 

Пример: sm_reserve_type 0 (по стандарту)

С помощью данной команды ,в зависимости от значения будут выделены количество N количество слотов на сервере. При значение например 2 будет зарезервированно 2 слота для админов с флагом доступа к зарезервированным слотам. 

Пример: sm_reserved_slots 0 (по стандарту)

Настройка отвечает за скрытность зарезервированных слотов от игроков , при значение 1 игроки будут видеть зарезервированные слоты. При значении 0 слоты просто будут спрятаны от игроков. 

Пример: sm_hide_slots 0 (по стандарту)

Команда определяет позволено ли простым игрокам отправлять администраторам сообщения. 

Например вот так say_team @<сообщение>. Допустимые значения 0 (Выключено) или 1 (Включено) 

Пример: sm_chat_mode 1 (по стандарту)

Настройка отвечает за отправку сообщений игроку сколько осталось времени до смены карты , время требуется указывать в секундах , при значение 0 настройка будет отключена. 

Пример: sm_timeleft_interval 0 (по стандарту)

Показывать сообщения запросов(тригеров) игроков всем или только тому, кто просил. 

1) Включить. 

Пример: sm_trigger_show 1 (по стандарту)

Настройка отображения прогресса голосования при значение 0 игроки не будут видеть прогресс голосования. 

Значение 1 — включено, 2 — отключено. 

Пример: sm_vote_progress_hintbox 0 (по стандарту)

Команда определяет, отображать ли игрокам прогресс голосования в Чате. 

Значение 1 — включено, 2 — отключено. 

Пример: sm_vote_progress_chat 0 (по стандарту)

Команда определяет, отображать ли игрокам прогресс голосования в Консоли сервера. 

Значение 1 — включено, 2 — отключено. 

Пример: sm_vote_progress_console 0 (по стандарту)

Команда определяет, отображать ли игрокам прогресс голосования в Консоли клиента. 

Значение 1 — включено, 2 — отключено. 

Пример: sm_vote_progress_client_console 0 (по стандарту)