multiplayer.cpp

Go to the documentation of this file.

/*
    Copyright (C) 2007 - 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_initialization/multiplayer.hpp"
 
#include "build_info.hpp"
#include "commandline_options.hpp"
#include "connect_engine.hpp"
#include "events.hpp"
#include "formula/format_timespan.hpp"
#include "formula/string_utils.hpp"
#include "game_config_manager.hpp"
#include "game_initialization/playcampaign.hpp"
#include "gettext.hpp"
#include "gui/dialogs/loading_screen.hpp"
#include "gui/dialogs/message.hpp"
#include "gui/dialogs/multiplayer/lobby.hpp"
#include "gui/dialogs/multiplayer/mp_create_game.hpp"
#include "gui/dialogs/multiplayer/mp_join_game.hpp"
#include "gui/dialogs/multiplayer/mp_login.hpp"
#include "gui/dialogs/multiplayer/mp_staging.hpp"
#include "log.hpp"
#include "map_settings.hpp"
#include "multiplayer_error_codes.hpp"
#include "preferences/preferences.hpp"
#include "replay.hpp"
#include "resources.hpp"
#include "saved_game.hpp"
#include "sound.hpp"
#include "utils/parse_network_address.hpp"
#include "wesnothd_connection.hpp"
 
#include <functional>
#include "utils/optional_fwd.hpp"
#include <thread>
 
static lg::log_domain log_mp("mp/main");
#define DBG_MP LOG_STREAM(debug, log_mp)
#define LOG_MP LOG_STREAM(info, log_mp)
#define WRN_MP LOG_STREAM(warn, log_mp)
#define ERR_MP LOG_STREAM(err, log_mp)
 
namespace mp
{
namespace
{
/** Pointer to the current mp_manager instance. */
class mp_manager* manager = nullptr;
 
/** The main controller of the MP workflow. */
class mp_manager
{
public:
    // Declare this as a friend to allow direct access to enter_create_mode
    friend void mp::start_local_game();
    friend void mp::send_to_server(const config&);
    friend mp::lobby_info* mp::get_lobby_info();
 
    mp_manager(const utils::optional<std::string> host);
 
    ~mp_manager()
    {
        assert(manager);
        manager = nullptr;
 
        if(network_worker.joinable()) {
            stop = true;
            network_worker.join();
        }
    }
 
    /**
     * Enters the mp loop. It consists of four screens:
     *
     * Host POV:   LOBBY <---> CREATE GAME ---> STAGING -----> GAME BEGINS
     * Player POV: LOBBY <--------------------> JOIN GAME ---> GAME BEGINS
     */
    void run_lobby_loop();
 
    bool post_scenario_staging(ng::connect_engine& engine);
 
    bool post_scenario_wait(bool observe);
 
private:
    /** Represents the contents of the [join_lobby] response. */
    struct session_metadata
    {
        session_metadata() = default;
 
        session_metadata(const config& cfg)
            : is_moderator(cfg["is_moderator"].to_bool(false))
            , profile_url_prefix(cfg["profile_url_prefix"].str())
            , queues()
        {
            if(cfg.has_child("queues")) {
                for(const config& queue : cfg.mandatory_child("queues").child_range("queue")) {
                    queue_info info;
                    info.id = queue["id"].to_int();
                    info.display_name = queue["display_name"].str();
                    info.players_required = queue["players_required"].to_int();
                    info.current_players = utils::split_set(queue["current_players"].str());
                    info.required_addons = utils::split_set(queue["addons"].str());
                    queues.emplace_back(info);
                }
            }
        }
 
        /** Whether you are logged in as a server moderator. */
        bool is_moderator = false;
 
        /** The external URL prefix for player profiles (empty if the server doesn't have an attached database). */
        std::string profile_url_prefix;
 
        /** The list of server-side queues */
        std::vector<queue_info> queues;
    };
 
    /** Opens a new server connection and prompts the client for login credentials, if necessary. */
    std::unique_ptr<wesnothd_connection> open_connection(const std::string& host);
 
    /** Opens the MP lobby. */
    bool enter_lobby_mode();
 
    /**
     * Opens the MP Create screen for hosts to configure a new game.
     */
    void enter_create_mode(utils::optional<config> preset = utils::nullopt, int queue_id = 0);
 
