Related Topics

[vadim]

Library in Babylon
Библиотека в Вавилоне
вступление к теме
Согласно легенде, Вавилонская библиотека была построена царём Навуходоносором II на холме Мугарран, в самом сердце Вавилона. В ней хранились тысячи книг, написанных на языках всех племён и народов, участвовавших в строительстве легендарной Вавилонской башни.
пояснение к теме
Библиотека в Вавилоне — это не просто место, где хранятся книги, статьи и руководства. Это символ, который на протяжении многих столетий вдохновлял мыслителей, людей, обладающих интеллектом. Данный символ олицетворяет идею о безграничном знании, бесконечных возможностях и одновременно о тщетности попыток найти истину в огромном потоке информации.
Наименование нашей темы лаконично и исчерпывающе передаёт идею, которую я стремлюсь донести до всех Камрадов нашего сообщества, будь то те, кто уже вовлечён в процесс модификации игр серии Total War, или тех, кто только начинает свой путь в этом сложном, но увлекательном мире модификации игр.
В публикациях данной темы будут входить учебные пособия и развёрнутые пояснения, составленные мной и моими коллегами с просторов славного ресурса Discord.

[vadim]

Итак приступаем к нашему действию Уважаемые Камрады.
Первые пару публикаций будут посвящены инструментарию под названием RPFM /примечание - примеры моддинга и изменения в файлах для пояснения механизма действия софта указаны на играх WH2 и WH3 - данные примеры полностью актуальны для файловой системы игры Pharaoh/
Статья №1
Учебное пособие:RPFM для начинающих
Автор ignotus
Подзаголовок: Разумно длинное и не совсем короткое руководство по моддингу с RPFM - с картинками
Рекомендую вам, уважаемые пользователи, ознакомится с использованием MediaWiki по моддингу игр серии Total War / To view the link Register /.
Откровенно говоря, я приятно удивлён тем, как мало вещей сломалось в процессе моей работы с модами, и как всё, что я создал, продолжает функционировать без каких-либо проблем. Это вызывает некоторое беспокойство, но не будем придавать этому значения. Приступим к нашему руководству!
Глава №0 Введение
Что такое моды для WH2 (или WH3) и что они могут делать?
В широком смысле моды - это файлы .pack, которые содержат практически все необходимые вам данные из WH2 (или WH3) - модели, статы, тексты, анимации, значения, скрипты, цифры.
RPFM, Rusted Pack File Manager, - это инструмент для редактирования файлов паков. Поэтому RPFM необходим практически для каждого мода игры серии Total War, который вы будете делать. Это руководство будет предназначено не только для WH2, но данные приёмы и их пояснения будут актуальны для других игр нашей серии (проверено на WH3).
Также можно редактировать файлы паков с помощью PFM (Pack File Manager) или TW: Assembly Kit (Акитой), но ни то, ни другое не рекомендуется: первый просто устарел и имеет вероятность заглючить, а второй инструментарий – хоть и является софтом от разработчиков, данным именно для моддига – он просто более сложен в применении и поэтому не особо подходит для разработки модов. Если в руководстве часто упоминается PFM, значит, оно сильно устарело, и вам, вероятно, стоит поискать более обновленное.
Также, прежде чем вы начнете, я рекомендую создать папку, в которой будут храниться ваши моды, RPFM и другие компоненты моддинга. Она понадобится нам позже.
Например моя папка - C:\REDACTED\OtherGameStuff\Warhammer2ExceptNeat
Глава №1 Установка RPFM
Лучшее место для получения RPFM - это раздел канала rpfm на сервере Da Modding Den Discord. Скорее всего, последняя версия уже выложена там. Однако вы также можете получить ее по следующей ссылке To view the link Register
Которая, на данный момент, выглядит примерно так:

На момент написания статьи (которая уже устарела) текущей версией является v2.3.2. Со временем в RPFM, несомненно, появятся новые дополнения и изменения (переход от RPFM v1 к v2 был довольно значительным), но функционал программы остаётся прежней:- она делает что-то с Pack Files. Кнопки могут переместиться, но делать они должны то же самое.
Что касается загрузки: если вы работаете под Windows, то загрузите файл, в котором есть 'rpfm-something-something-windows':

На данный момент RPFM упакован в папку .zip, которую можно распаковать практически чем угодно, но предыдущие версии были упакованы в папку .7z. Я рекомендую распаковывать их с помощью 7zip. 7zip довольно прост в загрузке и установке: просто возьмите любой из тех, на которых написано "windows", и, если он не работает, попробуйте следующий. В любом случае, 7-zip выходит за рамки данного руководства.
В любом случае, распакуйте RPFM в папку с модом, и в итоге у вас должно получиться что-то вроде этого:

Это не так уж необходимо, но мы сделаем ярлык для RPFM, чтобы не теряться в этой кучи папок каждый раз, когда захотим открыть наш инструмент (а открывать его придется часто). Найдите rpfm.exe (это экзе_файл программы для её запуска. В более ранних, а возможно, и более поздних версиях RPFM имя исполняемого файла может измениться. Попробуйте запускать, пока не заработает), щелкните правой кнопкой мыши и выберите "Создать ярлык":

Уточнение: в некоторых новых версиях исполняемый файл был переименован в rpfm_ui.exe
Выберите его для направления на Рабочий стол вашего компа.

И так это RPFM! Откройте его и присмотритесь к первичному интерфейсу - во всяком случае, для версии которой мы оперируем - он должен выглядеть хотя бы не много похоже:

(хотя значок в центре экрана может быть другим всё зависит от выбранной по дефолту игры).
Глава №2 Настройка RPFM

Прежде чем мы начнем бегать по кроличьим норам моддинга, нам нужно потратить немного времени на настройку самого софта RPFM, это необходимый процесс для его корректной и точной работы. Итак идём в PackFile -> Preferences /Настройки/

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

Зелёным цветом выделен выбор общего языка для меню. Вы можете включить свой родной язык или выбрать один из доступных вариантов.
Очень важно заполнить поля, которые выделены красным цветом. Первое указывает RPFM на каталог с основной папкой data WH2: это просто папка, в которой находится .exe (как показывает удобная подсказка!)
Второе указывает на причудливую папку "MyMod". Вам нужно будет создать ее и поместить в безопасное место - она может находиться где угодно, только не в Program Files. Создавайте папку для своей модификации на жёстком диске вашего компа где у вас больше места.
Раздел отмеченный синей рамкой не критичен /для исполнения/ , но это сэкономит вам немного времени: если установить RPFM по умолчанию со старта на WH2 или WH3 (или на Total War PHARAOH DYNASTIES ), то сама программа RPFM будет стартовать с основного каталога вашей Игры на которую вы и делаете мод. Остальные настройки можно оставить по умолчанию, они вам не нужны. Дальше все остальное по желанию. Как вы можете видеть, я также заполнил путь для Трои, потому что мне нравится немного модифицировать ее, но это не обязательно - мы модифицируем WH, поэтому нужно настроить только WH! В списке чекбоксов слева также есть "Использовать темную тему", что очень удобно для модинга в 3 часа ночи, когда вы чувствуете себя вампиром и яркий свет разрушает вас.
Закройте RPFM и запустите его снова, просто для надежности. (На самом деле это не нужно для этих настроек, вопреки красной надписи с предупреждением, но это избавляет нас от лишних щелчков).
Есть еще одна вещь, которую нам нужно сделать, чтобы RPFM работал должным образом, и это установка Total War: Warhammer 2 Assembly Kit (то же самое для Warhammer 3 или иных игр Total War ижке Warscape). Есть подробное руководство по тому, как это сделать от CA / To view the link Register / но вкратце, Steam -> Библиотека -> Инструменты, затем установите TW: Assembly Kit.

Важно (для RPFM), чтобы установочный пакет был установлен на том же диске, что и WH2/WH3. После загрузки снова запустите RPFM и нажмите «Специальные материалы» -> «Warhammer 2 / Warhammer 3» -> «Создать кэш зависимостей». (Если кнопка неактивна, просто откройте любой файл WH2/WH3, который вы хотите назвать; это легко сделать с помощью «Открыть из данных» и нажать на любой файл).

Это займет минуту, но это очень полезно для диагностического инструмента RPFM, который сообщает вам, когда ваши ключи не совпадают (короче говоря, он дает вам знать, где вы ошиблись).
Глава №3 Создание мода

Прежде чем мы начнём, стоит точно понять /и в дальнейшем помнить это/ что же делает софт производя работу над новой модификацией. Итак перечисляем по пунктам все аспекты работы в RPFM:
• Редактирование таблиц. Самое простое и удобное. Множество информации о данных в таблицах db серии игр Total War, например, о здоровье юнитов, найме рекрутов, о том, о скриптах и прописи их действия, о том, что делают очки навыков, о дилеммах: почти все эти данные хранятся в таблицах.
• Графика, модели, анимация и редактирование эффектов. Я совершенно не понимаю, как это работает, поэтому, если кто-нибудь сможет заполнить этот пробел, я буду признателен. Я знаю, что существуют текстуры, модели и анимация, но на этом всё.
o Вы можете создавать новых юнитов! От «стрелков с пистолетами из вахи, но синих, а не красных» до «древовидных людей с большими луками» и «полностью настраиваемых плавучих кораблей в качестве ездовых животных для персонажей Tomb King». Вы можете делать практически всё с помощью новых инструментов Phazer и редактора ресурсов h3ro (которого называют «Asset»).
o Вы можете создавать новые эффекты (например, блестящие предметы, которые появляются при активации заклинания).
o Вы можете переназначить и добавлять новые анимации, если у вас хватит на это сил, времени и доп. знаний.
o Что я знаю о вышесказанном, так это то, что всё это довольно сложно, и я бы не рекомендовал тем, кто только начинает заниматься моддингом, начинать с этого. Поищите другие руководства — на странице моддинга в Steam Мастерской есть несколько хороших руководств именно по данному вопросу.
• Скрипты. В то время как таблицы определяют, что существует, скрипты могут определять, как что-то происходит. Например, вторжение Хаоса в «Смертельных империях» почти полностью основано на скриптах. Как и «Ночь смерти» в Хеллеброне. Даже «Встречи в море» (где вы можете сразиться с целой толпой пиратов-вампиров) основаны на скриптах. «Встречи в лесу» лесных эльфов, дилеммы имперских графов — список функций, основанных на скриптах, можно продолжать. Довольно часто они связаны с базой данных (иногда в большей степени, чем другие — например, характеристики полностью определяются базой данных, но на самом деле получение любой характеристики зависит от скрипта)
• UI-скрипт. Строго говоря, это всё ещё скрипты, но с множеством координатных указаний на размещение кнопок по полю интерфейса игры, которые нужно нажимать, например, в «Культиве смерти», «Кузнице лесных эльфов Дейт», «Лаборатории плоти Трот» и тому подобном. К сожалению, я не знаком ни с одним из них, и, насколько я понимаю, их довольно сложно адаптировать под то, что вы хотите сделать.
o Опять же, если кто-то захочет заполнить немного больше информации, я буду признателен!
• Стартовые позиции. Вот это вот как раз уровень серьёзного, глубинного моддинга и именно это определяет, как всё устроено на первом ходу в кампании. Если вы действительно занимаетесь с игрой (например, добавляете новые фракции), это необходимо, но это настоящая боль, за что она и получила имя «Startpost». Будучи модом стартовой позиции, он также делает игру принципиально несовместимой с любым другим модом так же имеющем изменённые стартовые позиции, поскольку в начале кампании всё может быть устроено только одним способом! К счастью, если вы просто хотите переместить персонажа в другую локацию, вы можете сделать это с помощью скрипта, что гораздо удобнее и в какой то мере проще/если конечно уметь это делать правильно/.
Особенностью RPFM является редактирование таблиц. Он неплохо справляется со скриптами, но в конечном итоге лучше писать их на другом софте (Visual Studio Code хорошо подходит для опытных скриптеров), а затем вставлять в RPFM, когда закончите. Кроме того, RPFM как инструмент объединяет всё вышеперечисленное — у вас может быть сделана 3d модель например «Рыцари Хаоса» (Ratling Guns), но вам нужно будет поместить её в RPFM, для создания файл пакета с полной прописью во всех надлежащих файлах и корректного ввода всего этого хозяйства в саму игру.
RPFM не может редактировать файл Startpost (по крайней мере, пока), и для этого вам понадобится Assembly Kit Total War, но вам не стоит этого делать, если у вас нет действительно веской причины (а большинство причин недостаточно веские).
Учитывая всё это, мы собираемся сделать два простых мода. Во-первых, мы увеличим силу атаки лорда Скролка в ближнем бою до 100. Это будет редактирование таблицы. Во-вторых, мы сделаем так, чтобы он начинал игру в Каледоре, а не там, где он обычно находится. Вы могли бы сделать это с помощью изменения того самого Стартпоза в Assembly Kit, но я повторяю что на начальном этапе/и нулевых знаниях/ это плохая идея, поэтому мы воспользуемся прописанным скриптом. Всё что будет нами сделано, всё будет в итоге собрано в одном пак мода.
Ну и что сидим, кого ждём? Если вы решили Камрады – пора начинать.
Запустите RPFM с помощью удобного ярлыка, который вы создали ранее, и прежде чем мы начнём, нам нужно проверить кое-что и чуть ещё отладить наши настройки уже ставшего нам родным софта:

