Codec

Asset browser for Metal Gear Solid games (and others). This project is licensed under the MIT license. Support for M2 files is provided as a separate project, licensed under the GPL v3 license.

Support for the following formats is implemented:

• Archives
  • Generic
    • .iso Images
    • .bin/cue Images
    • .zip Files [read & write]
    • .ciso GameCube images
  • Metal Gear Specific
    • M2 Archive (Master Collection v1)
      • .psb.m Packaging Format
    • .dar Archives (MGS1, MGA2, MGO, MGO+, MGS PW, MGS4)
    • .dir Archives (MGS1, MGS2, TTS, MGS4)
    • .qar Archives (MGS2, TTS, MGS3, MGA2, MGO, MGO+, MGS PW, MGS4)
    • .slot Archives (MGS4)
    • .pak Archives (MGS4) [read & write]
    • _zar Archives (MGA2, MGO, MGO+)
    • BRF.DAT Archive (MGS1)
    • DEMO.DAT Archive (MGS1)
    • FACE.DAT Archive (MGS1) [read & write]
    • RADIO.DAT Archive (MGS1)
    • SLOT.DAT Archive (MGS PW)
    • STAGE.DAT Archive (MGS2 & TTS)
    • STAGE.DIR Archive (MGS1 & MGSVR)
    • VOX.DAT Archive (MGS1 & MGSVR)
• Files
  • Generic
    • All Basic Image Formats (PNG, JPEG, BMP, etc.)
    • All Basic 3D Formats (FBX, OBJ, STL, STEP, etc.)
    • WAV, MP3, and MIDI Audio Files
    • All VGMStream Formats (VAG, OGG Vorbis, etc.)
    • CD Audio Tracks
    • .pcx Image Files
  • Metal Gear Specific
    • .ctxr Texture Files (MGS2 & MGS3)
    • .gly Glyph Files (MGS1)
    • .pll Image Files (MGS1)
    • .rpk Texture Files (MGS1) [read & write]
    • .tri Texture Files (MGS2 & MGS3)
    • .txn/.dlz/.dld Texture Files (MGS4)
    • .txp Texture Files (MGS PW)
    • .mdx Model Files (MGS1)
    • .kmd Model Files (MGS1)
    • .kms Model Files (MGS2)
    • .kmy Model Files (TTS)
    • .mdn Model Files (MGS4)
    • .mdx Sequence Packs (MGS1)
    • .sdt Sound Packs (MGS2)
    • .sdx Sound Packs (MGS2)
    • .wvx Sound Packs (MGS1)

To view Master Collection resources, you will need to have a copy of the game on your system. The tool will automatically detect the Steam location of the game, but you can browse to any location as desired.

Running on Linux

sudo apt install -y libassimp-dev libmagickwand-dev mesa-utils
sudo apt-get install -y dotnet-runtime-9.0
chmod +x Codec.UI.Avalonia

Building

Release:

dotnet publish -c Release -r win-x64
dotnet publish -c Release -r linux-x64

Usage

// Setupvarservices=Codec.UI.ServiceRegistration.RegisterHeadless();varfsm=services.GetRequiredService<NestedFileSystemManager>();// Grab the root filesystem.// APIfsm.EnumerateEntries(@"G:\Rip\Exp\METAL GEAR SOLID DISC 1.CUE\MGS\FACE.DAT/0/f73b.face").Dump();varpath="...";usingvarreadA=fsm.OpenRead(path);usingvarreadB=fsm.Open(path,newFileStreamOptions{Mode=FileMode.Open,Access=FileAccess.Read,Share=FileShare.Read});usingvarreadC=fsm.Open(path,newFileStreamOptions{Mode=FileMode.Open,Access=FileAccess.Read,Share=FileShare.None});// Read/write file locks are supported hierarchically.usingvarwrite=fsm.Open(path,newFileStreamOptions{Mode=FileMode.Open,Access=FileAccess.ReadWrite,Share=FileShare.ReadWrite});// Read/write is supported on some filetypes.// Some files are virtual and cannot be written. This will throw:usingvarvirtualA=fsm.Open(@"...\MGS\FACE.DAT/0/f73b.face/base.img",newFileStreamOptions{Mode=FileMode.Open,Access=FileAccess.ReadWrite,Share=FileShare.None});// Some filesystems are read-only and cannot be written. This will throw:usingvarvirtualB=fsm.Open(@"...\METAL GEAR SOLID DISC 1.CUE\...",newFileStreamOptions{Mode=FileMode.Open,Access=FileAccess.ReadWrite,Share=FileShare.None});// You can obtain bitmaps from known image types using:varbitmap=fsm.Resolve<MagickImage>(path);// Likewise with Auio streams:varaudio=fsm.Resolve<AudioStream>(path)??(AudioStream)fsm.OpenRead(path);// And 3D Objects:varscene=fsm.Resolve<RenderableScene>(path);

OpenSource Info

Project	License	Details
Silk.NET	MIT	3D rendering and windowing
HIDDevices	Apache 2.0	Device handling
Assimp	MIT + BSD-3-Clause	3D object loading and saving
Magick.NET	Apache 2.0	Image loading and saving
VgmSharp	ISC	Audio loading
NAudio	MIT	Audio loading and playing
System.IO.Abstractions	MIT	Nested filesystems
CueSharp	BSD-2-Clause	CUE format
DiscUtils	MIT	ISO format
MeltySynth	MIT	MIDI Synthesizer
TinySoundFont	MIT	Sound Font file
DryWetMidi	MIT	MIDI creation
GMWare.M2	GPL 3.0	M2 Archive format
metalgeardev/MGS1		Reference code
mgs_reversing		Reference code
tools-mgs	zlib	Reference code
CtxrTool	MIT	Reference code
MGS-Master-Collection-Noesis		Reference code
kmy2ob		Reference code
Arsenal	MIT	Reference code
Solideye	MIT	Reference code
MGS-MDP-Noesis		Reference code
MGS2-Sound-Tools	MIT	Reference code
Metal Gear Master Collection	Non-transferrable	You need your own license to this software, and your license may not cover this usage.
Digital-7 Font	Freeware for home use	Frequency display (coming soon)
Font Awesome Free Icons	CC BY 4.0	Used for UI icons