Skip to content

Commit 9a559fe

Browse files
authored
Update README.md
1 parent f0c88ad commit 9a559fe

File tree

1 file changed

+5
-71
lines changed

1 file changed

+5
-71
lines changed

README.md

Lines changed: 5 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,9 @@ Nippon is a collection of tools designed to interact with the okami PC port. Thi
44
<img src="Assets/Editor.png" width="100%"/>
55

66
## Starting The Editor
7-
The editor requires at least one command line arguments which is the directory where the okami data files are. Supply arguments which contain spaces as strings.
8-
```
9-
Editor Help
10-
Editor DataDir [Width|Height]
7+
On first start the editor will ask for the okami data directory.
118

12-
Editor DataDir="...\Steam\steamapps\common\Okami\data_pc" Width=1920 Height=1080
13-
```
9+
It should look something along like `C:\Program Files (x86)\Steam\steamapps\common\Okami\data_pc`.
1410

1511
## Compile The Project
1612
First clone the repository and execute the setup which should create all missing folders and files.
@@ -19,83 +15,21 @@ git clone --branch main --depth 1 https://github.com/allogic/Nippon
1915
Setup.ps1
2016
```
2117
Launch the Visual Studio Solution, set the `Editor` as the startup project and build for `Debug` or `Release` bitness `x64`.
22-
To run or debug the editor one must additionally adjust a few editor properties. Go into `Editor/Properties/Debugging` and set the following parameters for all configurations and platforms:
23-
```
24-
Command Arguments = DataDir="...\Steam\steamapps\common\Okami\data_pc"
25-
Working Directory = $(SolutionDir)$(IntDir)
26-
```
27-
28-
## Utility Programs
29-
#### Archive Analyzer
30-
There are many different files inside the okami data directory but most of em share a common file structure. To list a few of them `DAT`, `BIN`, `IDD`, `AKT`, `CMP`, `DDP`, `EFF`, `PAC`, `SCP`, `TBL`. This programs job is to simplify your everyday work with those files.
31-
```
32-
ArchiveAnalyzer Help
33-
ArchiveAnalyzer Decrypt Input Output
34-
ArchiveAnalyzer Encrypt Input Output
35-
ArchiveAnalyzer Compress Input Output [Decrypt|Encrypt] (Experimental)
36-
ArchiveAnalyzer Unfold Input Output [Decrypt]
37-
ArchiveAnalyzer Extract Input Output [Decrypt]
38-
ArchiveAnalyzer ToC Input [Decrypt|Offset|Increment]
39-
40-
ArchiveAnalyzer ToC Input="...\Steam\steamapps\common\Okami\data_pc\etc\core.dat" Decrypt
41-
42-
Table Of Content
43-
-----------------------------------------------------------------------------------------
44-
0x00000080 # 00000 # kage # DDS # 22.48 KB
45-
0x000056C0 # 00001 # fude1 # DDS # 22.48 KB
46-
0x0000AD00 # 00002 # fude2 # DDS # 349.728 KB
47-
0x00060340 # 00003 # coreVtEstTbl # VET # 2.944 KB
48-
0x00060EE0 # 00004 # coreEff # EFF # 25394.304 KB
49-
| 0x00000060 # 00000 # coretex # TBL # 24742.192 KB
50-
| | 0x00000840 # 00000 # kemuri4 # DDS # 87.584 KB
51-
| | 0x00015E80 # 00001 # happa_anim # DDS # 87.584 KB
52-
| | 0x0002B4C0 # 00002 # hex_withline # DDS # 87.584 KB
53-
... ... ...
54-
| | 0x0004BEB0 # 00143 # pl00_143 # EST # 0.768 KB
55-
| | 0x0004C1D0 # 00144 # pl00_144 # EST # 0.768 KB
56-
| | 0x0004C4F0 # 00145 # runofs # ROF # 1.168 KB
57-
| 0x0004CAA0 # 00002 # pl00 # EMD # 0.32 KB
58-
| 0x0004CAE0 # 00003 # runofs # ROF # 0.32 KB
59-
0x0194D9E0 # 00007 # animalSet # ANC # 1.88 KB
60-
0x0194DE40 # 00008 # runofs # ROF # 0.64 KB
61-
```
62-
#### Binary Analyzer
63-
All people have different tools for different tasks, but if there are tons of files that need to be processed in the same way over and over again, then I'm sure you will find a use case for this analyzer.
64-
```
65-
BinaryAnalyzer Help
66-
BinaryAnalyzer Compare LeftInput RightInput [LeftDecrypt|RightDecrypt|ResultCount|Size|Stride|LeadStrideMultiplier]
67-
BinaryAnalyzer Search Input StringPattern [Decrypt]
68-
69-
BinaryAnalyzer Compare LeftInput="Scratch\r30d.dat" RightInput="Compress\r30d.dat" Stride=8
70-
71-
0x00000018 0x00000018
72-
-----------------------------------------------------------------------------------------------------
73-
0x00000000 | 0F 00 00 00 A0 00 00 00 | ........ | 0x00000000 | 00 00 00 00 00 00 00 00 | ........
74-
0x00000008 | 00 01 00 00 80 01 00 00 | ........ | 0x00000008 | 0F 00 00 00 A0 00 00 00 | ........
75-
0x00000010 | C0 01 00 00 A0 0D 00 00 | ........ | 0x00000010 | 00 01 00 00 80 01 00 00 | ........
76-
> 0x00000018 | 60 15 00 00 60 C0 18 00 | `...`... | 0x00000018 | C0 01 00 00 A0 0D 00 00 | ........
77-
0x00000020 | 00 CE 18 00 20 DC 18 00 | .... ... | 0x00000020 | 08 15 00 00 A8 BF 18 00 | ........
78-
0x00000028 | E0 2D 19 00 20 2E 19 00 | .-.. ... | 0x00000028 | 28 CD 18 00 48 DB 18 00 | (...H...
79-
0x00000030 | 60 2E 19 00 A0 2E 19 00 | `....... | 0x00000030 | 08 2D 19 00 48 2D 19 00 | .-..H-..
80-
0x00000038 | 80 2F 19 00 C0 2F 19 00 | ./.../.. | 0x00000038 | 88 2D 19 00 C8 2D 19 00 | .-...-..
81-
0x00000040 | 54 53 43 00 54 52 45 00 | TSC.TRE. | 0x00000040 | A8 2E 19 00 E8 2E 19 00 | ........
82-
0x00000048 | 54 41 54 00 52 4E 49 00 | TAT.RNI. | 0x00000048 | 54 53 43 00 54 52 45 00 | TSC.TRE.
83-
0x00000050 | 41 4B 54 00 53 43 50 00 | AKT.SCP. | 0x00000050 | 54 41 54 00 52 4E 49 00 | TAT.RNI.
84-
```
8518

8619
## Troubleshooting
8720
- If you got build errors, make sure you are using the latest Visual Studio version. (Tested with VS 2022 >= 17.X.X)
8821
- If for some reason the editor does not start, make sure the latest graphics card drivers are installed on your system.
89-
- If only black thumbnails appear, then one must first generate them via `MainMenu/Tools/Generate Thumbnails`. They should be visible after editor relaunch.
22+
- If only black thumbnails appear, then one must first generate them via `Database/Rebuild Thumbnails`. They should be visible right away.
9023

9124
## Exporting Assets
92-
Right click on a random actor that you wish to export and choose `Export as Wavefront` to generate a wavefront object and material file along with all referenced textures. It should be ready to be imported into blender or other 3D software. Be sure to enable backface culling in your external rendering software to view the objects properly, otherwise only the black hull will be visible for most objects.
25+
Right click on a random actor that you wish to export and choose `Export as Wavefront` to generate a wavefront object and material file along with all referenced textures. It should be ready to be imported into blender or any other 3D modeling software. Be sure to enable backface culling in your external rendering software to view the objects properly, otherwise only the black hull will be visible for most objects.
9326

9427
<img src="Assets/Oki.jpg" width="33%"/><img src="Assets/Crow.jpg" width="33%"/><img src="Assets/Rao.jpg" width="33%"/>
9528

9629
## Editor Scene Controls
9730
- `WASD` to move
9831
- `L-SHIFT` for lightspeed
32+
- `F` reset camera
9933

10034
## Issues / Pull Requests
10135
If bugs are being found, please don't hesitate to open an issue or pull request!

0 commit comments

Comments
 (0)