MAFIA MODDING MANUAL - djbozkosz.wz.cz · Nenab´ız´ı v ˇsak roz ˇs´ıˇren e mo´ znostiˇ upravy materi´ ´al u, a proto se tyto˚ upravy mus´ ´ı d ˇelat v c ´ılov

Verze: 2012.12.02Jazyk: Cesky

MAFIA MODDING MANUAL

Tomas Ruzickat [email protected]

www.djbozkosz.wz.czCopyright c© 2005 - 2012

Vysazeno v LATEXu

Obsah

1 Prıprava k modovanı 51.1 Potrebne nastroje . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.1.1 Mafia (doporucena verze: 1.0) . . . . . . . . . . . . . . . . . . . . . . . . . 51.1.2 MafiaDataXTractor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.1.3 Zanoza Modeler v1.07b . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.1.4 BSctriptView 6.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.1.5 DCED 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.1.6 Mafia World Editor v0.3.0.7 Beta . . . . . . . . . . . . . . . . . . . . . . . 81.1.7 Check.bin Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.1.8 Road.bin Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.1.9 RHAM 5.3.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.1.10 Menu.def Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.1.11 Mafia Text Editor v1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.1.12 4DS Unlocker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.1.13 3D Models, 3D Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1.2 System a extrakce dat, konfigurace editoru . . . . . . . . . . . . . . . . . . . . . . . 131.2.1 System slozek a souboru, rozbalenı dat . . . . . . . . . . . . . . . . . . . . 131.2.2 Konfigurace editoru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.3 Soubory a formaty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.1 anims - Animace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.2 diff - Difference data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.3 maps - Textury . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.4 missions - Mise - jsou trıdeny do slozek . . . . . . . . . . . . . . . . . . . . 151.3.5 models - Modely . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.3.6 records - Filmove sekvence . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.3.7 savegame - Ulozene pozice . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.3.8 sounds - Zvuky . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.3.9 sounds\MUSIC - Hudba . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161.3.10 system - Nekolik souboru pro hru . . . . . . . . . . . . . . . . . . . . . . . 161.3.11 tables - Definicnı soubory hry . . . . . . . . . . . . . . . . . . . . . . . . . 16

2 Textury 17

3 Modelovanı 18

4 Level design 19

2

Mafia Modding ManualTomas Ruzicka www.djbozkosz.wz.czCopyright c© 2005 - 2012 Verze: 2012.12.02

5 Skriptovanı 20

6 Dalsı upravy 21

3

www.djbozkosz.wz.cz


Uvod

Bude doplneno pozdeji.

4

www.djbozkosz.wz.cz


Kapitola 1

Prıprava k modovanı

Tato kapitola se zaobıra prehledem nutnych a doporucenych nastroju, jejich instalacı a zprovoznenım.Nakonec je zde popsan souborovy system hry, vcetne souhrnu vsech typu, popr. samotnych souboru.

1.1 Potrebne nastroje

1.1.1 Mafia (doporucena verze: 1.0)Autor: Illusion Softworks (nynı 2K Czech)

Obrazek 1.1: Logo hry Mafia.

Hru snad nenı potreba vıce popisovat. Je doporuceno pouzıvat puvodnı verzi - 1.0, protoze na nıfunguje nejvıce nastoju.

1.1.2 MafiaDataXTractorAutor: MassaSnygga

Obrazek 1.2: MafiaDataXTractor s oznazenymi archivy pro naslednou extrakci.

5

www.djbozkosz.wz.cz


Tento jednoduchy program, ktery dokaze extrahovat *.dta archivy ze hry. Pristupuje ke knihovnerw data.dll, ktera je ve slozce s hrou a pomocı funkcı z teto knihovny zıska algoritmy potrebne prodekompresi a rozbalenı souboru. Take pri prvnım spustenı programu opravı tuto knihovnu, aby v nıbyla nastavena vyssı priorita nacıtanı souboru ze slozek a v prıpade nenalezenı, by se soubory hledalyv puvodnıch *.dta archivech.

1.1.3 Zanoza Modeler v1.07bAutor: Oleg Melashenko

Obrazek 1.3: Zmodeler s importovanym modelem auta.

