map_settings.hpp

Go to the documentation of this file.

/*
    Copyright (C) 2007 - 2025
    by Mark de Wever <koraq@xs4all.nl>
    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.
*/
 
/**
 *  @file
 *  General settings and defaults for scenarios.
 */
 
#pragma once
 
#include <string>
 
#include "game_classification.hpp"
#include "game_initialization/create_engine.hpp"
#include "game_initialization/random_faction_mode.hpp"
 
/**
 * Contains the general settings which have a default.
 * These values can be used to initialize the preferences,
 * but also to set map values if these aren't defined.
 */
 
namespace settings {
 
    /**
     *  Gets the number of turns.
     *  If no valid value supplied, it will return a default.
     *  The value is also range checked.
     *  When out of bounds, it will be set to the nearest bound.
     *
     *  @param value        string containing the number of turns
     *
     *  @returns            the number of turns
     */
    int get_turns(const std::string& value);
    const int turns_min = 1;          /**< minimum number of turns */
    const int turns_max = 100;        /**< maximum number of turns */
    const int turns_default = 100;    /**< default number of turns */
    const int turns_step = 1;         /**< slider step size for turns */
 
    /**
     *  Gets the village gold.
     *  If no valid value supplied, it will return a default.
     *  The default is 1 for singleplayer, and 2 for multiplayer.
     *
     *  @param value        string containing the village gold
     *  @param classification
     *
     *  @returns            the village gold
     */
    int get_village_gold(const std::string& value, const game_classification* classification = nullptr);
 
    /**
     *  Gets the village unit level support.
     *  If no valid value supplied, it will return a default.
     *
     *  @param value        string containing the village support
     *
     *  @returns            the village support
     */
    int get_village_support(const std::string& value);
 
    /**
     *  Gets the xp modifier.
     *  If no valid value supplied, it will return a default.
     *
     *  @param value        string containing the xp modifier
     *
     *  @returns            the xp modifier
     */
    int get_xp_modifier(const std::string& value);
 
    //
    // mp_parameter defaults
    //
    void set_default_values(ng::create_engine& create);
    bool force_lock_settings(ng::create_engine& create);
 
    std::string game_name_default();
    int num_turns_default(ng::create_engine& create);
    int village_gold_default(ng::create_engine& create);
    int village_support_default(ng::create_engine& create);
    int xp_modifier_default(ng::create_engine& create);
    std::chrono::seconds mp_countdown_init_time_default();
    std::chrono::seconds mp_countdown_reservoir_time_default();
    std::chrono::seconds mp_countdown_turn_bonus_default();
    std::chrono::seconds mp_countdown_action_bonus_default();
    bool mp_countdown_default();
    bool use_map_settings_default(ng::create_engine& create);
    bool random_start_time_default(ng::create_engine& create);
    bool fog_game_default(ng::create_engine& create);
    bool shroud_game_default(ng::create_engine& create);
    bool allow_observers_default();
    bool shuffle_sides_default();
    random_faction_mode::type random_faction_mode_default();
} // namespace settings