wesnoth/src/game_launcher.cpp

/*
	Copyright (C) 2003 - 2025
	by David White <dave@whitevine.net>
	Part of the Battle for Wesnoth Project https://www.wesnoth.org/

	This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation; either version 2 of the License, or
	(at your option) any later version.
	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY.

	See the COPYING file for more details.
*/

#include "game_launcher.hpp"
#include "game_errors.hpp"

#include "ai/manager.hpp"          // for manager
#include "commandline_options.hpp" // for commandline_options
#include "config.hpp"              // for config, etc
#include "cursor.hpp"              // for set, CURSOR_TYPE::NORMAL
#include "exceptions.hpp"          // for error
#include "filesystem.hpp"          // for get_user_data_dir, etc
#include "game_classification.hpp" // for game_classification, etc
#include "game_config.hpp"         // for path, etc
#include "game_config_manager.hpp" // for game_config_manager
#include "game_initialization/multiplayer.hpp"  // for start_client, etc
#include "game_initialization/playcampaign.hpp" // for play_game, etc
#include "game_initialization/singleplayer.hpp" // for sp_create_mode
#include "generators/map_generator.hpp"         // for mapgen_exception
#include "gettext.hpp"                          // for _
#include "gui/dialogs/language_selection.hpp"   // for language_selection
#include "gui/dialogs/loading_screen.hpp"
#include "gui/dialogs/message.hpp" // for show error message
#include "gui/dialogs/multiplayer/mp_connect.hpp"
#include "gui/dialogs/title_screen.hpp"      // for show_debug_clock_button
#include "gui/dialogs/transient_message.hpp" // for show_transient_message
#include "gui/widgets/settings.hpp"          // for new_widgets
#include "language.hpp"                      // for language_def, etc
#include "log.hpp"                           // for LOG_STREAM, logger, general, etc
#include "map/exception.hpp"
#include "preferences/preferences.hpp"
#include "save_index.hpp"
#include "scripting/application_lua_kernel.hpp"
#include "sdl/surface.hpp"                // for surface
#include "serialization/compression.hpp"  // for format::NONE
#include "tstring.hpp"       // for operator==, operator!=
#include "video.hpp"
#include "wesnothd_connection_error.hpp"
#include "wml_exception.hpp" // for wml_exception

#include <algorithm> // for copy, max, min, stable_sort
#ifdef _WIN32
#include <boost/process/windows.hpp>
#endif
#include <boost/process.hpp>
#include <cstdlib>   // for system
#include <new>
#include <thread>
#include <utility> // for pair

#ifdef DEBUG_WINDOW_LAYOUT_GRAPHS
#include "gui/widgets/debug.hpp"
#endif

static lg::log_domain log_config("config");
#define ERR_CONFIG LOG_STREAM(err, log_config)
#define WRN_CONFIG LOG_STREAM(warn, log_config)
#define LOG_CONFIG LOG_STREAM(info, log_config)

#define ERR_GENERAL LOG_STREAM(err, lg::general())
#define LOG_GENERAL LOG_STREAM(info, lg::general())
#define WRN_GENERAL LOG_STREAM(warn, lg::general())
#define DBG_GENERAL LOG_STREAM(debug, lg::general())

#define LOG_TEST FORCE_LOG_TO(lg::general(), log_config)

static lg::log_domain log_mp_create("mp/create");
#define DBG_MP LOG_STREAM(debug, log_mp_create)

static lg::log_domain log_network("network");
#define ERR_NET LOG_STREAM(err, log_network)

static lg::log_domain log_enginerefac("enginerefac");
#define LOG_RG LOG_STREAM(info, log_enginerefac)

namespace bp = boost::process;