    /** Opens the MP Staging screen for hosts to wait for players. */
    void enter_staging_mode(queue_type::type queue_type, int queue_id = 0);
 
    /** Opens the MP Join Game screen for non-host players and observers. */
    void enter_wait_mode(int game_id, bool observe);
 
    /** Worker thread to handle receiving and processing network data. */
    std::thread network_worker;
 
    /** Flag to signal the worker thread terminate. */
    std::atomic_bool stop;
 
    /** The connection to the server. */
    std::unique_ptr<wesnothd_connection> connection;
 
    /** The current session's info sent by the server on login. */
    session_metadata session_info;
 
    /** This single instance is reused for all games played during the current connection to the server. */
    saved_game state;
 
    mp::lobby_info lobby_info;
 
    std::list<mp::network_registrar::handler> process_handlers;
 
public:
    const session_metadata& get_session_info() const
    {
        return session_info;
    }
    session_metadata& get_session_info()
    {
        return session_info;
    }
 
    auto add_network_handler(const decltype(process_handlers)::value_type& func)
    {
        return [this, iter = process_handlers.insert(process_handlers.end(), func)]() { process_handlers.erase(iter); };
    }
};
 
mp_manager::mp_manager(const utils::optional<std::string> host)
    : network_worker()
    , stop(false)
    , connection(nullptr)
    , session_info()
    , state()
    , lobby_info()
    , process_handlers()
{
    state.classification().type = campaign_type::type::multiplayer;
 
    if(host) {
        gui2::dialogs::loading_screen::display([&]() {
            connection = open_connection(*host);
 
            // If for whatever reason our connection is null at this point (dismissing the password prompt, for
            // instance), treat it as a normal condition and exit. Any actual error conditions throw exceptions
            // which can be handled higher up the stack.
            if(connection == nullptr) {
                return;
            }
 
            gui2::dialogs::loading_screen::progress(loading_stage::download_lobby_data);
 
            config data;
 
            while(!stop) {
                connection->wait_and_receive_data(data);
 
                if(const auto error = data.optional_child("error")) {
                    throw wesnothd_error((*error)["message"]);
                }
 
                else if(data.has_child("gamelist")) {
                    this->lobby_info.process_gamelist(data);
                    break;
                }
 
                else if(const auto gamelist_diff = data.optional_child("gamelist_diff")) {
                    this->lobby_info.process_gamelist_diff(*gamelist_diff);
                }
 
                else {
                    // No special actions to take. Pass the data on to the network handlers.
                    for(const auto& handler : process_handlers) {
                        handler(data);
                    }
                }
            }
        });
    }
 
    // Avoid setting this until the connection has been fully established. open_connection may throw,
    // in which case we don't want to point to an object instance that has not properly connected.
    assert(!manager);
    manager = this;
}
 
