game_launcher.cpp

Go to the documentation of this file.

/*
    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_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
 
#ifdef __APPLE__
 
//
// HACK: MacCompileStuff is currently on 1.86, so it could use the v2 API,
// but we need to update the libs manually to link against boost::process.
//
// -- vultraz, 2025-05-12
//
#if BOOST_VERSION > 108600
#error MacCompileStuff has been updated. Remove this block and the accompanying __APPLE__ checks below.
#endif
#include <boost/process/v1/child.hpp>
 
#elif BOOST_VERSION >= 108600
 
// boost::asio (via boost::process) complains about winsock.h otherwise
#ifdef _WIN32
#define WIN32_LEAN_AND_MEAN
#endif
#include <boost/process/v2/process.hpp>
 
#else
 
// process::v1 only. The v1 folders do not exist until 1.86
#ifdef _WIN32
#include <boost/process/windows.hpp>
#endif
#include <boost/process/child.hpp>
 
#endif
 
#include <algorithm> // for copy, max, min, stable_sort
#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)
 
game_launcher::game_launcher(const commandline_options& cmdline_opts)
    : cmdline_opts_(cmdline_opts)
    , config_manager_(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_()
    , 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_ = 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) {
#ifdef __cpp_aggregate_paren_init
        load_data_.emplace(
            savegame::save_index_class::default_saves_dir(), *cmdline_opts_.load);
#else
        load_data_ = savegame::load_game_metadata{
            savegame::save_index_class::default_saves_dir(), *cmdline_opts_.load};
#endif
        try {
            load_data_->read_file();
        } catch(const game::load_game_failed&) {
            load_data_.reset();
        }
    }
    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_ = utils::nullopt;
            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));
 
    config_manager_.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()
{
    config_manager_.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");
 
#ifdef __cpp_aggregate_paren_init
    load_data_.emplace(
        savegame::save_index_class::default_saves_dir(), save.filename(), "", true, true, false);
#else
    load_data_ = savegame::load_game_metadata{
        savegame::save_index_class::default_saves_dir(), save.filename(), "", true, true, false};
#endif
    load_data_->read_file();
 
    if(!load_prepared_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;
    }
 
    config_manager_.load_game_config_for_editor();
 
    ::init_textdomains(config_manager_.game_config());
 
    editor::EXIT_STATUS res = editor::start(false, screenshot_map_, true, screenshot_filename_);
    if (res != editor::EXIT_NORMAL) {
        PLAIN_LOG << "Error while taking screenshot of map: " << screenshot_map_;
    }
    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 {
        config_manager_.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();
}
 
savegame::load_game_metadata game_launcher::extract_load_data()
{
    return std::exchange(load_data_, utils::nullopt).value();
}
 
bool game_launcher::load_game_prompt()
{
    DBG_GENERAL << "Current campaign type: " << campaign_type::get_string(state_.classification().type);
    assert(!load_data_);
 
    // FIXME: evaluate which of these damn catch blocks are still necessary
    try {
        load_data_ = savegame::load_interactive();
 
    } 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;
    }
 
    // If the player canceled loading, we won't have any load data at this point
    return has_load_data();
}
 
bool game_launcher::load_prepared_game()
{
    auto load_data = extract_load_data();
    savegame::set_gamestate(state_, load_data);
 
    play_replay_ = load_data.show_replay;
 
    // in case show_replay && is_start_of_scenario
    // there won't be any turns to replay, but the
    // user gets to watch the intro sequence again ...
    if(load_data.show_replay && !state_.is_start_of_scenario()) {
        state_.statistics().clear_current_scenario();
    }
 
    if(load_data.cancel_orders) {
        state_.cancel_orders();
    }
 
    try {
        config_manager_.load_game_config_for_game(state_.classification(), state_.get_scenario_id());
    } catch(const config::error&) {
        return false;
    }
 
    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_) {
        // If no filename was specified, this will be an empty string.
        const std::string to_open = std::exchange(jump_to_editor_, utils::nullopt).value();
 
        if(start_editor(filesystem::normalize_path(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
    {
#if !defined(__APPLE__) && BOOST_VERSION >= 108600
        boost::asio::io_context io_context;
        auto c = boost::process::v2::process{io_context, wesnothd_program, { "-c", config }};
#else
#ifndef _WIN32
        boost::process::child c(wesnothd_program, "-c", config);
#else
        boost::process::child c(wesnothd_program, "-c", config, boost::process::windows::create_no_window);
#endif
#endif
        c.detach();
        // Give server a moment to start up
        using namespace std::chrono_literals;
        std::this_thread::sleep_for(50ms);
        return;
    }
#if defined(__APPLE__) || BOOST_VERSION < 108600
    catch(const boost::process::process_error& e)
#else
    catch(const std::exception& e)
#endif
    {
        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 config_manager_.load_config but maybe its better to have MULTIPLAYER
        // defined while we are in the lobby.
        config_manager_.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";
 
    config_manager_.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 {
                config_manager_.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) {
        config_manager_.load_game_config_for_editor();
 
        ::init_textdomains(config_manager_.game_config());
 
        res = editor::start(res != editor::EXIT_RELOAD_DATA, filename);
 
        if(res != editor::EXIT_RELOAD_DATA) {
            return res;
        }
 
        config_manager_.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";
    }
}