Локализация

Языковые файлы — это те же JSON, только значения в них показываются игроку: чат, уведомления, подписи в интерфейсе. Клиент Раст сообщает серверу свой язык. Плагин отдаёт файл из папки с этим кодом. Нет файла — игрок видит английский en.

Отдельный перевод нужен, если на сервер заходят не только с русским клиентом. Один русский файл не заменит en: английский клиент его не откроет.

Где лежат

server/server1/oxide/lang
├── en
│   └── Vanish.json
└── ru
    └── Vanish.json

Папка называется кодом языка: en, ru, uk, fr. Файл внутри называется как плагин. Чужой плагин не дописывают в Vanish.json.

У Vanish после установки обычно есть только en. Создайте рядом папку ru и скопируйте туда тот же файл, если хотите русский текст. Пустую папку без JSON плагин не видит.

Что можно менять

Укороченный пример английского файла:

{
  "VanishCommand": "vanish",
  "Vanished": "Vanish: <color=orange>Enabled</color>",
  "Reappear": "Vanish: <color=orange>Disabled</color>",
  "NoPerms": "You do not have permission to do this",
  "NoPlayers": "No players found using id: {0}"
}

Ключ слева не трогают. "VanishCommand" плагин ищет в коде. Поменяете ключ — фраза пропадёт, и в чат уйдёт сам ключ или пустая строка.

Значение справа можно перевести:

"NoPerms": "Недостаточно прав",
"Vanished": "Невидимость: <color=#ff6600>включена</color>"

Сохраните и выполните o.reload Vanish. Смотреть результат нужно клиентом того языка, чей файл вы правили. Русский клиент не покажет правку из папки en.

Подстановки

{0}, {1}, {2} — места, куда плагин вставит данные в момент показа. Номер задаёт автор, не вы.

"NoPlayers": "Игрок с id {0} не найден"

Если {0} был SteamID, в чате будет этот SteamID. Порядок слов в фразе менять можно, номера — нет. {2} без {0} и {1} в строке, где автор передаёт только два значения, выведет мусор или саму скобку. Не придумывайте новые номера и не удаляйте те, что уже стоят в тексте, если не понимаете, какое значение в них приезжает.

Разметка чата

В строке работают теги клиента Раст. Их пишут прямо в JSON, кавычки JSON при этом обычные двойные.

{
  "A": "<color=red>Красный текст</color>",
  "B": "<color=#ff6600>Тот же рыжий, но через HEX</color>",
  "C": "<b>Жирный</b>",
  "D": "<size=20>Крупнее</size>",
  "E": "<size=20><color=red><b>Всё сразу</b></color></size>"
}

Тег открыли — тег закройте. <color=red> без </color> красит и хвост чужих сообщений. Имена цветов вроде red и orange игра знает, свой цвет надёжнее задавать шестью символами HEX.

После правки снова o.reload. Если файл не разобрался, плагин останется на встроенных фразах: ищите запятую и кавычку по статье синтаксис JSON.