std::unique_ptr<wesnothd_connection> mp_manager::open_connection(const std::string& host)
{
    DBG_MP << "opening connection";
 
    if(host.empty()) {
        return nullptr;
    }
 
    // shown_hosts is used to prevent the client being locked in a redirect loop.
    std::set<std::pair<std::string, std::string>> shown_hosts;
    auto addr = shown_hosts.end();
 
    try {
        std::tie(addr, std::ignore) = shown_hosts.insert(parse_network_address(host, "15000"));
    } catch(const std::runtime_error&) {
        throw wesnothd_error(_("Invalid address specified for multiplayer server"));
    }
 
    // Start stage
    gui2::dialogs::loading_screen::progress(loading_stage::connect_to_server);
 
    // Initializes the connection to the server.
    auto conn = std::make_unique<wesnothd_connection>(addr->first, addr->second);
 
    // First, spin until we get a handshake from the server.
    conn->wait_for_handshake();
 
    gui2::dialogs::loading_screen::progress(loading_stage::waiting);
 
    config data;
 
    // Then, log in and wait for the lobby/game join prompt.
    while(true) {
        data.clear();
        conn->wait_and_receive_data(data);
 
        if(const auto reject = data.optional_child("reject"); reject || data.has_attribute("version")) {
            std::string version;
 
            if(reject) {
                version = (*reject)["accepted_versions"].str();
            } else {
                // Backwards-compatibility "version" attribute
                version = data["version"].str();
            }
 
            utils::string_map i18n_symbols;
            i18n_symbols["required_version"] = version;
            i18n_symbols["your_version"] = game_config::wesnoth_version.str();
 
            const std::string errorstring = VGETTEXT("The server accepts versions ‘$required_version’, but you are using version ‘$your_version’", i18n_symbols);
            throw wesnothd_error(errorstring);
        }
 
        // Check for "redirect" messages
        if(const auto redirect = data.optional_child("redirect")) {
            auto redirect_host = (*redirect)["host"].str();
            auto redirect_port = (*redirect)["port"].str("15000");
 
            bool recorded_host;
            std::tie(std::ignore, recorded_host) = shown_hosts.emplace(redirect_host, redirect_port);
 
            if(!recorded_host) {
                throw wesnothd_error(_("Server-side redirect loop"));
            }
 
            gui2::dialogs::loading_screen::progress(loading_stage::redirect);
 
            // Open a new connection with the new host and port.
            conn.reset();
            conn = std::make_unique<wesnothd_connection>(redirect_host, redirect_port);
 
            // Wait for new handshake.
            conn->wait_for_handshake();
 
            gui2::dialogs::loading_screen::progress(loading_stage::waiting);
            continue;
        }
 
        if(data.has_child("version")) {
            std::string version = game_config::wesnoth_version;
            std::string channel = game_config::dist_channel_id();
            conn->send_data(config{"version", config{"version", version, "client_source", channel}});
        }
 
        if(const auto error = data.optional_child("error")) {
            throw wesnothd_rejected_client_error((*error)["message"].str());
        }
 
        // Continue if we did not get a direction to login
        if(!data.has_child("mustlogin")) {
            continue;
        }
 
        // Enter login loop
        while(true) {
            std::string login = prefs::get().login();
 
            conn->send_data(config{"login", config{"username", login}});
            conn->wait_and_receive_data(data);
 
            gui2::dialogs::loading_screen::progress(loading_stage::login_response);
 
            if(const auto warning = data.optional_child("warning")) {
                std::string warning_msg;
 
                if((*warning)["warning_code"] == MP_NAME_INACTIVE_WARNING) {
                    warning_msg = VGETTEXT("The nickname ‘$nick’ is inactive. "
                        "You cannot claim ownership of this nickname until you "
                        "activate your account via email or ask an "
                        "administrator to do it for you.", {{"nick", login}});
                } else {
                    warning_msg = (*warning)["message"].str();
                }
 
                warning_msg += "\n\n";
                warning_msg += _("Do you want to continue?");
 
                if(gui2::show_message(_("Warning"), warning_msg, gui2::dialogs::message::yes_no_buttons) != gui2::retval::OK) {
                    return nullptr;
                } else {
                    continue;
                }
            }
 
            auto error = data.optional_child("error");
 
            // ... and get us out of here if the server did not complain
            if(!error) break;
 
            do {
                std::string password = prefs::get().password(host, login);
 
                const bool fall_through = (*error)["force_confirmation"].to_bool()
                    ? (gui2::show_message(_("Confirm"), (*error)["message"], gui2::dialogs::message::ok_cancel_buttons) == gui2::retval::CANCEL)
                    : false;
 
                // If:
                // * the server asked for a password
                // * the password isn't empty
                // * the user didn't press Cancel
                // * the connection is secure or the client was started with the option to use insecure connections
                // send the password to the server
                // otherwise go directly to the username/password dialog
                if(!(*error)["password_request"].empty() && !password.empty() && !fall_through && (conn->using_tls() || game_config::allow_insecure)) {
                    // the possible cases here are that either:
                    // 1) TLS encryption is enabled, thus sending the plaintext password is still secure
                    // 2) TLS encryption is not enabled, in which case the server should not be requesting a password in the first place
                    // 3) This is being used for local testing/development, so using an insecure connection is enabled manually
 
                    // Once again send our request...
                    conn->send_data(config{"login", config{"username", login, "password", password}});
                    conn->wait_and_receive_data(data);
 
                    gui2::dialogs::loading_screen::progress(loading_stage::login_response);
 
                    error = data.optional_child("error");
 
                    // ... and get us out of here if the server is happy now
                    if(!error) break;
                }
 
                // Providing a password either was not attempted because we did not
                // have any or failed:
                // Now show a dialog that displays the error and allows to
                // enter a new user name and/or password
 
                std::string error_message;
                utils::string_map i18n_symbols;
                i18n_symbols["nick"] = login;
 
                const auto extra_data = error->optional_child("data");
                if(extra_data) {
                    using namespace std::chrono_literals;
                    i18n_symbols["duration"] = utils::format_timespan(chrono::parse_duration((*extra_data)["duration"], 0s));
                }
 
                const std::string ec = (*error)["error_code"];
 
                if(!(*error)["password_request"].empty() && !conn->using_tls() && !game_config::allow_insecure) {
                    error_message = _("The remote server requested a password while using an insecure connection.");
                } else if(ec == MP_MUST_LOGIN) {
                    error_message = _("You must login first.");
                } else if(ec == MP_NAME_TAKEN_ERROR) {
                    error_message = VGETTEXT("The nickname ‘$nick’ is already taken.", i18n_symbols);
                } else if(ec == MP_INVALID_CHARS_IN_NAME_ERROR) {
                    error_message = VGETTEXT("The nickname ‘$nick’ contains invalid "
                            "characters. Only alpha-numeric characters (one at minimum), underscores and "
                            "hyphens are allowed.", i18n_symbols);
                } else if(ec == MP_NAME_TOO_LONG_ERROR) {
                    error_message = VGETTEXT("The nickname ‘$nick’ is too long. Nicks must be 20 characters or less.", i18n_symbols);
                } else if(ec == MP_NAME_RESERVED_ERROR) {
                    error_message = VGETTEXT("The nickname ‘$nick’ is reserved and cannot be used by players.", i18n_symbols);
                } else if(ec == MP_NAME_UNREGISTERED_ERROR) {
                    error_message = VGETTEXT("The nickname ‘$nick’ is not registered on this server.", i18n_symbols)
                            + _(" This server disallows unregistered nicknames.");
                } else if(ec == MP_SERVER_IP_BAN_ERROR) {
                    if(extra_data) {
                        error_message = VGETTEXT("Your IP address is banned on this server for $duration|.", i18n_symbols);
                    } else {
                        error_message = _("Your IP address is banned on this server.");
                    }
                } else if(ec == MP_NAME_AUTH_BAN_USER_ERROR) {
                    if(extra_data) {
                        error_message = VGETTEXT("The nickname ‘$nick’ is banned on this server’s forums for $duration|.", i18n_symbols);
                    } else {
                        error_message = VGETTEXT("The nickname ‘$nick’ is banned on this server’s forums.", i18n_symbols);
                    }
                } else if(ec == MP_NAME_AUTH_BAN_IP_ERROR) {
                    if(extra_data) {
                        error_message = VGETTEXT("Your IP address is banned on this server’s forums for $duration|.", i18n_symbols);
                    } else {
                        error_message = _("Your IP address is banned on this server’s forums.");
                    }
                } else if(ec == MP_NAME_AUTH_BAN_EMAIL_ERROR) {
                    if(extra_data) {
                        error_message = VGETTEXT("The email address for the nickname ‘$nick’ is banned on this server’s forums for $duration|.", i18n_symbols);
                    } else {
                        error_message = VGETTEXT("The email address for the nickname ‘$nick’ is banned on this server’s forums.", i18n_symbols);
                    }
                } else if(ec == MP_PASSWORD_REQUEST) {
                    error_message = VGETTEXT("The nickname ‘$nick’ is registered on this server.", i18n_symbols);
                } else if(ec == MP_PASSWORD_REQUEST_FOR_LOGGED_IN_NAME) {
                    error_message = VGETTEXT("The nickname ‘$nick’ is registered on this server.", i18n_symbols)
                            + "\n\n" + _("WARNING: There is already a client using this nickname, "
                            "logging in will cause that client to be kicked!");
                } else if(ec == MP_INCORRECT_PASSWORD_ERROR) {
                    error_message = _("The password you provided was incorrect.");
                } else if(ec == MP_TOO_MANY_ATTEMPTS_ERROR) {
                    error_message = _("You have made too many login attempts.");
                } else if(ec == MP_HASHING_PASSWORD_FAILED) {
                    error_message = _("Password hashing failed.");
                } else {
                    error_message = (*error)["message"].str();
                }
 
                gui2::dialogs::mp_login dlg(host, error_message, !((*error)["password_request"].empty()));
 
                // Need to show the dialog from the main thread or it won't appear.
                events::call_in_main_thread([&dlg]() { dlg.show(); });
 
                switch(dlg.get_retval()) {
                    // Log in with password
                    case gui2::retval::OK:
                        break;
                    // Cancel
                    default:
                        return nullptr;
                }
 
            // If we have got a new username we have to start all over again
            } while(login == prefs::get().login());
 
            // Somewhat hacky...
            // If we broke out of the do-while loop above error is still going to be nullopt
            if(!error) break;
        } // end login loop
 
        if(const auto join_lobby = data.optional_child("join_lobby")) {
            // Note any session data sent with the response. This should be the only place session_info is set.
            session_info = { join_lobby.value() };
 
            // All done!
            break;
        }
    }
 
    return conn;
}
 