game_launcher::game_launcher(const commandline_options& cmdline_opts)
	: cmdline_opts_(cmdline_opts)
	, font_manager_()
	, image_manager_()
	, main_event_context_()
	, hotkey_manager_()
	, music_thinker_()
	, music_muter_()
	, test_scenarios_{"test"}
	, screenshot_map_()
	, screenshot_filename_()
	, state_()
	, play_replay_(false)
	, multiplayer_server_()
	, jump_to_multiplayer_(false)
	, jump_to_campaign_{}
	, jump_to_editor_(false)
	, load_data_()
{
	bool no_music = false;
	bool no_sound = false;

	if(cmdline_opts_.core_id) {
		prefs::get().set_core(*cmdline_opts_.core_id);
	}
	if(cmdline_opts_.campaign) {
		jump_to_campaign_.jump = true;
		jump_to_campaign_.campaign_id = *cmdline_opts_.campaign;
		PLAIN_LOG << "selected campaign id: [" << jump_to_campaign_.campaign_id << "]";

		if(cmdline_opts_.campaign_difficulty) {
			jump_to_campaign_.difficulty = *cmdline_opts_.campaign_difficulty;
			PLAIN_LOG << "selected difficulty: [" << jump_to_campaign_.difficulty << "]";
		} else {
			jump_to_campaign_.difficulty = -1; // let the user choose the difficulty
		}

		if(cmdline_opts_.campaign_scenario) {
			jump_to_campaign_.scenario_id = *cmdline_opts_.campaign_scenario;
			PLAIN_LOG << "selected scenario id: [" << jump_to_campaign_.scenario_id << "]";
		}

		if(cmdline_opts_.campaign_skip_story) {
			jump_to_campaign_.skip_story = true;
		}
	}
	if(cmdline_opts_.clock)
		gui2::dialogs::show_debug_clock_button = true;
	if(cmdline_opts_.debug) {
		game_config::set_debug(true);
		game_config::mp_debug = true;
	}
#ifdef DEBUG_WINDOW_LAYOUT_GRAPHS
	if(cmdline_opts_.debug_dot_domain)
		gui2::debug_layout_graph::set_domain(*cmdline_opts_.debug_dot_domain);
	if(cmdline_opts_.debug_dot_level)
		gui2::debug_layout_graph::set_level(*cmdline_opts_.debug_dot_level);
#endif
	if(cmdline_opts_.editor) {
		jump_to_editor_ = true;
		if(!cmdline_opts_.editor->empty()) {
			load_data_ = savegame::load_game_metadata{
				savegame::save_index_class::default_saves_dir(), *cmdline_opts_.editor};
		}
	}
	if(cmdline_opts_.fps)
		prefs::get().set_show_fps(true);
	if(cmdline_opts_.fullscreen)
		prefs::get().set_fullscreen(true);
	if(cmdline_opts_.load)
		load_data_ = savegame::load_game_metadata{
			savegame::save_index_class::default_saves_dir(), *cmdline_opts_.load};
	if(cmdline_opts_.max_fps) {
		prefs::get().set_refresh_rate(std::clamp(*cmdline_opts_.max_fps, 1, 1000));
	}
	if(cmdline_opts_.nogui || cmdline_opts_.headless_unit_test) {
		no_sound = true;
		prefs::disable_preferences_save();
	}
	if(cmdline_opts_.new_widgets)
		gui2::new_widgets = true;
	if(cmdline_opts_.nomusic)
		no_music = true;
	if(cmdline_opts_.nosound)
		no_sound = true;
	if(cmdline_opts_.resolution) {
		const int xres = std::get<0>(*cmdline_opts_.resolution);
		const int yres = std::get<1>(*cmdline_opts_.resolution);
		if(xres > 0 && yres > 0) {
			prefs::get().set_resolution(point(xres, yres));
			prefs::get().set_maximized(false);
		}
	}
	if(cmdline_opts_.screenshot) {
		// TODO it could be simplified to use cmdline_opts_ directly if there is no other way to enter screenshot mode
		screenshot_map_ = *cmdline_opts_.screenshot_map_file;
		screenshot_filename_ = *cmdline_opts_.screenshot_output_file;
		no_sound = true;
		prefs::disable_preferences_save();
	}
	if (cmdline_opts_.server){
		jump_to_multiplayer_ = true;
		// Do we have any server specified ?
		if(!cmdline_opts_.server->empty()) {
			multiplayer_server_ = *cmdline_opts_.server;
		} else {
			// Pick the first server in config
			if(game_config::server_list.size() > 0) {
				multiplayer_server_ = prefs::get().network_host();
			} else {
				multiplayer_server_ = "";
			}
		}
		if(cmdline_opts_.username) {
			prefs::disable_preferences_save();
			prefs::get().set_login(*cmdline_opts_.username);
			if(cmdline_opts_.password) {
				prefs::disable_preferences_save();
				prefs::get().set_password(*cmdline_opts.server, *cmdline_opts.username, *cmdline_opts_.password);
			}
		}
	}
	if(cmdline_opts_.test) {
		if(!cmdline_opts_.test->empty()) {
			test_scenarios_ = {*cmdline_opts_.test};
		}
	}
	if(!cmdline_opts_.unit_test.empty()) {
		test_scenarios_ = cmdline_opts_.unit_test;
	}
	if(cmdline_opts_.windowed)
		prefs::get().set_fullscreen(false);
	if(cmdline_opts_.with_replay && load_data_)
		load_data_->show_replay = true;
	if(cmdline_opts_.translation_percent)
		set_min_translation_percent(*cmdline_opts_.translation_percent);

	if(!cmdline_opts.nobanner) {
		PLAIN_LOG
			<< "\nGame data:    " << game_config::path
			<< "\nUser data:    " << filesystem::get_user_data_dir()
			<< "\nCache:        " << filesystem::get_cache_dir()
			<< "\n";
	}

	// disable sound in nosound mode, or when sound engine failed to initialize
	if(no_sound || ((prefs::get().sound() || prefs::get().music_on() ||
	                  prefs::get().turn_bell() || prefs::get().ui_sound_on()) &&
	                 !sound::init_sound())) {
		prefs::get().set_sound(false);
		prefs::get().set_music(false);
		prefs::get().set_turn_bell(false);
		prefs::get().set_ui_sound(false);
	} else if(no_music) { // else disable the music in nomusic mode
		prefs::get().set_music(false);
	}
}

