README.MD

# SabreTools.Models

[![Build and Test](https://github.com/SabreTools/SabreTools.Models/actions/workflows/build_and_test.yml/badge.svg?branch=main)](https://github.com/SabreTools/SabreTools.Models/actions/workflows/build_and_test.yml)

**NOTICE**: This library has been deprecated. All functionality formerly in this library is in [SabreTools.Serialization](https://github.com/SabreTools/SabreTools.Serialization) as of version 2.0.0.

This library comprises of models that represent either directly serializable or representative structures for all SabreTools projects. All of the main models representing metadata files should have parsers created outside of the current code.

Find the link to the Nuget package [here](https://www.nuget.org/packages/SabreTools.Models).

## Releases

For the most recent stable build, download the latest release here: [Releases Page](https://github.com/SabreTools/SabreTools.Models/releases)

For the latest WIP build here: [Rolling Release](https://github.com/SabreTools/SabreTools.Models/releases/rolling)

## Notable Information Sources

Not all of this information was able to be gathered directly from the files in question, so here is a non-exhaustive list of sites and projects that allow this project to exist. Most of the models also have direct links to specific pages or code snippets, where available.

| Site/Project | Models Directory |
| --- | --- |
| [3DBrew](https://www.3dbrew.org/wiki/Main_Page) | N3DS |
| [Aaru Data Preservation Suite](https://github.com/aaru-dps) | PIC |
| [Advanced Access Content System Licensing Administrator (AACS LA)](https://aacsla.com/) | AACS |
| [BYTE*](https://web.archive.org/web/20240703222951/https://bytepointer.com/index.htm) | NewExecutable |
| [cabextract/libmspack](https://www.cabextract.org.uk/) | LZ |
| [DBox](https://dbox.tools/) | Xbox |
| [DebugInfo.com](https://www.debuginfo.com/index.html) | PortableExecutable |
| [Devilsclaw](https://devilsclaws.net/) | PFF |
| [DSiBrew](https://dsibrew.org/wiki/Main_Page) | Nitro |
| [DVD Resources for Open Source Development](https://dvd.sourceforge.net/) | DVD |
| [EDM/2](https://www.edm2.com/index.php/Main_Page) | LinearExecutable |
| [faydoc.tripod.com](https://faydoc.tripod.com/formats/) | LinearExecutable |
| [GuitarGame_ChartFormats](https://github.com/TheNathannator/GuitarGame_ChartFormats/) | Charts |
| [HandWiki](https://handwiki.org/wiki/Start) | Quantum |
| [HLLib](https://github.com/RavuAlHemio/hllib/) | BSP, GCF, NCF, PAK, SGA, VPK, WAD3, XZP |
| [IBM Documentation](https://www.ibm.com/docs/en) | TAR |
| [IETF](https://www.ietf.org/) | GZIP |
| [Independent Commodore Library](https://petlibrary.tripod.com/) | PKZIP |
| [Ladislav Zezula](http://zezula.net/en/tools/main.html) | MoPaQ |
| [libaacs](https://code.videolan.org/videolan/libaacs/) | AACS |
| [libbdplus](https://github.com/mwgoldsmith/bdplus) | BD+ |
| [libexe](https://github.com/libyal/libexe/) | NewExecutable |
| [MAME](https://github.com/mamedev/mame/) | CHD |
| [Matthew Russotto](http://www.russotto.net/quantumcomp.html) | Compression/Quantum |
| [Microsoft Learn](https://learn.microsoft.com/en-us/) | BMP, CFB, Compression/LZX, Compression/MSZIP, MicrosoftCabinet, OLE, PortableExecutable, SecuROM, WiseInstaller |
| [msitools](https://github.com/GNOME/msitools/) | CFB |
| [OSDev.org](https://wiki.osdev.org/Expanded_Main_Page) | MSDOS, NewExecutable |
| [PInvoke.net](http://www.pinvoke.net/index.aspx) | MSDOS |
| [PKWARE(?)](https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT) | PKZIP |
| [PS3 Developer Wiki](https://www.psdevwiki.com/ps3/) | IRD, PlayStation3 |
| [RanseiLink](https://github.com/Deijin27/RanseiLink) | Nitro |
| [Reverse Engineering Wise](https://codeberg.org/CYBERDEV/REWise) | WiseInstaller |
| [SharpCompress](https://github.com/adamhathcock/sharpcompress) | PKZIP |
| [Source SDK 2013](https://github.com/ValveSoftware/source-sdk-2013) | BSP |
| [Technical Committee T10](https://www.t10.org/) | PIC |
| [The Go tools for Windows + Assembler](https://www.godevtool.com/) | PortableExecutable |
| [The Whole Half-Life](https://twhl.info/wiki/page/Specification:_WAD3) | WAD3 |
| [Unshield](https://github.com/twogood/unshield) | InstallShieldCabinet |
| [unshieldv3](https://github.com/wfr/unshieldv3) | InstallShieldArchiveV3 |
| [Valve Developer Community](https://developer.valvesoftware.com/wiki/Main_Page) | BSP, VPK |
| [w4kfu's bl0g](https://web.archive.org/web/20250206143756/http://blog.w4kfu.com/) | SafeDisc |
| [Wine](https://github.com/wine-mirror/wine/) | LZ |
| [XboxDevWiki.net](https://xboxdevwiki.net/Main_Page) | Xbox |
| [XeNTaX Game Research Forum](http://web.archive.org/web/20231031162306/https://forum.xentax.com/) | SFFS |
Add README 2023-09-04 01:37:24 -04:00			`# SabreTools.Models`

Add badge for build status 2024-12-06 10:48:43 -05:00			`[![Build and Test](https://github.com/SabreTools/SabreTools.Models/actions/workflows/build_and_test.yml/badge.svg?branch=main)](https://github.com/SabreTools/SabreTools.Models/actions/workflows/build_and_test.yml)`

Update final notice 2025-09-29 07:29:37 -04:00			`NOTICE: This library has been deprecated. All functionality formerly in this library is in [SabreTools.Serialization](https://github.com/SabreTools/SabreTools.Serialization) as of version 2.0.0.`
Add deprecation notice 2025-09-26 12:00:12 -04:00
Add README 2023-09-04 01:37:24 -04:00			`This library comprises of models that represent either directly serializable or representative structures for all SabreTools projects. All of the main models representing metadata files should have parsers created outside of the current code.`

Add Nuget link 2023-09-04 21:58:17 -04:00			`Find the link to the Nuget package [here](https://www.nuget.org/packages/SabreTools.Models).`

Rename workflow file, add releases to README 2024-12-06 10:47:42 -05:00			`## Releases`

			`For the most recent stable build, download the latest release here: [Releases Page](https://github.com/SabreTools/SabreTools.Models/releases)`

			`For the latest WIP build here: [Rolling Release](https://github.com/SabreTools/SabreTools.Models/releases/rolling)`

Clickable sources, archive links for dead pages 2025-08-15 10:09:43 -04:00			`## Notable Information Sources`

			`Not all of this information was able to be gathered directly from the files in question, so here is a non-exhaustive list of sites and projects that allow this project to exist. Most of the models also have direct links to specific pages or code snippets, where available.`

			`\| Site/Project \| Models Directory \|`
			`\| --- \| --- \|`
			`\| [3DBrew](https://www.3dbrew.org/wiki/Main_Page) \| N3DS \|`
			`\| [Aaru Data Preservation Suite](https://github.com/aaru-dps) \| PIC \|`
			`\| [Advanced Access Content System Licensing Administrator (AACS LA)](https://aacsla.com/) \| AACS \|`
			`\| [BYTE*](https://web.archive.org/web/20240703222951/https://bytepointer.com/index.htm) \| NewExecutable \|`
			`\| [cabextract/libmspack](https://www.cabextract.org.uk/) \| LZ \|`
			`\| [DBox](https://dbox.tools/) \| Xbox \|`
			`\| [DebugInfo.com](https://www.debuginfo.com/index.html) \| PortableExecutable \|`
			`\| [Devilsclaw](https://devilsclaws.net/) \| PFF \|`
			`\| [DSiBrew](https://dsibrew.org/wiki/Main_Page) \| Nitro \|`
			`\| [DVD Resources for Open Source Development](https://dvd.sourceforge.net/) \| DVD \|`
			`\| [EDM/2](https://www.edm2.com/index.php/Main_Page) \| LinearExecutable \|`
			`\| [faydoc.tripod.com](https://faydoc.tripod.com/formats/) \| LinearExecutable \|`
			`\| [GuitarGame_ChartFormats](https://github.com/TheNathannator/GuitarGame_ChartFormats/) \| Charts \|`
			`\| [HandWiki](https://handwiki.org/wiki/Start) \| Quantum \|`
			`\| [HLLib](https://github.com/RavuAlHemio/hllib/) \| BSP, GCF, NCF, PAK, SGA, VPK, WAD3, XZP \|`
			`\| [IBM Documentation](https://www.ibm.com/docs/en) \| TAR \|`
			`\| [IETF](https://www.ietf.org/) \| GZIP \|`
			`\| [Independent Commodore Library](https://petlibrary.tripod.com/) \| PKZIP \|`
			`\| [Ladislav Zezula](http://zezula.net/en/tools/main.html) \| MoPaQ \|`
Cleanup from last PR 2025-09-12 12:54:22 -04:00			`\| [libaacs](https://code.videolan.org/videolan/libaacs/) \| AACS \|`
Clickable sources, archive links for dead pages 2025-08-15 10:09:43 -04:00			`\| [libbdplus](https://github.com/mwgoldsmith/bdplus) \| BD+ \|`
			`\| [libexe](https://github.com/libyal/libexe/) \| NewExecutable \|`
			`\| [MAME](https://github.com/mamedev/mame/) \| CHD \|`
			`\| [Matthew Russotto](http://www.russotto.net/quantumcomp.html) \| Compression/Quantum \|`
			`\| [Microsoft Learn](https://learn.microsoft.com/en-us/) \| BMP, CFB, Compression/LZX, Compression/MSZIP, MicrosoftCabinet, OLE, PortableExecutable, SecuROM, WiseInstaller \|`
			`\| [msitools](https://github.com/GNOME/msitools/) \| CFB \|`
			`\| [OSDev.org](https://wiki.osdev.org/Expanded_Main_Page) \| MSDOS, NewExecutable \|`
			`\| [PInvoke.net](http://www.pinvoke.net/index.aspx) \| MSDOS \|`
			`\| [PKWARE(?)](https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT) \| PKZIP \|`
			`\| [PS3 Developer Wiki](https://www.psdevwiki.com/ps3/) \| IRD, PlayStation3 \|`
			`\| [RanseiLink](https://github.com/Deijin27/RanseiLink) \| Nitro \|`
			`\| [Reverse Engineering Wise](https://codeberg.org/CYBERDEV/REWise) \| WiseInstaller \|`
Source my sources 2025-08-28 07:40:09 -04:00			`\| [SharpCompress](https://github.com/adamhathcock/sharpcompress) \| PKZIP \|`
Clickable sources, archive links for dead pages 2025-08-15 10:09:43 -04:00			`\| [Source SDK 2013](https://github.com/ValveSoftware/source-sdk-2013) \| BSP \|`
			`\| [Technical Committee T10](https://www.t10.org/) \| PIC \|`
			`\| [The Go tools for Windows + Assembler](https://www.godevtool.com/) \| PortableExecutable \|`
			`\| [The Whole Half-Life](https://twhl.info/wiki/page/Specification:_WAD3) \| WAD3 \|`
			`\| [Unshield](https://github.com/twogood/unshield) \| InstallShieldCabinet \|`
			`\| [unshieldv3](https://github.com/wfr/unshieldv3) \| InstallShieldArchiveV3 \|`
			`\| [Valve Developer Community](https://developer.valvesoftware.com/wiki/Main_Page) \| BSP, VPK \|`
			`\| [w4kfu's bl0g](https://web.archive.org/web/20250206143756/http://blog.w4kfu.com/) \| SafeDisc \|`
			`\| [Wine](https://github.com/wine-mirror/wine/) \| LZ \|`
			`\| [XboxDevWiki.net](https://xboxdevwiki.net/Main_Page) \| Xbox \|`
			`\| [XeNTaX Game Research Forum](http://web.archive.org/web/20231031162306/https://forum.xentax.com/) \| SFFS \|`