void mp_manager::run_lobby_loop()
{
    // This should only work if we have a connection. If we're in a local mode,
    // enter_create_mode should be accessed directly.
    if(!connection) {
        return;
    }
 
    // A return of false means a config reload was requested, so do that and then loop.
    while(!enter_lobby_mode()) {
        game_config_manager* gcm = game_config_manager::get();
        gcm->reload_changed_game_config();
        gcm->load_game_config_for_create(true); // NOTE: Using reload_changed_game_config only doesn't seem to work here
 
        lobby_info.refresh_installed_addons_cache();
 
        connection->send_data(config{"refresh_lobby"});
    }
}
 
bool mp_manager::enter_lobby_mode()
{
    DBG_MP << "entering lobby mode";
 
    // Connection should never be null in the lobby.
    assert(connection);
 
    // We use a loop here to allow returning to the lobby if you, say, cancel game creation.
    while(true) {
        if(auto cfg = game_config_manager::get()->game_config().optional_child("lobby_music")) {
            for(const config& i : cfg->child_range("music")) {
                sound::play_music_config(i);
            }
 
            sound::commit_music_changes();
        } else {
            sound::empty_playlist();
            sound::stop_music();
        }
 
        int dlg_retval = 0;
        int dlg_joined_game_id = 0;
        std::string preset_scenario = "";
        config server_preset;
        int queue_id = 0;
        {
            gui2::dialogs::mp_lobby dlg(lobby_info, *connection, dlg_joined_game_id);
            dlg.show();
            dlg_retval = dlg.get_retval();
            server_preset = dlg.queue_game_server_preset();
            queue_id = dlg.queue_id();
        }
 
        try {
            switch(dlg_retval) {
            case gui2::dialogs::mp_lobby::CREATE_PRESET:
                enter_create_mode(utils::make_optional(server_preset), queue_id);
                break;
            case gui2::dialogs::mp_lobby::CREATE:
                enter_create_mode();
                break;
            case gui2::dialogs::mp_lobby::JOIN:
                [[fallthrough]];
            case gui2::dialogs::mp_lobby::OBSERVE:
                enter_wait_mode(dlg_joined_game_id, dlg_retval == gui2::dialogs::mp_lobby::OBSERVE);
                break;
            case gui2::dialogs::mp_lobby::RELOAD_CONFIG:
                // Let this function's caller reload the config and re-call.
                return false;
            default:
                // Needed to handle the Quit signal and exit the loop
                return true;
            }
        } catch(const config::error& error) {
            if(!error.message.empty()) {
                gui2::show_error_message(error.message);
            }
 
            if(dlg_retval == gui2::dialogs::mp_lobby::CREATE_PRESET) {
                connection->send_data(config{"leave_server_queue", config{"queue_id", queue_id}});
            }
 
            // Update lobby content
            connection->send_data(config{"refresh_lobby"});
        }
    }
 
    return true;
}
 