bool game_launcher::init_language()
{
	if(!::load_language_list()) {
		return false;
	}

	language_def locale;
	if(cmdline_opts_.language) {
		std::vector<language_def> langs = get_languages(true);
		for(const language_def& def : langs) {
			if(def.localename == *cmdline_opts_.language) {
				locale = def;
				break;
			}
		}
		if(locale.localename.empty()) {
			PLAIN_LOG << "Language symbol '" << *cmdline_opts_.language << "' not found.";
			return false;
		}
	} else {
		locale = get_locale();
	}
	::set_language(locale);

	return true;
}

bool game_launcher::init_video()
{
	// Handle special commandline launch flags
	if(cmdline_opts_.nogui
		|| cmdline_opts_.screenshot
		|| cmdline_opts_.headless_unit_test
		|| cmdline_opts_.render_image)
	{
		if(!(cmdline_opts_.multiplayer
			|| cmdline_opts_.screenshot
			|| cmdline_opts_.plugin_file
			|| cmdline_opts_.headless_unit_test
			|| cmdline_opts_.render_image))
		{
			PLAIN_LOG << "--nogui flag is only valid with --multiplayer or --screenshot or --plugin flags";
			return false;
		}
		if(cmdline_opts_.screenshot) {
			// Screenshots require a rendering context, and thus a window,
			// so we create one but hidden.
			video::init(video::fake::hide_window);
		} else {
			// Other functions don't require a window at all.
			video::init(video::fake::no_window);
		}
		return true;
	}

	// Initialize video subsystem, and create a new window.
	video::init();

	// Set window title and icon
	video::set_window_title(game_config::get_default_title_string());

#if !(defined(__APPLE__))
	surface icon(image::get_surface(image::locator{"icons/icon-game.png"}, image::UNSCALED));
	if(icon != nullptr) {
		video::set_window_icon(icon);
	}
#endif
	return true;
}

