savegame.cpp

Go to the documentation of this file.

/*
   Copyright (C) 2003 - 2016 by Jörg Hinrichs, refactored from various
   places formerly created by David White <[email protected]>
   Part of the Battle for Wesnoth Project http://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 <boost/iostreams/filter/gzip.hpp>

#include "savegame.hpp"

#include "save_index.hpp"
#include "carryover.hpp"
#include "config_assign.hpp"
#include "format_time_summary.hpp"
#include "formatter.hpp"
#include "formula/string_utils.hpp"
#include "game_display.hpp"
#include "game_end_exceptions.hpp"
#include "game_preferences.hpp"
#include "gettext.hpp"
#include "gui/dialogs/game_load.hpp"
#include "gui/dialogs/game_save.hpp"
#include "gui/dialogs/message.hpp"
#include "gui/dialogs/campaign_difficulty.hpp"
#include "gui/dialogs/transient_message.hpp"
#include "gui/widgets/settings.hpp"
#include "gui/widgets/window.hpp"
#include "log.hpp"
#include "map/map.hpp"
#include "map/label.hpp"
#include "persist_manager.hpp"
#include "replay.hpp"
#include "resources.hpp"
#include "save_index.hpp"
#include "serialization/binary_or_text.hpp"
#include "serialization/parser.hpp"
#include "statistics.hpp"
//#include "units/unit.hpp"
#include "units/id.hpp"
#include "version.hpp"

static lg::log_domain log_engine("engine");
#define LOG_SAVE LOG_STREAM(info, log_engine)
#define ERR_SAVE LOG_STREAM(err, log_engine)

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


namespace savegame {

bool save_game_exists(const std::string& name, compression::format compressed)
{
    std::string fname = name;
    replace_space2underbar(fname);

    fname += compression::format_extension(compressed);

    return filesystem::file_exists(filesystem::get_saves_dir() + "/" + fname);
}

void clean_saves(const std::string& label)
{
    std::vector<save_info> games = get_saves_list();
    std::string prefix = label + "-" + _("Auto-Save");
    LOG_SAVE << "Cleaning saves with prefix '" << prefix << "'\n";
    for (std::vector<save_info>::iterator i = games.begin(); i != games.end(); ++i) {
        if (i->name().compare(0, prefix.length(), prefix) == 0) {
            LOG_SAVE << "Deleting savegame '" << i->name() << "'\n";
            delete_game(i->name());
        }
    }
}

loadgame::loadgame(CVideo& video, const config& game_config, saved_game& gamestate)
    : game_config_(game_config)
    , video_(video)
    , gamestate_(gamestate)
    , filename_()
    , difficulty_()
    , load_config_()
    , show_replay_(false)
    , cancel_orders_(false)
    , select_difficulty_(false)
    , summary_()
{}

void loadgame::show_dialog()
{
    if(get_saves_list().empty()) {
        gui2::show_transient_message(video_, _("No Saved Games"),
            _("There are no save files to load"));
        return;
    }

    // FIXME: Integrate the load_game dialog into this class
    // something to watch for the curious, but not yet ready to go
    gui2::tgame_load load_dialog(game_config_);
    load_dialog.show(video_);

    if (load_dialog.get_retval() == gui2::twindow::OK) {
        select_difficulty_ = load_dialog.change_difficulty();

        filename_ = load_dialog.filename();
        show_replay_ = load_dialog.show_replay();
        cancel_orders_ = load_dialog.cancel_orders();

        summary_ = load_dialog.summary();
    }
}

void loadgame::show_difficulty_dialog()
{
    if(summary_["corrupt"].to_bool() || (is_replay_save(summary_)) || (!summary_["turn"].empty())) {
        return;
    }

    std::string campaign_id = summary_["campaign"];

    for(const config &campaign : game_config_.child_range("campaign"))
    {
        if(campaign["id"] != campaign_id) {
            continue;
        }

        gui2::tcampaign_difficulty difficulty_dlg(campaign);
        difficulty_dlg.show(video_);

        // Return if canceled, since otherwise difficulty_ will be set to 'CANCEL'
        if (difficulty_dlg.get_retval() != gui2::twindow::OK) {
            return;
        }

        difficulty_ = difficulty_dlg.selected_difficulty();

        // Exit loop
        break;
    }
}

// Called only by play_controller to handle in-game attempts to load. Instead of returning true,
// throws a "load_game_exception" to signal a resulting load game request.
bool loadgame::load_game()
{
    if (!video_.faked()) {
        show_dialog();
    }

    if(filename_.empty()) {
        return false;
    }

    // Confirm the integrity of the file before throwing the exception.
    // Use the summary in the save_index for this.

    const config & summary = save_index_manager.get(filename_);

    if (summary["corrupt"].to_bool(false)) {
        gui2::show_error_message(video_,
                _("The file you have tried to load is corrupt: '"));
        return false;
    }

    if (!loadgame::check_version_compatibility(summary["version"].str(), video_)) {
        return false;
    }

    throw game::load_game_exception(filename_, show_replay_, cancel_orders_, select_difficulty_, difficulty_, true);
}

bool loadgame::load_game(
          const std::string& filename
        , const bool show_replay
        , const bool cancel_orders
        , const bool select_difficulty
        , const std::string& difficulty
        , bool skip_version_check)
{
    filename_ = filename;
    difficulty_ = difficulty;
    select_difficulty_ = select_difficulty;

    if (filename_.empty()){
        show_dialog();
    }
    else{
        show_replay_ = show_replay;
        cancel_orders_ = cancel_orders;
    }

    if (filename_.empty())
        return false;

    if (select_difficulty_)
        show_difficulty_dialog();

    std::string error_log;
    read_save_file(filename_, load_config_, &error_log);

    convert_old_saves(load_config_);

    if(!error_log.empty()) {
        try {
            gui2::show_error_message(video_,
                    _("Warning: The file you have tried to load is corrupt. Loading anyway.\n") +
                    error_log);
        } catch (utf8::invalid_utf8_exception&) {
            gui2::show_error_message(video_,
                    _("Warning: The file you have tried to load is corrupt. Loading anyway.\n") +
                    std::string("(UTF-8 ERROR)"));
        }
    }

    if (!difficulty_.empty()){
        load_config_["difficulty"] = difficulty_;
    }
    // read classification to for loading the game_config config object.
    gamestate_.classification() = game_classification(load_config_);

    if (skip_version_check) {
        return true;
    }

    return check_version_compatibility();
}

bool loadgame::check_version_compatibility()
{
    return loadgame::check_version_compatibility(gamestate_.classification().version, video_);
}

bool loadgame::check_version_compatibility(const version_info & save_version, CVideo & video)
{
    if (save_version == game_config::version) {
        return true;
    }

    const version_info &wesnoth_version = game_config::wesnoth_version;

    // Even minor version numbers indicate stable releases which are
    // compatible with each other.
    if (wesnoth_version.minor_version() % 2 == 0 &&
        wesnoth_version.major_version() == save_version.major_version() &&
        wesnoth_version.minor_version() == save_version.minor_version())
    {
        return true;
    }

    // Do not load if too old. If either the savegame or the current
    // game has the version 'test', load. This 'test' version is never
    // supposed to occur, except when Soliton is testing MP servers.
    if (save_version < game_config::min_savegame_version &&
        save_version != game_config::test_version &&
        wesnoth_version != game_config::test_version)
    {
        const std::string message = _("This save is from an old, unsupported version ($version_number|) and cannot be loaded.");
        utils::string_map symbols;
        symbols["version_number"] = save_version.str();
        gui2::show_error_message(video, utils::interpolate_variables_into_string(message, &symbols));
        return false;
    }

    if(preferences::confirm_load_save_from_different_version()) {
        const std::string message = _("This save is from a different version of the game ($version_number|). Do you wish to try to load it?");
        utils::string_map symbols;
        symbols["version_number"] = save_version.str();
        const int res = gui2::show_message(video, _("Load Game"), utils::interpolate_variables_into_string(message, &symbols),
            gui2::tmessage::yes_no_buttons);
        return res == gui2::twindow::OK;
    }

    return true;
}

void loadgame::set_gamestate()
{
    gamestate_.set_data(load_config_);
}

bool loadgame::load_multiplayer_game()
{
    show_dialog();

    if (filename_.empty())
        return false;

    std::string error_log;
    {
        cursor::setter cur(cursor::WAIT);
        log_scope("load_game");

        read_save_file(filename_, load_config_, &error_log);
        copy_era(load_config_);

        gamestate_.set_data(load_config_);
    }

    if(!error_log.empty()) {
        gui2::show_error_message(video_,
                _("The file you have tried to load is corrupt: '") +
                error_log);
        return false;
    }

    if(is_replay_save(summary_)) {
        gui2::show_transient_message(video_, _("Load Game"), _("Replays are not supported in multiplayer mode."));
        return false;
    }

    if(gamestate_.classification().campaign_type != game_classification::CAMPAIGN_TYPE::MULTIPLAYER) {
        gui2::show_transient_error_message(video_, _("This is not a multiplayer save."));
        return false;
    }

    return check_version_compatibility();
}

void loadgame::copy_era(config &cfg)
{
    const config &replay_start = cfg.child("replay_start");
    if (!replay_start) return;

    const config &era = replay_start.child("era");
    if (!era) return;

    config &snapshot = cfg.child("snapshot");
    if (!snapshot) return;

    snapshot.add_child("era", era);
}

savegame::savegame(saved_game& gamestate, const compression::format compress_saves, const std::string& title)
    : gamestate_(gamestate)
    , filename_()
    , title_(title)
    , error_message_(_("The game could not be saved: "))
    , show_confirmation_(false)
    , compress_saves_(compress_saves)
{}

bool savegame::save_game_automatic(CVideo& video, bool ask_for_overwrite, const std::string& filename)
{
    if (filename == "")
        create_filename();
    else
        filename_ = filename;

    if (ask_for_overwrite){
        if (!check_overwrite(video)) {
            return save_game_interactive(video, "", gui::OK_CANCEL);
        }
    }

    return save_game(&video);
}

bool savegame::save_game_interactive(CVideo& video, const std::string& message,
                                     gui::DIALOG_TYPE dialog_type)
{
    show_confirmation_ = true;
    create_filename();

    const int res = show_save_dialog(video, message, dialog_type);

    if (res == 2) {
        throw_quit_game_exception(); //Quit game
    }

    if (res == gui2::twindow::OK && check_overwrite(video)) {
        return save_game(&video);
    }

    return false;
}

int savegame::show_save_dialog(CVideo& video, const std::string& message, const gui::DIALOG_TYPE dialog_type)
{
    int res = 0;

    if (dialog_type == gui::OK_CANCEL){
        gui2::tgame_save dlg(filename_, title_);
        dlg.show(video);
        res = dlg.get_retval();
    }
    else if (dialog_type == gui::YES_NO){
        gui2::tgame_save_message dlg(filename_, title_, message);
        dlg.show(video);
        res = dlg.get_retval();
    }

    set_filename(filename_);

    if (!check_filename(filename_, video)) {
        res = gui2::twindow::CANCEL;
    }

    return res;
}

bool savegame::check_overwrite(CVideo& video)
{
    if(!save_game_exists(filename_, compress_saves_)) {
        return true;
    }

    std::ostringstream message;
    message << _("Save already exists. Do you want to overwrite it?") << "\n" << _("Name: ") << filename_;
    const int res = gui2::show_message(video, _("Overwrite?"), message.str(), gui2::tmessage::yes_no_buttons);
    return res == gui2::twindow::OK;

}

bool savegame::check_filename(const std::string& filename, CVideo& video)
{
    if (filesystem::is_compressed_file(filename)) {
        gui2::show_error_message(video, _("Save names should not end on '.gz' or '.bz2'. "
            "Please remove the extension."));
        return false;
    }

    return true;
}

bool savegame::is_illegal_file_char(char c)
{
    return c == '/' || c == '\\' || c == ':'
#ifdef _WIN32
    || c == '?' || c == '|' || c == '<' || c == '>' || c == '*' || c == '"'
#endif
    ;
}

void savegame::set_filename(std::string filename)
{
    filename.erase(std::remove_if(filename.begin(), filename.end(),
                is_illegal_file_char), filename.end());
    filename_ = filename;
}

void savegame::before_save()
{
}

bool savegame::save_game(CVideo* video, const std::string& filename)
{

    try {
        Uint32 start, end;
        start = SDL_GetTicks();

        if (filename_ == "")
            filename_ = filename;

        before_save();

        write_game_to_disk(filename_);
        if (resources::persist != nullptr) {
            resources::persist->end_transaction();
            resources::persist ->start_transaction();
        }

        end = SDL_GetTicks();
        LOG_SAVE << "Milliseconds to save " << filename_ << ": " << end - start << std::endl;

        if (video != nullptr && show_confirmation_)
            gui2::show_transient_message(*video, _("Saved"), _("The game has been saved."));
        return true;
    } catch(game::save_game_failed& e) {
        ERR_SAVE << error_message_ << e.message << std::endl;
        if (video != nullptr){
            gui2::show_error_message(*video, error_message_ + e.message);
            //do not bother retrying, since the user can just try to save the game again
            //maybe show a yes-no dialog for "disable autosaves now"?
        }

        return false;
    };
}

void savegame::write_game_to_disk(const std::string& filename)
{
    LOG_SAVE << "savegame::save_game" << std::endl;

    filename_ = filename;
    filename_ += compression::format_extension(compress_saves_);

    std::stringstream ss;
    {
        config_writer out(ss, compress_saves_);
        write_game(out);
        finish_save_game(out);
    }
    filesystem::scoped_ostream os(open_save_game(filename_));
    (*os) << ss.str();

    if (!os->good()) {
        throw game::save_game_failed(_("Could not write to file"));
    }
}

void savegame::write_game(config_writer &out)
{
    log_scope("write_game");

    out.write_key_val("version", game_config::version);

    gamestate_.write_general_info(out);
    out.open_child("statistics");
    statistics::write_stats(out);
    out.close_child("statistics");
}

void savegame::finish_save_game(const config_writer &out)
{
    try {
        if(!out.good()) {
            throw game::save_game_failed(_("Could not write to file"));
        }
        save_index_manager.remove(gamestate_.classification().label);
    } catch(filesystem::io_exception& e) {
        throw game::save_game_failed(e.what());
    }
}

// Throws game::save_game_failed
filesystem::scoped_ostream savegame::open_save_game(const std::string &label)
{
    std::string name = label;
    replace_space2underbar(name);

    try {
        return filesystem::scoped_ostream(filesystem::ostream_file(filesystem::get_saves_dir() + "/" + name));
    } catch(filesystem::io_exception& e) {
        throw game::save_game_failed(e.what());
    }
}

scenariostart_savegame::scenariostart_savegame(saved_game &gamestate, const compression::format compress_saves)
    : savegame(gamestate, compress_saves)
{
    set_filename(gamestate.classification().label);
}

void scenariostart_savegame::write_game(config_writer &out){
    savegame::write_game(out);
    gamestate().write_carryover(out);
}

replay_savegame::replay_savegame(saved_game &gamestate, const compression::format compress_saves)
    : savegame(gamestate, compress_saves, _("Save Replay"))
{}

void replay_savegame::create_filename()
{
    set_filename((formatter() << gamestate().classification().label << " " << _("replay")).str());
}

void replay_savegame::write_game(config_writer &out) {
    savegame::write_game(out);

    gamestate().write_carryover(out);
    out.write_child("replay_start", gamestate().replay_start());

    out.open_child("replay");
    gamestate().get_replay().write(out);
    out.close_child("replay");

}

autosave_savegame::autosave_savegame(saved_game &gamestate,
                    game_display& gui, const compression::format compress_saves)
    : ingame_savegame(gamestate, gui, compress_saves)
{
    set_error_message(_("Could not auto save the game. Please save the game manually."));
}

void autosave_savegame::autosave(const bool disable_autosave, const int autosave_max, const int infinite_autosaves)
{
    if(disable_autosave)
        return;

    save_game_automatic(gui_.video());

    remove_old_auto_saves(autosave_max, infinite_autosaves);
}

void autosave_savegame::create_filename()
{
    std::string filename;
    if (gamestate().classification().label.empty())
        filename = _("Auto-Save");
    else
        filename = gamestate().classification().label + "-" + _("Auto-Save") + gamestate().get_starting_pos()["turn_at"];

    set_filename(filename);
}

oos_savegame::oos_savegame(saved_game& gamestate, game_display& gui, bool& ignore)
    : ingame_savegame(gamestate, gui, preferences::save_compression_format())
    , ignore_(ignore)
{}

int oos_savegame::show_save_dialog(CVideo& video, const std::string& message, const gui::DIALOG_TYPE /*dialog_type*/)
{
    int res = 0;

    std::string filename = this->filename();

    if (!ignore_){
        gui2::tgame_save_oos dlg(ignore_, filename, title(), message);
        dlg.show(video);
        res = dlg.get_retval();
    }

    set_filename(filename);

    if (!check_filename(filename, video)) {
        res = gui2::twindow::CANCEL;
    }

    return res;
}