void mp_manager::enter_create_mode(utils::optional<config> preset, int queue_id)
{
    DBG_MP << "entering create mode";
 
    // if this is using pre-determined settings and the settings came from the server, use those
    // else look for them locally
    if(preset) {
        gui2::dialogs::mp_create_game::quick_mp_setup(state, preset.value());
        enter_staging_mode(queue_id >= 0 ? queue_type::type::server_preset : queue_type::type::normal, queue_id);
    } else if(gui2::dialogs::mp_create_game::execute(state, connection == nullptr)) {
        enter_staging_mode(queue_type::type::normal);
    } else if(connection) {
        connection->send_data(config{"refresh_lobby"});
    }
}
 
void mp_manager::enter_staging_mode(queue_type::type queue_type, int queue_id)
{
    DBG_MP << "entering connect mode";
 
    std::unique_ptr<mp_game_metadata> metadata;
 
    // If we have a connection, set the appropriate info. No connection means we're in local game mode.
    if(connection) {
        metadata = std::make_unique<mp_game_metadata>(*connection);
        metadata->connected_players.insert(prefs::get().login());
        metadata->is_host = true;
        metadata->queue_type = queue_type::get_string(queue_type);
        metadata->queue_id = queue_id;
    }
 
    bool dlg_ok = false;
    {
        ng::connect_engine connect_engine(state, true, metadata.get());
        dlg_ok = gui2::dialogs::mp_staging::execute(connect_engine, connection.get());
    } // end connect_engine
 
    if(dlg_ok) {
        campaign_controller controller(state);
        controller.set_mp_info(metadata.get());
        controller.play_game();
    }
 
    if(connection) {
        connection->send_data(config{"leave_game"});
    }
}
 