bool game_launcher::init_lua_script()
{
	bool error = false;

	if(!cmdline_opts_.nobanner) {
		STREAMING_LOG << "Checking lua scripts... ";
	}

	if(cmdline_opts_.script_unsafe_mode) {
		// load the "package" package, so that scripts can get what packages they want
		plugins_manager::get()->get_kernel_base()->load_package();
	}

	if(cmdline_opts_.plugin_file) {
		std::string filename = *cmdline_opts_.plugin_file;

		PLAIN_LOG << "Loading a plugin file'" << filename << "'...";

		filesystem::scoped_istream sf = filesystem::istream_file(filename);

		try {
			if(sf->fail()) {
				throw std::runtime_error("failed to open plugin file");
			}

			/* Cancel all "jumps" to editor / campaign / multiplayer */
			jump_to_multiplayer_ = false;
			jump_to_editor_ = false;
			jump_to_campaign_.jump = false;

			std::string full_plugin((std::istreambuf_iterator<char>(*sf)), std::istreambuf_iterator<char>());

			plugins_manager& pm = *plugins_manager::get();

			std::size_t i = pm.add_plugin(filename, full_plugin);

			for(std::size_t j = 0; j < pm.size(); ++j) {
				PLAIN_LOG << j << ": " << pm.get_name(j) << " -- " << pm.get_detailed_status(j);
			}

			PLAIN_LOG << "Starting a plugin...";
			pm.start_plugin(i);

			for(std::size_t j = 0; j < pm.size(); ++j) {
				PLAIN_LOG << j << ": " << pm.get_name(j) << " -- " << pm.get_detailed_status(j);
			}

			plugins_context pc("init");

			for(std::size_t repeat = 0; repeat < 5; ++repeat) {
				PLAIN_LOG << "Playing a slice...";
				pc.play_slice();

				for(std::size_t j = 0; j < pm.size(); ++j) {
					PLAIN_LOG << j << ": " << pm.get_name(j) << " -- " << pm.get_detailed_status(j);
				}
			}

			return true;
		} catch(const std::exception& e) {
			gui2::show_error_message(std::string("When loading a plugin, error:\n") + e.what());
			error = true;
		}
	}

	if(!error && !cmdline_opts_.nobanner) {
		PLAIN_LOG << "ok";
	}

	return !error;
}

void game_launcher::set_test(const std::string& id)
{
	state_.clear();
	state_.classification().type = campaign_type::type::test;
	state_.classification().campaign_define = "TEST";
	state_.classification().era_id = "era_default";

	state_.set_carryover_sides_start(config{"next_scenario", id});
}

bool game_launcher::play_test()
{
	// This first_time variable was added in 70f3c80a3e2 so that using the GUI
	// menu to load a game works. That seems to have edge-cases, for example if
	// you try to load a game a second time then Wesnoth exits.
	static bool first_time = true;

	if(!cmdline_opts_.test) {
		return true;
	}

	if(!first_time) {
		return false;
	}

	first_time = false;

	if(test_scenarios_.size() == 0) {
		// shouldn't happen, as test_scenarios_ is initialised to {"test"}
		PLAIN_LOG << "Error in the test handling code";
		return false;
	}

	if(test_scenarios_.size() > 1) {
		PLAIN_LOG << "You can't run more than one unit test in interactive mode";
	}

	set_test(test_scenarios_.at(0));

	game_config_manager::get()->load_game_config_for_game(state_.classification(), state_.get_scenario_id());

	try {
		campaign_controller ccontroller(state_);
		ccontroller.play_game();
	} catch(savegame::load_game_exception& e) {
		load_data_ = std::move(e.data_);
		return true;
	}

	return false;
}

/**
 * Runs unit tests specified on the command line.
 *
 * If multiple unit tests were specified, then this will stop at the first test
 * which returns a non-zero status.
 */
// Same as play_test except that we return the results of play_game.
// \todo "same ... except" ... and many other changes, such as testing the replay
game_launcher::unit_test_result game_launcher::unit_test()
{
	// There's no copy of play_test's first_time variable. That seems to be for handling
	// the player loading a game via the GUI, which makes no sense in a non-interactive test.
	if(cmdline_opts_.unit_test.empty()) {
		return unit_test_result::TEST_FAIL;
	}

	auto ret = unit_test_result::TEST_FAIL; // will only be returned if no test is run
	for(const auto& scenario : test_scenarios_) {
		set_test(scenario);
		ret = single_unit_test();
		const char* describe_result;
		switch(ret) {
		case unit_test_result::TEST_PASS:
			describe_result = "PASS TEST";
			break;
		case unit_test_result::TEST_FAIL_LOADING_REPLAY:
			describe_result = "FAIL TEST (INVALID REPLAY)";
			break;
		case unit_test_result::TEST_FAIL_PLAYING_REPLAY:
			describe_result = "FAIL TEST (ERRORED REPLAY)";
			break;
		case unit_test_result::TEST_FAIL_WML_EXCEPTION:
			describe_result = "FAIL TEST (WML EXCEPTION)";
			break;
		case unit_test_result::TEST_FAIL_BY_DEFEAT:
			describe_result = "FAIL TEST (DEFEAT)";
			break;
		case unit_test_result::TEST_PASS_BY_VICTORY:
			describe_result = "PASS TEST (VICTORY)";
			break;
		case unit_test_result::BROKE_STRICT_TEST_PASS:
			describe_result = "BROKE STRICT (PASS)";
			break;
		case unit_test_result::BROKE_STRICT_TEST_FAIL:
			describe_result = "BROKE STRICT (FAIL)";
			break;
		case unit_test_result::BROKE_STRICT_TEST_FAIL_BY_DEFEAT:
			describe_result = "BROKE STRICT (DEFEAT)";
			break;
		case unit_test_result::BROKE_STRICT_TEST_PASS_BY_VICTORY:
			describe_result = "BROKE STRICT (VICTORY)";
			break;
		default:
			describe_result = "FAIL TEST (UNKNOWN)";
			break;
		}

		PLAIN_LOG << describe_result << " (" << int(ret) << "): " << scenario;
		if(ret != unit_test_result::TEST_PASS) {
			break;
		}
	}

	return ret;
}