ingame_savegame::ingame_savegame(saved_game &gamestate,
                    game_display& gui, const compression::format compress_saves)
    : savegame(gamestate, compress_saves, _("Save Game")),
    gui_(gui)
{
}

void ingame_savegame::create_filename()
{
    set_filename((formatter() << gamestate().classification().label
        << " " << _("Turn") << " " << gamestate().get_starting_pos()["turn_at"]).str());
}

void ingame_savegame::write_game(config_writer &out) {
    log_scope("write_game");

    savegame::write_game(out);

    gamestate().write_carryover(out);
    out.write_child("snapshot",gamestate().get_starting_pos());
    out.write_child("replay_start", gamestate().replay_start());
    out.open_child("replay");
    gamestate().get_replay().write(out);
    out.close_child("replay");
}

//changes done during 1.11.0-dev
static void convert_old_saves_1_11_0(config& cfg)
{
    if(!cfg.has_child("snapshot")){
        return;
    }

    const config& snapshot = cfg.child("snapshot");
    const config& replay_start = cfg.child("replay_start");
    const config& replay = cfg.child("replay");

    if(!cfg.has_child("carryover_sides") && !cfg.has_child("carryover_sides_start")){
        config carryover;
        //copy rng and menu items from toplevel to new carryover_sides
        carryover["random_seed"] = cfg["random_seed"];
        carryover["random_calls"] = cfg["random_calls"];
        for(const config& menu_item : cfg.child_range("menu_item")) {
            carryover.add_child("menu_item", menu_item);
        }
        carryover["difficulty"] = cfg["difficulty"];
        carryover["random_mode"] = cfg["random_mode"];
        //the scenario to be played is always stored as next_scenario in carryover_sides_start
        carryover["next_scenario"] = cfg["scenario"];

        config carryover_start = carryover;

        //copy sides from either snapshot or replay_start to new carryover_sides
        if(!snapshot.empty()){
            for(const config& side : snapshot.child_range("side")) {
                carryover.add_child("side", side);
            }
            //for compatibility with old savegames that use player instead of side
            for(const config& side : snapshot.child_range("player")) {
                carryover.add_child("side", side);
            }
            //save the sides from replay_start in carryover_sides_start
            for(const config& side : replay_start.child_range("side")) {
                carryover_start.add_child("side", side);
            }
            //for compatibility with old savegames that use player instead of side
            for(const config& side : replay_start.child_range("player")) {
                carryover_start.add_child("side", side);
            }
        } else if (!replay_start.empty()){
            for(const config& side : replay_start.child_range("side")) {
                carryover.add_child("side", side);
                carryover_start.add_child("side", side);
            }
            //for compatibility with old savegames that use player instead of side
            for(const config& side : replay_start.child_range("player")) {
                carryover.add_child("side", side);
                carryover_start.add_child("side", side);
            }
        }

        //get variables according to old hierarchy and copy them to new carryover_sides
        if(!snapshot.empty()){
            if(const config& variables = snapshot.child("variables")){
                carryover.add_child("variables", variables);
                carryover_start.add_child("variables", replay_start.child_or_empty("variables"));
            } else if (const config& variables = cfg.child("variables")){
                carryover.add_child("variables", variables);
                carryover_start.add_child("variables", variables);
            }
        } else if (!replay_start.empty()){
            if(const config& variables = replay_start.child("variables")){
                carryover.add_child("variables", variables);
                carryover_start.add_child("variables", variables);
            }
        } else {
            carryover.add_child("variables", cfg.child("variables"));
            carryover_start.add_child("variables", cfg.child("variables"));
        }

        cfg.add_child("carryover_sides", carryover);
        cfg.add_child("carryover_sides_start", carryover_start);
    }

    //if replay and snapshot are empty we've got a start of scenario save and don't want replay_start either
    if(replay.empty() && snapshot.empty()){
        LOG_RG<<"removing replay_start \n";
        cfg.clear_children("replay_start");
    }

    //remove empty replay or snapshot so type of save can be detected more easily
    if(replay.empty()){
        LOG_RG<<"removing replay \n";
        cfg.clear_children("replay");
    }

    if(snapshot.empty()){
        LOG_RG<<"removing snapshot \n";
        cfg.clear_children("snapshot");
    }
}
//changes done during 1.13.0-dev
static void convert_old_saves_1_13_0(config& cfg)
{
    if(config& carryover_sides_start = cfg.child("carryover_sides_start"))
    {
        if(!carryover_sides_start.has_attribute("next_underlying_unit_id"))
        {
            carryover_sides_start["next_underlying_unit_id"] = cfg["next_underlying_unit_id"];
        }
    }
    if(cfg.child_or_empty("snapshot").empty())
    {
        cfg.clear_children("snapshot");
    }
    if(cfg.child_or_empty("replay_start").empty())
    {
        cfg.clear_children("replay_start");
    }
    if(config& snapshot = cfg.child("snapshot"))
    {
        //make [end_level] -> [end_level_data] since its alo called [end_level_data] in the carryover.
        if(config& end_level = cfg.child("end_level") )
        {
            snapshot.add_child("end_level_data", end_level);
            snapshot.clear_children("end_level");
        }
        //if we have a snapshot then we already applied carryover so there is no reason to keep this data.
        if(cfg.has_child("carryover_sides_start"))
        {
            cfg.clear_children("carryover_sides_start");
        }
    }
    if(!cfg.has_child("snapshot") && !cfg.has_child("replay_start"))
    {
        cfg.clear_children("carryover_sides");
    }
    //This code is needed because for example otherwise it won't find the (empty) era
    if(!cfg.has_child("multiplayer")) {
        cfg.add_child("multiplayer", config_of
            ("mp_era", "era_blank")
            ("show_connect", false)
            ("show_configure", false)
            ("mp_use_map_settings", true)
        );
    }
}