void mp_manager::enter_wait_mode(int game_id, bool observe)
{
    DBG_MP << "entering wait mode";
 
    // The connection should never be null here, since one should never reach this screen in local game mode.
    assert(connection);
 
    mp_game_metadata metadata(*connection);
    metadata.is_host = false;
 
    if(const mp::game_info* gi = lobby_info.get_game_by_id(game_id)) {
        metadata.current_turn = gi->current_turn;
    }
 
    if(prefs::get().skip_mp_replay() || prefs::get().blindfold_replay()) {
        metadata.skip_replay = true;
        metadata.skip_replay_blindfolded = prefs::get().blindfold_replay();
    }
 
    bool dlg_ok = false;
    {
        gui2::dialogs::mp_join_game dlg(state, *connection, true, observe);
 
        if(!dlg.fetch_game_config()) {
            connection->send_data(config{"leave_game"});
            return;
        }
 
        dlg_ok = dlg.show();
    }
 
    if(dlg_ok) {
        campaign_controller controller(state);
        controller.set_mp_info(&metadata);
        controller.play_game();
    }
 
    connection->send_data(config{"leave_game"});
}
 
bool mp_manager::post_scenario_staging(ng::connect_engine& engine)
{
    return gui2::dialogs::mp_staging::execute(engine, connection.get());
}
 
bool mp_manager::post_scenario_wait(bool observe)
{
    gui2::dialogs::mp_join_game dlg(state, *connection, false, observe);
 
    if(!dlg.fetch_game_config()) {
        connection->send_data(config{"leave_game"});
        return false;
    }
 
    if(dlg.started()) {
        return true;
    }
 
    return dlg.show();
}
 
} // end anon namespace
 
/** Pubic entry points for the MP workflow */
 
void start_client(const std::string& host)
{
    DBG_MP << "starting client";
    mp_manager(host).run_lobby_loop();
}
 
void start_local_game()
{
    DBG_MP << "starting local game";
 
    prefs::get().set_message_private(false);
 
    mp_manager(utils::nullopt).enter_create_mode();
}
 