game_launcher::unit_test_result game_launcher::single_unit_test()
{
	game_config_manager::get()->load_game_config_for_game(state_.classification(), state_.get_scenario_id());

	level_result::type game_res = level_result::type::fail;
	try {
		campaign_controller ccontroller(state_, true);
		game_res = ccontroller.play_game();
		if(game_res == level_result::type::fail) {
			if(lg::broke_strict()) {
				return unit_test_result::BROKE_STRICT_TEST_FAIL;
			} else {
				return unit_test_result::TEST_FAIL;
			}
		}
	} catch(const wml_exception& e) {
		PLAIN_LOG << "Caught WML Exception:" << e.dev_message;
		return unit_test_result::TEST_FAIL_WML_EXCEPTION;
	}

	savegame::clean_saves(state_.classification().label);

	if(cmdline_opts_.noreplaycheck) {
		return pass_victory_or_defeat(game_res);
	}

	savegame::replay_savegame save(state_, compression::format::none);
	save.save_game_automatic(false, "unit_test_replay");

	load_data_ = savegame::load_game_metadata{
		savegame::save_index_class::default_saves_dir(), save.filename(), "", true, true, false};

	if(!load_game()) {
		PLAIN_LOG << "Failed to load the replay!";
		return unit_test_result::TEST_FAIL_LOADING_REPLAY; // failed to load replay
	}

	try {
		const bool was_strict_broken = lg::broke_strict();
		campaign_controller ccontroller(state_, true);
		ccontroller.play_replay();
		if(!was_strict_broken && lg::broke_strict()) {
			PLAIN_LOG << "Observed failure on replay";
			return unit_test_result::TEST_FAIL_PLAYING_REPLAY;
		}
	} catch(const wml_exception& e) {
		PLAIN_LOG << "WML Exception while playing replay: " << e.dev_message;
		return unit_test_result::TEST_FAIL_PLAYING_REPLAY;
	}

	return pass_victory_or_defeat(game_res);
}

game_launcher::unit_test_result game_launcher::pass_victory_or_defeat(level_result::type res)
{
	if(res == level_result::type::defeat) {
		if(lg::broke_strict()) {
			return unit_test_result::BROKE_STRICT_TEST_FAIL_BY_DEFEAT;
		} else {
			return unit_test_result::TEST_FAIL_BY_DEFEAT;
		}
	} else if(res == level_result::type::victory) {
		if(lg::broke_strict()) {
			return unit_test_result::BROKE_STRICT_TEST_PASS_BY_VICTORY;
		} else {
			return unit_test_result::TEST_PASS_BY_VICTORY;
		}
	}

	if(lg::broke_strict()) {
		return unit_test_result::BROKE_STRICT_TEST_PASS;
	} else {
		return unit_test_result::TEST_PASS;
	}
}

bool game_launcher::play_screenshot_mode()
{
	if(!cmdline_opts_.screenshot) {
		return true;
	}

	game_config_manager::get()->load_game_config_for_editor();

	::init_textdomains(game_config_manager::get()->game_config());

	editor::start(false, screenshot_map_, true, screenshot_filename_);
	return false;
}

