Загрузчик Protobuf

Загрузить файл protobuf(.data) во время выполнения.
Все моды открывают исходный код вгитхаб.
Особая благодарность@chenstackдля CSharpLoader

Следующий текст в первую очередь предназначен для разработчиков.
Если вы пользователь, вам не обязательно знать подробности об этом моде.
Вам нужно следовать инструкциям по установке другого автора только в том случае, если он утверждает, что его мод требует этот мод.
И знайте, что Ctrl+F7 — это горячая клавиша перезагрузки.

Как загрузить файл .Data:


Зачем вам это нужно?
Этот мод может загружать записи одну за другой вместо того, чтобы перезаписывать всю таблицу.
ЕСЛИ моддеры создают моды «.data» вместо модов «.pak», то весьма вероятно, что они не будут конфликтовать друг с другом.
(Этот мод не удаляет магическим образом все конфликты! Даже если вы установите этот мод, ваши старые «pak»-моды все равно будут конфликтовать, как и раньше.)
Для моддеров: вы можете изменять файл .data и перезагружать его во время выполнения. Это экономит время на упаковку, отладку или слияние пакетов для пользователей.

注意:不是说你装了这个mod，原本冲突的mod就突然间不冲突了！！
Встроенные данные могут быть изменены с помощью модуля mod.发布并以该mod加载,就不会像以前pak文件那样极易冲突了
Пакет данных для хранения данных и пакет pak для хранения данных.

Примечание:

0. Перезагрузка и сброс
Нажмите Ctrl+F7, чтобы перезагрузить файлы данных.
Данные в памятиБУДЕТ сброшен(Начиная с версии 1.1) перед перезагрузкой.
Но типы данных, которые не являются клонируемыми, не будут сброшены.
Этот мод изменяет prorobuf и обновляет кэш в GameDB при перезагрузке.

Нажмите Ctrl + F8 для сброса.
При загрузке файлов данных этот мод сохраняет значения до изменения.
При сбросе этот мод записывает сохранённые записи обратно.
Если другой мод изменит запись, измененную этим модом, между загрузкой и сбросом, эти изменения будут утеряны.
При нажатии Ctrl+F7 для перезагрузки этот мод автоматически сбросится перед перезагрузкой.

Нажмите Ctrl+F9 для суперсброса.
Перезагрузить все из виртуальных файлов.
При сбросе мод пытается восстановить только изменённые данные. При суперсбросе мод сбрасывает всё и загружает данные из PAK-файлов (как это делала игра при запуске).
Если нет ошибки, сбоя загрузки или другого мода, изменяющего protobuf, «Сброс» и «Суперсброс» должны иметь абсолютно одинаковый эффект.

1.Порядок загрузки:
Этот мод загружает подпапки вЛексикографический порядок(также известный как порядок словаря).
Например, папка «100_abc» должна быть загружена раньше «200_lalla».
Не выполняется рекурсивный поиск по папке. Например, файлы в папке «CSharpLoader/Mods/ProtobufLoader/BestSuit/MoreSuitSubDir/» не будут загружены.
Настоятельно рекомендуем называть вашу папку в формате [Номер]_[Имя], на случай, если вам потребуется загрузка в определенном порядке.

Для файлов в той же папке:
Этот мод сначала загружает все файлы ".data" (исключая ".insert.data" или ".bak.data") в порядке словаря.
Затем этот мод загружает все «.insert.data» в порядке словаря.

2.Правило нагрузки
При загрузке записи в «.data».
Если его нет в таблице в памяти, он будет добавлен в таблицу.
Если он уже есть в таблице в памяти, старая запись будетПолностью Замененопо новому.
Это означает, что у вас может быть несколько файлов данных, которые изменяют одну и ту же таблицу. Они не будут конфликтовать, пока они не изменяют одну и ту же запись.
Если они изменят одну и ту же запись,побеждает последний заряженный.

При загрузке записи в «.insert.data».
Если его нет в таблице в памяти, он будет добавлен в таблицу.
Если он уже есть в таблице в памяти, увеличивайте его идентификатор до тех пор, пока новый идентификатор не исчезнет из таблицы. Измените его идентификатор и вставьте его в таблицу с новым идентификатором.