void start_local_game_commandline(const commandline_options& cmdline_opts)
{
    DBG_MP << "starting local MP game from commandline";
 
    const game_config_view& game_config = game_config_manager::get()->game_config();
 
    // The setup is done equivalently to lobby MP games using as much of existing
    // code as possible.  This means that some things are set up that are not
    // needed in commandline mode, but they are required by the functions called.
    prefs::get().set_message_private(false);
 
    DBG_MP << "entering create mode";
 
    // Set the default parameters
    saved_game state;
    state.classification().type = campaign_type::type::multiplayer;
 
    mp_game_settings& parameters = state.mp_settings();
 
    // Hardcoded default values
    state.classification().era_id = "era_default";
    parameters.name = "multiplayer_The_Freelands";
 
    // Default values for which at getter function exists
    parameters.num_turns = settings::get_turns("");
    parameters.village_gold = settings::get_village_gold("");
    parameters.village_support = settings::get_village_support("");
    parameters.xp_modifier = settings::get_xp_modifier("");
 
    // Do not use map settings if --ignore-map-settings commandline option is set
    if(cmdline_opts.multiplayer_ignore_map_settings) {
        DBG_MP << "ignoring map settings";
        parameters.use_map_settings = false;
    } else {
        parameters.use_map_settings = true;
    }
 
    // None of the other parameters need to be set, as their creation values above are good enough for CL mode.
    // In particular, we do not want to use the preferences values.
 
    state.classification().type = campaign_type::type::multiplayer;
 
    // [era] define.
    if(cmdline_opts.multiplayer_era) {
        state.classification().era_id = *cmdline_opts.multiplayer_era;
    }
 
    if(auto cfg_era = game_config.find_child("era", "id", state.classification().era_id)) {
        state.classification().era_define = cfg_era["define"].str();
    } else {
        PLAIN_LOG << "Could not find era '" << state.classification().era_id << "'";
        return;
    }
 
    // [multiplayer] define.
    if(cmdline_opts.multiplayer_scenario) {
        parameters.name = *cmdline_opts.multiplayer_scenario;
    }
 
    if(auto cfg_multiplayer = game_config.find_child("multiplayer", "id", parameters.name)) {
        state.classification().scenario_define = cfg_multiplayer["define"].str();
    } else {
        PLAIN_LOG << "Could not find [multiplayer] '" << parameters.name << "'";
        return;
    }
 
    state.set_carryover_sides_start(
        config {"next_scenario", parameters.name}
    );
 
    game_config_manager::get()->load_game_config_for_game(state.classification(), state.get_scenario_id());
 
    state.expand_random_scenario();
    state.expand_mp_events();
    state.expand_mp_options();
 
    // Should number of turns be determined from scenario data?
    if(parameters.use_map_settings && state.get_starting_point().has_attribute("turns")) {
        DBG_MP << "setting turns from scenario data: " << state.get_starting_point()["turns"];
        parameters.num_turns = state.get_starting_point()["turns"].to_int();
    }
 
    DBG_MP << "entering connect mode";
 
    {
        ng::connect_engine connect_engine(state, true, nullptr);
 
        // Update the parameters to reflect game start conditions
        connect_engine.start_game_commandline(cmdline_opts, game_config);
    }
 
    if(resources::recorder && cmdline_opts.multiplayer_label) {
        std::string label = *cmdline_opts.multiplayer_label;
        resources::recorder->add_log_data("ai_log","ai_label",label);
    }
 
    unsigned int repeat = (cmdline_opts.multiplayer_repeat) ? *cmdline_opts.multiplayer_repeat : 1;
    for(unsigned int i = 0; i < repeat; i++){
        saved_game state_copy(state);
        campaign_controller controller(state_copy);
        controller.play_game();
    }
}
 
bool goto_mp_staging(ng::connect_engine& engine)
{
    return manager && manager->post_scenario_staging(engine);
}
 
bool goto_mp_wait(bool observe)
{
    return manager && manager->post_scenario_wait(observe);
}
 
bool logged_in_as_moderator()
{
    return manager && manager->get_session_info().is_moderator;
}
 
std::string get_profile_link(int user_id)
{
    if(manager) {
        const std::string& prefix = manager->get_session_info().profile_url_prefix;
 
        if(!prefix.empty()) {
            return prefix + std::to_string(user_id);
        }
    }
 
    return "";
}
 
std::vector<queue_info>& get_server_queues()
{
    static std::vector<queue_info> queues;
    if(manager) {
        return manager->get_session_info().queues;
    }
    return queues;
}
 
void send_to_server(const config& data)
{
    if(manager && manager->connection) {
        manager->connection->send_data(data);
    }
}
 
network_registrar::network_registrar(const handler& func)
{
    if(manager /*&& manager->connection*/) {
        remove_handler = manager->add_network_handler(func);
    }
}
 
network_registrar::~network_registrar()
{
    if(remove_handler) {
        remove_handler();
    }
}
 
lobby_info* get_lobby_info()
{
    return manager ? &manager->lobby_info : nullptr;
}
 
} // end namespace mp