bool game_launcher::play_render_image_mode()
{
	if(!cmdline_opts_.render_image) {
		return true;
	}

	state_.classification().type = campaign_type::type::multiplayer;
	DBG_GENERAL << "Current campaign type: " << campaign_type::get_string(state_.classification().type);

	try {
		game_config_manager::get()->load_game_config_for_game(state_.classification(), state_.get_scenario_id());
	} catch(const config::error& e) {
		PLAIN_LOG << "Error loading game config: " << e.what();
		return false;
	}

	// A default output filename
	std::string outfile = "wesnoth_image.png";

	// If a output path was given as an argument, use that instead
	if(cmdline_opts_.render_image_dst) {
		outfile = *cmdline_opts_.render_image_dst;
	}

	if(image::save_image(*cmdline_opts_.render_image, outfile) != image::save_result::success) {
		exit(1);
	}

	return false;
}

bool game_launcher::has_load_data() const
{
	return load_data_.has_value();
}

bool game_launcher::load_game()
{
	assert(game_config_manager::get());

	DBG_GENERAL << "Current campaign type: " << campaign_type::get_string(state_.classification().type);

	savegame::loadgame load(savegame::save_index_class::default_saves_dir(), state_);
	if(load_data_) {
		load.data() = std::move(*load_data_);
		clear_loaded_game();
	}

	try {
		if(!load.load_game()) {
			return false;
		}

		load.set_gamestate();
		try {
			game_config_manager::get()->load_game_config_for_game(state_.classification(), state_.get_scenario_id());
		} catch(const config::error&) {
			return false;
		}

	} catch(const config::error& e) {
		if(e.message.empty()) {
			gui2::show_error_message(_("The file you have tried to load is corrupt"));
		} else {
			gui2::show_error_message(_("The file you have tried to load is corrupt: '") + e.message + '\'');
		}

		return false;
	} catch(const wml_exception& e) {
		e.show();
		return false;
	} catch(const filesystem::io_exception& e) {
		if(e.message.empty()) {
			gui2::show_error_message(_("File I/O Error while reading the game"));
		} else {
			gui2::show_error_message(_("File I/O Error while reading the game: '") + e.message + '\'');
		}

		return false;
	} catch(const game::error& e) {
		if(e.message.empty()) {
			gui2::show_error_message(_("The file you have tried to load is corrupt"));
		} else {
			gui2::show_error_message(_("The file you have tried to load is corrupt: '") + e.message + '\'');
		}

		return false;
	}

	play_replay_ = load.data().show_replay;
	LOG_CONFIG << "is middle game savefile: " << (state_.is_mid_game_save() ? "yes" : "no");
	LOG_CONFIG << "show replay: " << (play_replay_ ? "yes" : "no");
	// in case load.data().show_replay && state_.is_start_of_scenario
	// there won't be any turns to replay, but the
	// user gets to watch the intro sequence again ...

	if(!state_.is_start_of_scenario() && load.data().show_replay) {
		state_.statistics().clear_current_scenario();
	}

	if(state_.classification().is_multiplayer()) {
		state_.unify_controllers();
	}

	if(load.data().cancel_orders) {
		state_.cancel_orders();
	}

	return true;
}

bool game_launcher::new_campaign()
{
	state_.clear();
	state_.classification().type = campaign_type::type::scenario;
	play_replay_ = false;

	return sp::select_campaign(state_, jump_to_campaign_);
}

std::string game_launcher::jump_to_campaign_id() const
{
	return jump_to_campaign_.campaign_id;
}

bool game_launcher::play_campaign() {
	jump_to_campaign_.jump = false;
	if(new_campaign()) {
		state_.set_skip_story(jump_to_campaign_.skip_story);
		launch_game(reload_mode::NO_RELOAD_DATA);
		return true;
	}
	return false;
}

bool game_launcher::goto_campaign()
{
	if(jump_to_campaign_.jump) {
		return play_campaign();
	}

	return true;
}

bool game_launcher::goto_multiplayer()
{
	if(!jump_to_multiplayer_) {
		return true;
	}

	jump_to_multiplayer_ = false;
	return play_multiplayer(mp_mode::CONNECT);
}

