Resources for decoding Amiga AmberStar data files, including Hippel-CoSo sound modules.

Make sure that the Amiga AmberStar data files are in the data/ subdirectory. Their names should be in all-caps (AMBERDEV.UDO etc.).

To compile and run, use the Rust cargo tool.

The current run modes are supported:

• cargo run strings: Dump out all text strings
• cargo run graphics: Shows some graphics
• cargo run song $X: Tries to play in-game song ${X} (will likely crash sooner or later).

I wanted a zero-stakes project to learn the basics of Rust, and this seemed fun. No promises as to whether this will or will not go anywhere.

Very much WIP. The following bits work to some extent:

• Data: Container format decoding is fully supported
• Text: String extraction seems to work
• In-Game Songs: Those songs (in Hippel-CoSo format) can be extracted and played (be aware that the sound player is very rudimentary and poorly debugged).
• Graphics: Decoding for some graphics works, but the palettes aren't always obvious

The following don't do anything yet:

• Intro/Outro
• Game scripts
• Maps
• Automaps
• Game Scripts

Only tested on a late English version of the game.

• All container formats can be decoded.
• Please check the WIP format descriptions

• Ambermoon resources: https://github.com/Pyrdacor/Ambermoon

This work is based by documentation collected from the following sources:

• Pyrdacor's collection of AmberMoon documentation: [https://github.com/Pyrdacor/Ambermoon]
• Heikki Orsila's UADE, specifically m68k assembly implementations of Jochen Hippel's sound formats
• Christian Corti's Flod 4.1 player for Jochen Hippel's 4-voice formats