Caricatore Protobuf

Carica il file protobuf(.data) in fase di esecuzione.
Tutte le mod sono open source ingithub.
Un ringraziamento speciale a@chenstackper CSharpLoader

Il testo seguente è fondamentalmente rivolto agli sviluppatori.
Se sei un utente, non hai realmente bisogno di conoscere i dettagli di questa mod.
Devi seguire le istruzioni di installazione di un altro autore solo se dice che la sua mod richiede questa mod.
E sappi che Ctrl+F7 è il tasto di scelta rapida per ricaricare.

Come caricare un file .Data:


Perché ne hai bisogno?
Questa mod può caricare i record uno alla volta anziché sovrascrivere l'intera tabella.
SE i modder creano mod ".data" invece di mod ".pak", ci sono ottime probabilità che non entrino in conflitto tra loro.
(Questa mod non elimina magicamente tutti i conflitti! Anche se installi questa mod, le tue vecchie mod "pak" continueranno a creare conflitti come prima.)
Per i modder, è possibile modificare il file .data e ricaricarlo in fase di esecuzione. Ciò consente di risparmiare tempo nel creare pacchetti, eseguire il debug o unire pacchetti per gli utenti.

注意：不是说你装了这个mod, 原本冲突的mod就突然间不冲突了.
意思是以后修改数据类的mod可以直接以data文件的形式发布并以该mod加载,就不会像以前pak文件那样极易冲突了
还省了把data文件打包成pak的工夫

Nota:

0. Ricarica e ripristina
Premere Ctrl+F7 per ricaricare i file di dati.
Dati in memoriaVerrà ripristinato(Dalla v1.1) prima di ricaricare.
Tuttavia, i tipi di dati che non sono clonabili non verranno reimpostati.
Questa mod modificherà prorobuf e aggiornerà la cache in GameDB durante il ricaricamento.

Premere Ctrl + F8 per reimpostare.
Quando si caricano file di dati, questa mod memorizza i valori prima della modifica.
Quando viene ripristinata, questa mod riscrive i record memorizzati.
Se un altro mod modifica il record modificato da questo mod tra il caricamento e il ripristino, tali modifiche andranno perse.
Quando si preme Ctrl+F7 per ricaricare, questa mod verrà automaticamente reimpostata prima di ricaricare.

Premere Ctrl+F9 per effettuare il Super Reset.
Ricarica tutto dai file virtuali.
Con "Reset", questa mod tenta di recuperare solo i dati modificati. Con "Super Reset", questa mod scarta tutto e li carica da file .pak (come faceva il gioco all'avvio).
Se non c'è un bug, un errore di caricamento o un'altra mod che modifica il protobuf, "Reset" e "Super Reset" dovrebbero avere esattamente lo stesso effetto.

1. Ordine di caricamento:
Questa mod carica le sottocartelle inOrdine lessicografico(noto anche come ordine del dizionario).
Ad esempio, la cartella "100_abc" deve essere caricata prima di "200_lalla".
Non verrà eseguita la ricerca ricorsiva nella cartella. Ad esempio, i file in "CSharpLoader/Mods/ProtobufLoader/BestSuit/MoreSuitSubDir/" non verranno caricati.
Si consiglia vivamente di assegnare alla cartella il nome [Numero]_[Nome] nel caso in cui sia necessario caricarla in un certo ordine.

Per i file nella stessa cartella:
Questa mod carica prima tutti i file ".data" (esclusi ".insert.data" o ".bak.data") in ordine di dizionario,
Quindi questa mod carica tutti i ".insert.data" nell'ordine del dizionario.

2. Regola di carico
Quando viene caricato un record in ".data".
Se non è presente nella tabella in memoria, verrà aggiunto alla tabella.
Se è già presente nella tabella in memoria, il vecchio record saràInteramente Sostituitoda quello nuovo.
Ciò significa che è possibile avere più file di dati che modificano la stessa tabella, senza che entrino in conflitto finché non modificano lo stesso record.
Se modificano lo stesso record,vince l'ultimo caricato.

Quando viene caricato un record in ".insert.data".
Se non è presente nella tabella in memoria, verrà aggiunto alla tabella.
Se è già presente nella tabella in memoria, aumenta il suo ID finché il nuovo ID non è più presente nella tabella. Modifica il suo ID e inseriscilo nella tabella con il nuovo ID.

Questa mod caricherà i file dopo l'inizializzazione della localizzazione.
Quando questa mod viene caricata da CSharpLoader, se sia GameInstance che GSLocalization hanno terminato l'inizializzazione, questa mod caricherà immediatamente i file.
Altrimenti questa mod caricherà i file non appena GSlocalization verrà inizializzato.

3. Cosa modifica questa mod?
Generalmente i dati nel gioco esistono in:
A) File virtuali in formato .pak.
B) GSProtobufRuntimeAPI/BG_ProtobufDataAPI Cache in memoria.
C) GameDBRuntime/BGW_GameDB Cache in memoria
D) Altre istanze in memoria