bool game_launcher::goto_editor()
{
	if(jump_to_editor_) {
		jump_to_editor_ = false;

		const std::string to_open = load_data_ ? filesystem::normalize_path(load_data_->filename) : "";
		clear_loaded_game();

		if(start_editor(to_open) == editor::EXIT_QUIT_TO_DESKTOP) {
			return false;
		}
	}

	return true;
}

void game_launcher::start_wesnothd()
{
	std::string wesnothd_program = "";
	if(!prefs::get().get_mp_server_program_name().empty()) {
		wesnothd_program = prefs::get().get_mp_server_program_name();
	} else {
		wesnothd_program = filesystem::get_wesnothd_name();
	}

	std::string config = filesystem::get_user_data_dir() + "/lan_server.cfg";
	if (!filesystem::file_exists(config)) {
		// copy file if it isn't created yet
		filesystem::write_file(config, filesystem::read_file(filesystem::get_wml_location("lan_server.cfg").value()));
	}

	LOG_GENERAL << "Starting wesnothd";
	try
	{
#ifndef _WIN32
		bp::child c(wesnothd_program, "-c", config);
#else
		bp::child c(wesnothd_program, "-c", config, bp::windows::create_no_window);
#endif
		c.detach();
		// Give server a moment to start up
		using namespace std::chrono_literals;
		std::this_thread::sleep_for(50ms);
		return;
	}
	catch(const bp::process_error& e)
	{
		prefs::get().set_mp_server_program_name("");

		// Couldn't start server so throw error
		WRN_GENERAL << "Failed to start server " << wesnothd_program << ":\n" << e.what();
		throw game::mp_server_error("Starting MP server failed!");
	}
}

bool game_launcher::play_multiplayer(mp_mode mode)
{
	game_config::set_debug(game_config::mp_debug);
	try {
		if(mode == mp_mode::HOST) {
			try {
				start_wesnothd();
			} catch(const game::mp_server_error&) {
				prefs::get().show_wesnothd_server_search();

				try {
					start_wesnothd();
				} catch(const game::mp_server_error&) {
					return false;
				}
			}
		}

		// If a server address wasn't specified, prompt for it now.
		if(mode != mp_mode::LOCAL && multiplayer_server_.empty()) {
			if(!gui2::dialogs::mp_connect::execute()) {
				return false;
			}

			// The prompt saves its input to preferences.
			multiplayer_server_ = prefs::get().network_host();

			if(multiplayer_server_ != prefs::get().builtin_servers_list().front().address) {
				prefs::get().set_network_host(multiplayer_server_);
			}
		}

		// create_engine already calls game_config_manager::get()->load_config but maybe its better to have MULTIPLAYER
		// defined while we are in the lobby.
		game_config_manager::get()->load_game_config_for_create(true);

		events::discard_input(); // prevent the "keylogger" effect
		cursor::set(cursor::NORMAL);

		if(mode == mp_mode::LOCAL) {
			mp::start_local_game();
		} else {
			mp::start_client(multiplayer_server_);
			multiplayer_server_.clear();
		}

	} catch(const wesnothd_rejected_client_error& e) {
		gui2::show_error_message(e.message);
	} catch(const game::mp_server_error& e) {
		gui2::show_error_message(_("Error while starting server: ") + e.message);
	} catch(const game::load_game_failed& e) {
		gui2::show_error_message(_("The game could not be loaded: ") + e.message);
	} catch(const game::game_error& e) {
		gui2::show_error_message(_("Error while playing the game: ") + e.message);
	} catch(const mapgen_exception& e) {
		gui2::show_error_message(_("Map generator error: ") + e.message);
	} catch(const wesnothd_error& e) {
		if(!e.message.empty()) {
			ERR_NET << "caught network error: " << e.message;

			std::string user_msg;
			auto conn_err = dynamic_cast<const wesnothd_connection_error*>(&e);

			if(conn_err) {
				// The wesnothd_connection_error subclass is only thrown with messages
				// from boost::system::error_code which we can't translate ourselves.
				// It's also the originator of the infamous EOF error that happens when
				// the server dies. <https://github.com/wesnoth/wesnoth/issues/3005>. It
				// will provide a translated string instead of that when it happens.
				user_msg = !conn_err->user_message.empty()
					? conn_err->user_message
					: _("Connection failed: ") + e.message;
			} else {
				// This will be a message from the server itself, which we can
				// probably translate.
				user_msg = translation::gettext(e.message.c_str());
			}

			gui2::show_error_message(user_msg);
		} else {
			ERR_NET << "caught network error";
		}
	} catch(const config::error& e) {
		if(!e.message.empty()) {
			ERR_CONFIG << "caught config::error: " << e.message;
			gui2::show_transient_message("", e.message);
		} else {
			ERR_CONFIG << "caught config::error";
		}
	} catch(const incorrect_map_format_error& e) {
		gui2::show_error_message(_("The game map could not be loaded: ") + e.message);
	} catch(savegame::load_game_exception& e) {
		load_data_ = std::move(e.data_);
		// this will make it so next time through the title screen loop, this game is loaded
	} catch(const wml_exception& e) {
		e.show();
	} catch(const game::error& e) {
		PLAIN_LOG << "caught game::error...";
		gui2::show_error_message(_("Error: ") + e.message);
	}

	return true;
}

