Big Endian 32 Marathon Versions Save

Changes

• https://github.com/Big-Endian-32/Marathon/commit/0435d7fb4a5ccb5f00f474f3ea8a28bf8a9c0127 Added GetTotalSize function for retrieving the total byte count of nested data in an ArchiveDirectory.
• https://github.com/Big-Endian-32/Marathon/commit/4f7f31200f458cd38337263aa192d1d397e114b4 Added BinaryHelper class with some functions to make byte lengths more human readable.
• https://github.com/Big-Endian-32/Marathon/commit/03a2812cc903241ab65fd21d2270c0680044bc09 Added preliminary Ninja reading and writing.
• https://github.com/Big-Endian-32/Marathon/commit/d1f08c25507a9396a8ae716400c5a133658eeff3 Added more known flags for SonicNextSaveData and made SonicNextFlags use StringEnumConverter, making the JSON exports a bit more human readable.
• https://github.com/Big-Endian-32/Marathon/commit/fd2eac7158ca7dc4e60e1066b69a1c75df4704e7 Improved readability of decompiled results from Lua bytecode, using more IDA-styled naming conventions for unknown locals and arguments.
• https://github.com/Big-Endian-32/Marathon/commit/dfe733465be0a4c7da5f4f81ce9f8352f990721e Made ObjectDataType use StringEnumConverter, making the JSON exports a bit more human readable.
• https://github.com/Big-Endian-32/Marathon/commit/73c83007a90f8b796243432e509cea8c287df345 Implemented ByteArrayConverter for JSON conversion with unknown data.
• https://github.com/Big-Endian-32/Marathon/commit/2247b3e53d574fef2e376a33df1e78f7bb580e31 Implemented a parser for the CompletelyUnknownData segment of ParticleEffectBank.
• https://github.com/Big-Endian-32/Marathon/commit/47f8e6afdd1273436fece20dc41b46d524ff89dc Added support for Windows (x64), Linux and macOS.

Fixes

• https://github.com/Big-Endian-32/Marathon/commit/18c0df8ea3cd7ac07f0a5736f854d0069ab67766 Fixed the logger wrapping entire logs in square brackets, rather than just the caller.

Changes

• https://github.com/Big-Endian-32/Marathon/commit/d33572f558dec4fe611cda563577a98e64556206 Added LeaveOpen property to FileBase to allow the stream to be left open.
• https://github.com/Big-Endian-32/Marathon/commit/d41813dbd944564a236b5bec6db71f6df9160427 Reimplemented CreateDirectories to U8Archive to allow you to create an archive structure based on a local directory.
• https://github.com/Big-Endian-32/Marathon/commit/2a9867c06bf358a47707070a5d811189ac672ba6 Reimplemented SonicNextSaveData, now with a more complete specification at 98.86% cracked.
• https://github.com/Big-Endian-32/Marathon/commit/f416485d59d27d36c28549c123a1b0dac5dcba3f Added ReadNullPaddedString to BinaryReaderEx to make reading hard-coded string lengths easier without null characters getting in the way.
• https://github.com/Big-Endian-32/Marathon/commit/b325ff0a2e5e70e11bf65c4f4effe0c28cc39124 Reimplemented GetFiles to ArchiveHelper to allow you to enumerate all files in an archive into a single list.
• https://github.com/Big-Endian-32/Marathon/commit/f159028fb5a3845045bd3282c2786c31052761bc The minimum .NET version is now .NET 6.0 to utilise some of the C# 10 features.
• https://github.com/Big-Endian-32/Marathon/commit/6c6d99a2b9808d93f47fe680ec86debb2251dbf6 Added error logging to the command-line interface (if an exception occurs, Marathon.CLI.log should now appear next to the executable).

Fixes

• https://github.com/Big-Endian-32/Marathon/commit/88f68861848e70ade256b41ed14e4484b073dd9a Fixed an underlying issue with the archive writer causing uncompressed archives to write the incorrect sizes.
• https://github.com/Big-Endian-32/Marathon/commit/f3d8c06617b6c3e0f4ceb72b63362d943e6a451d Fixed the BINA writer not using the correct encoding (fixes BINA-formatted files not writing Japanese characters correctly).

Welcome to Marathon!

Let's get up-to-date, shall we? Sonic '06 Toolkit has been discontinued for almost a year and in that time, we've certainly improved regarding reverse-engineering and general software development. This release presents the step up we've taken since the last release of Sonic '06 Toolkit, and while this doesn't have a GUI yet, I hope our efforts towards at least allowing a lot of these previously unknown formats to be editable suffices in this release.

Why "Marathon"?

"Marathon" is one of the internal names used by SONIC THE HEDGEHOG, along with "SonicNext". The original PE header name for the Xbox 360 executable is marathon.exe, so that may actually be the proper internal name. I chose the name because Sonic Team used it, it's as simple as that.

What is there to offer in this release?

Marathon supports a multitude of formats that were previously unknown in the Sonic '06 Toolkit days. The available formats are listed in the repository's README document, so please head over there to see what's new. Alternatively, the command-line interface displays all of the supported serialisable formats if you open the application without a file.

Is Marathon complete?

Far from it... Marathon is certainly still a work-in-progress, but I feel like now is the right time to make a public release with our current work, as everything is now up to a more acceptable standard than Sonic '06 Toolkit or the earlier revisions of Marathon. A command-line tool existing alone is certainly a lot more friendly than asking newcomers to build Marathon and write C# code to edit the formats.

There are still some formats that we haven't fully cracked, so you may see remnants of that for certain exports with unknown data. If you can figure out what any of that does though, feel free to reach out.

How do I use Marathon?

Marathon can be used in two ways; as a C# API or as a command-line interface. There will be documentation available at a later date regarding the C# API, but the command-line interface is as easy to use as dragging supported files into it.

Depending on the format, the file's contents will be exported to JSON, which you can then make your changes in. As long as the extension is left intact, Marathon will automatically detect which format you exported and create a new file with your changes.

If you want to rename the JSON, just make sure you leave the full extension. For example; if you export a Message Table, ensure that the JSON uses the *.mst.json extension before dragging back into Marathon.

Where do I get the C# library?

Marathon is available on NuGet - you can download and use the latest release available from there and it'll be updated for every push to this repository.

This feels like a README.

Yeah, it kinda does, doesn't it?

► Use ArcPacker instead of Arctool (fixes an issue with the repacker ceasing function due to the Win32 API). ► Added feedback if there's a .NET settings issue.

This may be the last release of Sonic '06 Toolkit for Environment 3 - this codebase is now obsolete. Stay tuned for Environment 4!

► Implemented batch XNM decoder.

► Added loop options for ATRAC3plus. ► Optimised standalone sound decoder for ATRAC3plus. ► Redesigned Sonic Sound Studio. ► Added volume control to Sonic Sound Studio.

► Fixed invalidated repack sessions.

► Fixed unhandled exception when creating a new ARC with another tab open. ► Added modifier keys to all SDK menus for external file modification (hold SHIFT to use).

► Added warning if the user attempts to close the application when an archive is repacking. ► Improved Session Log UI and resizing.

► Added verification for application dependencies, which allows for dependency updates on the fly. ► Improved Session Log UI. ► Improved application stability. ► All processed paths are now decoded to help with virtual machines accessing drives on Unix systems (the most oddly specific error, I know).