WH2/WH3 должна быть выбрана в качестве основной игры в настройках. Мы, конечно, создаём мод для WH! Если это не так, произойдёт куча ошибок.
Теперь давайте создадим наш мод в RPFM! Вы можете сделать это по старинке, выбрав «PackFile -> New PackFile» но функция MyMod в RPFM значительно упрощает процесс: откройте меню MyMod и нажмите «New MyMod»!

Появится небольшое окошко, в котором все понятно написано.

Текст в рамке
Что следует учитывать перед созданием нового мода:
- Выберите игру, для которой вы будете создавать мод.
- Выберите простое название (оно не должно заканчиваться на ".pack").
- Если вы хотите использовать несколько слов, используйте вместо пробела _
- Вы не можете создать мод для игры, путь к которой не указан в настройках.
Весь текст там объясняет сам себя. Что касается названия, мне нравится начинать с моего имени пользователя, а затем использовать подчёркивания, чтобы немного описать мод. Так что я назову его aidenpons_lord_skrolk_yes_yes, нажму «Save» и вперёд!

Теперь мы хотим изменить атаку Скролка в ближнем бою. Это будет делаться в таблицах. Выделив свой пак мода щелкните правой кнопкой мыши для вызова контекстного меню, и нажать «Создать» (а не «Добавить! это другая таблица), а затем «Создать Таблицу DB» (сокращение от «база данных», то есть «таблица»).

Нажмите на него, и появится окно с миллионом вариантов этих таблиц!

Это нехорошо, нам нужна атака в ближнем бою, а не куча всего и всего! Нам нужно знать, в какой таблице он находится, и чтобы это выяснить, у нас есть несколько вариантов:
1. Обратится за помощью на Дискорд канал Da Modding Den.
2. Найдите это сами, как независимый и способный человек!
Я рекомендую вариант б), если это возможно. Но не волнуйтесь, это не так уж сложно. Что мы знаем об атаке в ближнем бою? В файлах игры она может называться иначе, поэтому мы не будем искать её по названию. Что ещё мы знаем? Ну, мы знаем, что у лорда Скролка есть атака в ближнем бою. Итак, давайте просто выполним поиск по исходным данным CA и посмотрим, где он появится.
Отложите это в сторону и откройте другой экземпляр RPFM, нажав на тот удобный ярлык, который вы создали ранее. Убедившись, что выбрана правильная игра Warhammer, нажмите левой кнопкой мыши на PackFile. Здесь у нас есть несколько вариантов...

Мы хотим загрузить данные WH2/WH3, чтобы потом искать в них то, что нам нужно. Благодаря улучшениям в RPFM, нам больше не нужно думать, какой именно пакетный файл нам нужен: мы можем просто открыть их все сразу с помощью кнопки "Load All CA Packfiles" Загрузить все файлы CA.
Стоит также отметить, что Open from Content Открыть из содержимого открывается из содержимого мастерской Steam: удобно, если вы хотите проверить файл пака мода, но нам это не нужно. Open From Data Открыть из данных открывается из папки данных игры, где находятся файлы паков игры и модов, что объясняет массивное окно, которое появляется при наведении на него курсора.
В любом случае, загрузите все CA PackFiles, дайте им время загрузиться - это много больших пакетов, и у нас должно получиться что-то вроде того:

Обновление: в некоторых новых версиях Load All CA Packfiles выполняется автоматически после генерации кэша зависимостей. Поэтому, если кнопка неактивна, не паникуйте; это может означать, что вам не нужно выполнять этот шаг, поскольку CA Packfiles уже загружены.
Далее нажмите на маленькую стрелочку > с лева от вашего.packа, и ниже откроется всё древо папок! Разверните папку db (папка, в которой находятся все таблицы), и появится еще больше папок! ... Так вот почему загрузка заняла так много времени. Разверните произвольную папку и щелкните на ее data__ (все они имеют такое имя):

Это таблица. В данном случае это таблица, которая определяет, как усталость влияет на бой: вы можете видеть, что при подъёме по стенам усталость увеличивается на 10 000, а при бездействии усталость уменьшается на -18 (что, вероятно, означает, что усталость снижается, что соответствует игровым знаниям).
В любом случае, нам нужна была атака ближнего боя лорда Скролка. Ну, мы знаем, что у лорда Скролка есть атака ближнего боя. Так что давайте попробуем найти его! Для этого мы воспользуемся невероятно удобным глобальным поиском RPFM. Нажмите «Вид» -> «Переключить окно глобального поиска», чтобы открыть его.

(Примечание: в RPFM версии 1, которая полностью устарела, для доступа к глобальному поиску нужно было щёлкнуть правой кнопкой мыши в любом месте в левой части папки. Однако мы работаем с более современными технологиями!) Справа должно появиться окно с надписью «RPFM»:

Давайте введем Lord Skrolk в строку поиска, нажмем кнопку Search и посмотрим, что получится! Подождав немного (около 7 с на моей компьютере - ни в коем случае не больше минуты), мы получаем некоторые результаты: (Примечание: результаты могут отличаться в зависимости от того, какая версия RPFM и WH используется, но в любом случае идея глобального поиска по-прежнему работает).

Хм. Давайте рассмотрим один из них подробнее: нажмите на > рядом с db/character_skills_tables/data__, чтобы развернуть его, и посмотрите, что он обнаружил..

Дважды щелкните по нему, и таблица откроется.

Что ж, по крайней мере, мы нашли лорда Скролка. Это явно описание чего-то, а не атака в ближнем бою. Но если мы пролистаем влево и вправо, то увидим, что ключ — это то, что во многих таблицах WH используется для обозначения чего-то уникального (например, у юнитов есть ключи, у снарядов есть ключи, у дилемм есть ключи, у регионов есть ключи, у провинций есть ключи, у зданий есть ключи и т. д. и т. п.), — в WH не использует пробелы, как мы искали, а вместо этого использует подчёркивания. Итак, учитывая это, давайте попробуем вместо этого поискать lord_skrolk!
Подождите пару секунд, и, вау, сколько ещё результатов! Думаю, это имеет смысл для лидера целой фракции — модель, звук, события и всё такое! И одна из этих таблиц, надеюсь, посвящена атаке в ближнем бою...

В данный момент мы ищем в базе данных, но стоит упомянуть и другие вкладки. Поиск совпадений в базе данных WH2/WH3 — это действительно хороший способ начать поиск, если вы знаете только внутриигровое название. Функция «Совпадения по тексту» ищет, помимо прочего, скрипты и часть модели под названием «вариативная сетка» (не спрашивайте меня, что это значит, потому что я не знаю) — хорошо, если вы ищете скрипты или модели, но мы этим не занимаемся, так что можем игнорировать эту функцию. Я понятия не имею, что делает функция «Совпадения по схеме», и она мне никогда не была нужна, так что, надеюсь, мы можем её игнорировать.
Кроме того, не стесняйтесь изменять размер окна (перетаскивайте различные всплывающие элементы), если у вас достаточно места на экране. В любом случае, нам нужна атака в ближнем бою. Здесь нет таблицы, похожей на melee_attack, но если прокрутить немного вверх, давайте попробуем main_units_tables?

land_unit! Это что-то! Дважды щелкните на нем, откроется новая вкладка в RPFM и прокрутите вниз до нужной строки.

(Дополнение: WH2, это руководство и RPFM претерпели множество обновлений с момента выхода игры. Если вы внимательно посмотрите, то увидите, что в левом верхнем углу написано data.pack, а не warhammer_2, и что Скролк находится на 709-й строке, хотя сейчас он на 789-й. Всё меняется, и я действительно не могу постоянно обновлять это руководство. При моддинге, как минимум, важно уметь быстро соображать, потому что всё вокруг меняется.)
Вы можете увидеть наши предыдущие таблицы character_skills_tables, открытые на неактивной вкладке. Нам они больше не нужны, и вы можете закрыть их, если хотите. Сейчас мы рассмотрим main_units.
Прокручивая страницу, мы видим такие вещи, как стоимость содержания, стоимость в многопользовательском режиме, некоторые голосовые подсказки, но ничего похожего на атаку в ближнем бою. Что ж, это действительно похоже на лорда Скролка (wh2_main_skv_cha_lord_skrolk кажется подходящим вариантом), так что, вероятно, мы на верном пути. А что насчёт этого наземного юнита? Если мы наведём курсор на заголовок столбца в RPFM, то увидим, на какую таблицу он ссылается. (Некоторые столбцы в таблицах связывают другие таблицы между собой, как в этом примере, но, очевидно, «Стоимость обслуживания» не ссылается на таблицу!)

Таблица под названием land_units. Было бы неплохо найти её быстро. Это можно сделать двумя способами: во-первых, найти таблицу вручную. Это довольно быстро, потому что если мы выберем случайную папку слева и нажмём L (для Land_units), то в папке мы увидим первое совпадение с L. (При желании можно напечатать ещё быстрее, набрав L A N D _ U N I T S, но для моих пальцев это слишком)

Ну, lab_settings - это точно не то, что нам нужно, но если мы прокрутим страницу немного вниз, то найдем land_units_tables.
Другой - и гораздо более быстрый - вариант заключается в использовании удобной функции Go To в RPFM. Щелкните правой кнопкой мыши на ячейке и выберите Go To -> Go To Definition/Перейти/ Перейти к определению/, и, фазам, RPFM приведет вас прямо в нужный нам файл!

В любом случае, теперь перед нами открыта таблица land_units_tables:

Теперь мы действительно не хотим прокручивать все десять миллиардов строк этой таблицы, чтобы найти Skrolk, но вместо этого в RPFM есть удобный раздел «Фильтр» прямо под таблицей. Введите в него skrolk, и он покажет только строки, соответствующие skrolk в разделе «Ключ». (Мы бы не хотели искать skrolk в разделе «Категория»!) С более подробными фильтрами можно делать множество мощных вещей (они поддерживают регулярные выражения, очень удобные для поиска), но и этот простой фильтр тоже вполне подойдёт:

