Libreria di indirizzi per plugin SKSE

E' importante! Questo è ora diviso in due versioni: edizione speciale (1.5.x) ed edizione anniversaria (1.6.x). Gli ID che puntano agli indirizzi non corrisponderanno tra queste due versioni (il gioco eseguibile è troppo diverso per corrispondere, e anche se corrispondono al codice all'interno di queste funzioni è comunque diverso).

La descrizione

Per gli utenti mod regolari: Scaricare e installare il pacchetto"all-in-one "dalla sezione file. è possibile utilizzare il gestore mod o farlo manualmente. I file. bin dovrebbero andare qui:
Dati/SKSE/Plug-in/
Non c'è bisogno di leggere il resto di tutto questo.

Per gli autori del plugin skse dll:
Questa è una risorsa modder (un file di intestazione). è possibile caricare un database che memorizza gli offset in modo che il plugin dll possa essere indipendente dalla versione senza richiedere di essere ricompilato. Il file di intestazione può essere scaricato dalla sezione opzionale dei file. Per l'edizione anniversario il file di intestazione è chiamato versionlibdb.h invece di versiondb.h! Se stai usando commonlib allora tutto questo è già incorporato e non hai bisogno di nulla da qui.


Come usare

Il modo più veloce:


Ora ti stai chiedendo qual è il valore"123 "lì. Questo è l'identificazione di un indirizzo. Database di versioni diverse avranno lo stesso ID per un indirizzo, ma può indicare valori diversi. Per ottenere un elenco di tutte le coppie di ID e valori per una versione specifica fai questo:



Invece di 1,5,62,0 metti la versione che stai invertendo e familiarità con. Devi prima avere il file di database corrispondente nella directory/Data/SKSE/plugins.

Dopo aver chiamato questo si dovrebbe avere un nuovo file nella directory principale skyrim chiamato"offsets-1.5.62.0.txt "o qualsiasi cosa si metta come il nome del file. Sarà nel formato in cui ogni riga è:
ID decimaleOffset esagerato

Per esempio se si dispone di un indirizzo 142f4def8(puntatore statico dei caratteri del giocatore) in 1.5.62.0 che si desidera rendere indipendente la versione si farebbe questo:
1. cercare 2f4def8 nel file di offset. Perché questo è l'offset senza la base 140000000
2. vedere che l'ID è 517014 (decimale!)
3. se si desidera questo indirizzo nella DLL in runtime fai questo:


void * addressOf142F4DEF8 = db.FindAddressById(517014);


Ed ecco che ce l'hai.

La struttura versiondb ha le seguenti funzioni:

Spoiler:  

La mostra


bool Dump (const std:: string & path); //scarica il database attualmente caricato nel file
Carico bool (int major, int minor, int revision, int build); //caricare una versione specifica se db-major-minor-revision-build.bin esiste nella directory data/SKSE/plugins
Carico bool (); //carica la versione per l'applicazione corrente
void Clear (); //cancellare il database attualmente caricato
void GetLoadedVersion(int & major, int & minor, int & revision, int & build) const; //ottenere la versione del file di database che abbiamo caricato ora
bool GetExecutableVersion(int & major, int & minor, int & revision, int & build) const; //ottenere la versione dell'applicazione attualmente in esecuzione
const std:: string & GetModuleName () const; //ottenere il nome del modulo di database attualmente caricato, questo dovrebbe mostrare "SkyrimSE.exe"
const std:: string & GetLoadedVersionString () const; //ottenere la versione attualmente caricata come stringa, ad esempio "1.5.62.0"
const std:: map& GetOffsetMap () const; //ottenere la mappa dell'ID da spostare se è necessario iterarla manualmente
void * FindAddressById (ID lungo lungo non firmato) const; //trovare indirizzo per ID, questo includerà già l'indirizzo base e l'indirizzo corretto. Ritornerà null se non trovato!
bool FindOffsetById(ID lungo non firmato, & risultato lungo non firmato) const; //trovare offset per id, questo verrà semplicemente offset senza base inclusa.
Bool finddbyaddress(void * ptr, unsigned long long & result) const; //trovare id per indirizzo, questo tenterà una ricerca inversa per convertire indirizzo in id
bool FindIdByOffset(offset lungo senza segno, & risultato lungo senza segno) const; //trovare id per offset, questo tenterà una ricerca inversa per convertire offset in id


Le cose che dovresti sapere e tenere a mente:

1. puoi includere qualsiasi (o tutti) dei file di database con il tuo plugin ma può aumentare la dimensione del file notevolmente (di circa 2.5 mb). Finora è stato comune contrassegnare questo mod come dipendenza invece.