//changes done during 1.13.0+dev
static void convert_old_saves_1_13_1(config& cfg)
{
    if(config& multiplayer = cfg.child("multiplayer")) {
        if(multiplayer["mp_era"] == "era_blank") {
            multiplayer["mp_era"] = "era_default";
        }
    }
    //This currently only fixes start-of-scenario saves.
    if(config& carryover_sides_start = cfg.child("carryover_sides_start"))
    {
        for(config& side : carryover_sides_start.child_range("side"))
        {
            for(config& unit : side.child_range("unit"))
            {
                if(config& modifications = unit.child("modifications"))
                {
                    for(config& advancement : modifications.child_range("advance"))
                    {
                        modifications.add_child("advancement", advancement);
                    }
                    modifications.clear_children("advance");
                }
            }
        }
    }
    for(config& snapshot : cfg.child_range("snapshot")) {
        if (snapshot.has_attribute("used_items")) {
            config used_items;
            for(const std::string& item : utils::split(snapshot["used_items"])) {
                used_items[item] = true;
            }
            snapshot.remove_attribute("used_items");
            snapshot.add_child("used_items", used_items);
        }
    }
}

void convert_old_saves(config& cfg)
{
    version_info loaded_version(cfg["version"]);
    if(loaded_version < version_info("1.12.0"))
    {
        convert_old_saves_1_11_0(cfg);
    }
    // '<= version_info("1.13.0")' doesn't work
    //because version_info cannot handle 1.13.0-dev versions correctly.
    if(loaded_version < version_info("1.13.1"))
    {
        convert_old_saves_1_13_0(cfg);
    }
    if(loaded_version <= version_info("1.13.1"))
    {
        convert_old_saves_1_13_1(cfg);
    }
    LOG_RG<<"cfg after conversion "<<cfg<<"\n";
}

}