README
¶
Chihuahua
Chihuahua is project for view and modified God Hand (PS2 game) develop by Clover Studio and publish by Capcom.
Other Projects
Since God Hand using the same game engine for Okami (the fact is some Okami asset found in God Hand USA ISO), there some overlap project that have same mission. Also after Clover Studio shut down and founded PlatinumGames, PlatinumGames still use same tech with slightly modification.
- https://github.com/Al-Hydra/GodHand-Noesis-Plugin
- https://github.com/akitotheanimator/God-Hand-Tools/
- https://github.com/christianmateus?tab=repositories&q=god+hand&type=&language=&sort=
- https://github.com/Shintensu/OkamiHD-Reverse-Engineering
- https://github.com/whataboutclyde/okami-utils
- https://github.com/allogic/Nippon
- https://github.com/Kerilk/bayonetta_tools/
- https://github.com/WoefulWolf/NieR2Blender2NieR
TODO: add more projects.
Tools
Windows and Linux executable available to download on release page, and you can access the web version on anasrar.github.io/chihuahua/
| Name | Description | CLI | GUI | Web |
|---|---|---|---|---|
| datpack | Pack generic dat container. | yes |
yes |
todo |
| datunpack | Unpack generic dat container. | yes |
yes |
todo |
| modelviewer | Model viewer for XXX.dat file except evXXX.dat, drag and drop XXX.dat file, support export as GLTF. |
no |
yes |
todo |
| png2tim | Convert PNG to TIM (TIM3 and TIM2), Note: see how to convert PNG to indexed mode. | yes |
yes |
tim/frompng |
| roomviewer | Room viewer for rXXX.dat file, drag and drop rXXX.dat file, support export as GLTF. |
no |
yes |
todo |
| scrviewer | SCR viewer for view SCR and MD file, drag and drop SCR, MD, and TM3 file, support export as GLTF. | no |
yes |
todo |
| t32pack | Pack PNG container as T32, Note: see how to convert PNG to indexed mode. | yes |
yes |
todo |
| t32unpack | Unpack T32 container as indexed PNG, support single export as PNG via GUI. | yes |
yes |
todo |
| timviewer | TIM viewer for view TIM2 (orivia_), TIM3, TM3 image texture, support export as PNG. |
no |
yes |
tim/viewer |
| tm3pack | Pack TIM3 container as TM3. | yes |
yes |
todo |
| tm3unpack | Unpack TIM3 container as TM3. | yes |
yes |
todo |
PNG Indexed Mode
[!IMPORTANT]
Only PNG with indexed mode that can be converted and the colors is less than256.Width and height should be
2^n, where maxnis 9 (to not exceeded PS2 RAM).
[!TIP] Convert PNG to indexed mode.
GIMP: Image > Mode > Indexed.
Photoshop: Image > Mode > Indexed Color.
Developer
ImHex
Using https://github.com/WerWolv/ImHex to analyze file format. There pkg/*/*.hexpat file.
TODOS
- mot2gltf
- Blender Add-ons: export as SCR room
- Blender Add-ons: export as SCR model
File Format
AFS: archive file system.
AKG: see pkg/akg/akg.hexpat.
AKT: generic dat container, contain AKG.
CMP: generic dat container, contain MOT.
EFF: generic dat container, contain TBL and EMD.
EMS: npc spawn transform.
ENV: TIM2.
FST: file system tree.
MDB: bones, texture index, and vertex buffer.
OMS: object spawn transform.
SCP: generic dat container, contain SCR and TM3.
SCR: container for MDB, contain name and transform.
MOT: contain animation curve with bone target and channel.
T32: container texture mostly for UI, the structure is `{textures: {palettes: {}[]}[]}`.
TIM2: PS2 texture format.
TIM3: extend version PS2 texture format.
TM3: TIM3 container.
TODO: add more file format.
File Name Pattern
elXX: model for cutscene.
emXX: npc model data.
idXX: generic dat contain UI stuff.
olXX: object model data (breakable, weapon).
orivia_X: TIM2 image texture on pause menu.
plXX: playable character data.
rXXX: (stage) room data.
TODO: add more file name pattern.
Directories