Всего одно попадание по поиску? Обычно это довольно хорошо, так как это указывает на то, что это своего рода главный узел, связывающий множество элементов. Прокрутите таблицу, и вы увидите информацию о маунтах/лошадях/, боевом духе, доспехах, оружии ближнего боя и — что это? Атака ближнего боя! Мы нашли его!

Теперь, прежде чем мы слишком сильно начнём ломать голову/вьесжая в суть алгоритма поиска/, давайте поговорим о самих пакетах данных игры. Редактировать их — совершенно е наш метод, так как после этого вы не сможете вернуться к исходному состоянию без переустановки игры, и именно поэтому RPFM не позволит вам сохранить изменения, если вы попытаетесь это сделать. Вместо этого мы создали мод!
Вернитесь к экземпляру RPFM, в котором открыт ваш мод (или откройте его снова, если вы его закрыли). Если вы его закрыли, есть отличный трюк с RPFM, который позволяет очень быстро его открыть. Он находится в меню MyMod:

Очень быстро и очень удобно. В любом случае, мы закрыли его, потому что не знали, какая таблица нам нужна, но теперь мы знаем, что нам нужна таблица land_units! Итак, снова щёлкните правой кнопкой мыши, создайте, Сreate - Сreate DB создайте базу данных.....

... и на этот раз мы знаем, какую таблицу нам нужно выбрать — это land_units . Если ввести land_units, мы не получим нужный результат, но его легко найти среди четырёх вариантов в выпадающем списке:

В первой строке new_file будет имя вашей таблицы. Это не очень важно - за исключением того, что оно не должно заканчиваться цифрой и не должно содержать пробелов, - но мне нравится, опять же, предварять его своим именем, а затем что-то о таблице. Так что aiden_land_units подойдет как нельзя лучше.

Нажмите «Create» /Создать/, откройте его, и он будет пустым. Ну конечно, он будет пустым — мы ничего в него не добавляли!

Ну, мы хотим вставить сюда строчку о лорде Скролке и изменить его атаку ближнего боя. Думаю, вы могли бы напечатать все от руки, если бы хотели получить какие-то бонусные страдания, но я люблю, чтобы мой моддинг был приятным опытом (именно поэтому я не трогаю startpos), а в RPFM мы можем копировать и вставлять строки (и многое другое!) поверх! Вернитесь в RPFM с открытым файлом data.pack, и он должен быть там, где мы его оставили. Теперь, как и в Excel, если вы щелкните на номере строки, будет выделена вся строка. Щелкните правой кнопкой мыши где-нибудь в этом ряду, выберите Копировать, затем Копировать (другая опция нам не нужна):

Теперь вернитесь в наш мод, щелкните правой кнопкой мыши в любом месте представления таблицы и нажмите "Вставить как новую строку"!

Результат должен быть такой!

Разделы немного сжаты, но они есть! Теперь перейдите к атаке ближнего боя, дважды щелкните, чтобы выбрать ее, вставьте наше хорошее модифицированное значение 100, нажмите Enter, и готово!

Но прежде чем мы начнем слишком увлекаться использованием сверхсильного Лорда Скролка, нам нужно сделать еще две вещи:
Первое - сохраните мод! Для этого достаточно Ctrl+S или PackFile -> Save. Второе - более важное: скопировать мод в каталог данных игры, чтобы менеджеры модов могли его подхватить. Вместо того чтобы вручную вылавливать пакетный файл и вставлять его, RPFM делает это двумя щелчками мыши: PackFile -> Install!

Дополнение: В предыдущих версиях RPFM это находилось в меню MyMod. Опять же, кнопки могут перемещаться - важно думать головой)
Кстати, если вы получаете ошибку, которая выглядит следующим образом:

