Homecoming Launcher

About

The Homecoming Launcher is the officially supported patching application for Homecoming: City of Heroes. It was released in Issue 27 on October 2021.

Homecoming Launcher has the following features:

• Faster patching. Homecoming Launcher uses modern packaging methods and compression to achieve a much faster patching experience than prior launchers.
• Portable application. Once installed, the Launcher exists only in the folder it is installed in with no Registry Keys, Library Files, or other components required. Backup and moving is as simple as copy & paste.
• One click play. Once patched, any card on the left (referred to as profile) can be launched by clicking Play, or clicking on the card once it says "Ready".
• User-Mode. Homecoming Launcher does not require any Administrator rights to install or run (with a key exception noted in Requirements below.)
• Multi-launch. Enabled on any system by visiting Options and clicking a check box. The Launcher runs in single-launch mode by default (only one copy of the Game Client can run at a time.)
• Opt-in patching. Users who do not want to patch Live or Prerelease profiles do not have to. Simply ignore them.
• Manifest-free. Homecoming Launcher does away with manifest addresses for patching. Because it uses a "chain-of-trust" method that reaches the Homecoming CDN directly, Homecoming Launcher is designed for Homecoming: City of Heroes use only and does not patch any other games or tools. (Titan Icon and Paragon Chat are no longer included.)
• Smart install. On first run, Homecoming Launcher detects an existing Tequila launch and asks to copy the Issue 24 files to speed up installation and patching on first use.

First Time Use

1. Download the [Installer] from Homecoming Servers.
2. Run the installer.
3. Installation directory: it will ask where to install the files, with "C:\Games\Homecoming" as a default. It will also ask to install a shortcut on the Desktop and Start Menu for you.
4. First run: Only if Tequila is installed. It will ask whether you want to copy Issue 24 files and import certain files. Your screenshots, modifications (anything in /data under Tequila), power customizations, costumes, and logs will be copied over to the new client. (For space saving reasons, screenshots and architect files will not be copied. Those will need to be moved/backed up on your own.)
5. After installation is completed, the installer will exit and run the Launcher for the first time. You can click the download icon on any profile to start patching immediately.

Requirements

Homecoming Launcher needs no additional software to run. Unlike Tequila, it does not use .NET 3.5 to operate. The game client still requires Visual C 2015 Runtime to start. If the runtime is not found, Homecoming Launcher will prompt to install the runtime on the first run. Visual C 2015 Runtime requires administrative rights to install (either an Administrator Account in Windows, or a username/password for one-time use.) This is the only time Homecoming Launcher will require such privileges.

Updates

On occasion, updates to Homecoming Launcher will be automatically downloaded and installed. This is fully-automatic: if an update is present, the Launcher will close immediately, update itself, and return to the display.

Command Line Use

Homecoming Launcher also has a command line app to use to perform patching and launch the game by script. Assuming you choose the default directory, and you use the 64-bit client to play the game, the file is located in "C:\Games\Homecoming\bin\win64\launchercli.exe". The following arguments work with LauncherCLI.exe.

Command	Example	Description
list	> launchercli list	Shows a list of installed profiles and their ID names. Profiles by ID: live: Live Client. Used for the live game service. beta: Beta Client. Used for Beta Testing an upcoming patch or revision. pre: Prerelease Client. Used for quick-release tests that doesn't involve a major revision to the Live Client.
install	> launchercli install live	Installs a given profile by ID Name.
uninstall	> launchercli uninstall beta	Uninstalls a given profile by ID Name.
update	> launchercli update pre	Performs updates on the given profile by ID Name. Shows a progress counter and returns to command prompt when finished.
verify	> launchercli verify live	Performs a file check on a given profile by ID Name. Once all the files pass or fail validation, returns to command prompt when finished.
launch	> launchercli launch live [''arguments'']	Selects the given profile by ID Name and launches Homecoming: City of Heroes. Returns to command prompt once the client shows the "Loading" graphic. The [''arguments''] area (no brackets needed) is where you can enter command-line arguments for the Game Client to launch. It's not needed to start the game, and certain arguments have been removed concerning Homecoming: City of Heroes (-authserver isn't accepted any longer, for example.)