Zmodeler je modelovacı nastroj pro vytvorenı modelu do nekolika starsıch her, vcetne Mafie (ex-port modelu do *.4ds formatu). Dovoluje modelovat a texturovat geometrii objektu s pomocı stan-dardnıch nastroju: posun, rotace, merıtko, zrcadlenı, kopırovanı ci mazanı a mnoho dalsıch. Tytonastroje lze aplikovat, jak na cele objekty, tak na vybrane polygony ci jejich vrcholy. Tento programje spıse orientovan na vytvarenı modelu aut, ale zle jej bez obav take vyuzıt pro modelovanı budov ainterieru vcetne jejich vybavenı. Nenabızı vsak rozsırene moznosti upravy materialu, a proto se tytoupravy musı delat v cılovem souboru modelu pomocı hexa editoru (napr.: sıla odlesku, zmena nazvupruhlednych textur, animovane textury, apod.).

6

www.djbozkosz.wz.cz


1.1.4 BSctriptView 6.0Autor: Braingib

Obrazek 1.4: BSV s nactenou misı.

Tento pomerne dulezity program, dovoluje upravovat soubory mise. Vynika svou jednoduchostı,je prehledny a odladeny. Umoznuje vkladat ruzne druhy objektu do mise, napr.: standardnı modely,fyzikalnı modely, auta, postavy, svetla, zvuky a skripty. Lze upravovat zakladnı i nektere rozsırenevlastnosti objektu.

1.1.5 DCED 2Autori: ASM, Scream, asdfadf, LGs0pHT

Obrazek 1.5: DCED s nactenou misı.

7

www.djbozkosz.wz.cz


DCED je alternativou k vyse zmınenemu programu. Je komplexnejsı a nabızı upravu vıce vlast-nostı u objektu. Naprıklad zmenu nazvu objektu, modelu ci sektoru. Mezi dalsı funkce patrı importnebo export jednotlivych objektu do DNC formatu nebo zvyraznenı syntaxe skriptu. Tento editor jevsak doporucen pouze pro minimalnı upravy, ktere nezvladne BSV, protoze pri delsım pouzıvanı jenestabilnı a poskozuje soubory mise.

1.1.6 Mafia World Editor v0.3.0.7 BetaAutor: ASM

Obrazek 1.6: MWE s nactenou misı.

MWE je funkcnotı podobny dvema minulym programum, ovsem nactenou misi zobrazı v inter-aktivnım 3D pohledu. Je zacılem hlavne na umist’ovanı objektu v misi, tvorbu kolizı vsech typu aposlednı verze take dovoluje generovat lightmapy (stıny). Verze 3.0.7 je ve fazi beta, protoze u li-ghtmapu jeste nejdou zdaleka implementovany vsechny funkce.

8

www.djbozkosz.wz.cz


1.1.7 Check.bin EditorAutor: zibob32

Obrazek 1.7: Pouzitı CHEDu spolu se hrou.

CHED je dulezity pri tvorbe novych lokacı, protoze dovoluje vytvorit a spravovat navigacnı bodypro chodce, AI, tramvaje a letadla. Bohuzel je rusky, takze ze zacatku muze byt ovladanı trochukomplikovanejsı.

1.1.8 Road.bin EditorAutor: djbozkosz (ano ja)

Obrazek 1.8: Pouzitı ROE spolu se hrou.

ROE je editor vlastnı tvorby a umoznuje tvorit a spravovat navigacnı body, ktere vyuzıva doprava.

9

www.djbozkosz.wz.cz


1.1.9 RHAM 5.3.3Autor: Akay

Obrazek 1.9: RHAM s nactenym souborem vlastnostı aut.

RHAM dovoluje upravovat vsechny vlastnosti kazdeho typu auta, vcetne pridavanı a odebıranıdefinic jednotlivych aut. Lze vyuzıt take import a export definic jednoho typu auta do souboru.

1.1.10 Menu.def EditorAutor: djbozkosz

Obrazek 1.10: MDE s nahledem GUI.

10

www.djbozkosz.wz.cz


Mensı editor vlastnı tvorby, se kterym lze upravit rozlozenı oken a loadovacıch obrazovek ve verzihry 1.0.

1.1.11 Mafia Text Editor v1.1Autor: Bibber

Obrazek 1.11: Mafia Text Editor s nactenym souborem textu.

S tımto editorem lze vytvaret a upravovat veskere textove popisky, napr.: v menu, ukoly, titulkydabingu, apod. Kazdy text musı mıt sve ID, ktere je pozdeji pouzito ve hre.

1.1.12 4DS UnlockerAutor: ???

Obrazek 1.12: Pouzitı 4DS Unlockeru.

Program s jedinou funkcı: odemknout drıve exportovany 4ds model tak, aby jej bylo mozne znovuimportovat do Zmodeleru.

11

www.djbozkosz.wz.cz


1.1.13 3D Models, 3D CharactersAutor: Akay