Теперь наш маленький симпатичный файл находится в каталоге данных WH2 и готов к тому, чтобы его подхватил либо загрузчик модов CA – Лаучер от разработчиков самой Игры, либо Kaedrin’s Mod Manager (KMM). Крайне важно сначала протестировать свои моды (и, по крайней мере, убедиться, что они загружаются и игра не вылетает!), поэтому мы это сделаем.
Хотя KMM определенно превосходен в управлении большим количеством модов, а его функция профиля - находка, на самом деле нам нужен Лаучер от CA для загрузки мода (подробнее об этом позже. Загрузите его, и если вы прокрутите вниз, тадаааааааам! Вот он наш результат господа Камрады.

Включите это, нажмите «Играть», нажмите «Играть» в обязательном меню «предупреждение о том, что вы используете мод» (кто-нибудь, кроме меня, вообще это читает?), и WH2/WH3 загрузится с нашим модом!:
Мы могли бы начать новую кампанию, чтобы всё проверить, но в принципе можно не утруждать себя, а просто увидеть данный результат в пользовательских сражениях.

Ссылки на файл статьи в Word формате

TutorialRPFM For Dummies EN (Раскрыть)

To view the link Register

TutorialRPFM For Dummies RU (Раскрыть)

To view the link Register

[Dr.Schmeisser]

Отлично. Спасибо Вадим за туториал.

[vadim]

Большое спасибо Камрад Dr.Schmeisser за изменения темы/то о чем я и просил/
Подскажите тег какой ставится для серенького фона статьи?
А то тут готовлю Большой развернутый мануал по RPFM от самого автора софта Frodo
Хотелось бы единообразия при выкладывании своих фолиантов.

[Dr.Schmeisser]

vadim

Подскажите тег какой ставится для серенького фона статьи?

Какой серый? Тот который я сверху использовал? Клавиша называется "Рамка-Объявление". А в виде тега она выглядит так:

[notice]Контент[/notice]

[Аброр]

Надо это пособие вывести за рамки данной игры и её темы. Чтобы для всех было видно, а то придётся каждый раз это писать. С выходом новой игры придут новые люди и так по кругу. Думаю, вообще всех пособий надо сделать отдел. Суть ведь не меняется независимо от игр...

[vadim]

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

[vadim]

Заканчиваю Большой мануал от автора софта RPFM - думаю завтра последние разделы/после Рабочего шуршания/ добью и буду выкладывать
очередной Мега полезный фолиант в нашей Library of Babylon.

[vadim]

Rusted PackFile Manager
RPFM Документация с развёрнутым пояснением интерфейсов и функционала
Автор: Frodo45127
Расширенный перевод: vadim

1. Что такое RPFM?

Это Rusted PackFile Manager, он же RPFM, инструмент создания модов для современных игр серии Total War.
Прежде чем рассказать о том, что он делает, следует немного объяснить, как работает сам моддинг в играх Total War начиная с игры Empire. Yачиная с этой славной стратегии, большинство данных в играх Total War находится в файлах .pack, упакованных вместе, чтобы их было быстрее и удобней исполнять при активации всего игрового механизма. Эти .pack-файлы представляют собой контейнеры. Внутри них находится тонна файлов с фактическими данными игры. Вот некоторые из этих файлов:
Таблицы DB: содержат большинство модифицируемых вещей игры, таких как статистика юнитов, информация о зданиях, ..... Они всегда находятся в папке db/whatever_tables/table_file.
LOCs: содержит фактический текст, который вы видите на экране во время игры. Да, все эти буквы – текстовая локализация Игры.
Lua/Txt/Xml/...: обычные текстовые файлы. Ничего сложного.
RigidModels: файлы с реальными 3D-моделями почти всего, что вы видите в игре, например юнитов, строений, монстров и т. д.
Изображения UI: иконки, текстуры и т.д.....

Итак, как же выполняется моддинг в современных играх серии Total War? Вы создаёте mod пакет, добавляете некоторые из этих файлов, изменяете их, а затем сообщаете программе запуска, что нужно использовать этот мод с внесёнными вами изменениями. Просто, не так ли? Теперь, что такое RPFM? Это программа, которая позволяет создавать и редактировать эти пакеты, а также редактировать таблицы, локации и т. д. внутри них. Вот, в общих чертах и вся суть процесса моддинга игры.

Но постойте, разве это вам не напоминает что-то? Если вы уже сталкивались с модификацией современной игры Total War, то да.

RPFM был создан как полная переработка старого PFM (PackFile Manager). Дело в том, что PFM работал медленно, содержал ошибки и не обновлялся более полугода, пока кто-то не решил заняться его улучшением. Однако RPFM вышел за рамки своего базового начального софта PFM/на основе которого он и был создан/.

Если вы раньше использовали PFM, то заметите, что у RPFM похожий интерфейс, и большинство функций находятся в тех же местах или рядом с ними. Это сделано для того, чтобы модераторам, которые привыкли к PFM, было легче освоить новый, более качественный инструмент.
Итак, вы хотите попробовать? Тогда прочтите раздел Начальная конфигурация софта RPFM – данный раздел поясняет первичные доп. Настройки программы RPFM.
И помните, что вы всегда можете получить доступ к этой документации, нажав на Open RPFM Manual в правом нижнем углу экрана самого софта.

2. Начальная конфигурация RPFM /первичные настройки/

После первого запуска RPFM нам нужно настроить несколько параметров.

Сначала вам должно быть предложено обновить схемы. Нажмите "Да". Схемы - это файлы, используемые для редактирования таблиц, поэтому они вам нужны. Помните, что они всегда должны быть актуальными.

Затем нам нужно перейти в Paths / Settings, после чего появится окно, показанное выше. Кажется, что нужно знать много нового для точной настройки, но на самом деле всё намного проще чем кажется. Итак это пути к файлам игр серии TW, а так же направление к Доп. Инструментарию от разработчиков и к Новому/созданному вами/ паку вашего мода :
Game Folder - Папка с Игрой: Это направление к папке, в которой находится ваша игра. Не там, где /data, а там, где именно файл.EXE!!! RPFM необходимы данные направления к рабочим файлам игр, так что это необходимо прописать в обязательном порядке.

Assembly Kit Folder - Папка Assembly Kit: Это папка, в которой находятся инструменты моддинга от разработчиков игр СА.

MyMod's Folder - Папка MyMod: это путь, где будет храниться ваш MyMod. О MyMod будет рассказано в следующей главе этой документации, а пока вам просто нужно знать, что это путь, который RPFM будет использовать для хранения файлов вашего мода. Рекомендация задать путь к папке имеющей достаточно большой объём.

7-Zip Folder – Папка с exe файлом 7-Zip: если у вас установлен 7-Zip, поместите сюда папку, в которой находится exe-файл 7-Zip. Это необходимо для поддержки сжатия. Без него, если вы попытаетесь сжать пакет, это не удастся.
Далее, все эти флажки. Вы можете получить объяснение того, что они делают, просто наведя на них курсор мыши, как здесь.

Далее - кнопка "Текстовый редактор". Она управляет всеми настройками текстового редактора, включая его цветовые темы.

И, наконец, кнопка Shortcuts "Ярлыки". Нажав ее, вы откроете окно " Shortcuts ", где можно просмотреть и отредактировать все конфигурации клавиш, используемые в RPFM в данный момент.

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

Когда вы закончите с настройками, просто нажмите кнопку Save - Сохранить. Вы можете восстановить все настройки по умолчанию с помощью кнопки слева (то же самое касается ярлыков с их кнопкой Restore Defaults). Следует учесть, что если какой-либо из путей недействителен, RPFM удалит его при нажатии кнопки Сохранить.

Теперь последний шаг. Он необязательный, но рекомендуемый, и требует, чтобы у вас был установлен Assembly Kit для ваших игр. Нужно зайти в раздел Special Stuff и для каждой игры нажать Generate Dependency Cache. Это создаст специальный файл, который поможет RPFM со справочными данными для столбцов таблицы. Пока что он не включен для Empire и Napoleon, но должен работать для всех остальных игр.

На этом начальная настройка завершена. Теперь, когда мы закончили настройку RPFM, давайте посмотрим, какие возможности он может предложить.

3. Кнопки и их назначение
В этой главе мы рассмотрим все кнопки общего назначения и скрытые действия, которые есть в RPFM (действия, специфичные для PackedFile, описаны в соответствующей главе), так что вам не придется спрашивать, что они делают. Не забывайте, что в дополнение к этой главе вы можете навести курсор мыши почти на каждую кнопку RPFM, и в строке состояния внизу появится короткое сообщение, объясняющее, что эта кнопка делает.

3.1 Панель меню
Во-первых, верхняя панель меню. В ней пять меню, о которых будет рассказано в следующих главах. Но чтобы дать вам представление о том, что у нас есть:
• PackFile ПакФайл: Здесь находятся все основные функции для пак файлов, такие как "Создать", "Открыть" и "Сохранить". Назначение данных функций просто и элементарено/названия отделов полностью описывают их функционал/.
• MyMod МойМод: Здесь находится все, что связано с использованием функции MyMod.
• View Вид: Здесь вы можете скрывать/показывать определенные панели пользовательского интерфейса.
• Game Selected Выбранная игра: Здесь вы выбираете игру, для которой вы модифицируете текущий пакет, если RPFM не смог выбрать ее за вас.
• Special Stuff Особые функции: Здесь идёт указание на спец функции софта направленные на все установленные игры серии TW.Например на создание кеша для каждой игры и тд.
• Tools Инструменты: Здесь находятся специализированные инструменты, такие как художник фракций и редактор юнитов.
• About О программе: Сюда вы попадете, когда захотите прочитать эту документацию, проверить обновление для софта на Patreonе или узнать, какая версия RPFM у вас установлена.

3.1.1 Меню PackFile /пояснение и уточнение функционала разделов/


Здесь мы можем найти основные действия:
• New PackFile: Создает новый файл PackFile.
• Open PackFile: открывает один или несколько PackFiles в RPFM.
• Save PackFile: сохранение изменений, сделанных в PackFile, на диск компа.
• Save PackFile As Сохранить пакетный файл как: Сохраняет текущий файл PackFile как.
• Install: Устанавливает открытый в данный момент файл PackFile в папку с данными игры.
• Unistall: Удаляет открытый в данный момент PackFile из папки данных с игрой.
• Open Recent…/xxx.pack Открыть недавний.../xxx.pack: Открыть недавно открытый файл PackFile.
• Open From Content…/xxx.pack Открыть из папки Content.../xxx.pack: Открыть выбранный PackFile из папки Content (Workshop mods) игры. Требуется настройка пути к игре.
• Open From Data…/xxx.pack Открыть из папки Data.../xxx.pack: Открыть выбранный файл PackFile из папки Data игры. Требуется настройка пути к игре.
• Open From Autosave…/xxx.pack Открыть из автосохранения.../xxx.pack: Открывает выбранный файл PackFile из папки Autosave. Автосохранения относятся к каждому паку и сортируются от самого нового к самому старому, поэтому если вы хотите загрузить последнее автосохранение, выберите первое.
• Load All CA PackFiles Загрузить все CA PackFiles: Создает в памяти поддельный PackFile и пытается загрузить в него все данные из каждого Vanilla PackFile игры. Имейте в виду, что это займет некоторое время. Отключается, если у вас загружены зависимости в панели зависимостей.
• Change PackFile Type Изменить тип файла: Позволяет изменить тип открытого PackFile и настроить для него некоторые параметры.
• Settings Настройки: Откройте окно настроек.
• Quit Уйти: Кликнув на этот пункт вы можите выйти из программы RPFM.

Типы файлов Pack /можно увидеть данный столбец кликнув на графу Change PackFile Type / - так вот Типы файлов это то, что использует для загрузки всех данных игры. Перечислим следующие типы, в том порядке, в котором игра их загружает для работы всех своих процессов:
• Boot Загрузочный: Используется boot.pack. Не полезен для моддинга. Загружается первым.
• Release Релиз: Это дефолтный пак файл. В данном расширении например находится пак файл дата/очень важный с данными data.pack/ Используется большинством CA PackFiles. Не полезен для моддинга.
• Pactch Патч: Используется некоторыми CA PackFiles, особенно в Shogun 2 и более старых играх. Не полезен для моддинга.
• Mod Мод: Используется большинством модов. Это тот, который вы будете использовать чаще всего.
• Movie Мув: Используется некоторыми CA PackFiles и некоторыми специфическими модами. Полезен для моддинга. Всегда загружается первым при прочитывании всех пак файлов игры. Этот пак файл с расширением мув всегда будет загружать данные которые находятся в нём первыми в игре/даже первей чем дефолтные оф. паки игры/

В этом меню есть еще несколько опций для настройки PackFiles:
• Header Is Extended Заголовок расширен: Заголовок файла PackFile расширен (отображается только на арене).
• Index Includes Timestamp Индекс включает временную метку: В индексе файла PackFile есть метка времени, возможно, дата последнего изменения.
• Index Is Encrypted Индекс зашифрован: Индекс файла PackFile зашифрован.
• Data Is Encrypted Data Данные зашифрованы: Данные файла PackFile зашифрованы.
• Data Is Conpressed Data Данные сжаты: Данные файла PackFile сжаты.

Что касается этих опций, просто примите во внимание, что любой PackFile с включенной любой из этих опций (кроме Data Is Compressed) не будет распознан программой запуска как мод. И RPFM не поддерживает сохранение PackFiles с включенными Index Is Encrypted, Data Is Encrypted или Header Is Extended.
Если вы не включите опцию Allow Editing of CA PackFiles/которая напоминаем находится в разделе Settings - Настройки/ , RPFM не позволит вам сохранить Boot, Release или Patch PackFiles.
На этом мы закончим работу с меню PackFile. Далее - меню MyMod.

3.1.2 Меню MyMod


MyMod - это функция, помогающая моддерам хранить данные о своих модах. Система начиналась как почти 1:1 клон функции MyMod в PFM и расширялась с этого момента, так что она должна быть легкой в использовании и для ветеранов.
Для тех, кто в курсе, помните папку MyMod, которую мы задали в настройках? Когда мы создаем MyMod, в этой папке будет создана папка для игры, для которой предназначен мод (если ее не было раньше), а внутри нее - PackFile и папка, обе с названием вашего мода. Каждый раз, когда вы извлекаете что-то из PackFile, оно будет автоматически извлекаться в его папку, повторяя структуру, которую оно имеет в PackFile. Например, при извлечении таблицы она будет извлечена в папку mymod_folder/db/table_name/file. Добавление файлов/папок из папки MyMod также добавит их в зеркальном отражении пути, который они имеют. Например, добавление файла из папки mymod_folder/db/table_name/file_ добавит его в PackFile/db/table_name/file.
Это облегчает отслеживание файлов мода, и вы даже можете поместить эту папку в .git или любую другую систему контроля версий, так как у вас будет распакованный мод, который вы сможете упаковать одним щелчком мыши (ну, несколькими щелчками).
Меню MyMod содержит следующие кнопки:
• Open MyMod Folder Открыть папку MyMod: Открывает папку MyMod в проводнике файлов по умолчанию.
• New MyMod Новый мод: Открывает диалоговое окно New MyMod Dialog. Оно описано в этом списке.
• Delete Selected MyMod Удалить выбранный MyMod: Удаляет выбранный в данный момент MyMod. Это нельзя отменить, поэтому вы получите предупреждение, прежде чем сделать это.
• Import Импортировать: Импортирует содержимое папки MyMod из открытого в данный момент файла MyMod PackFile в указанный PackFile.
• Export Экспорт: Извлеките текущий файл MyMod PackFile в папку MyMod.
• Название игры/yourmod.pack: Откройте ранее созданный MyMod, чтобы редактировать, удалять, устанавливать, .... все, что вы хотите, детка!

Когда мы нажмем кнопку New MyMod, появится следующее диалоговое окно:

Здесь вы можете настроить MyMod на нужные вам функции. Как только вы закончите, нажмите "Сохранить", и ваш новый MyMod будет создан и открыт.
И, наконец, несколько замечаний:
• Чтобы иметь возможность использовать импорт/экспорт, необходимо, чтобы ваш MyMod был открыт.
• Только MyMod PackFiles, открытые из XXX/yourmod.pack, будут пользоваться возможностями MyMod, такими как сохранение путей при добавлении/распаковке файлов. Открытые вручную MyMod PackFiles будут рассматриваться как обычные PackFiles.

3.4 Меню вида просмотра


В данном меню вы можете скрывать/показывать определенные панели пользовательского интерфейса:
• Toggle PackFile Contents Содержание PackFile: То, что слева, с файлами и папками в нем.
• Toggle Global Search Глобальный поиск: Панель для поиска материала во всем открытом паке
• Toggle Diagnostics Диагностика: Панель для отображения результатов диагностики по всему паку
• Toggle Dependencies Зависимости: Панель для отображения всех загруженных данных в момент направленной зависимости от дефолт папок.
• Toggle References Референц файл : Референц поиска: панель для отображения найденного референца/ключа названия файла или папки или тд/, или найденных с помощью функции поиска референцов

3.1.4 Меню выбора игры


В этом меню вы можете изменить текущую выбранную игру. При открытии PackFiles RPFM пытается быть умным и автоматически выбирать игру, но есть некоторые PackFiles, которые одинаковы для разных игр (например, Attila и Warhammer 1 PackFiles идентичны), так что... просто убедитесь, что выбрана правильная игра после открытия PackFile, так как это влияет на работу многих частей программы. Полный список поддерживаемых игр выглядит следующим образом:
• Pharaoh Dynasties: Полная поддержка.
• Pharaoh: Полная поддержка.
• Warhammer 3: Полная поддержка.
• Тroy: Полная поддержка.
• Тhree Kingdoms: Полная поддержка.
• Warhammer 2: Полная поддержка.
• Warhammer: Полная поддержка.
• Thrones of Britannia: Полная поддержка.
• Аttila: Полная поддержка.
• Rome 2: Полная поддержка.
• Shogun 2: Полная поддержка.
• Napoleon: Почти полная поддержка. Отсутствует поддержка генерации кэша зависимостей.
• Empire: Почти полная поддержка. Отсутствует поддержка генерации кэша зависимостей.
• Arena: Поддержка PackFiles только для чтения. Неполная схема.

Кроме того, в верхней части есть несколько удобных кнопок для открытия определенных папок в файловом менеджере, установленном по умолчанию в вашей системе:
• Запустить выбранную игру: Быстрый ярлык для запуска выбранной в данный момент игры.
• Открыть папку данных игры: Откройте папку данных выбранной игры, если путь к ней указан в настройках.
• Откройте папку Assembly Kit игры: Открыть папку с набором для сборки выбранной игры, если путь к ней указан в настройках. Только для Rome 2 и более поздних игр.
• Откройте папку конфигурации RPFM: Очень важное направление и папки с помощью которых можно производить детальную шлифовку данных софта/Откройте папку config RPFM, которая содержит конфиги, ярлыки, схемы, crashlogs, porn,....

3.1.5 Дополнительное меню Спец. элементы

---------------

Это меню содержит... специальные функции, реализованные для конкретных игр. В принципе, сюда попадает любая функция, которая не вписывается ни в одно другое место. Здесь есть:
• Патч SiegeAI: используется в Warhammer 1 и 2 для создания осадных карт, с которыми может справиться ИИ. По сути, создайте свою карту с необходимыми для работы ИИ вещами, а затем исправьте её в PackFile с помощью этого патча.
• Build Startpos: Изменение прописей в файле Стартпост или создание нового файла Стартпост.
• Optimize PackFile: уменьшает размер вашего PackFile и повышает его совместимость с другими модами за счет очистки некоторых элементов в вашем packfile:

При оптимизации вашего пак файла вот что меняется в конфигурации файлов
DB: Удаляет неизмененные строки из ванили. Если таблица пуста, она удаляет ее. Файлы игнорирования называются так же, как и ванильные (если вы не отключите это в настройках).
Loc: Удаляет неизмененные строки из ванили.
Xml: Удалены xml-файлы из папки terrain/tiles, так как они остались после экспорта Терри...
• Generate Dependencies Cache: генерирует кэш, используемый для таких вещей, как проверка зависимостей, диагностика, ..... Пока не работает для Empire и Napoleon.
• Live Export Прямой экспорт: Экспортирует все скриптовые и ui файлы из открытого пака в папку данных игры со случайным числом, а также помещает все сопоставления путей в файл в папке exe. Таким образом, вы можете загрузить этот файл в игре, и он позволит вам загрузить указанные скрипты и ui файлы без перезапуска игры.

Также есть функция Rescue PackFile, которую НЕЛЬЗЯ использовать, если вас не проинструктировали как работает данная фича.

3.1.6 Tools Menu Меню Инструментов


Меню с пользовательскими инструментами, интегрированными в RPFM:
Faction Painter: позволяет менять цвета всех фракций в игре.
Unit Editor: позволяет редактировать юнитов
Translator: позволяет переводить описание в локализации

3.1.7 About Menu О программе


Довольно простое и понятное меню:
About QT: показывает информацию об используемой версии Qt (фреймворк, который RPFM использует для пользовательского интерфейса).
About RPFM: показывает информацию об используемой версии RPFM и кредитах.
Check Updates: проверяет, доступна ли более новая версия RPFM.
Check Schema Update: проверяет, доступна ли более новая версия схем schema RPFM, и загружает их.
Check TW Autogen Update: проверяет, доступна ли более новая версия репозитория lua TW Autogen, и загружает ее.
Схемы schema, о которых я говорил в последнем пункте, позволяют RPFM декодировать и открывать таблицы всех поддерживаемых игр. Более новые схемы означают больше открываемых таблиц. Очень часто после обновления несколько таблиц меняют свою структуру и больше не декодируются. Чтобы заставить их снова работать, схему необходимо обновить.
Примечание – в последних версиях программы осталось только три элемента данного раздела About QT. About RPFM. Check Updates – все остальные вынесены в отдельное меню обновления версии софта.


3.2 PackFile TreeView Файловое древо Пакфайла

Первый раздел слева – Содержимое Pack файла, если кликнуть на пак раскроется весь раздел с папками и прочими файлами — это и естьTreeView PackFile/древо пак файла/. Здесь отображаются все файлы внутри нашего/или дефолтного/ PackFiles. Если вам что-то там не нравится, его можно переместить в другое место или даже закрыть. Когда вы щелкните правой кнопкой мыши по любому из файлов или папок в нутрии древа, появится следующее контекстное меню:

Так думаю будет более наглядно и понятно о чём речь.

В контекстном меню перечислены все операции, которые вы можете использовать для изменения своего PackFile. Каждая из данных операций имеет свои горячие клавиши для быстрого исполнения функций. Рассмотрим это меню всё по порядку.
• Add…/Add File Добавить/ Добавить файл : Позволяет добавить один или несколько файлов в PackFile. Если обнаружены файлы TSV, RPFM попытается импортировать их как таблицы/ locs расширение локации.
• Add…/Add Folder Добавить/ Добавить папку : Позволяет добавить папку и все файлы в ней в PackFile. Если в данной папке будут обнаружены файлы TSV, RPFM попытается импортировать их как таблицы/ locs
• Add…/Add from PackFile Добавить/ Добавить из ПакФайла : Позволяет добавлять файлы или папки из другого PackFile в ваш PackFile. Просто выберите то, что хотите добавить, дважды щелкните по нему, и оно будет добавлено в ваш PackFile, сохраняя свой путь и структуру выбранного древа.
• Create…/Create Folder Создать…/Создать папку: Позволяет создать пустую папку. Из-за особенностей работы PackFiles пустые папки не сохраняются, поэтому, если вы хотите сохранить папку, добавьте в нее файл. Поддерживает структурность древа пути/когда папка в папке/.
• Create…/Create AnimPack Создать…/Создать Пак Анимации: Позволяет создать пустой AnimPack.
• Create…/Create DB Создать…/Создать файлы DB: Позволяет создать пустую таблицу DB файла.
• Create…/Create Loc Создать…/Создать файл Лакализации Loc: Позволяет создать пустой Loc файл. Вы также можете создать его относительный путь с подпапками, написав что-то вроде folder1/folder2/file вместо просто имени файла.
• Create…/Create Portrait Settings Создать…/Создать файл настроек UI Портретов: Позволяет создать файл настроек портрета. Его можно инициализировать данными из открытого мода.
• Create…/Create Text Добавить/ Добавить текстовой файл : Позволяет создать пустой текстовый файл. ЛЮБОЙ ТЕКСТОВЫЙ ФАЙЛ (включая lua, xml,...). Вы также можете создать его относительный путь, написав что-то вроде folder1/folder2/file вместо просто имени файла.
• Create…/Create Quick File Создать…/Создать быстрый файл: Позволяет создать файл на основе контекста выбранной игры. Текущие контексты, в которых это работает:
1. db/x_tables: создает новую пустую таблицу базы данных последней версии, поддерживаемой выбранной игрой.
2. text/: создает файл loc.
3. scripts/: создает скрипт LUA.
4. variationmeshes/variantmeshdefinitions/: создает файл variationmesh.
• Open…/Open with Decoder Открыть…/Открыть с помощью декодера: Позволяет открыть таблицу в PackedFile Decoder. Используется только для декодирования новых таблиц, так что не рекомендуется без надлежащих навыков этим пользоваться.
• Open…/Open Dependency Manager Открыть…/Открыть менеджер зависимостей: Позволяет открыть список зависимостей, включенных в Pack File. Ознакомьтесь со следующей главой, чтобы узнать, что представляет собой этот Dependency Manager Менеджер зависимостей.
• Open…/Open Containing Folder Открыть…/Открыть содержащую папку: Позволяет открыть папку, в которой находится открытый PackFile (если он находится на диске), с помощью файлового менеджера вашей системы по умолчанию.
• Open…/Open PackFile Settings Открыть…/Открыть настройки PackFile: Позволяет открыть настройки текущего открытого PackFile.
• Open…/Open with External Program Открыть…/Открыть с помощью внешней программы: Позволяет открывать PackedFile с помощью внешней программы. Для таблиц и locs файлов выполняется некоторая внутренняя подпрограмма декодинга, чтобы их можно было открыть в excel/calc/программе, с помощью которой открываются ваши tsv-файлы.
• Open…/Open Notes Открыть…/Открыть заметки Позволяет открыть панель заметок для записи полезной и поясняющей информации, связанной с PackFile мода /например что сделано в данный этап или сессию/.
• Rename/Move: позволяет переименовать/или изменить расширение файла который выбран в нутрии структуры вашего PackFile.
• Delete: позволяет удалить все, что выбрано. Если выбран PackFile, он удаляет все файлы из него.
• Extract: позволяет извлечь все, что выбрано из PackFile. Если выбранное вами сжато/зашифровано, RPFM распакует/расшифрует его перед извлечением, поэтому полученный файл можно использовать.
• Copy Path: позволяет скопировать путь выбранного элемента в буфер обмена.
• Merge Tables: позволяет объединить несколько таблиц DB/LOC в одну.
• Update Table: позволяет обновить структуру таблицы до последней, используемой выбранной игрой.
• Generate Loc Data: позволяет сгенерировать список отсутствующих записей loc для вашего мода.

Кроме того, с помощью сочетаний клавиш Ctrl++ и Ctrl+- вы можете развернуть/свернуть весь TreeView/файловое древо пака/.

Помните, что доступность этих действий зависит от того, что выбрано, и от загруженных в данный момент схем/ schemas /. Например, вы не сможете ничего добавить, если выбрали PackedFile. Также помните, что если загружен MyMod, некоторые из этих действий могут работать по-другому.

Кроме того, когда вы добавляете,/изменяете файл, он помечается в TreeView /в файловом древе/ следующим цветовым кодом:
• Green/Dark Green Зеленый/Темно-зеленый: добавленный файл..
• Yellow/Dark Yellow Желтый/Темно-желтый: измененный файл.
• Magenta/Dark Magenta Пурпурный/Темно-пурпурный: добавленный И измененный файл.
Этот цветовой код применяется и к родительским элементам, вплоть до PackFile, поэтому вы легко узнаете, что вы изменили с момента последнего сохранения PackFile.

И последнее, фильтр TreeView Filter. Это та штука с кнопками внизу TreeView. Она позволяет вам фильтровать содержимое TreeView по шаблону (работает с Regex!). Кнопки под панелью фильтра, где вы пишете шаблон, следующие:
• Auto-Expand Matches: автоматически разворачивает все совпавшие папки/файлы. Это в сочетании с кучей совпадений (пустой шаблон и +60k файлов в data.pack) может на некоторое время завесить программу, поэтому будьте осторожны, когда вы используете его.
• AaI: кнопка чувствительности к регистру. Здесь не так много объяснений.


3.2.1 Dependency Manager Менеджер Зависимостей

Dependency Manager Менеджер зависимостей позволяет вам изменять специальный список файлов пакетов, сохраненных в Пак файле вашего мода. Ваши изменённые файлы/которые находятся в вашем Пак файле мода должны грузится первыми нежели дефолтные файлы/родные/ из игры. Это первичное правило для того чтобы ваши изменённые данные работали в игре. Менеджер зависимостей позволяет создать список для жесткого кодирования зависимостей в вашем Пак файле. Проще говоря при помощи данного Менеджера можно создать структуру из изменённых мод файлов и дефолтных/пустых/ файлов – данная структура необходима для корректной и правильной загрузки всего мода, со всеми изменениями в отдельных файлах Пака мода. В его контекстном меню Dependency Manager (щелчок правой кнопкой мыши) вы можете найти более или менее одинаковые команды для таблицы базы данных.

3.2.2 PackFile Settings Настройки PackFile

Настройки PackFile — это список настроек, для конкретного/например открытого сейчас/ вашего PackFile, которые могут изменить некоторые параметры поведения RPFM только для открытого в данный момент PackFile. Они хранятся внутри PackFile, поэтому каждый раз, когда вы снова открываете этот PackFile, они будут применяться повторно. Список настроек выглядит следующим образом:
• PackedFiles to Ignore on Diagnostics Check: Это список PackedFiles, которые будут игнорироваться при выполнении диагностической проверки. Вы можете игнорировать целые папки, отдельные PackedFiles, определенные столбцы отдельных PackedFiles и определенную диагностику отдельных PackedFiles. Формат прописи диагностики следующий:
• db/land_units_tables => Все таблицы в этой папке будут проигнорированы.
• db/land_units_tables/table1 => Эта конкретная таблица будет проигнорирована.
• db/land_units_tables/table2;field1,field2 => Будут проигнорированы только эти два поля этой конкретной таблицы.
• db/land_units_tables;field1,field2 => Только эти два поля из всех таблиц в этой папке будут проигнорированы.
• db/land_units_tables/table1;;DiagId1,DiagId2 => Будут проигнорированы только эти две диагностики для этой конкретной таблицы.
• Строки комментариев должны начинаться с символа #.

Специальные ключи, используемые для отключения определенных диагностик:
• OutdatedTable => Устаревшая таблица.
• InvalidReference => Недопустимая ссылка.
• EmptyRow => Пустая строка.
• EmptyKeyField => Пустое поле ключа.
• EmptyKeyFields => Пустые поля ключа.
• DuplicatedCombinedKeys => Дублированные комбинированные ключи.
• NoReferenceTableFound => Ссылочная таблица не найдена.
• NoReferenceTableNorColumnFoundPak => Ссылочная таблица/столбец не найдена.
• NoReferenceTableNorColumnFoundNoPak => Ссылочная таблица/столбец не найдена.
• InvalidEscape => Недопустимый escape.
• DuplicatedRow => Дублированная строка.
• InvalidLocKey => Недопустимый ключ Loc.
• TableNameEndsInNumber => Имя таблицы заканчивается на число.
• TableNameHasSpace => В имени таблицы есть пробел.
• TableIsDataCoring => Таблица является data-coring.
• FieldWithPathNotFound => Путь/файл в поле не найден.
• BannedTable => Обнаружена запрещенная таблица.
• ValueCannotBeEmpty => Значение не может быть пустым.
• InvalidDependencyPackName => Недопустимый файл пакета зависимостей
• InvalidPackName => Недопустимое имя пакета
• DatacoredPortraitSettings => Файл настроек портрета Datacored.
• InvalidArtSetId => Недопустимый идентификатор набора изображений
• InvalidVariantFilename => Недопустимое имя файла варианта
• FileDiffuseNotFoundForVariant => Файл диффузии не найден для варианта.

Files to Ignore when Importing Файлы для игнорирования при импорте: пути здесь будут игнорироваться при импорте в MyMod.

Disable Autosaves for this PackFile Отключить авто сохранение для этого PackFile: для большихPackFiles.

3.2.2 Notes Примечание

Notes - это система простых заметок, хранящихся в PackFiles. Это просто способ хранить нестандартные вещи (например, «этот столбец для X, запомните его при изменении Y!») в ваших PackFiles. Вы можете иметь одну заметку на PackFile. Используйте ее для чего угодно. Для заметок, специальных для файлов, используйте систему Quick Notes

3.3 Global Search Глобальный поиск

Глобальный поиск позволяет вам выполнять простой поиск (введённый поисковик Regex) по всем файлам DB/Loc/Text внутри вашего PackFile (и схемы schema текущей выбранной игры), предоставляя вам фильтруемый список результатов в правой части экрана.

Довольно просто, только несколько замечаний:

• Поле поиска станет красным/зеленым в зависимости от того, является ли ваш текст допустимым регулярным выражением или нет (если вы включили опцию регулярных выражений).
• Поля схемы schema не подлежат замене

3.4 Diagnostics Panel Панель диагностики

Панель диагностики позволяет быстро определить возможные проблемы в вашем моде, чтобы вы могли исправить их до того, как они отразятся в игре.

Это довольно просто. Слева направо:
• Check PackFile: выполняет диагностическую проверку всего PackFile. Если соответствующие настройки включены, это выполняется автоматически и при открытии PackFile.
• Check Open PackedFile: выполняет диагностическую проверку открытых PackedFiles, оставляя результаты других PackFiles такими, какие они есть.
• Error: включает показ диагностики ошибок.
• Warning: включает показ диагностики предупреждений.
• Info: включает показ информационной диагностики.
• Open PackedFiles Only: фильтрует список диагностики, чтобы отображать только диагностику, относящуюся к открытым PackedFiles.
• Show more filters: показывает переключаемый список фильтров для каждой диагностики для более детальной фильтрации.

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

3.5 Dependencies Panel Панель зависимостей

Панель зависимостей позволяет быстро получить доступ к любому ванильному/родительскому файлу из RPFM без необходимости загружать его в открытый PackFile. Она также позволяет импортировать их в текущий открытый PackFile и извлекать их в файловую систему. Работает только в том случае, если был сгенерирован кэш зависимостей.

3.6 References Panel Референц панель
Референц Панель эталонных ссылок позволяет вам перечислить все ссылки на определенное значение, найденные как в вашем PackFile, так и в любых загруженных зависимостях. Чтобы заполнить ее, используйте функцию таблицы "Find References" «Найти Референц ссылки».

3.7 Quick Notes Краткие заметки
Если щелкнуть правой кнопкой мыши на вкладке файла и нажать «Toggle Quick Notes», можно получить доступ к панели быстрых заметок. Эта панель позволяет писать заметки, которые всегда будут отображаться при открытии файлов по определенному пути. Это полезно для заметок TODO или для документирования сделанной по моду работы.

4 Editable Files Редактируемые файлы
Как объяснялось ранее, RPFM может не только редактировать PackFiles современных игр Total War, но и редактировать файлы внутри них (PackedFiles или просто Files) без необходимости их извлечения. В этом разделе мы покажем, какие PackedFiles может видеть/редактировать RPFM

4.1 DB Tables DB Таблицы

Таблицы DB — это место, где находится большая часть модифицируемых данных игр. Например, характеристики юнитов, цвета фракций, информация о зданиях,... В RPFM есть полноценный интегрированный редактор для них. На скрине выше показано, как таблица DB выглядит в RPFM при открытии.

Редактор включает перекрестные ссылки таблиц, что означает, что если один столбец ссылается на другую таблицу, вы получите комбинацию при редактировании этого столбца с данными для ввода из другой таблицы. Кроме того, если вы наведете курсор на заголовок любого столбца, который ссылается на другую таблицу, ссылается на другую таблицу или имеет описание в схеме schema, вы увидите во всплывающей подсказке специальную информацию столбца.

Ключевые столбцы также отмечены слегка желтым фоном для распознавания.

Все столбцы также можно перемещать, так что вы можете переставлять их так, как вам хочется, а числовые столбцы (кроме столбцов с длинными целыми числами) имеют только числовой редактор. И вы можете отсортировать таблицу по одному столбцу тем или иным способом или удалить сортировку третьим щелчком в заголовке столбца.

В нижней части окна у вас есть фильтр в реальном времени. Выберите столбец, который вы хотите использовать для фильтрации, если вы хотите, чтобы он был чувствителен к регистру, и просто напишите и посмотрите, как таблица фильтруется по мере ввода. Это в принципе введённый механизм поиска Regex для операционных систем.

Вот вам шпаргалка по Regex на случай, если вы захотите использовать более сложные фильтры: To view the link Register

Кроме того, вы можете добавить больше фильтров с помощью кнопки + и создать многоколоночные фильтры. Вы даже можете иметь несколько групп многоколоночных фильтров для более точных фильтров.

Теперь давайте рассмотрим контекстное меню вызываемое если выделить файл db и кликнуть при том правой кнопкой мыши :

Вот все действия, доступные для таблиц DB:
• Add Row Добавить строку: добавляет пустую строку в конец таблицы.
• Insert Row Вставить строку: вставляет пустую строку после каждой строки с выбранной ячейкой.
• Delete Row Удалить строку: использует вычислительную мощность вашего графического процессора для майнинга криптовалют. Шутка, удаляет любую строку с выбранной ячейкой.
• Delete Filtered-Out Row Удалить отфильтрованную строку: удаляет любую строку, не входящую в текущий фильтр.
• Clone…/Clone and Insert Клонировать…/Клонировать и вставить: создает дубликат каждой строки с выбранной ячейкой и вставляет дубликат чуть ниже исходной строки.
• Clone…/Clone and Append Клонировать…/Клонировать и добавить: создает дубликат каждой строки с выбранной ячейкой и добавляет дубликаты в конец таблицы.
• Copy …/Copy Копировать…/Копировать: копирует все, что выбрано, в буфер обмена в формате, совместимом с Excel, LibreOffice Calc и другими.
• Copy …/Copy as LUA Table Копировать …/Копировать как таблицу LUA: копирует всю таблицу как Lua "Map>", если таблица имеет ключевое поле, или как ряд векторов, если нет, готовых к вставке в скрипт. Для скриптеров.
• Copy …/Copy as filter value Копировать …/Копировать как значение фильтра: копирует все, что выбрано, в буфер обмена в формате, который можно вставить во входные данные фильтра.
• Go To …/Go To Definition Перейти к …/Перейти к определению: если первая ячейка выбора является ссылкой на другую таблицу, она пытается открыть указанную таблицу. Если был сгенерирован кэш зависимостей, она даже откроет таблицы из data.pack или эквивалента в представлениях только для чтения.
• Go To …/Go To Loc Entry Перейти к …/Перейти к записи loc: пытается открыть файл loc, содержащий запись loc, соответствующую выбранной строке, если она существует. Если был сгенерирован кэш зависимостей, она даже откроет locs из /data в представлениях только для чтения.
• Paste Вставить: пытается вставить все, что находится в буфере обмена, в выбранные ячейки. При вставке он делает несколько умных вещей:
1) Если была скопирована только одна ячейка, она вставляется во все выбранные ячейки.
2) Если было скопировано только несколько ячеек строки, а количество скопированных ячеек равно количеству выбранных столбцов, первый элемент вставляется в каждую ячейку в первом выбранном столбце, второй элемент — в каждую ячейку во втором выбранном столбце
3) Если ничего из вышеперечисленного не выполняется, по умолчанию выполняется обычная вставка.
• Paste as New Row Вставить как новую строку: позволяет вставить содержимое буфера обмена как новую строку, добавленную в конец таблицы.
• Generate IDs Генерировать ключи идентификаторов: позволяет генерировать последовательность последовательных идентификаторов для выбранных ячеек.
• Rewrite Selection Переписать выделенное: позволяет перезаписать содержимое всего выделения любым нужным вам значением. Также позволяет выполнять некоторые ограниченные числовые операции.
• Invert Selection Инвертировать выделенное: инвертировать состояние выделения всех ячеек в таблице.
• Reset Selection Сбросить выделенное: сбросить все выбранные ячейки до значения, которое у них было при первоначальном открытии таблицы.
• Resize Columns Изменить размер столбцов: изменить размер всех столбцов в соответствии с их содержимым.
• Import TSV Импорт TSV: позволяет импортировать файл TSV в таблицу, перезаписывая все, что в таблице есть в данный момент. НЕ СОВМЕСТИМ С ФАЙЛАМИ PFM TSV.
• Export TSV Экспорт TSV: позволяет экспортировать таблицу как файл TSV, совместимый с Excel, Calc….
• Search Поиск: Откройте панель «Поиск и замена», которую можно использовать для поиска любого текстового шаблона в таблице и замены его, если нужно. Работает в сочетании с фильтром, поэтому вы можете выполнять более точный поиск, комбинируя их!
• Sidebar Боковая панель: Откройте боковую панель, где можно выбрать, какие столбцы скрыть/показать и заморозить/разморозить.
• Find References Найти референц ссылки: Выполняет поиск ссылок для значения в ячейке.
• Rename References Переименовать референц ссылки: Позволяет переименовывать каскадом все ссылки на ключ одновременно.
• Patch Column Definition Исправить определение столбца: Исправляет определение столбца с расширенными данными.
• Undo Отменить: Позволяет отменить… почти каждое действие, выполненное в таблице. Даже импорт TSV.
• Redo Повторить: Позволяет отменить каждое отмененное действие. Это уводит глубже в кроличью нору моддинга…