2. dovresti sempre caricare il database solo una volta all'avvio, inizializzare/memorizzare gli indirizzi necessari e lasciarlo scaricare. Scaricare significa solo che la struttura versiondb viene eliminata o persa (se si è assegnato sullo stack). Questo assicurerà che non si utilizzi una quantità inutile di memoria durante l'esecuzione del gioco. Non c'è bisogno di mantenere il database caricato durante il gioco. Questo è un punto moot se si usa commonlib in quanto lo carica solo una volta invece di ogni dll.

3. il database contiene indirizzi di funzioni, variabili globali, RTTI, vtables e qualsiasi altra cosa che possa avere un riferimento a esso. Non contiene indirizzi che si trovano nel mezzo delle funzioni o nel mezzo dei globali. Se hai bisogno di un indirizzo nel mezzo della funzione dovresti cercare l'indirizzo base della funzione e aggiungere l'offset extra da solo. Non contiene inoltre cose inutili come l'allineamento attorno alle funzione(che sono riferimenti in rdata), la sezione pdata viene scartata e alcune informazioni generate dal compilatore da rdata vengono scartate.

4. si dovrebbe sempre controllare il risultato per assicurarsi che il database caricato correttamente (bool load restituisce true) e che gli indirizzi richiesti effettivamente restituiscano un risultato valido (non null). Se non riesce a caricare significa che il file mancava la versione più probabile o sbagliata (ad esempio cercando di usare l'intestazione se in ae). Se la query fallisce significa che l'indirizzo non è stato trovato in quella versione. Questo potrebbe significare che il codice del gioco è cambiato abbastanza da non essere più valido per quella versione o il database stesso non è riuscito a rilevare l'indirizzo corretto. Se una di queste cose accade si dovrebbe fallire l'inizializzazione del plugin per far sapere a skse che non si è caricato correttamente. O mostrare manualmente un messaggio di errore.

5. sarebbe anche meglio se avete controllato per assicurarsi che l'indirizzo esiste in tutte le versioni del gioco prima di pubblicare il vostro plugin dll. Per farlo caricare ogni versione del file di database e interrogare lo stesso ID indirizzo in ciascuna di esse per assicurarsi che esista:

Spoiler:  

La mostra


bool LoadAll (std:: vettore& Tutti)
{
Versioni int statiche [] = {3, 16, 23, 39, 50, 53, 62, 73, 80, 97, -1};
Per (int i=0; versione [i] > = 0; i++)
{
VersionDb * db = new VersionDb ();
if (! db-> Load(1, 5, versioni [i], 0))
{
Cancellare db;
Restituire falso;
}
all.push_back(db);
}
Restituisce vera;
}

Bool existensinall (std):: vettore& tutti, ID lungo non firmato)
{
Risultato lungo lungo non firmato = 0;

{
if (! db-> FindOffsetById(id, risultato))

}
Restituisce vera;
}

void FreeAll (std:: vettore& Tutti)
{
for(db automatico: tutti)
Cancellare db;
all.clear ();
}

Boolean IsOk ()
{
std:: vettoreTutti;
if (! LoadAll(all))
{
_FATALERROR("caricare uno o più database di versione per l'eseguibile corrente! ");
FreeAll (all);
Restituire falso;
}

if (! Existensinall(all, 517014))
{
_FATALERROR("517014 non esiste in tutte le versioni del database! ");


}

FreeAll (all);
//Ok!
Restituisce vera;
}


In questo modo puoi essere sicuro che il tuo mod dll funzionerà in tutte le versioni, o se non funziona in alcune versioni puoi scriverlo sulla pagina del mod.

6. a volte dovrai fare qualcosa di diverso in base alla versione del gioco in esecuzione. Puoi farlo con questo frammento di codice:

Spoiler:  

La mostra


int major = 0, minor = 0, revision = 0, build = 0;
if (! db.GetExecutableVersion(major, minor, revision, build))
{
_FATALERROR("qualcosa è andato storto! ");
Restituire falso;
}

//gioco in esecuzione è 1.5.x e almeno versione 1.5.39.0
if (maggiore == 1 & & minore == 5 & & revisione > = 39)
{
//roba...
}


7. ti preghiamo di tenere a mente: se compilate la vostra skse dll in modalità di debug il tempo di carico del database può essere circa 14 secondi! In modalità rilascio questo è circa 0,2 secondi. Questo è dovuto al fatto che i contenitori di libreria standard sono molto lenti in quella modalità(std map).


Le autorizzazioni

Fai quello che vuoi.