Obrazek 1.13: Databaze modelu.

Tyto soubory napovedy shrnujı skoro vsechny modely z Mafie do abecednıch seznamu spolu sobrazkem a ruskym popisem (ktery nenı az tak nutny). 3D models obsahuje databazi modelu, kromepostav. Ty doplnuje 3D Characters, ktera obsahuje pouze modely postav.

12

www.djbozkosz.wz.cz


1.2 System a extrakce dat, konfigurace editoru

1.2.1 System slozek a souboru, rozbalenı datNejprve je potreba extrahovat data ze hry. Nasledujıcı tabulka shrnuje obsah vsech slozek, ktere jsouvytvoreny extrahovanım archivu.

Archiv Slozka Popisa0.dta sounds Zvukya1.dta missions Misea2.dta models Modelya3.dta anims Animace 1a4.dta anims Animace 2a5.dta diff Difference data - objekty pro filmove sekvencea6.dta maps Texturya7.dta records Filmove sekvencea8.dta ..vıce slozek.. Patch verze 1.1a9.dta system Nekolik souboru pro hruaa.dta tables Definicnı soubory hryab.dta sounds\MUSIC Hudbaac.dta anims Animace 3

Zde zalezı ciste na modari, ktere slozky potrebuje rozbalit. Pokud bude tvorit mod, jenz upravujepouze textury, stacı extrahovat pouze slozku maps. Pri tvorbe novych aut, je nutne extrahovat slozky:maps, models, prıpadne tables a sounds. Pokud bude modar vytvaret komplexnı mody s misemi, musırozbalit: maps, missions, models, sounds, sounds\MUSIC, system a tables.

1.2.2 Konfigurace editoruEditory na Mafii nenı nutne instalovat. Pouze nekolik je nutne spravne nakonfigurovat popr. doinsta-lovat nutne knihovny:

Zmodeler: pri tvorbe a importu modelu je vhodne nastavit cestu do slozky maps s texturamahry. Otevrete okno: Zobrazenı→ Textury→ Prednastavene cesty... a kliknete na Add Textures searchpath..., kde najdete a vyberte slozku maps ve slozce s Mafiı.

BScriptView: Na novejsıch operacnıch systemech od Microsoftu, tedy Windows Vista, 7, a 8nenı mozne spustit BSV, protoze system neobsahuje knihovny nutne pro beh vsech verzı BSV. Ty jemozne nainstalovat instalatorem MSVBVM50.EXE, ktery je ve slozce s BSV.

Mafia World Editor: v konfiguracnım souboru Editor.ini upravte hodnotu klıce MafiaPath nacestu k Mafii na vasem disku (napr.: C:\Program Files (x86)\Mafia).

Setup hry Mafia: aby hra pracovala prımo s texturama, v setupu hry Setup.exe nastavte kvalitu avelikost textur na Truecolor.

13

www.djbozkosz.wz.cz


1.3 Soubory a formatyTato sekce popisuje vsechny typy a ucel souboru vyskytujıcıch se ve hre.

1.3.1 anims - AnimaceSoubor Popis*.5ds Morfovana (morph) animace tela postavy*.tck Pohyb postavy pri animaci

1.3.2 diff - Difference dataSoubor Popis*.chg Kazdy soubor obsahuje extra objekty, ktere jsou nacteny u kazde

filmove sekvence

1.3.3 maps - TexturySoubor Popis*.bmp Obrazek textury - nejvyssı kvalita (truecolor), obrazky jsou

ulozeny s 24 bitovou hlobkou nebo v rezimu 256 barev*.dx1 Obrazek nepruhledne textury - komprimovana kvalita, obrazek je

generovan z bmp vzoru*.dx2 Obrazek color key textury (jedna barva je pruhledna) - kompri-

movana kvalita, obrazek je generovan z bmp vzoru*.dx3 Obrazek pruhledne textury - komprimovana kvalita, obrazek je

generovan z bmp vzoru*.555 Obrazek pruhledne textury - nızka kvalita, obrazek je generovan

z bmp vzoru*.565 Obrazek nepruhledne textury - nızka kvalita, obrazek je gene-

rovan z bmp vzoru

14

www.djbozkosz.wz.cz


1.3.4 missions - Mise - jsou trıdeny do slozekSoubor PopisMISE\cache.bin Zhusteny soubor objektu, ktere jsou lepeny na scene.4ds, obvykle

jsou v nem ulozeny domy ve meste a jeho prıtomnost v misi od-blokuje moznost nastavenı dohlednosti

