Skip to content

An alternative OpenSauce installer that preserves the sweetness.

License

Notifications You must be signed in to change notification settings

MirisWisdom/AmaiSosu

Repository files navigation

HCE.AmaiSosu

An Alternative OpenSauce Installer

Download Support

Introduction

AmaiSosu is an installer for the HCE OpenSauce mod, which seeks to make the installation much more straightforward and easy. It serves as the successor of SweetSauce, in both its name and in its functionality.

AmaiSosu installs the OpenSauce library data to the given HCE directory path, and it also installs in-game UI for configuring OpenSauce. If OpenSauce/HAC2 files are present in the given HCE directory path, it will back them up to a directory named AmaiSosu.Backup.<GUID>. HAC2 is incompatible with OS, thus it will be deactivated to ensure that there is no collision.

Features

  • installation of the OpenSauce libraries, in-game UI and user configurations;
  • installation of OpenSauce development tools (OS_Guerilla, OS_Sapien, OS_Tool, etc.);
  • installation of the OpenSauce IDE to the HCE directory, for self-containerisation & convenience;
  • automatic back-up of existing OpenSauce data in the HCE directory (both files and folders);
  • automatic back-up & deactivation of HAC2 if it exists, due to its incompatibility with OpenSauce;
  • automatic detection attempt of a legally installed HCE directory for an even easier installation;
  • ability to manually specify a HCE directory, for portable/non-standard HCE installations;
  • minimum administrative requirements -- they are only needed if HCE is installed a restricted location;
  • minimum .NET Framework required is 4.5, which comes built-in as of Windows 8 -- no need for multiple .NET versions;
  • dependencies used by OpenSauce (e.g. MSVCR) are all installed to the HCE directory rather than on the system.

Usage

  1. Download the installer and run it with administrative permissions.
  2. If HCE is legally installed, its path should be detected. Just click Install, and you're done!
  3. However, if the path is not found, please click on browse and look for haloce.exe on your computer. Then, you can click Install and be done!

Support

Given that the GitHub repository is a public mirror of the upstream code, issues are disabled there. To report bugs, please rely on the official Reddit thread, or contact me on Discord if you know my username!

Development

Library

As of v0.3.4, AmaiSosu uses a forked version Atarashii Library's OpenSauce module for installing OS to the system. It also applies its own modifications and enhancements on top, such as backing up existing OpenSauce data, resolving HAC2 conflicts and installing the OS IDE to the HCE directory.

Repository

The GitHub repository for AmaiSosu serves a public read-only mirror of the private upstream repository. All commits are immediately mirrored to GitHub for transparency.

Contributors

The following invaluable testers have reported/assisted with issues:

Attributions

About

An alternative OpenSauce installer that preserves the sweetness.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages