Функции rvpacker
rvpacker-txt-rs-lib отвечает за чтение текста из RPG Maker игр и его записи обратно. Он имеет четыре части.
Чтение
Чтение расшифровывает исходный архив (если необходимо), парсит файлы данных игры, и высирает обычные текстовые файлы для редактирования.
Когда вы впервые откроете проект, вам будет выведен диалог с опциями чтения перед тем как парсить файлы - вам нужно всё настроить и нажать "применить". Затем, вы можете перечитать файлы вручную через кнопку rv чтобы всё перепарсить, например если игра была обновлена и её исходные файлы тоже.
| Опция | Действие |
|---|---|
| Режим чтения | По-умолчанию: не делает ничего, если файлы не изменены с прошлого чтения. Используйте принудительный режим чтобы полностью перечитать текст. Добавление/Принудительное добавление добавляют новый текст к уже имеющемуся переводы. |
| Режим дубликатов | Удалить дубликаты (рекомендуется) удаляет повторяющиеся линии в картах и ивентах. Разрешить дубликаты сохраняет каждую строку в пределах одной карты или ивента. Файлы System, scripts, и plugin всегда обрабатываются в режиме разрешённых дубликатов. |
| Игнорирование | Пропускает строки указанные в файле .rvpacker-ignore (посмотрите чистку). |
| Пропустить устаревшее | Удаляет строки с прошлого чтения которые больше не существуют в исходном тексте. |
| Распарсить ивенты карт | Также парсит метаданные ивентов карт - айди, название, и позицию X/Y. |
| Использовать название игры из ini файла | Для RPG Maker 2000/2003/XP/VX/VX Ace, название игры не всегда присутствует в System файле. Включите эту опцию чтобы достать его из Game.ini (XP/VX/VX Ace) или RPG_RT.ini (2000/2003). Заголовок расшифровывается с использованием указанной кодировки сверху - если название выходит сломанным, это знак того что кодировка указана неверно. Если в названии присутсвуют не только ASCII символы, оно может помочь вам узнать использованную в файлах игры кодировку. |
Кнопка выбора файлов в окне позволяет вам ограничить чтение для определённых файлов вместо всего проекта.
Запись
Запись доступна через кнопку . Она записывает ваш текущий перевод обратно в игровые файлы, совместимые с игрой. Запись выводится в
ПАПКА_ПРОЕКТА/.rpgmtranslate/output, всё что вам нужно чтобы применить перевод к игре - скопировать содержимое .rpgmtranslate/output в папку игры.
Запись может быть активирована горячими клавишами Ctrl+W.
Для движков 2000/2003/XP/VX присутствует очень важная опция записи - кодировка текста. Прочтите настройки для дополнительной информации.
Чистка
Чистка избавляется от непереведённых строк, и может опционально создать файл .rvpacker-ignore, чтобы строки не появлялись снова при повторных чтениях.
Экспорт/импорт
Конвертирует ваши файлы перевода в/из CSV, XLSX, XML, JSON и YAML - полезно для редактирования в качестве таблицы, отправки кому-нибудь кто не хочет использовать приложение, или архивации.
Выберите формат, папку, какие файлы включить, а затем экспортировать ли или импортировать. Каждый файл перевода экспортируется в файл выбранного формата (например actors.txt -> actors.csv) - импорт требует правильного наименования.
Импорт перезаписывает содержимое файла перевода, так что убедитесь что файл который вы импортируете содержит нужные данные.