AmaiSosu.lib 0.0.1-DUMMY

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Framework 4.6.2 This package targets .NET Framework 4.6.2. The package is compatible with this framework or higher.
This is a prerelease version of AmaiSosu.lib. 
dotnet add package AmaiSosu.lib --version 0.0.1-DUMMY
                    


                    

                
NuGet\Install-Package AmaiSosu.lib -Version 0.0.1-DUMMY
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="AmaiSosu.lib" Version="0.0.1-DUMMY" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="AmaiSosu.lib" Version="0.0.1-DUMMY" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="AmaiSosu.lib" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add AmaiSosu.lib --version 0.0.1-DUMMY
                    


                    

                
#r "nuget: AmaiSosu.lib, 0.0.1-DUMMY"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package AmaiSosu.lib@0.0.1-DUMMY
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=AmaiSosu.lib&version=0.0.1-DUMMY&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=AmaiSosu.lib&version=0.0.1-DUMMY&prerelease
                    


                            Install as a Cake Tool

<html> <p align="center"> <img src="https://user-images.githubusercontent.com/10241434/61166409-7f6f7d80-a55f-11e9-8e68-bfaa3e39890e.png"> <p> <h1 align="center"> AmaiSosu </h1> <h3 align="center"> An Alternative OpenSauce Installer </h3> <p align="center"> <img src="https://user-images.githubusercontent.com/10241434/61166547-fc035b80-a561-11e9-8928-d39d5d4a6a77.png"> <p> <p align="center"> <a href="https://github.com/HaloSPV3/AmaiSosu/releases/latest"> Download </a> • <a href="https://www.reddit.com/r/halospv3/comments/9xvnn5/amaisosu_an_opensauce_installer/"> Support </a> </p> </html>

<html> <a href="https://codeclimate.com/github/HaloSPV3/AmaiSosu/maintainability"> <img src="https://api.codeclimate.com/v1/badges/a095f82cd198d0034b04/maintainability" /> </a> <a href="https://codeclimate.com/github/HaloSPV3/AmaiSosu/test_coverage"> <img src="https://api.codeclimate.com/v1/badges/a095f82cd198d0034b04/test_coverage" /> </a> <a href="https://codecov.io/gh/HaloSPV3/AmaiSosu"> <img src="https://codecov.io/gh/HaloSPV3/AmaiSosu/branch/main/graph/badge.svg?token=55B93J5TFA" /> </a> </html>

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 and in-game settings user interface;
  • 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;
  • automatic installation when bundled with SPV3;
  • 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!

Portable Installations

OpenSauce 4.0.0 (2015) and 4.0.1 (2017) require the following files at non-portable paths:

Usage File Path
In-game config overlay(?) C:\\ProgramData\\Kornner Studios\\Halo CE\\OpenSauceUI.pak
Geometry Buffer shaders C:\\ProgramData\\Kornner Studios\\Halo CE\\shaders\\gbuffer_shaders.shd
Post-Processing shaders C:\\ProgramData\\Kornner Studios\\Halo CE\\shaders\\pp_shaders.shd

For users out there with alternative HCE installations in conformist environments, download the installer and extract it using 7-Zip or WinRAR. Then, run the extracted AmaiSosu.GUI.exe executable without admin permissions and install it to your portable HCE directory.

Note that attempting to install AmaiSosu to HCE in a restricted location (e.g. Program Files\Microsoft Games\) without admin permissions will cause issues!

Support

Please post an issue if you encounter any problems.

Contributors

The following invaluable testers have reported/assisted with issues:

Attributions

Badge dump

Markdown

codecov

HTML

<html> <a href="https://codeclimate.com/github/HaloSPV3/AmaiSosu/maintainability"> <img src="https://api.codeclimate.com/v1/badges/a095f82cd198d0034b04/maintainability" /> </a> <a href="https://codeclimate.com/github/HaloSPV3/AmaiSosu/test_coverage"> <img src="https://api.codeclimate.com/v1/badges/a095f82cd198d0034b04/test_coverage" /> </a> <a href="https://codecov.io/gh/HaloSPV3/AmaiSosu"> <img src="https://codecov.io/gh/HaloSPV3/AmaiSosu/branch/main/graph/badge.svg?token=55B93J5TFA" /> </a> </html>

Product Compatible and additional computed target framework versions.
.NET net6.0-windows7.0 is compatible.  net7.0-windows was computed.  net8.0-windows was computed.  net9.0-windows was computed.  net10.0-windows was computed. 
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • .NETFramework 4.6.2

    • HXE (>= 2.3.1)

  • .NETFramework 4.8

    • HXE (>= 2.3.1)

  • net6.0-windows7.0

    • HXE (>= 2.3.1)

NuGet packages (1)

Showing the top 1 NuGet packages that depend on AmaiSosu.lib:

Package Downloads
AmaiSosu

OpenSauce Installer

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.0.1-DUMMY 86 7/9/2026

# Changelog
All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## v0.4.1
### Added
- Added --auto parameter to install to Working Directory.

## v0.4.0
### Added
- A completely new user interface and branding style.

### Removed
- Installation of user XML settings (OpenSauce generates them on start-up).

## v0.3.5
### Added
- Asynchronous invocation of the installation procedure.
- Ability to detect an officially SPV3.2 directory.
- Remove OpenSauce data directory pre-installation.

### Changed
- Changed licence to GPL-3.0.

## v0.3.4
### Added
- Manifest file for reinforcing administrative requirements.

### Fixed
- Eliminate the "This program might not have installed correctly" warning by adding a manifest file.

### Removed
- Atarashii library is no longer used; instead, its OpenSauce installation code has been ported to AmaiSosu.

## v0.3.3
### Changed
- The background image's resolution has been increased in size.
- Distributed SFX compilation method (from WinRAR to 7-Zip).

### Fixed
- False positives from some AVs on VirusTotal, due to the SFX compilation method. Cheers to moiler  & `Anton#6293` for
 informing me about the false positives.
- Graphical glitches on WINE due to previously lower resolution background. Cheers to
 [Lionir](https://github.com/lionirdeadman) for the heads up.

## v0.3.2
### Added
- Outputting of the source version/revision used for compiling the binary.
- Deactivation of the install button until a valid HCE directory is chosen.

## v0.3.1
### Fixed
- Unintentional backing up of default HCE shader files when installing OpenSauce. AmaiSosu now distinguishes betweeen
 OpenSauce shader files and HCE shader files. A thank you to the following invaluable testers for assisting with this
 issue: `Anton#6293`, [Michelle](https://github.com/gbMichelle) and [Lionir](https://github.com/lionirdeadman).

## v0.3.0
### Added
- Introduced support for installing the OpenSauce IDE to a dedicated sub-directory in the HCE directory, rather than to
 the original directory which is pretty obscure and inconvenient to access.

## v0.2.0
### Added
- Introduced support for detecting & backing up HAC2. Because HAC2 is incompatible with OpenSauce, AmaiSosu will back up
  its DLL to disable HCE from loading it.

## v0.1.0
### Added
- Everything! This is the initial release of AmaiSosu.
 Please report issues [here](https://www.reddit.com/r/halospv3/comments/9xvnn5/amaisosu_an_opensauce_installer/)!