11#include "../settings_type.h"
12#include "../core/random_func.hpp"
14#include "api/script_object.hpp"
15#include "../textfile_gui.h"
16#include "../string_func.h"
19#include "table/strings.h"
21#include "../safeguards.h"
25 if (
name.has_value()) {
26 this->name =
name.value();
45 for (
const auto &item : config.
settings) {
46 this->
settings[item.first] = item.second;
65 this->
config_list = std::make_unique<ScriptConfigItemList>();
79 this->
SetSetting(item.name, this->GetSetting(item.name));
86 const auto it = this->
settings.find(name);
94 if (this->
info ==
nullptr)
return;
97 if (config_item ==
nullptr)
return;
113 for (SettingValueList::iterator it = this->
settings.begin(); it != this->
settings.end();) {
115 assert(config_item !=
nullptr);
120 if (editable && visible) {
130 return this->
info !=
nullptr;
145 std::string_view to_process = value;
148 size_t pos = to_process.find_first_of(
'=');
149 if (pos == std::string_view::npos)
return;
151 std::string_view item_name = to_process.substr(0, pos);
153 to_process.remove_prefix(pos + 1);
154 pos = to_process.find_first_of(
',');
156 std::from_chars(to_process.data(), to_process.data() + std::min(pos, to_process.size()), item_value);
160 if (pos == std::string_view::npos)
return;
161 to_process.remove_prefix(pos + 1);
167 if (this->
settings.empty())
return {};
170 for (
const auto &item : this->
settings) {
171 format_append(result,
"{}={},", item.first, item.second);
175 result.resize(result.size() - 1);
181 if (slot == CompanyID::Invalid() || this->
GetInfo() ==
nullptr)
return std::nullopt;
186void ScriptConfig::SetToLoadData(ScriptInstance::ScriptData *data)
191ScriptInstance::ScriptData *ScriptConfig::GetToLoadData()
196static std::pair<StringParameter, StringParameter> GetValueParams(
const ScriptConfigItem &config_item,
int value)
200 auto it = config_item.
labels.find(value);
201 if (it != std::end(config_item.
labels))
return {STR_JUST_RAW_STRING, it->second};
203 return {STR_JUST_INT, value};
213 auto [param1, param2] = GetValueParams(*
this, value);
225 return this->
description.empty() ? TC_ORANGE : TC_LIGHT_BLUE;
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
SettingValueList settings
List with all setting=>value pairs that are configure for this Script.
std::optional< std::string > GetTextfile(TextfileType type, CompanyID slot) const
Search a textfile file next to this script.
void AnchorUnchangeableSettings()
As long as the default of a setting has not been changed, the value of the setting is not stored.
bool HasScript() const
Is this config attached to an Script? In other words, is there a Script that is assigned to this slot...
void SetSetting(std::string_view name, int value)
Set the value of a setting for this config.
void Change(std::optional< std::string_view > name, int version=-1, bool force_exact_match=false)
Set another Script to be loaded in this slot.
void StringToSettings(std::string_view value)
Convert a string which is stored in the config file or savegames to custom settings of this Script.
virtual ~ScriptConfig()
Delete an Script configuration.
int version
Version of the Script.
virtual ScriptInfo * FindInfo(const std::string &name, int version, bool force_exact_match)=0
This function should call back to the Scanner in charge of this Config, to find the ScriptInfo belong...
const std::string & GetName() const
Get the name of the Script.
class ScriptInfo * info
ScriptInfo object for related to this Script version.
std::unique_ptr< ScriptConfigItemList > config_list
List with all settings defined by this Script.
int GetVersion() const
Get the version of the Script.
void ClearConfigList()
Routine that clears the config list.
std::unique_ptr< ScriptInstance::ScriptData > to_load_data
Data to load after the Script start.
class ScriptInfo * GetInfo() const
Get the ScriptInfo linked to this ScriptConfig.
void ResetSettings()
Reset all settings to their default value.
std::string name
Name of the Script.
const ScriptConfigItemList * GetConfigList()
Get the config list for this ScriptConfig.
int GetSetting(const std::string &name) const
Get the value of a setting for this config.
std::string SettingsToString() const
Convert the custom settings to a string that can be stored in the config file or savegames.
void ResetEditableSettings(bool yet_to_start)
Reset only editable and visible settings to their default value.
All static information from an Script like name, version, etc.
const ScriptConfigItemList * GetConfigList() const
Get the config list for this Script.
const std::string & GetMainScript() const
Get the filename of the main.nut script.
const ScriptConfigItem * GetConfigItem(std::string_view name) const
Get the description of a certain Script config option.
int GetVersion() const
Get the version of the script.
int GetSettingDefaultValue(const std::string &name) const
Get the default value for a setting.
static constexpr Owner OWNER_DEITY
The object is owned by a superuser / goal script.
@ AI_DIR
Subdirectory for all AI files.
@ GAME_DIR
Subdirectory for all game scripts.
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
std::vector< ScriptConfigItem > ScriptConfigItemList
List of ScriptConfig items.
@ Boolean
This value is a boolean (either 0 (false) or 1 (true) ).
@ Developer
This setting will only be visible when the Script development tools are active.
@ InGame
This setting can be changed while the Script is running.
ScriptInfo keeps track of all information of a script, like Author, Description, ....
ClientSettings _settings_client
The current settings for this game.
GUISettings gui
settings related to the GUI
bool ai_developer_tools
activate AI/GS developer tools
Info about a single Script setting.
ScriptConfigFlags flags
Flags for the configuration setting.
std::string GetString(int value) const
Get string to display this setting in the configuration interface.
LabelMapping labels
Text labels for the integer values.
int min_value
The minimal value this configuration setting can have.
int max_value
The maximal value this configuration setting can have.
std::string description
The description of the configuration setting.
TextColour GetColour() const
Get text colour to display this setting in the configuration interface.
TextfileType
Additional text files accompanying Tar archives.