chihuahua

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 14 Open GitHub ↗

Chihuahua is project for view and modified God Hand (PS2 game) develop by Clover Studio and publish by Capcom.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://github.com/anasrar/chihuahua/releases/tag/nightly), and you can access the web version on [anasrar.github.io/chihuahua/](https://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](#png-indexed-mode). | `yes` | `yes` | [`tim/frompng`](https://anasrar.github.io/chihuahua/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`                              |
| **t32viewer**   | T32 viewer for view T32 file that use as texture UI, support export as PNG and convert PNG to T32.         | `no`  | `yes` |                              `todo`                              |
| **timviewer**   | TIM viewer for view TIM2 (`orivia_`), TIM3, TM3 image texture, support export as PNG.                      | `no`  | `yes` |  [`tim/viewer`](https://anasrar.github.io/chihuahua/tim/viewer)  |
| **tm3pack**     | Pack TIM3 container as TM3.                                                                                | `yes` | `yes` |                          `in progress`                           |
| **tm3unpack**   | Unpack TIM3 container as TM3.                                                                              | `yes` | `yes` |                          `in progress`                           |

## PNG Indexed Mode

> [!IMPORTANT]  
> Only PNG with indexed mode that can be converted and the colors is less than `256`.
>
> Width and height should be `2^n`, where max `n` is 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: texture UI.
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`.

## Built With

- https://go.dev/
- https://www.raylib.com/
- https://github.com/gen2brain/raylib-go
- https://github.com/ocornut/imgui
- https://github.com/cimgui/cimgui
- https://github.com/AllenDang/cimgui-go
- https://svelte.dev

chihuahua

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README