bool game_launcher::play_multiplayer_commandline()
{
	if(!cmdline_opts_.multiplayer) {
		return true;
	}

	DBG_MP << "starting multiplayer game from the commandline";

	game_config_manager::get()->load_game_config_for_create(true);

	events::discard_input(); // prevent the "keylogger" effect
	cursor::set(cursor::NORMAL);

	try {
		mp::start_local_game_commandline(cmdline_opts_);
	} catch(savegame::load_game_exception& e) {
		load_data_ = std::move(e.data_);
		return true;
	}

	return false;
}

bool game_launcher::change_language()
{
	if(!gui2::dialogs::language_selection::execute()) {
		return false;
	}

	if(!(cmdline_opts_.nogui || cmdline_opts_.headless_unit_test)) {
		video::set_window_title(game_config::get_default_title_string());
	}

	t_string::reset_translations();
	image::flush_cache();
	sound::flush_cache();
	font::load_font_config();

	return true;
}

void game_launcher::launch_game(reload_mode reload)
{
	assert(!load_data_);
	if(play_replay_) {
		play_replay();
		return;
	}

	gui2::dialogs::loading_screen::display([this, reload]() {
		gui2::dialogs::loading_screen::progress(loading_stage::load_data);

		if(reload == reload_mode::RELOAD_DATA) {
			try {
				game_config_manager::get()->load_game_config_for_game(
					state_.classification(), state_.get_scenario_id());
			} catch(const config::error&) {
				return;
			}
		}
	});

	try {
		campaign_controller ccontroller(state_);
		ccontroller.play_game();
		ai::manager::singleton_ = nullptr;
	} catch(savegame::load_game_exception& e) {
		load_data_ = std::move(e.data_);
		// this will make it so next time through the title screen loop, this game is loaded
	} catch(const wml_exception& e) {
		e.show();
	} catch(const mapgen_exception& e) {
		gui2::show_error_message(_("Map generator error: ") + e.message);
	}
}

void game_launcher::play_replay()
{
	assert(!load_data_);
	try {
		campaign_controller ccontroller(state_);
		ccontroller.play_replay();
	} catch(savegame::load_game_exception& e) {
		load_data_ = std::move(e.data_);
		// this will make it so next time through the title screen loop, this game is loaded
	} catch(const wml_exception& e) {
		e.show();
	}
}

editor::EXIT_STATUS game_launcher::start_editor(const std::string& filename)
{
	editor::EXIT_STATUS res = editor::EXIT_STATUS::EXIT_NORMAL;
	while(true) {
		game_config_manager::get()->load_game_config_for_editor();

		::init_textdomains(game_config_manager::get()->game_config());

		res = editor::start(res != editor::EXIT_RELOAD_DATA, filename);

		if(res != editor::EXIT_RELOAD_DATA) {
			return res;
		}

		game_config_manager::get()->reload_changed_game_config();
	}

	return editor::EXIT_ERROR; // not supposed to happen
}

void game_launcher::clear_loaded_game()
{
	load_data_.reset();
}

game_launcher::~game_launcher()
{
	try {
		sound::close_sound();
		video::deinit();
	} catch(std::exception& e) {
		ERR_GENERAL << "Suppressing exception thrown during ~game_launcher: " << e.what();
	} catch(...) {
		ERR_GENERAL << "Suppressing exception " << utils::get_unknown_exception_type() << " thrown during ~game_launcher";
	}
}