Skip to content

Shenmue-Mods/ShenmueDK

Repository files navigation

Shenmue Developer Kit for C++

Shenmue I & II Modding SDK for C++

This library is a port of the ShenmueDKSharp.

How to contribute:

  • Feel free to commit if you want to contribute some fixes or features.
  • If you found an bug just create an issue on GitHub.
  • For feature requests just create an issue on GitHub.

Usage

See the github wiki.

File Formats

For more informations about the file formats see the wulinshu wiki.

Containers

Name Read Write Description Notes
AFS ✔️ ✔️ Archive
IDX ✔️ AFS Archive Reference Names
PKF ✔️ ✔️ Archive (mainly textures for PKS)
PKS (IPAC) ✔️ ✔️ Archive
SPR ✔️ ✔️ Sprite texture Container
GZ ✔️ ✔️ GZip
TAD/TAC ✔️ ✔️ d3t TAD/TAC container with hash mapping Filename coverage based on wulinshu hash database

Textures/Images

Name Read Write Description Notes
PVRT ✔️ PowerVR Texture
DDS ✔️ ✔️ DirectDraw_Surface
BMP ✔️ ✔️ Bitmap format
PNG ✔️ ✔️ PNG format

PVR color formats

Value Name Read Write Description
0x00 ARGB1555 ✔️ ✔️ Format consisting of one bit of alpha value and five bits of RGB values.
0x01 RGB565 ✔️ ✔️ Format without alpha value and consisting of five bits of RB values and six bits of G value.
0x02 ARGB4444 ✔️ ✔️ Format consisting of four bits of alpha value and four bits of RGB values.
0x03 YUV422 ✔️ ✔️ YUV422 format
0x04 BUMP ✔️ ✔️ Bump map with positiv only normal vectors (S and R direction angles)
0x05 RGB555 ✔️ ✔️ for PCX compatible only
0x06 ARGB8888 ✔️ ✔️ Format consisting of 1 byte of alpha value and 1 byte of RGB values. (Palettize only!)
0x80 DDS_RGB24 ✔️ ✔️ RGB24 format (DXT1)
0x81 DDS_RGBA32 ✔️ ✔️ RGBA32 format (DXT3)

PVR data formats

Value Name Read Write Notes
0x01 SQUARE_TWIDDLED ✔️ ✔️
0x02 SQUARE_TWIDDLED_MIPMAP ✔️ ✔️
0x03 VECTOR_QUANTIZATION ✔️ ✔️
0x04 VECTOR_QUANTIZATION_MIPMAP ✔️ ✔️
0x05 PALETTIZE_4BIT ✔️ ✔️
0x06 PALETTIZE_4BIT_MIPMAP ✔️ ✔️
0x07 PALETTIZE_8BIT ✔️ ✔️
0x08 PALETTIZE_8BIT_MIPMAP ✔️ ✔️
0x09 RECTANGLE ✔️ ✔️
0x0A RECTANGLE_MIPMAP Reserved: Can't use.
0x0B RECTANGLE_STRIDE ✔️ ✔️
0x0C RECTANGLE_STRIDE_MIPMAP Reserved: Can't use.
0x0D RECTANGLE_TWIDDLED ✔️ ✔️ Should not be supported.
0x0E BMP No information.
0x0F BMP_MIPMAP No information.
0x10 VECTOR_QUANTIZATION_SMALL ✔️ ✔️
0x11 VECTOR_QUANTIZATION_SMALL_MIPMAP ✔️ ✔️
0x80 DDS ✔️ ✔️ DDS format
0x87 DDS ✔️ ✔️ DDS format

Models/Animation

Name Read Write Description Notes
MT5 ✔️ Model Container
MT6 Model Container
MT7 Model Container
MOTN Motion data (Animation sequences)
OBJ ✔️ Wavefront OBJ
DAE ✔️ Khronos Group COLLADA

Audio

Name Read Write Description Notes
SND Dreamcast sound file
XWMA Xbox WMA (XAudio2) file

Subtitles/Text

Name Read Write Description Notes
SRF Cinematic subtitles file
FONTDEF Font definition file
SUB Subtitles file
GLYPHS Font glyph file
FON Disk font file

Mapinfo

Name Read Write Description Notes
CHRD
CHRM
COLS Collisions (sm1)
DOOR Door portals?
ECAM
FLDD Collisions (sm2)
LGHT Lighting data
MAPR
MAPT
SCEX Cutscenes and maybe other stuff
SNDP Sound program
WTHR Weather data

Other

Name Read Write Description Notes
ATH Sequence Data
SRL Scroll Data
IWD LCD Table
WDT Weather Data
UI UI Json
CHR Character
MVS MVS data
DYM Dynamics Info
CRM Character Model
CHT Character Properties
CSV Comma-separated values
EMU Emulator file

Credits

Contributors:

Other: