mafia modding manual

Verze: 2012.12.02
Jazyk: Česky
M AFIA M ODDING M ANUAL
Tomáš Růžička
t [email protected]
www.djbozkosz.wz.cz
c 2005 - 2012
Copyright Vysázeno v LATEXu
Obsah
1
Přı́prava k modovánı́
1.1 Potřebné nástroje . . . . . . . . . . . . . . . .
1.1.1 Mafia (doporučená verze: 1.0) . . . . .
1.1.2 MafiaDataXTractor . . . . . . . . . . .
1.1.3 Zanoza Modeler v1.07b . . . . . . . .
1.1.4 BSctriptView 6.0 . . . . . . . . . . . .
1.1.5 DCED 2 . . . . . . . . . . . . . . . . .
1.1.6 Mafia World Editor v0.3.0.7 Beta . . .
1.1.7 Check.bin Editor . . . . . . . . . . . .
1.1.8 Road.bin Editor . . . . . . . . . . . . .
1.1.9 RHAM 5.3.3 . . . . . . . . . . . . . .
1.1.10 Menu.def Editor . . . . . . . . . . . .
1.1.11 Mafia Text Editor v1.1 . . . . . . . . .
1.1.12 4DS Unlocker . . . . . . . . . . . . . .
1.1.13 3D Models, 3D Characters . . . . . . .
1.2 Systém a extrakce dat, konfigurace editorů . . .
1.2.1 Systém složek a souborů, rozbalenı́ dat
1.2.2 Konfigurace editorů . . . . . . . . . . .
1.3 Soubory a formáty . . . . . . . . . . . . . . .
1.3.1 anims - Animace . . . . . . . . . . . .
1.3.2 diff - Difference data . . . . . . . . . .
1.3.3 maps - Textury . . . . . . . . . . . . .
1.3.4 missions - Mise - jsou třı́děny do složek
1.3.5 models - Modely . . . . . . . . . . . .
1.3.6 records - Filmové sekvence . . . . . . .
1.3.7 savegame - Uložené pozice . . . . . . .
1.3.8 sounds - Zvuky . . . . . . . . . . . . .
1.3.9 sounds\MUSIC - Hudba . . . . . . . .
1.3.10 system - Několik souborů pro hru . . .
1.3.11 tables - Definičnı́ soubory hry . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5
5
5
5
6
7
7
8
9
9
10
10
11
11
12
13
13
13
14
14
14
14
15
15
15
15
15
16
16
16
2
Textury
17
3
Modelovánı́
18
4
Level design
19
2
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
5
Skriptovánı́
20
6
Dalšı́ úpravy
21
3
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Úvod
Bude doplněno později.
4
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Kapitola 1
Přı́prava k modovánı́
Tato kapitola se zaobı́rá přehledem nutných a doporučených nástrojů, jejich instalacı́ a zprovozněnı́m.
Nakonec je zde popsán souborový systém hry, včetně souhrnu všech typů, popř. samotných souborů.
1.1
1.1.1
Potřebné nástroje
Mafia (doporučená verze: 1.0)
Autor: Illusion Softworks (nynı́ 2K Czech)
Obrázek 1.1: Logo hry Mafia.
Hru snad nenı́ potřeba vı́ce popisovat. Je doporučeno použı́vat původnı́ verzi - 1.0, protože na nı́
funguje nejvı́ce nástojů.
1.1.2
MafiaDataXTractor
Autor: MassaSnygga
Obrázek 1.2: MafiaDataXTractor s oznaženými archivy pro následnou extrakci.
5
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Tento jednoduchý program, který dokáže extrahovat *.dta archivy ze hry. Přistupuje ke knihovně
rw data.dll, která je ve složce s hrou a pomocı́ funkcı́ z této knihovny zı́ská algoritmy potřebné pro
dekompresi a rozbalenı́ souborů. Také při prvnı́m spuštěnı́ programu opravı́ tuto knihovnu, aby v nı́
byla nastavena vyššı́ priorita načı́tánı́ souborů ze složek a v přı́padě nenalezenı́, by se soubory hledaly
v původnı́ch *.dta archivech.
1.1.3
Zanoza Modeler v1.07b
Autor: Oleg Melashenko
Obrázek 1.3: Zmodeler s importovaným modelem auta.
Zmodeler je modelovacı́ nástroj pro vytvořenı́ modelů do několika staršı́ch her, včetně Mafie (export modelů do *.4ds formátu). Dovoluje modelovat a texturovat geometrii objektů s pomocı́ standardnı́ch nástrojů: posun, rotace, měřı́tko, zrcadlenı́, kopı́rovánı́ či mazanı́ a mnoho dalšı́ch. Tyto
nástroje lze aplikovat, jak na celé objekty, tak na vybrané polygony či jejich vrcholy. Tento program
je spı́še orientován na vytvářenı́ modelů aut, ale zle jej bez obav také využı́t pro modelovánı́ budov a
interiérů včetně jejich vybavenı́. Nenabı́zı́ však rozšı́řené možnosti úpravy materiálů, a proto se tyto
úpravy musı́ dělat v cı́lovém souboru modelu pomocı́ hexa editoru (např.: sı́la odlesku, změna názvu
průhledných textur, animované textury, apod.).
6
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.1.4
BSctriptView 6.0
Autor: Braingib
Obrázek 1.4: BSV s načtenou misı́.
Tento poměrně důležitý program, dovoluje upravovat soubory mise. Vyniká svou jednoduchostı́,
je přehledný a odladěný. Umožňuje vkládat různé druhy objektů do mise, např.: standardnı́ modely,
fyzikálnı́ modely, auta, postavy, světla, zvuky a skripty. Lze upravovat základnı́ i některé rozšı́řené
vlastnosti objektů.
1.1.5
DCED 2
Autoři: ASM, Scream, asdfadf, LGs0pHT
Obrázek 1.5: DCED s načtenou misı́.
7
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
DCED je alternativou k výše zmı́něnému programu. Je komplexnějšı́ a nabı́zı́ úpravu vı́ce vlastnostı́ u objektů. Napřı́klad změnu názvu objektu, modelu či sektoru. Mezi dalšı́ funkce patřı́ import
nebo export jednotlivých objektů do DNC formátu nebo zvýrazněnı́ syntaxe skriptů. Tento editor je
však doporučen pouze pro minimálnı́ úpravy, které nezvládne BSV, protože při delšı́m použı́vánı́ je
nestabilnı́ a poškozuje soubory mise.
1.1.6
Mafia World Editor v0.3.0.7 Beta
Autor: ASM
Obrázek 1.6: MWE s načtenou misı́.
MWE je funkčnotı́ podobný dvěma minulým programům, ovšem načtenou misi zobrazı́ v interaktivnı́m 3D pohledu. Je zacı́lem hlavně na umist’ovánı́ objektů v misi, tvorbu kolizı́ všech typů a
poslednı́ verze také dovoluje generovat lightmapy (stı́ny). Verze 3.0.7 je ve fázi beta, protože u lightmapů ještě nejdou zdaleka implementovány všechny funkce.
8
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.1.7
Check.bin Editor
Autor: zibob32
Obrázek 1.7: Použitı́ CHEDu spolu se hrou.
CHED je důležitý při tvorbě nových lokacı́, protože dovoluje vytvořit a spravovat navigačnı́ body
pro chodce, AI, tramvaje a letadla. Bohužel je rusky, takže ze začátku může být ovládánı́ trochu
komplikovanějšı́.
1.1.8
Road.bin Editor
Autor: djbozkosz (ano já)
Obrázek 1.8: Použitı́ ROE spolu se hrou.
ROE je editor vlastnı́ tvorby a umožňuje tvořit a spravovat navigačnı́ body, které využı́vá doprava.
9
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.1.9
RHAM 5.3.3
Autor: Akay
Obrázek 1.9: RHAM s načteným souborem vlastnostı́ aut.
RHAM dovoluje upravovat všechny vlastnosti každého typu auta, včetně přidávánı́ a odebı́ránı́
definic jednotlivých aut. Lze využı́t také import a export definic jednoho typu auta do souboru.
1.1.10
Menu.def Editor
Autor: djbozkosz
Obrázek 1.10: MDE s náhledem GUI.
10
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Menšı́ editor vlastnı́ tvorby, se kterým lze upravit rozloženı́ oken a loadovacı́ch obrazovek ve verzi
hry 1.0.
1.1.11
Mafia Text Editor v1.1
Autor: Bibber
Obrázek 1.11: Mafia Text Editor s načteným souborem textů.
S tı́mto editorem lze vytvářet a upravovat veškeré textové popisky, např.: v menu, úkoly, titulky
dabingu, apod. Každý text musı́ mı́t své ID, které je později použito ve hře.
1.1.12
4DS Unlocker
Autor: ???
Obrázek 1.12: Použitı́ 4DS Unlockeru.
Program s jedinou funkcı́: odemknout dřı́vě exportovaný 4ds model tak, aby jej bylo možné znovu
importovat do Zmodeleru.
11
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.1.13
3D Models, 3D Characters
Autor: Akay
Obrázek 1.13: Databáze modelů.
Tyto soubory nápovědy shrnujı́ skoro všechny modely z Mafie do abecednı́ch seznamů spolu s
obrázkem a ruským popisem (který nenı́ až tak nutný). 3D models obsahuje databázi modelů, kromě
postav. Ty doplňuje 3D Characters, která obsahuje pouze modely postav.
12
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.2
Systém a extrakce dat, konfigurace editorů
1.2.1
Systém složek a souborů, rozbalenı́ dat
Nejprve je potřeba extrahovat data ze hry. Následujı́cı́ tabulka shrnuje obsah všech složek, které jsou
vytvořeny extrahovánı́m archivů.
Archiv
a0.dta
a1.dta
a2.dta
a3.dta
a4.dta
a5.dta
a6.dta
a7.dta
a8.dta
a9.dta
aa.dta
ab.dta
ac.dta
Složka
sounds
missions
models
anims
anims
diff
maps
records
..vı́ce složek..
system
tables
sounds\MUSIC
anims
Popis
Zvuky
Mise
Modely
Animace 1
Animace 2
Difference data - objekty pro filmové sekvence
Textury
Filmové sekvence
Patch verze 1.1
Několik souborů pro hru
Definičnı́ soubory hry
Hudba
Animace 3
Zde záležı́ čistě na modaři, které složky potřebuje rozbalit. Pokud bude tvořit mod, jenž upravuje
pouze textury, stačı́ extrahovat pouze složku maps. Při tvorbě nových aut, je nutné extrahovat složky:
maps, models, přı́padně tables a sounds. Pokud bude modař vytvářet komplexnı́ mody s misemi, musı́
rozbalit: maps, missions, models, sounds, sounds\MUSIC, system a tables.
1.2.2
Konfigurace editorů
Editory na Mafii nenı́ nutné instalovat. Pouze několik je nutné správně nakonfigurovat popř. doinstalovat nutné knihovny:
Zmodeler: při tvorbě a importů modelů je vhodné nastavit cestu do složky maps s texturama
hry. Otevřete okno: Zobrazenı́ → Textury → Přednastavené cesty... a klikněte na Add Textures search
path..., kde najděte a vyberte složku maps ve složce s Mafiı́.
BScriptView: Na novějšı́ch operačnı́ch systémech od Microsoftu, tedy Windows Vista, 7, a 8
nenı́ možné spustit BSV, protože systém neobsahuje knihovny nutné pro běh všech verzı́ BSV. Ty je
možné nainstalovat instalátorem MSVBVM50.EXE, který je ve složce s BSV.
Mafia World Editor: v konfiguračnı́m souboru Editor.ini upravte hodnotu klı́če MafiaPath na
cestu k Mafii na vašem disku (např.: C:\Program Files (x86)\Mafia).
Setup hry Mafia: aby hra pracovala přı́mo s texturama, v setupu hry Setup.exe nastavte kvalitu a
velikost textur na Truecolor.
13
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.3
Soubory a formáty
Tato sekce popisuje všechny typy a účel souborů vyskytujı́cı́ch se ve hře.
1.3.1
anims - Animace
Soubor
*.5ds
*.tck
1.3.2
diff - Difference data
Soubor
*.chg
1.3.3
*.dx2
*.dx3
*.555
*.565
Popis
Každý soubor obsahuje extra objekty, které jsou načteny u každé
filmové sekvence
maps - Textury
Soubor
*.bmp
*.dx1
Popis
Morfovaná (morph) animace těla postavy
Pohyb postavy při animaci
Popis
Obrázek textury - nejvyššı́ kvalita (truecolor), obrázky jsou
uloženy s 24 bitovou hlobkou nebo v režimu 256 barev
Obrázek neprůhledné textury - komprimovaná kvalita, obrázek je
generován z bmp vzoru
Obrázek color key textury (jedna barva je průhledná) - komprimovaná kvalita, obrázek je generován z bmp vzoru
Obrázek průhledné textury - komprimovaná kvalita, obrázek je
generován z bmp vzoru
Obrázek průhledné textury - nı́zká kvalita, obrázek je generován
z bmp vzoru
Obrázek neprůhledné textury - nı́zká kvalita, obrázek je generován z bmp vzoru
14
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.3.4
missions - Mise - jsou třı́děny do složek
Soubor
MISE\cache.bin
MISE\car table.dat
MISE\clusters.seg
MISE\effect.bin
MISE\check.bin
MISE\rmorf.bin
MISE\road.bin
MISE\scene.4ds
MISE\scene2.bin
MISE\tree.klz
1.3.5
models - Modely
Soubor
*.4ds
*.5ds
*.6ds
1.3.6
Popis
Filmová sekvence - obsahuje animace a pohyby různých hernı́ch
objektů
savegame - Uložené pozice
Soubor
*.nnn
*.sav
1.3.8
Popis
Model
Morfovaná (morph) animace modelu
Model stı́nu postavy nebo auta
records - Filmové sekvence
Soubor
*.rep
1.3.7
Popis
Zhuštěný soubor objektů, které jsou lepeny na scene.4ds, obvykle
jsou v něm uloženy domy ve městě a jeho přı́tomnost v misi odblokuje možnost nastavenı́ dohlednosti
Nedůležitá definice pro dopravu
Polygonové efekty filmové sekvence
Standardnı́ efekty
Navigace pro chodce, AI, tramvaje, letadla, váže se na scene2.bin
animované morph efekty - váže se na Model Objekty ze
scene2.bin, daný 4ds model musı́ obsahovat také 5ds animaci se
stejným názvem
Navigace pro dopravu, váže se na scene2.bin
Hlavnı́ model scény - obvykle obsahuje unikátnı́ objekty, např.:
terén, silnice, interiér, apod.
Nutný a nejdůležitějšı́ soubor mise - obsahuje objekty, body,
skripty, světla, zvuky, auta, postavy, apod., váže se na scene.4ds
Kolize - zajišt’ujě, aby se interaktivnı́ hernı́ objekty nepropadly,
váže se na scene.4ds a scene2.bin
Popis
Uložená pozice mise
Různé soubory obsahujı́cı́: profily, časy tratı́, apod.
sounds - Zvuky
Soubor
*.wav
Popis
Zvukový soubor
15
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
1.3.9
sounds\MUSIC - Hudba
Soubor
*.ogg
1.3.10
Popis
Vorbis zvukový soubor
system - Několik souborů pro hru
Soubor
m pravda.wav
mrseg0.sav
taxi pas.dat
1.3.11
Popis
Easter egg, který se spustı́ při střelenı́ do okna v průchodu nad
East Marshall Bridgem v Down Townu
Výchozı́ uložená pozice
Skript, který řı́dı́ taxikařenı́ v jı́zdě (aktivace přı́kazem skriptu:
taxidriver enable)
tables - Definičnı́ soubory hry
Soubor
dat\*.dat
carcyclopedia.def
carindex.def
circuits.def
credits.def
effects.tbl
EFFECTS.TXT
enemy.txt
*.gmf
championship.def
lang xx.def
load.def
materials.def
menu.def
parnik.def
particles.def
playerindex.def
playerpedia.def
sounds.dat
text xx.def
tyres.bin
tyres.dat
vehicles.bin
vehicles.dat
version.txt
voices.def
zidle.tbl
Popis
Animace mimiky obličeje při mluvenı́
Tabulka aut, obsahujı́cı́ jejich názvy a modely, váže se na
vehicles.bin
Téměř identický soubor jako carcyclopedia.def
Tabulka tratı́, obsahujı́cı́ jejich názvy a složky s misemi
Definice titulků na konci hry
Tabulka částicových efektů
Seznam částicových efektů
Seznam AI hlášek postav dle označenı́
Definice pı́sma
Tabulka šampionátu
Tabulka pı́smen, kde xx je jazyk
Tabulka loadovacı́ch obrazovek
Tabulka materiálů
Tabulka menu položek pro verzi hry 1.0
Navigačnı́ body pro lodě ve městě - závisı́ na definici objektu
mostu ve scéně
Tabulka modelů částicových efektů, které použı́vá effect.tbl
Tabulka řidičů pro dopravu
Tabulka postav
Tabulka zvuků - definice pro fyziku, zbraně, atd...
Tabulka veškerých textů, kde xx je jazyk
Tabulka vlastnostı́ pneumatik
Tabulka vlastnostı́ pneumatik
Tabulka vlastnostı́ aut
Tabulka vlastnostı́ aut
Obsahuje xx značku, která určı́ jazyk hry
Tabulka hlasů pro AI
Neznámý soubor
16
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Kapitola 2
Textury
17
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Kapitola 3
Modelovánı́
18
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Kapitola 4
Level design
19
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Kapitola 5
Skriptovánı́
20
Tomáš Růžička www.djbozkosz.wz.cz
c 2005 - 2012 Verze: 2012.12.02
Copyright Mafia Modding Manual
Kapitola 6
Dalšı́ úpravy
21