All'avvio del gioco, il gioco legge tutti i dati da A a B, quindi crea la cache di alcuni dati in C.
Durante il processo di gioco, alcune istanze leggono direttamente da B/C, altre creano una cache di B/C in D all'inizializzazione e leggono da D in un secondo momento.

Quando si utilizza una mod `pak` tradizionale, in realtà si sta sovrascrivendo A.
Quando questa mod carica le mod,modifica B e forza la ricostruzione di C.


4.2.File di configurazione:
ProtobufLoader/Config.json:
Stai zitto: riduce l'output del registro se vero. Falso per impostazione predefinita.
Se devi caricare file di dati di grandi dimensioni, attiva questa opzione per aumentare le prestazioni.
Stai zitto: se è vero, riduce ulteriormente l'output del log. Falso per impostazione predefinita.
ShuuutUp: non verrà generato alcun output di registro a meno che non si verifichi un errore se il valore è true. Falso per impostazione predefinita.
EnableChineseConsoleLog:Imposta la codepage della console CSharpLoader su UTF-8per visualizzare correttamente il registro della console in cinese. Vero per impostazione predefinita. (Disattivalo se hai bisogno di altri caratteri nella console.)

4.3.AVVISO: Se si desidera modificare più record in una tabella.
Il tuo file di dati dovrebbe contenereSOLTANTOi record modificati per evitare conflitti. (Perché è proprio questo lo scopo di usare questo caricatore.)

(Se hai bisogno di un pulsante "Elimina qualsiasi cosa tranne questa" in DataEditor.
Puoi attendere che l'autore di DataEditor lo aggiunga.
Oppure usail mio fork di Data Editor.)

5.Le seguenti tabelle non sono supportate.


6. Fai attenzione agli elementi con lo stesso nome ma ID diverso.
Per esempio,
Un medicinale può avere un oggetto ricetta e un oggetto medicinale entrambi nella tabella degli oggetti con lo stesso nome. Ma sono diversi.
Un equipaggio potrebbe avere diversi record per ogni livello nella tabella degli equipaggi.
Anche un effetto passivo di vigore potrebbe avere più registrazioni per ogni livello.
Ecc.

7. Prestare attenzione ai dati che vengono letti solo dalla tabella desc durante l'inizializzazione.
Per esempio,
La tabella TransQiTianDaShengConfigDesc viene utilizzata per inizializzare BUS_QiTianDaShengComp.
Se si ricarica la tabella dopo aver avviato il gioco, potrebbe non avere effetto perché la funzione init non è stata ancora richiamata.



Esempi di file di dati:
È possibile scaricare i seguenti esempi nella pagina File.
100_增加一个珍玩套装(君子牌风铎仙篆)增加火抗
200_锦鳞套加2条套装效果_日金乌套改为加大量攻防
300_青田葫芦改为10口上限
400_金箍棒(大圣套)添加天龙棍效果
500_行者套改为1件即可触发
600_InsertData_插入全局设置和被动技能映射
Esempio di conversione di mod esistenti in versione file di dati

Puoi usare ilEditor di datiper verificare esattamente cosa hanno fatto.
(Si noti che alcuni esempi modificano la stessa tabella e possono funzionare contemporaneamente.
E ogni file di dati di esempio contiene SOLO i record necessari.)


Installa manualmente:
0.InstallCSharpLoader(>= v0.0.8)
(Nota che una versione precedente di questa mod potrebbe non funzionare con l'ultima versione di CSharpLoader. Si consiglia di aggiornare anche questa mod se si desidera aggiornare CSharpLoader)

1. Scaricare il file zip ed estrarlo.

2.
copiare la cartella [ModName] in[CartellaGioco]\b1\Binari\Win64\CSharpLoader\Mods\
la struttura della directory dovrebbe essere simile a:
-- b1\Binari\Win64\CSharpLoader\Mods\
-- [NomeMod]
-- [NomeMod].dll

Installazione tramite Vortex:
Supportato