MISE\car table.dat Nedulezita definice pro dopravuMISE\clusters.seg Polygonove efekty filmove sekvenceMISE\effect.bin Standardnı efektyMISE\check.bin Navigace pro chodce, AI, tramvaje, letadla, vaze se na scene2.binMISE\rmorf.bin animovane morph efekty - vaze se na Model Objekty ze

scene2.bin, dany 4ds model musı obsahovat take 5ds animaci sestejnym nazvem

MISE\road.bin Navigace pro dopravu, vaze se na scene2.binMISE\scene.4ds Hlavnı model sceny - obvykle obsahuje unikatnı objekty, napr.:

teren, silnice, interier, apod.MISE\scene2.bin Nutny a nejdulezitejsı soubor mise - obsahuje objekty, body,

skripty, svetla, zvuky, auta, postavy, apod., vaze se na scene.4dsMISE\tree.klz Kolize - zajist’uje, aby se interaktivnı hernı objekty nepropadly,

vaze se na scene.4ds a scene2.bin

1.3.5 models - ModelySoubor Popis*.4ds Model*.5ds Morfovana (morph) animace modelu*.6ds Model stınu postavy nebo auta

1.3.6 records - Filmove sekvenceSoubor Popis*.rep Filmova sekvence - obsahuje animace a pohyby ruznych hernıch

objektu

1.3.7 savegame - Ulozene poziceSoubor Popis*.nnn Ulozena pozice mise*.sav Ruzne soubory obsahujıcı: profily, casy tratı, apod.

1.3.8 sounds - ZvukySoubor Popis*.wav Zvukovy soubor

15

www.djbozkosz.wz.cz


1.3.9 sounds\MUSIC - HudbaSoubor Popis*.ogg Vorbis zvukovy soubor

1.3.10 system - Nekolik souboru pro hruSoubor Popism pravda.wav Easter egg, ktery se spustı pri strelenı do okna v pruchodu nad

East Marshall Bridgem v Down Townumrseg0.sav Vychozı ulozena pozicetaxi pas.dat Skript, ktery rıdı taxikarenı v jızde (aktivace prıkazem skriptu:

taxidriver enable)

1.3.11 tables - Definicnı soubory hrySoubor Popisdat\*.dat Animace mimiky obliceje pri mluvenıcarcyclopedia.def Tabulka aut, obsahujıcı jejich nazvy a modely, vaze se na

vehicles.bincarindex.def Temer identicky soubor jako carcyclopedia.defcircuits.def Tabulka tratı, obsahujıcı jejich nazvy a slozky s misemicredits.def Definice titulku na konci hryeffects.tbl Tabulka casticovych efektuEFFECTS.TXT Seznam casticovych efektuenemy.txt Seznam AI hlasek postav dle oznacenı*.gmf Definice pısmachampionship.def Tabulka sampionatulang xx.def Tabulka pısmen, kde xx je jazykload.def Tabulka loadovacıch obrazovekmaterials.def Tabulka materialumenu.def Tabulka menu polozek pro verzi hry 1.0parnik.def Navigacnı body pro lode ve meste - zavisı na definici objektu

mostu ve sceneparticles.def Tabulka modelu casticovych efektu, ktere pouzıva effect.tblplayerindex.def Tabulka ridicu pro dopravuplayerpedia.def Tabulka postavsounds.dat Tabulka zvuku - definice pro fyziku, zbrane, atd...text xx.def Tabulka veskerych textu, kde xx je jazyktyres.bin Tabulka vlastnostı pneumatiktyres.dat Tabulka vlastnostı pneumatikvehicles.bin Tabulka vlastnostı autvehicles.dat Tabulka vlastnostı autversion.txt Obsahuje xx znacku, ktera urcı jazyk hryvoices.def Tabulka hlasu pro AIzidle.tbl Neznamy soubor

16

www.djbozkosz.wz.cz


Kapitola 2

Textury

17

www.djbozkosz.wz.cz


Kapitola 3

Modelovanı

18

www.djbozkosz.wz.cz


Kapitola 4

Level design

19

www.djbozkosz.wz.cz


Kapitola 5

Skriptovanı

20

www.djbozkosz.wz.cz


Kapitola 6

Dalsı upravy

21

www.djbozkosz.wz.cz

Documents

MAFIA MODDING MANUAL - djbozkosz.wz.cz · Nenab´ız´ı v ˇsak roz ˇs´ıˇren e mo´ znostiˇ upravy materi´ ´al u, a proto se tyto˚ upravy mus´ ´ı d ˇelat v c ´ılov