Hogyan használd a DayZ Tools Addon Buildert PBO építéshez
Az Addon Builder a DayZ Tools-szal érkező hivatalos PBO-csomagoló, és minden PC-mod gerince - a nyers mod-mappádból tölthető .pbo-t készít. A modderek „addon breaker" néven becézik, mert a régebbi verziók szeszélyesek voltak, de a friss frissítések valóban megbízhatóvá tették. Ez a végigvezetés sorban veszi az összes mezőt és opciót, az eszköz elindításától a tiszta „build successful" üzenetig.
Kövesd sorban. Az első lépések a megfelelő mappákra irányítják a buildert, a középsők a csomagolási opciókat veszik át, az Options ablakban pedig két beállítás - a files-to-copy minták és a privát kulcs - csendben dönt egy mod sorsáról.
01
Indítsd el a DayZ Tools-t
HolSteam Library
Miért számítIngyenes hivatalos eszközkészlet
Az Addon Builder a DayZ Tools-ban található, ami egy ingyenes csomag a Steamen (App 830640). Nyisd meg a Steamet, állítsd át a könyvtár szűrőjét a Tools megjelenítésére, és keress rá a DayZ Tools-ra - ha nem jelenik meg, győződj meg róla, hogy a Tools kategória engedélyezve van a kereső feletti legördülő menüben.
Indítsd el, és hagyd, hogy admin módban induljon. A DayZ Tools a szabványos, támogatott módja az Addon Builder beszerzésének, így nincs szükség harmadik féltől letöltésre ehhez az útmutatóhoz.
A DayZ Tools indítóban az eszközök a bal oldalon vannak felsorolva. Az Addon Builder a harmadik felülről - kattints rá a csomagoló megnyitásához.
Ezután megjelenik a fő ablak az összes mezővel és jelölőnégyzettel. Elsőre zsúfoltnak tűnhet, de minden opciót lent veszünk át, abban a sorrendben, ahogy ténylegesen használni fogod őket.
03
Állítsd be az Addon source directory-t (a P: meghajtón)
HolA fő ablak felső mezője
Miért számítFeloldja a textúra- és modell-útvonalakat
Az Addon source directory a mod-struktúrád legelső mappájára mutat - a gyökérmappára, ami mindent tartalmaz, amit csomagolni akarsz. A builder ettől a mappától indulva végigjár mindent, és behúz minden benne lévő fájlt.
Mindig a P: meghajtóról csomagolj, ahol a modding-munkád nagy részét végezned kell. A P: meghajtó automatikusan kitölti a helyes fájlútvonalakat, így a mod által hivatkozott textúrák, modellek és egyéb assetek feloldódnak csomagoláskor. Ha helyette egy C:\Program Files\Steam\steamapps\... típusú helyre mutatsz, az útvonalak egy olyan helyet égetnek be, ami másnak nincs meg a gépén, és az assetek nem töltődnek be.
04
Válaszd ki a destination directory-t és a .pbo fájlnevet
HolMásodik mező
Miért számítIde kerül a kész PBO
A destination directory (vagy a .pbo-ra végződő fájlnév) pontosan eldönti, hova íródik a csomagolt fájl. Egyenesen abba a mappastruktúrába teheted, amit szeretnél - például a szervered addons mappájába - ennek az egy sornak a szerkesztésével.
Ez különösen kapóra jön teszteléskor: módosítsd itt az útvonalat, és a builder oda írja ki, ahova kell, minden más beállítás nélkül. Bármikor átirányíthatod, amikor más célpontba csomagolsz.
05
Állítsd be az Addon prefixet (és verziót)
HolPrefix és version mezők
Miért számítFelülír egy core vagy idegen PBO-t
Az Addon prefix lehetővé teszi egy core PBO vagy valaki más PBO-jának teljes felülírását. Ha a fájljaidat az eredetihez illesztve prefixeled, a játék a vanilla helyett a te verziódat tölti be - hasznos átfogó vanilla változtatásokhoz, például az összes jármű textúrájának újraírásához vagy blooded ruhák hozzáadásához az összes vanilla rvmat fájlhoz anélkül, hogy mindegyikhez külön retextúrát készítenél.
A prefixelés mély téma; ugyanaz az Arma 3-as koncepció érvényes itt is, ezért érdemes rákeresni a Bohemia wikin és közösségi videókon, ha a teljes részletet akarod. A mellette lévő Addon version mező csak nyilvántartás - 1.0, 2.0 és így tovább - a kiadásaid rendezéséhez. A buildre nincs hatással.
06
Kapcsold be a Clear temp folder-t
HolJelölőnégyzet
Miért számítBiztonságos ideiglenes mentés csomagolás közben
A Clear temp folder bekapcsolásával a builder csomagolás közben biztonsági másolatot készít a mododról egy temp mappába a P: meghajtón. Ha bármi elromlik a build közben, ez a másolat mentőöv arra az esetre, ha a core mappastruktúrád valahogy megsérülne.
Sikeres csomagoláskor a temp másolat automatikusan törlődik, a kész .pbo pedig a korábban beállított célhelyre kerül - készen a tesztelésre, Steamre feltöltésre vagy a szerveren betöltésre.
07
Kapcsold be a Sign output PBO-t (.bikey)
HolJelölőnégyzet + kulcs-útvonal az Options-ban
Miért számítKötelező publikus és privát modhoz
Az aláírás egy privát .bikey-vel ír egy aláírást a PBO-dra. Ez kötelező minden publikus - sőt privát - mod használatához: a játékosnak a megfelelő .bikey-t a szervere gyökerében lévő keys mappába kell tennie. E kulcs nélkül egy aláíratlan PBO egyszerűen nem töltődik be a játékba.
A jelölőnégyzet szürke marad, amíg az Options ablakban nem irányítod a buildert egy privát kulcsra (a 11. lépésben). Állítsd be előbb a kulcsot, és a Sign output PBO opció elérhetővé válik.
08
Kapcsold be a Binarize-t (és a Binarize all textures-t)
HolJelölőnégyzetek
Miért számítHogy a motor helyesen olvassa a fájlokat
A Binarize - sok modder „bi-nice"-nak ejti - a motor lefordított formátumává alakítja a modelljeidet és configjaidat. Egyszerre védi a munkádat (aki kicsomagolja a modot, az Object Builderben a modelled helyett egy helyőrző blokkot lát), és ami fontosabb, hogy a DayZ helyesen olvashassa a fájlstruktúrádat. A kihagyása ismert oka a furcsa, nehezen diagnosztizálható hibáknak.
A Binarize all textures ugyanezt teszi magukkal a textúrákkal. Normál kiadáshoz mindkettőt kapcsold be. Az egyetlen kritikus kivétel a config.cpp, amit soha nem szabad binarizálni - ezt a 10. lépésben a files-to-copy lista kezeli.
09
Kapcsold be az Enable extended logging-ot
HolJelölőnégyzet
Miért számítRészletes kimenet hibakereséshez
Az Enable extended logging hatására a builder teljes jelentést ír ki mindenről, amit csomagolás közben tesz - minden szinkronizált, használt és feldolgozott fájlról. Ha egy build elhasal, ez a részletesség engedi visszakövetni a pontos fájlt vagy lépést, ami a problémát okozta.
Egy sikertelen build hibaablakot dob fel, amit el kell tüntetned. Egy jó futás tiszta „build successful" üzenettel és az alatta megjelenő teljes fájllistával zárul.
10
Állítsd be a files-to-copy mintákat (Options → General)
HolOptions ablak, General fül
Miért számítMindig legyen benne *.cpp
Nyisd meg az Options-t, és maradj a General fülön. A „files to copy" doboz vesszővel vagy pontosvesszővel elválasztott mintalistát tartalmaz - például *.emat; - amiket a builder úgy másol be a PBO-ba, ahogy vannak, binarizálás nélkül. Minden bejegyzés egy csillag (bármilyen név), egy pont, a kiterjesztés, majd egy pontosvessző a lezáráshoz.
Mindig tartsd benne a *.cpp-t ebben a listában. Ha a config.cpp binarizálódik, elronthatja a health-rendszert - a kiinduló életállapotok talán már nem mennek át helyesen sérültbe, súlyosan sérültbe vagy tönkrementbe. A config.cpp vezérli, hogyan implementálódnak az itemek és modellek, a sérülés-értékeiket és a hozzájuk tartozó textúrákat, így a binarizálástól való megvédése elengedhetetlen.
Ki kell hagynod az image set és layout fájlokat is. Ha ezek binarizálódnak, nem jelennek meg ikonként vagy ghost-képként - a halvány attachment-előnézetek, amiket a tárak, gránátok és hasonló egyedi itemek mellett látsz - így a copy listában hagyásuk működőképesen tartja a UI-grafikádat.
11
Add meg a privát kulcs útvonalát
HolOptions → General
Miért számítEngedélyezi az aláírást; tesztkulcsot cserélj kiadás előtt
Még mindig az Options-ban állítsd be a Path to the private key-t a .bikey fájlodra - ez teszi nem-szürkévé a 7. lépés Sign output PBO jelölőnégyzetét. Kattints a három pontra, navigálj a privát kulcsok mappádba, és kattints duplán a használni kívánt kulcsra.
Gyakori munkafolyamat egy dedikált tesztkulccsal csomagolni. Ha ezt teszed, állítsd vissza, mielőtt publikálsz: ha olyan kulccsal írsz alá, ami nem egyezik a szerver keys mappájában lévő .bikey-vel, az betöltési problémákat okoz. Ugyanez az Options fül tartalmazza a temp mappa útvonalát, a project mappa útvonalát (ezt a P: meghajtódra irányítsd), az author mezőt (alapból a Steam-neved) és az exclusion pattern listát - a kizárási fájlt hagyd alapértelmezetten.
A General melletti Tools fül csak az eszközök alap-útvonalait listázza. Szinte sosincs ok hozzányúlni; hagyd bepipálva a „use default"-ot, hacsak nem szándékosan helyezted át a telepítésedet.
12
Csomagolj és erősítsd meg a „build successful"-t
HolPack gomb
Miért számítLétrehozza a betölthető PBO-t
A forrás és a célhely beállítva, az opciók kiválasztva, kattints a Pack-re. Ha a célhelyen már van PBO, a builder megkérdezi, felülírja-e - erősítsd meg igennel - ha pedig nincs, azonnal elkezd csomagolni.
Amikor végez, „build successful"-t látsz, a kimenet pedig a célmappádba íródik. Ha egy build elhasal, próbáld meg még egyszer, mielőtt elhinnéd, hogy a mod hibás - az Addon Builder időnként megbicsaklik, és egy tiszta második próba gyakran sikerül. Innen a .pbo készen áll tesztelésre, aláírásra vagy kiadásra.
A P: meghajtó automatikusan feloldja a mod által hivatkozott fájlútvonalakat, így a textúrák, modellek és egyéb assetek helyesen töltődnek be. A C:\Program Files-szerű útvonalról csomagolás egy olyan helyet éget be, ami másnak nincs meg, és az assetek nem töltődnek be.
Miért legyen mindig a *.cpp a files-to-copy listában?
A config.cpp binarizálása elronthatja a health-rendszert, így a kiinduló életállapotok talán nem mennek át sérültbe, súlyosan sérültbe vagy tönkrementbe. A *.cpp benntartása a files-to-copy listában binarizálatlanul másolja be, és ezt elkerüli.
Alá kell írnom a PBO-mat?
Bármilyen megosztott modhoz igen. A privát .bikey-vel való aláírás kötelező, és a játékosoknak a megfelelő .bikey-t a szerverük keys mappájába kell tenniük. Aláíratlan PBO nem töltődik be.
Mit csinál pontosan a Binarize?
A motor formátumává fordítja a modelljeidet és configjaidat, megvédi őket az Object Builderben való megnyitástól, és lehetővé teszi, hogy a DayZ helyesen olvassa a fájlstruktúrádat. A kihagyása nehezen diagnosztizálható hibákat okoz.
Elhasalt a buildem - most mi legyen?
Kapcsold be az extended logging-ot, hogy lásd, pontosan melyik fájl okozta a hibát, majd csomagolj még egyszer. Az Addon Builder időnként megbicsaklik, és egy tiszta második próba gyakran sikerül.