Перейти к основному контенту

Многоязычная поддержка

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


1. Включение многоязычной поддержки

Чтобы включить многоязычную поддержку, отредактируйте файл customs.properties и установите:

MultiLangEnable = True

Также убедитесь, что вы определили язык по умолчанию для вашего сервера:

MultiLangDefault = en
  • Использует коды языков ISO 639
  • По умолчанию en (Английский)

Затем укажите, какие языки разрешены:

MultiLangAllowed = en,es,pt,ru

2. Локализация диалогов

Конфигурация

Локализация диалогов включается автоматически, когда MultiLangEnable = True.

Как добавить переведенные диалоги

  1. Перейдите в ваш Datapack проект
  2. Следуйте по этому пути:
data/lang/<ISO 639 code>/data/html/
  1. Добавьте ваш переведенный файл с тем же именем, что и оригинальный файл

Пример

Путь:

data/lang/ru/data/html/noquest.htm

Содержание:

<html>
<body>
Вы не выполняете квест, связанный с этим NPC, или не соответствуете минимальным требованиям.
</body>
</html>

3. Переключение языка в игре

Чтобы позволить игрокам менять язык в игре, включите обработчик языка:

MultiLangHandler = True

После включения игроки могут использовать голосовую команду:

.lang

Это откроет меню, где они могут выбрать предпочитаемый язык.


4. Локализация системных сообщений

Конфигурация

Включите локализацию системных сообщений:

MultiLangSystemMessageEnable = True
MultiLangSystemMessageAllowed = en,es,pt,ru

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

  1. Перейдите в ваш Datapack проект
  2. Следуйте по этому пути:
data/lang/<ISO 639 code>/sm/
  1. Добавьте файл с именем:
SystemMessageLocalisation.xml

Пример

Путь:

data/lang/ru/sm/SystemMessageLocalisation.xml

Содержание:

<?xml version="1.0" encoding="UTF-8"?>
<list xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../../../xsd/SystemMessageLocalisation.xsd">
<sm id="0" text="Вы были отключены от сервера." />
<sm id="1" text="Сервер выключится через $s1 секунд(ы). Пожалуйста, найдите безопасное место для выхода." />
</list>

5. Локализация строк NPC

Конфигурация

Включите локализацию строк NPC:

MultiLangNpcStringEnable = True
MultiLangNpcStringAllowed = en,es,pt,ru

Как добавить переведенные строки NPC

  1. Перейдите в ваш Datapack проект
  2. Следуйте по этому пути:
data/lang/<ISO 639 code>/ns/
  1. Добавьте файл с именем:
NpcStringLocalisation.xml

Пример

Путь:

data/lang/ru/ns/NpcStringLocalisation.xml

Содержание:

<?xml version="1.0" encoding="UTF-8"?>
<list xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../../../xsd/NpcStringLocalisation.xsd">
<ns id="1010221" text="Черная луна... Теперь ты понимаешь, что она открыла глаза?" />
<ns id="1010222" text="Собираются кровавые облака. Скоро начнется дождь. Дождь из алой крови..." />
<ns id="1010223" text="Пока бессмысленный свет спит, тьма проснется первой. Хммм..." />
</list>