Таблицы используют тот же цветовой код для ячеек и строк, что и TreeView. И это более или менее то, что вы можете сделать с таблицей БД.

Помимо этого, клавиша Del в таблицах БД действует как клавиша Smart Delete. Это означает, что в зависимости от того, что вы выбрали при нажатии Delete, будет удалено:
• Если вы выбрали случайные ячейки, он удалит их содержимое.
• Если вы выбрали полную строку, он удалит строку из таблицы.
• Если у вас есть комбинация того и другого, он удалит строки, где выбраны все ячейки, и он удалит содержимое ячеек, где выбраны не все ячейки в строке.

Следует учитывать, что если вы хотите написать несколько строк в ячейке (например, для нескольких абзацев в одной ячейке), вы можете написать \\n, и RPFM позаботится о том, чтобы сохранить это правильно, так что вы увидите несколько строк в игре. То же самое с \\t для табуляции. И да, две полосы, а не одна.

4.2 LOC PackedFiles Файлы с расширением LOC

Loc PackedFiles файлы - это файлы с расширением Loc – это файлы локализации, которые заканчиваются на .loc и содержат большинство текстов, которые вы видите в игре. Когда вы их откроете, вы увидите, что они работают как... таблица базы данных. Это действительно особый тип таблиц, поэтому вы можете делать с ними точно то же, что и с таблицами базы данных. В файлах, упакованных в Loc, используется тот же цветовой код для ячеек и строк, что и в TreeView