Этот мод загрузит файлы после локализации инициализации.
При загрузке этого мода с помощью CSharpLoader, если и GameInstance, и GSLocalization завершили инициализацию, этот мод немедленно загрузит файлы.
В противном случае этот мод загрузит файлы сразу после инициализации GSlocalization.

3.Что изменяет этот мод?
Обычно данные в игре существуют в:
А) Виртуальные файлы в формате .pak.
B) Кэш GSProtobufRuntimeAPI/BG_ProtobufDataAPI в памяти.
C) Кэш GameDBRuntime/BGW_GameDB в памяти
D) Другие экземпляры в памяти

При запуске игры она считывает все данные из A в B, а затем создает кэш некоторых данных в C.
В процессе игры некоторые экземпляры напрямую считывают данные из B/C, другие создают кэш B/C в D при инициализации и считывают данные из D позже.

При использовании традиционного `pak`-мода вы фактически переопределяете A.
Когда этот мод загружает моды, онизменяет B и заставляет перестраивать C.


4.2.Файл конфигурации:
ProtobufLoader/Config.json:
Замолчи: уменьшить вывод журнала, если true. По умолчанию — False.
Если вам нужно загрузить большой объем файлов данных, включите эту функцию для повышения производительности.
Заткнись: уменьшить выход журнала в будущем, если значение true. По умолчанию — false.
Заткнись: не будет выведено никакого журнала, если не возникнет ошибка, если true. По умолчанию — False.
EnableChineseConsoleLog:Установите кодовую страницу консоли CSharpLoader на UTF-8.для корректного отображения китайского языка в консоли. Значение по умолчанию — true. (Отключите, если вам нужны другие символы в консоли.)

4.3.УВЕДОМЛЕНИЕ: Если вы хотите изменить несколько записей в таблице.
Ваш файл данных должен содержатьТОЛЬКОизмененные записи, чтобы избежать конфликтов. (Потому что в этом и есть весь смысл использования этого загрузчика.)

(Если вам нужна кнопка «Удалить все, кроме этого» в DataEditor.
Вы можете подождать, пока автор DataEditor добавит его.
Или используйтемоя версия редактора данных.)

5.Следующие таблицы не поддерживаются.


6. Обратите внимание на элементы с одинаковым названием, но разным идентификатором.
Например,
Лекарство может иметь рецепт и лекарственный предмет в таблице предметов с одинаковым названием. Но они разные.
Снаряжение может иметь несколько записей для каждого уровня в таблице снаряжения.
Пассивный эффект энергии также может иметь несколько записей для каждого уровня.
И т. д.

7. Помните о данных, которые считываются только из таблицы desc при инициализации.
Например,
Таблица TransQiTianDaShengConfigDesc используется для инициализации BUS_QiTianDaShengComp.
Если вы перезагрузите таблицу после начала игры, это может не вступить в силу, поскольку функция init еще не была вызвана повторно.



Примеры файлов данных:
Вы можете загрузить следующие примеры на странице файлов.
100_增加一个珍玩套装(君子牌风铎仙篆)增加火抗
200_锦鳞套加2条套装效果_日金乌套改为加大量攻防
300_青田葫芦改为10口上限
400_金箍棒(大圣套)添加天龙棍效果
500_行者套改为1件即可触发
600_InsertData_插入全局设置和被动技能映射
Пример преобразования существующих модов в версию файла данных

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


Установить вручную:
0.УстановитьCSharpLoader(>= v0.0.8)
(Обратите внимание, что более ранняя версия этого мода может не работать с последней версией CSharpLoader. Рекомендуем также обновить этот мод, если вы хотите обновить CSharpLoader)

1. загрузите zip-файл и распакуйте его.

2.
скопируйте папку [ModName] в[GameFolder]\b1\Binaries\Win64\CSharpLoader\Mods\
Структура dir должна быть такой:
-- b1\Binaries\Win64\CSharpLoader\Mods\
-- [ModName]
-- [ИмяМода].dll

Установка Vortex:
Поддерживается