Function launchGame

src/back/GameLauncher.ts:136–305

(opts: LaunchGameOpts, onWillEvent: ApiEmitterFirable<GameLaunchInfo>, curation: boolean, serverOverride?: string)

   * @param serverOverride Change active server for this game launch only
   */
  export async function launchGame(opts: LaunchGameOpts, onWillEvent: ApiEmitterFirable<GameLaunchInfo>, curation: boolean, serverOverride?: string): Promise<void> {
    await checkAndInstallPlatform(opts.game.detailedPlatforms!, opts.state, opts.openDialog);
    // Handle any special game data actions
    const gameData = !curation ? (opts.game.activeDataId ? await fpDatabase.findGameDataById(opts.game.activeDataId) : null) : null;
    // Run all provided additional applications with "AutoRunBefore" enabled
    if (opts.game.addApps) {
      const addAppOpts: Omit<LaunchAddAppOpts, 'addApp' | 'parentGame'> = {
        changeServer: opts.changeServer,
        fpPath: opts.fpPath,
        htdocsPath: opts.htdocsPath,
        dataPacksFolderPath: opts.dataPacksFolderPath,
        sevenZipPath: opts.sevenZipPath,
        native: opts.native,
        execMappings: opts.execMappings,
        lang: opts.lang,
        isDev: opts.isDev,
        exePath: opts.exePath,
        appPathOverrides: opts.appPathOverrides,
        providers: opts.providers,
        proxy: opts.proxy,
        openDialog: opts.openDialog,
        openExternal: opts.openExternal,
        runGame: opts.runGame,
        runAddApp: opts.runAddApp,
        envPATH: opts.envPATH,
        state: opts.state,
        activeConfig: opts.activeConfig,
        autoClearWininetCache: opts.autoClearWininetCache,
        override: opts.override,
      };
      for (const addApp of opts.game.addApps) {
        if (addApp.autoRunBefore) {
          await launchAdditionalApplication({ ...addAppOpts, addApp, parentGame: opts.game }, curation);
        }
      }
    }
    // Launch game callback
    const launchCb = async (launchInfo: GameLaunchInfo): Promise<void> =>  {
      /**
       * Order
       * - API listeners
       * - Middleware
       * - Handle game data params
       */
      await onWillEvent.fire(launchInfo)
      .then(async () => {
        // Handle middleware
        if (launchInfo.activeConfig) {
          log.info(logSource, `Using Game Configuration: ${launchInfo.activeConfig.name}`);
          for (const middlewareConfig of launchInfo.activeConfig.middleware) {
            // Find middleware in registry
            const middleware = opts.state.registry.middlewares.get(middlewareConfig.middlewareId);
            if (!middleware) {
              throw `Middleware not found (${middlewareConfig.middlewareId})`;
            }
            try {
              launchInfo = await Promise.resolve(middleware.execute(launchInfo, middlewareConfig));
            } catch (err) {