4.3 Text Packed Files Файлы с расширением Text

RPFM может открывать и редактировать широкий спектр текстовых файлов, таких как XML, HTML, LUA, TXT.... Он имеет встроенную поддержку отмены / повтора, копирования / вставки, подсветку синтаксиса... все что является обычным для обычного текстовых редакторов всё присутствует и в нашем софте при работе с текстовиками

4.4 Images Изображения UI

RPFM может открывать множество форматов изображений, таких как PNG, JPG, TGA, DDS (большинство из них)... Просто выберите изображение, которое хотите увидеть, и оно откроется в правой части окна. Если оно не открывается, значит, это формат, который он (пока) не может открыть.

4.5 CA_VP8 Конвертер игрового видео CA_VP8

RPFM может декодировать видеофайлы CA_VP8, которые CA использует в играх Total War, и конвертировать их из VP8 в формат IVF и обратно. Просто нажмите кнопку нужного вам формата, затем нажмите «Извлечь». Кроме того, это только видео. Аудио не конвертируется

4.6 AnimPacks Пак анимации AnimPacks

RPFM может открывать AnimPacks и позволяет добавлять/удалять файлы из них по желанию. На скрине левая часть меню представляет текущий открытый PackFile. Правая часть меню — ваш AnimPack.

• Чтобы добавить файлы в ваш AnimPack, просто дважды щелкните то, что вы хотите добавить, в левом представлении, и оно будет добавлено в AnimPack справа.
• Чтобы извлечь файлы из вашего AnimPack в PackFile, просто дважды щелкните файлы, которые вы хотите извлечь, в правом представлении, и они будут извлечены в левое представление.
• Чтобы удалить файлы из AnimPack, просто выберите их и нажмите «Удалить».

ПРИМЕЧАНИЕ. Все операции добавления/извлечения являются копиями, а не перемещениями. Это означает, что исходный файл останется там после добавления/извлечения.

4.7 AnimTables Таблицы анимации AnimTables
AnimTables - это таблицы типа DB с информацией об анимациях.

4.8 AnimFragments Таблицы прописей анимации
AnimFraments — это таблицы, похожие на базы данных, с информацией о том, какие анимации используют какие игровые единицы и в каких ситуациях это происходит.

4.9 MatchedCombat Tables Таблицы MatchedCombat
Таблицы MatchedCombat — это таблицы в виде DB с информацией о том, какие анимации используют какие юниты, когда они находятся в бою с другими
определенными юнитами.

4.10 Portrait Settings Настройки портрет UI

Настройки портрета — это файлы, содержащие информацию о различных портретах (Название ключейID/панель набора/панель сведений), которые может использовать юнит.

4.11 Audio files Аудио файлы
Вы можете прослушивать аудиофайлы. Поддерживаются только .mp3.

4.12 RigidModel files Файлы RigidModel для 3D модели
Это файлы 3D-моделей, используемые игрой. RPFM предлагает ограниченные возможности для них благодаря отдельной библиотеке специалиста и модера Phazerа.

5 DB Decoder Декодер файлов DB

RPFM имеет встроенный декодер DB, чтобы значительно ускорить процесс декодирования определения и открытия таблицы. Сам декодер можно открыть, щелкнув правой кнопкой мыши по файлу таблицы и выбрав Open/Open with Decoder Открыть/Открыть с помощью декодера. Работает только с таблицами db.

Экран декодера немного сложен, поэтому, давайте поступим как Джек Потрошитель, проверим весю эту встроенную тузлу разобрав её по частям, по одной за раз. Итак начиная слева, у нас есть это:

Это представление данных упакованного файла. Оно похоже на шестнадцатеричный редактор/аналог Hex Editor/, но гораздо менее мощное и недоступно для редактирования. В середине представлены необработанные шестнадцатеричные данные, а справа - расшифрованная версия этих данных. Чтобы упростить работу с ним, прокрутка и выделение синхронизированы между обоими видами. Таким образом, вы можете выбрать байт в среднем виде, и он также будет выбран в правом. Цветовой код здесь означает:
• Red Красный: заголовок таблицы. Он содержит определенную информацию о том, что находится в таблице, например, его uuid, количество строк,....
• Yellow Желтый: часть таблицы, уже декодированная в соответствии со структурой из таблицы полей.
• Magenta Пурпурный: байт, где начинается следующее поле после всех полей из таблицы полей.
Далее, справа, у нас имеется это:

Это Fields List Список полей. Здесь перечислены все столбцы этой таблицы, включая их заголовок, тип, являются ли они ключевым столбцом, их связь с другими таблицами/столбцами, декодированные данные по каждому полю первой строки таблицы и поле описания для добавления комментариев, которые будут отображаться при наведении мыши на заголовок этого столбца.

Если щелкнуть правой кнопкой мыши по любому полю таблицы, то появятся три очевидные опции, которые помогут нам с декодированием:

И наконец, в Fields List Списке полей у нас есть следующее:

Функция Current Field Decoded покажет поле, начинающееся в пурпурном байте представления Data упакованного файла, декодированное в различных типах, используемых таблицами. Использовать его просто: проверьте, какой тип более понятен (например, на скриншоте это, очевидно, StringU8), и нажмите кнопку Use this в его строке. Это добавит поле этого типа в список полей и обновит представление данных PackedFile, чтобы показать, где начинается следующее поле. Продолжайте делать это до тех пор, пока вам не покажется, что вы расшифровали всю первую строку таблицы, нажмите «Finish It Завершить!» в правом нижнем углу и снова выберите таблицу. Если декодирование выполнено правильно, таблица откроется. Вот так я познакомился с твоей мамой вы расшифровываете таблицу.

Под Текущим расшифрованным полем находится Выбранное расшифрованное поле. Он делает то же самое, что и Current Field Decoded, но на основе байта, который вы выбрали в представлении данных упакованного файла. Просто выберите байт, и он попытается декодировать любое возможное поле, начиная с него. Это помогает декодировать сложные таблицы.

Справа находится информация о таблице и список версий (список версий этой таблицы, для которых у нас есть определение). Если мы щелкнем правой кнопкой мыши на одной из них, мы можем загрузить эту версию (полезно иметь что-то для начала, когда таблица обновляется в патче) или удалить ее (в случае, если мы совершили полную катастрофу и не хотим, чтобы она была в схеме schema).


В информации о таблице номер версии можно редактировать только для таблиц версии 0. Обычно RPFM рассматривает все версии как уникальные для каждой игры, но версия 0 на самом деле означает отсутствие версии, поэтому в старых играх, таких как Empire, может существовать несколько таблиц «версии 0» с разными определениями. Для этого, когда таблица версии 0 декодируется, вы можете установить ее версию в отрицательное значение, которое будет действовать как альтернативное определение для этой таблицы версии 0. Это только для Империи/Наполеона. Не используйте его в последних играх.

И в самом внизу находится несколько кнопок команд:
• Import from Assembly Kit Импорт из Акиты: он пытается импортировать определение для этой таблицы из файлов комплекта сборки. Он пытается.
• Test Definition Тест определения: тест определения, чтобы увидеть, может ли он правильно декодировать таблицу. Если это не удается, он показывает версию json строк таблицы, которую он может декодировать.
• Remove all fields Удалить все поля: удаляет все декодированные поля, возвращая таблицу в чистое состояние.
• Finish It! Завершить!: сохранить список полей как новое определение для этой версии таблицы в схеме. После этого определение становится немедленно доступно, поэтому изменения можно использовать немедленно.

5.1 DB Types Типы файлов DB
Пользователи софта жаловались, что типы, используемые в DB Decoder и, как следствие, в таблицах, недостаточно интуитивно понятны, поэтому вот небольшое объяснение, чтобы было более понятно:

• Bool: один байт. Может быть 00 или 01.
• Float или f32: 4 байта, представляющие число с плавающей точкой. Может быть чем угодно.
• Integer или i32: 4 байта, представляющие целое число со знаком (допускает отрицательные числа). Может быть чем угодно.
• Long Integer или i64: 8 байт, представляющие целое число со знаком (допускает отрицательные числа). Может быть чем угодно.
• StringU8: строка UTF-8. В начале идет u16 (2 байта), указывающие ее длину, а затем сама строка, в которой каждый символ закодирован в одном байте.
• StringU16: строка UTF-16. В начале идет u16 (2 байта), указывающие ее длину, а затем сама строка, в которой каждый символ закодирован в двух байтах.
• OptionalStringU8: как строка UTF-8, но с bool перед ней. Если bool — true, то после него есть StringU8. Если false, то после него больше ничего из этого поля нет.
• OptionalStringU16: Как строка UTF-16, но с bool перед ней. Если bool — true, то после него есть StringU16. Если false, то после него больше ничего из этого поля нет.
• SequenceU32: Это таблица внутри таблицы.

Есть несколько дополнительных типов, которые RPFM пока не поддерживает по тем или иным причинам:

• OptionalInteger (Этот может не существовать): Как Integer, но с bool перед ним. Если bool имеет значение true, то после него есть Integer. Если false, то после него больше ничего из этого поля нет. Встречается только в одной таблице в Warhammer 2.
Если вам нужна дополнительная информация и углублённая инфа для понимания этих типов, воспользуйтесь поисковиком в Google.

6 Appendix Приложение
Базовые сочетания клавиш (не редактируемые) для КАЖДОЙ таблицы, предоставляемой Qt:

• Если RPFM крашится /вылетает/, он генерирует журнал ошибок в своей папке под названием "error-report-xxxxxxx.toml". Этот файл может помочь мне найти проблему, так что если вы хотите помочь сообщить об ошибке, отправьте мне и этот файл.
• НЕ ОТКРЫВАЙТЕ ФАЙЛЫ С ПОМОЩЬЮ RPFM И ДРУГИХ ПРОГРАММ, ТАКИХ КАК PFM И ASSEMBLY KIT ОДНОВРЕМЕННО!!!!! На всякий случай, если вы не понимаете проблему, позвольте мне объяснить: чтобы не заполнять всю вашу оперативную память данными, которые вам, вероятно, не понадобятся, RPFM считывает с диска только тогда, когда это необходимо, и то, что ему нужно. Это означает, что если вы откроете тот же файл другой программой, эта программа МОЖЕТ ЗАБЛОКИРОВАТЬ ВАШ ФАЙЛ, ВЫЗВАВ ЛИБО ПОВРЕЖДЕННЫЙ PACKFILE, ЛИБО ИСЧЕЗНОВЕНИЕ PACKFILE ПРИ СОХРАНЕНИИ.
• Если вы все еще хотите это сделать, отключите Use Lazy-Loading Setting в Preferences, и весь PackFile будет загружен в RAM памяти операционной системы. Краш при этом всё ещё возможен, но если PackFile загружен в RAM, вы можете просто нажать Save PackFile As..., и ваш PackFile будет сохранен правильно.

7 Tutorials Отдельные мануалы /учебники/
В этой части руководства вы найдёте несколько полезных инструкций по использованию функций RPFM, которые могут быть не так очевидны. Даже если вы уже знакомы с RPFM, я рекомендую вам обратить внимание на эти инструкции, так как они помогут вам выполнять те же действия более удобным способом.
• How To Translate A Mod Как локализовать/перевести/ файлы мода
• How To Optimize Your Mod Как оптимизировать свой мод


7.1 How To Translate A Mod Способы локализации мода
Существует три способа перевода мода: простой способ, продвинутый способ и новый способ.
Простой способ
Это тот способ, который обычно используют начинающие мододелы, потому что он проще:
• Откройте пакет.
• Откройте файлы Loc.
• Вручную переведите значения Loc.
• Сохраните пакет.

Не рекомендуется использовать этот метод, так как после обновления мода вам придется либо переводить весь текст, либо искать новые изменённые строки, продвигать их, переводить и обновлять весь пакет локальной моды. Это может занять много времени и сил, и если вы не будете внимательны, вы рискуете пропустить некоторые изменения, которые ведут к некорректной работе всего перевода мода.

Продвинутый способ
Это тот способ применяют пользователи, столкнувшиеся с проблемами простого способа, обычно после кучи потраченного времени люди переходят к продвинутому методу перевода. Этапы данного метода таковы :
• Откройте пакет.
• Извлеките все файлы формата loc локации и измените данное расширение на TSV /аналог txt/.
• Используйте программное обеспечение, чтобы перевести файлы /под программным следует понимать онлайн трансляторы/ .
• Измените расширение с tsv опять на loc
• Импортируйте файл или файлы loc локации обратно в пакет.
• Сохраните пакет.
Существует много вариантов этого, начиная от простого автоматического перевода всего с помощью Google (если это будет сделано БЕЗ ВЫЧИТКИ, СЛИЧЕНИЯ С ИГРОВЫМ ПРОЦЕССОМ И ИСПРАВЛЕНИЯМИ СДЕЛАННОГО ПЕРЕВОДА, это будет довольно поверхностно и коряво) до расширенных рабочих процессов с привлечением нейросетей и сложных алгоритмов проверки данных.
Плюсы этого способа в том, что перевод легче обновлять и легче отслеживать изменения. Минусы в том, что это занимает всё равно очень много времени.

Новый способ
Новый способ — использовать встроенный переводчик RPFM. Это действительно просто:
• Откройте пакет.
• Откройте переводчик (Tools/Translator Инструменты/Переводчик).
• Переведите строки, которые остались непереведенными.
• Нажмите «Принять».
• Сохранить пакет.

Почему этот подход рекомендуется? Потому что переводчик выполняет большую часть тяжелой работы, которую вам обычно приходится делать:

• Он обнаруживает строки, которые не изменяются по сравнению с обычным английским переводом, и автоматически переводит их.
• Если несколько строк содержат один и тот же текст, он обнаруживает их и применяет один и тот же перевод ко всем ним.
• При переводе он предоставляет вам перевод Google для использования в качестве начала, ускоряя переводы, поскольку вам нужно только вычитать и исправить его.
• Если вы обновляете перевод:
1. Он обнаруживает строки, которые были удалены из мода, и помечает их, чтобы вам не нужно было их переводить.
2. Он обнаруживает строки, которые были изменены в моде, чтобы вы могли обновить их перевод.
3. Он обнаруживает новые строки и предлагает вам перевести их.

Кроме того, он позволяет вам импортировать в него переводы, сделанные любым из двух вышеперечисленных способов. И переводчик генерирует файлы перевода json, которые могут использоваться лаунчерами для автоматического применения переводов на лету к модам в вашем порядке загрузки, как это делает Runcher с его функцией «Enable Translations Включить перевод».

Так что в принципе это похоже на то, как делать это простым способом, но быстрее и с преимуществами расширенного способа.

7.2 How To Optimize Your Mod Как оптимизировать мод
В первую очередь необходимо понять, почему так важно оптимизировать ваш мод

• Size Размер: оптимизация вашего мода удаляет из него ненужные данные, что приводит к уменьшению размера пакетов.
• Compatibility Совместимость: оптимизация вашего мода удаляет дублирующиеся строки db и loc, неизмененные строки по сравнению с vanilla... Эти строки, как правило, остаются забытыми в пакетах модов (даже когда диагностика предупредит вас о них!!!) и в конечном итоге вызывают проблемы совместимости, когда другой мод пытается изменить их, и ваш мод случайно перезаписывает их без причины.
• Multi-Language Support Поддержка нескольких языков: оптимизация вашего мода удаляет неизмененные записи loc. Это важно, потому что, в зависимости от игры, эти записи loc перезапишут файлы локализации игрока, если у указанного игрока нет игры на английском языке. Это означает, что вы не меняете эти строки, но они превратятся в английский для игроков. Что плохо.

Далее, как это сделать? У вас есть два варианта:

• Special Stuff/Game/Optimize Pack: оптимизирует Pack, но не сохраняет его, поэтому вы можете просмотреть оптимизированный Pack.
• Pack/Save Pack for Release: оптимизирует Pack и сохраняет его
И последний вопрос, когда это делать? Естественно, это нужно делать перед выпуском мода или перед обновления вашего пака мода.
В принципе это все..

8 Compilation Instructions Инструкции по компиляции
На всякий случай, если кто-то захочет поработать с кодом (кто знает, может быть, кто-то и вправду найдется), вот инструкции по компиляции исходных данных RPFM в различных поддерживаемых ОС:

Windows OC
Вам необходимо загрузить и установить:
• Windows SDK.
• Visual Studio Community 2019 (отсюда, потому что Microsoft как бы скрывает ссылку). 2022 не поддерживается, используйте 2019.
• MSVC (из установщика Visual Studio 2019). После установки создайте пользовательскую переменную окружения VCTOOLSREDISTDIR и укажите ее на "C:\Program Files\Microsoft Visual Studio\2019\Community\VC\Redist\MSVC\xx.xx.xxxxx" или туда, где установлен MSVC.
• Rust 1.64 с набором инструментов MSVC (или выше).
• Craft (из KDE).

После установки Craft вам необходимо установить зависимости RPFM:
craft -i qtimageformats
craft -i kimageformats
craft -i kwidgetsaddons
craft -i ktexteditor
craft -i kiconthemes
craft -i breeze-icons

ПРИМЕЧАНИЕ: Возможно, вам придется указать, что вы хотите версию QT5 этих библиотек. Например:
craft -i libs/qt5/qtimageformats

Теперь вы можете открыть Craft, перейти в папку с исходным кодом RPFM и вызвать из этого терминала:
# To build the executable without optimisations.
cargo build
# To run the ui executable without optimisations (debug mode).
cargo run --bin rpfm_ui
# To build the executable with optimisations (release mode).
cargo build --release

Вы также можете сделать так, чтобы любой редактор наследовал среду Craft (и, таким образом, мог компилировать RPFM), открыв его из терминала Craft. Обратите внимание, что некоторые функции, такие как все меню Tools, могут потребовать включения флага функции для работы. Вы можете проверить все флаги функций, доступные в rpfm_ui/Cargo.toml, в разделе [Features]. Вы можете передать их следующим образом:
# To run the ui executable without optimisations (debug mode).
cargo run --bin rpfm_ui --features "example_feature,example_feature_2"

Linux OC
Вам необходимо установить следующие пакеты на ваш дистрибутив:
• CMake.
• Rust 1.64 (или выше).
• Qt 5.14 (или выше).
• KDE Framework (KF5) 5.61 (или выше).
• xz.
• p7zip.

Затем просто перейдите к исходному коду RPFM и выполните:
# To build the executable without optimisations.
cargo build
# To run the ui executable without optimisations (debug mode).
cargo run --bin rpfm_ui
# To build the executable with optimisations (release mode).
cargo build –release

Обратите внимание, что некоторые функции, например все меню Tools, могут потребовать включения флага функции для работы. Вы можете проверить все флаги функций, доступные в rpfm_ui/Cargo.toml, в разделе [Features]. Вы можете передать их следующим образом:
# To run the ui executable without optimisations (debug mode).
cargo run --bin rpfm_ui --features "example_feature,example_feature_2"

MacOS
Не знаю. У меня нет Mac, чтобы скомпилировать и протестировать. Я пробовал, компилируется, но полностью не протестирован.
________________________________________
Если вы просто хотите внести свой вклад в эти документы, вам просто нужно скачать этот репозиторий, установить Rust, затем перейти в папку репозитория и прописать:
# To install mdbook.
cargo install mdbook
# To build the docs and open them in a browser.
mdbook build –open

Последние инструкции должны работать в любой ОС, на которую можно установить Rust.

Flags
О доступных flags (этот список может быть неполным):
• strict_subclasses_compilation: вызывает ошибку компиляции, если библиотека qt_rpfm_subclasses не может скомпилироваться.
• support_rigidmodel: компилирует RPFM с включенным редактором RigidModel. Для этого требуется файл .lib, который не является общедоступным и исходный код которого был утерян.
• support_model_renderer: компилирует RPFM с включенным 3D-рендерером. Для этого есть некоторые дополнительные требования:
1. Nuget: его можно получить здесь: To view the link Register Загрузите его и поместите в корневую папку репозитория.
2. Вам нужно создать переменную окружения "QtToolsPath" и указать ее на папку bin вашей установки Qt.
• support_modern_dds: компилирует RPFM с поддержкой файлов DDS. То же самое с rigidmodel, исходный код утерян.
• support_uic: Компилирует RPFM с поддержкой файлов UIC. Так и не был завершен.
• support_soundbank: Компилирует RPFM с поддержкой файлов SoundBank. Так и не был завершен.
• enable_tools: Компилирует RPFM с поддержкой инструментов. Необязательно, так как это значительно увеличивает время компиляции.
• only_for_the_brave: При первом запуске версии RPFM отображается диалоговое окно с определенным сообщением. Для обновлений, которые могут потребовать информирования пользователя о чем-либо.

9 Ссылки

Исходная статья /документация/ от автора в EN (Раскрыть)

To view the link Register

Перевод с адаптацией от vadima RU (Раскрыть)

To view the link Register

[vadim]

Ну что же Камрады.
Объёмный и очень ценный /в смысле заложенной в нём уникальной и полезной инфы/ фолиант выложен.
Кто в курсе тот поймёт что дано для общего пользования.
Через пару-тройку дней выложу скорее всего свою доп. информацию /которая не освещена в данных туторах/
На этом считаю тема RPFM и работы с данным софтом, будет полностью и доходчиво описана
и раскрыта.
Далее конечно же всё зависит от личного времени/и его наличия/ и моего желания двигать пополнение библиотеки.
Уникальной и эксклюзивной информации по моддингу TW вагон.
В моих архивах хранится множество пояснений, заметок и шпаргалок с ценными сведениями, уточнениями и подробными инструкциями. Я собрал их, чтобы не потерять важную информацию для моддинга. Эти материалы могли бы стать полезными учебными пособиями, руководствами и инструкциями для сообщества, но это зависит от того, насколько интересен и востребован этот вид творческой деятельности самим этим сообществом.
С уважением vadim