2009-08-21 20:21:05 +00:00
/*
* This file is part of OpenTTD .
* OpenTTD 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 , version 2.
* OpenTTD is distributed in the hope that it will be useful , but WITHOUT ANY WARRANTY ; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE .
* See the GNU General Public License for more details . You should have received a copy of the GNU General Public License along with OpenTTD . If not , see < http : //www.gnu.org/licenses/>.
*/
2008-01-07 00:19:09 +00:00
/** @file settings_type.h Types related to global configuration settings. */
# ifndef SETTINGS_TYPE_H
# define SETTINGS_TYPE_H
# include "date_type.h"
2020-12-14 22:35:07 +00:00
# include "economy_type.h"
2008-01-07 14:02:26 +00:00
# include "town_type.h"
2008-05-07 09:07:19 +00:00
# include "transport_type.h"
2008-05-29 20:21:28 +00:00
# include "network/core/config.h"
2009-01-12 17:11:45 +00:00
# include "company_type.h"
2013-06-09 12:56:35 +00:00
# include "cargotype.h"
# include "linkgraph/linkgraph_type.h"
2011-11-24 12:20:14 +00:00
# include "zoom_type.h"
2011-01-02 00:34:21 +00:00
# include "openttd.h"
2008-01-07 00:19:09 +00:00
2021-03-01 12:12:17 +00:00
/* Used to validate sizes of "max" value in settings. */
const size_t MAX_SLE_UINT8 = UINT8_MAX ;
const size_t MAX_SLE_UINT16 = UINT16_MAX ;
const size_t MAX_SLE_UINT32 = UINT32_MAX ;
const size_t MAX_SLE_UINT = UINT_MAX ;
const size_t MAX_SLE_INT8 = INT8_MAX ;
const size_t MAX_SLE_INT16 = INT16_MAX ;
const size_t MAX_SLE_INT32 = INT32_MAX ;
const size_t MAX_SLE_INT = INT_MAX ;
2012-12-05 19:34:45 +00:00
/** Settings profiles and highscore tables. */
enum SettingsProfile {
SP_BEGIN = 0 ,
SP_EASY = SP_BEGIN , ///< Easy difficulty.
SP_MEDIUM , ///< Medium difficulty.
SP_HARD , ///< Hard difficulty.
SP_END , ///< End of setting profiles.
SP_CUSTOM = SP_END , ///< No profile, special "custom" highscore.
SP_SAVED_HIGHSCORE_END , ///< End of saved highscore tables.
SP_MULTIPLAYER = SP_SAVED_HIGHSCORE_END , ///< Special "multiplayer" highscore. Not saved, always specific to the current game.
SP_HIGHSCORE_END , ///< End of highscore tables.
} ;
2011-02-06 18:11:39 +00:00
/** Available industry map generation densities. */
enum IndustryDensity {
ID_FUND_ONLY , ///< The game does not build industries.
ID_MINIMAL , ///< Start with just the industries that must be present.
ID_VERY_LOW , ///< Very few industries at game start.
ID_LOW , ///< Few industries at game start.
ID_NORMAL , ///< Normal amount of industries at game start.
ID_HIGH , ///< Many industries at game start.
ID_END , ///< Number of industry density settings.
} ;
2008-05-25 22:36:44 +00:00
/** Settings related to the difficulty of the game */
struct DifficultySettings {
2008-05-26 00:31:36 +00:00
byte max_no_competitors ; ///< the number of competitors (AIs)
byte number_towns ; ///< the amount of towns
2011-02-06 18:26:50 +00:00
byte industry_density ; ///< The industry density. @see IndustryDensity
2008-05-26 00:31:36 +00:00
uint32 max_loan ; ///< the maximum initial loan
byte initial_interest ; ///< amount of interest (to pay over the loan)
byte vehicle_costs ; ///< amount of money spent on vehicle running cost
byte competitor_speed ; ///< the speed at which the AI builds
byte vehicle_breakdowns ; ///< likelihood of vehicles breaking down
byte subsidy_multiplier ; ///< amount of subsidy
byte construction_cost ; ///< how expensive is building
byte terrain_type ; ///< the mountainousness of the landscape
byte quantity_sea_lakes ; ///< the amount of seas/lakes
2012-12-05 19:38:44 +00:00
bool economy ; ///< how volatile is the economy
bool line_reverse_mode ; ///< reversing at stations or not
bool disasters ; ///< are disasters enabled
2008-05-26 00:31:36 +00:00
byte town_council_tolerance ; ///< minimum required town ratings to be allowed to demolish stuff
2020-04-14 21:04:41 +00:00
bool money_cheat_in_multiplayer ; ///< is the money cheat permitted for non-admin multiplayer clients
2021-03-14 16:44:15 +00:00
bool rename_towns_in_multiplayer ; ///< is renaming towns permitted for non-admin multiplayer clients
2008-01-13 13:36:01 +00:00
} ;
2018-04-28 21:27:14 +00:00
/** Settings relating to viewport/smallmap scrolling. */
enum ViewportScrollMode {
VSM_VIEWPORT_RMB_FIXED , ///< Viewport moves with mouse movement on holding right mouse button, cursor position is fixed.
VSM_MAP_RMB_FIXED , ///< Map moves with mouse movement on holding right mouse button, cursor position is fixed.
VSM_MAP_RMB , ///< Map moves with mouse movement on holding right mouse button, cursor moves.
VSM_MAP_LMB , ///< Map moves with mouse movement on holding left mouse button, cursor moves.
VSM_END , ///< Number of scroll mode settings.
} ;
2020-06-23 20:05:21 +00:00
/** Settings related to time display. This may be loaded from the savegame and/or overriden by the client. */
struct TimeSettings {
bool time_in_minutes ; ///< whether to use the hh:mm conversion when printing dates
uint16 ticks_per_minute ; ///< how many ticks per minute
uint16 clock_offset ; ///< clock offset in minutes
} ;
2008-05-25 19:17:03 +00:00
/** Settings related to the GUI and other stuff that is not saved in the savegame. */
2020-06-23 20:05:21 +00:00
struct GUISettings : public TimeSettings {
2008-05-25 19:17:03 +00:00
bool sg_full_load_any ; ///< new full load calculation, any cargo must be full read from pre v93 savegames
2010-12-13 21:53:23 +00:00
bool lost_vehicle_warn ; ///< if a vehicle can't find its destination, show a warning
2020-08-29 12:31:52 +00:00
bool restriction_wait_vehicle_warn ; ///< if a vehicle is waiting for an extended time due to a routing restriction, show a warning
2008-05-25 19:17:03 +00:00
uint8 order_review_system ; ///< perform order reviews on vehicles
2019-05-11 18:58:16 +00:00
bool no_depot_order_warn ; ///< if a non-air vehicle doesn't have at least one depot order, show a warning
2009-01-04 18:34:23 +00:00
bool vehicle_income_warn ; ///< if a vehicle isn't generating income, show a warning
2008-05-25 19:17:03 +00:00
bool show_finances ; ///< show finances at end of year
bool sg_new_nonstop ; ///< ttdpatch compatible nonstop handling read from pre v93 savegames
bool new_nonstop ; ///< ttdpatch compatible nonstop handling
2009-04-12 14:11:14 +00:00
uint8 stop_location ; ///< what is the default stop location of trains?
2012-10-13 09:16:20 +00:00
uint8 auto_scrolling ; ///< scroll when moving mouse to the edge (see #ViewportAutoscrolling)
2008-05-25 19:17:03 +00:00
byte errmsg_duration ; ///< duration of error message
2014-09-13 13:30:31 +00:00
uint16 hover_delay_ms ; ///< time required to activate a hover event, in milliseconds
2008-05-25 19:17:03 +00:00
bool link_terraform_toolbar ; ///< display terraform toolbar when displaying rail, road, water and airport toolbars
2010-02-08 23:46:35 +00:00
uint8 smallmap_land_colour ; ///< colour used for land and heightmap at the smallmap
2018-04-28 21:27:14 +00:00
uint8 scroll_mode ; ///< viewport scroll mode
2008-05-25 19:17:03 +00:00
bool smooth_scroll ; ///< smooth scroll viewports
bool measure_tooltip ; ///< show a permanent tooltip when dragging tools
byte liveries ; ///< options for displaying company liveries, 0=none, 1=self, 2=all
2018-10-28 02:17:36 +00:00
bool prefer_teamchat ; ///< choose the chat message target with \<ENTER\>, true=all clients, false=your team
2008-05-25 19:17:03 +00:00
uint8 advanced_vehicle_list ; ///< use the "advanced" vehicle list
uint8 loading_indicators ; ///< show loading indicators
uint8 default_rail_type ; ///< the default rail type for the rail GUI
2020-09-18 22:32:47 +00:00
uint8 default_road_type ; ///< the default road/tram types for the road/tram GUI
2008-05-25 19:17:03 +00:00
uint8 toolbar_pos ; ///< position of toolbars, 0=left, 1=center, 2=right
2010-11-13 23:40:36 +00:00
uint8 statusbar_pos ; ///< position of statusbar, 0=left, 1=center, 2=right
2008-05-25 19:17:03 +00:00
uint8 window_snap_radius ; ///< windows snap at each other if closer than this
2009-01-07 16:11:27 +00:00
uint8 window_soft_limit ; ///< soft limit of maximum number of non-stickied non-vital windows (0 = no limit)
2019-04-21 19:15:55 +00:00
ZoomLevel zoom_min ; ///< minimum zoom out level
ZoomLevel zoom_max ; ///< maximum zoom out level
2021-03-13 09:00:53 +00:00
ZoomLevel sprite_zoom_min ; ///< maximum zoom level at which higher-resolution alternative sprites will be used (if available) instead of scaling a lower resolution sprite
2008-05-25 22:36:44 +00:00
byte autosave ; ///< how often should we do autosaves?
2009-10-27 20:28:10 +00:00
bool threaded_saves ; ///< should we do threaded saves?
2008-05-25 19:17:03 +00:00
bool keep_all_autosave ; ///< name the autosave in a different way
bool autosave_on_exit ; ///< save an autosave when you quit the game, but do not ask "Do you really want to quit?"
2018-05-24 17:40:54 +00:00
bool autosave_on_network_disconnect ; ///< save an autosave when you get disconnected from a network game with an error?
2009-01-03 00:58:59 +00:00
uint8 date_format_in_default_names ; ///< should the default savegame/screenshot name use long dates (31th Dec 2008), short dates (31-12-2008) or ISO dates (2008-12-31)
2008-05-25 19:17:03 +00:00
byte max_num_autosaves ; ///< controls how many autosavegames are made before the game starts to overwrite (names them 0 to max_num_autosaves - 1)
2019-02-02 02:09:40 +00:00
uint8 savegame_overwrite_confirm ; ///< Mode for when to warn about overwriting an existing savegame
2008-05-25 19:17:03 +00:00
bool population_in_label ; ///< show the population of a town in his label?
uint8 right_mouse_btn_emulation ; ///< should we emulate right mouse clicking?
uint8 scrollwheel_scrolling ; ///< scrolling using the scroll wheel?
uint8 scrollwheel_multiplier ; ///< how much 'wheel' per incoming event from the OS?
2015-08-02 18:37:42 +00:00
bool viewport_map_scan_surroundings ; ///< look for the most important tile in surroundings
bool show_slopes_on_viewport_map ; ///< use slope orientation to render the ground
uint32 default_viewport_map_mode ; ///< the mode to use by default when a viewport is in map mode, 0=owner, 1=industry, 2=vegetation
uint32 action_when_viewport_map_is_dblclicked ; ///< what to do when a doubleclick occurs on the viewport map
uint32 show_scrolling_viewport_on_map ; ///< when a no map viewport is scrolled, its location is marked on the other map viewports
bool show_bridges_on_map ; ///< bridges are rendered on a viewport in map mode
bool show_tunnels_on_map ; ///< tunnels are rendered on a viewport in map mode
uint32 show_vehicle_route ; ///< show a vehicle's route when its orders/timetable window is focused
uint32 dash_level_of_route_lines ; ///< the dash level passed to GfxDrawLine() (plain if 0)
bool use_owner_colour_for_tunnelbridge ; ///< bridges and tunnels are rendered with their owner's colour
2009-11-25 16:17:06 +00:00
bool timetable_arrival_departure ; ///< show arrivals and departures in vehicle timetables
2015-08-01 18:47:09 +00:00
uint8 max_departures ; ///< maximum number of departures to show per station
uint16 max_departure_time ; ///< maximum time in advance to show departures
uint16 departure_calc_frequency ; ///< how often to calculate departures (in ticks)
bool departure_show_vehicle ; ///< whether to show vehicle names with departures
bool departure_show_group ; ///< whether to show group names with departures
bool departure_show_company ; ///< whether to show company names with departures
bool departure_show_vehicle_type ; ///< whether to show vehicle type icons with departures
bool departure_show_vehicle_color ; ///< whether to show vehicle type icons in silver instead of orange
bool departure_larger_font ; ///< whether to show the calling at list in a larger font
bool departure_destination_type ; ///< whether to show destination types for ports and airports
bool departure_show_both ; ///< whether to show departure and arrival times on the same line
bool departure_only_passengers ; ///< whether to only show passenger services
bool departure_smart_terminus ; ///< whether to only show passenger services
uint8 departure_conditionals ; ///< how to handle conditional orders
bool departure_show_all_stops ; ///< whether to show stops regardless of loading/unloading done at them
bool departure_merge_identical ; ///< whether to merge identical departures
2017-03-24 18:55:16 +00:00
bool right_mouse_wnd_close ; ///< close window with right click
2008-05-25 19:17:03 +00:00
bool pause_on_newgame ; ///< whether to start new games paused or not
bool enable_signal_gui ; ///< show the signal GUI when the signal button is pressed
2009-02-09 02:57:15 +00:00
Year coloured_news_year ; ///< when does newspaper become coloured?
2020-06-23 20:05:21 +00:00
bool override_time_settings ; ///< Whether to override time display settings stored in savegame.
2008-05-25 19:17:03 +00:00
bool timetable_in_ticks ; ///< whether to show the timetable in ticks rather than days
2016-05-06 18:47:46 +00:00
bool timetable_leftover_ticks ; ///< whether to show leftover ticks after converting to minutes/days, in the timetable
2015-08-01 18:47:09 +00:00
bool timetable_start_text_entry ; ///< whether to enter timetable start times as text (hhmm format)
uint8 date_with_time ; ///< whether to show the month and year with the time
2009-01-04 14:51:49 +00:00
bool quick_goto ; ///< Allow quick access to 'goto button' in vehicle orders window
2008-05-25 19:17:03 +00:00
bool auto_euro ; ///< automatically switch to euro in 2002
byte drag_signals_density ; ///< many signals density
2012-04-17 19:43:29 +00:00
bool drag_signals_fixed_distance ; ///< keep fixed distance between signals when dragging
2008-05-25 19:17:03 +00:00
Year semaphore_build_before ; ///< build semaphore signals automatically before this year
2008-06-05 11:26:38 +00:00
byte news_message_timeout ; ///< how much longer than the news message "age" should we keep the message in the history
2008-08-02 22:47:34 +00:00
bool show_track_reservation ; ///< highlight reserved tracks.
2008-08-02 22:49:23 +00:00
uint8 default_signal_type ; ///< the signal type to build by default.
uint8 cycle_signal_types ; ///< what signal types to cycle with the build signal tool.
2009-01-04 11:11:11 +00:00
byte station_numtracks ; ///< the number of platforms to default on for rail stations
byte station_platlength ; ///< the platform length, in tiles, for rail stations
bool station_dragdrop ; ///< whether drag and drop is enabled for stations
bool station_show_coverage ; ///< whether to highlight coverage area
2009-02-05 17:59:59 +00:00
bool persistent_buildingtools ; ///< keep the building tools active after usage
2010-12-29 13:32:35 +00:00
bool expenses_layout ; ///< layout of expenses window
2011-08-21 12:53:13 +00:00
uint32 last_newgrf_count ; ///< the numbers of NewGRFs we found during the last scan
2011-08-21 19:23:06 +00:00
byte missing_strings_threshold ; ///< the number of missing strings before showing the warning
2011-12-11 15:55:31 +00:00
uint8 graph_line_thickness ; ///< the thickness of the lines in the various graph guis
2015-08-30 16:09:43 +00:00
bool show_train_length_in_details ; ///< show train length in vehicle details window top widget
2016-07-05 20:54:43 +00:00
bool show_train_weight_ratios_in_details ; ///< show train weight ratios in vehicle details window top widget
2015-08-30 16:09:43 +00:00
bool show_vehicle_group_in_details ; ///< show vehicle group in vehicle details window top widget
2015-12-09 01:01:37 +00:00
bool show_restricted_signal_default ; ///< Show restricted electric signals using the default sprite
2017-03-30 22:32:37 +00:00
bool show_adv_tracerestrict_features ; ///< Show advanced trace restrict features in UI
2019-12-05 18:13:35 +00:00
bool show_progsig_ui ; ///< Show programmable pre-signals feature in UI
2021-09-04 02:14:09 +00:00
bool show_noentrysig_ui ; ///< Show no-entry signals feature in UI
2017-10-16 23:16:10 +00:00
bool show_veh_list_cargo_filter ; ///< Show cargo list filter in UI
2012-12-05 19:34:25 +00:00
uint8 osk_activation ; ///< Mouse gesture to trigger the OSK.
2019-01-10 09:45:38 +00:00
byte starting_colour ; ///< default color scheme for the company to start a new game with
2019-04-04 21:06:38 +00:00
bool show_newgrf_name ; ///< Show the name of the NewGRF in the build vehicle window
2021-01-07 09:17:05 +00:00
bool auto_remove_signals ; ///< automatically remove signals when in the way during rail construction
2021-02-17 14:31:09 +00:00
uint16 refresh_rate ; ///< How often we refresh the screen (time between draw-ticks).
2021-02-28 14:41:03 +00:00
uint16 fast_forward_speed_limit ; ///< Game speed to use when fast-forward is enabled.
2015-08-02 18:37:42 +00:00
bool show_vehicle_route_steps ; ///< when a window related to a specific vehicle is focused, show route steps
2015-11-20 23:55:02 +00:00
bool show_vehicle_list_company_colour ; ///< show the company colour of vehicles which have an owner different to the owner of the vehicle list
2017-08-18 00:49:03 +00:00
bool enable_single_veh_shared_order_gui ; ///< enable showing a single vehicle in the shared order GUI window
2018-03-29 17:52:54 +00:00
bool show_adv_load_mode_features ; ///< enable advanced loading mode features in UI
2018-03-29 19:39:25 +00:00
bool disable_top_veh_list_mass_actions ; ///< disable mass actions buttons for non-group vehicle lists
2018-06-17 03:27:03 +00:00
bool adv_sig_bridge_tun_modes ; ///< Enable advanced modes for signals on bridges/tunnels.
2021-06-17 16:07:18 +00:00
bool sort_track_types_by_speed ; ///< Sorts track types by compatibility first, and speed next, instead of newGRF slot
2018-06-21 22:28:19 +00:00
bool show_depot_sell_gui ; ///< Show go to depot and sell in UI
2019-02-25 23:04:10 +00:00
bool open_vehicle_gui_clone_share ; ///< Open vehicle GUI when share-cloning vehicle from depot GUI
2020-08-03 22:30:05 +00:00
uint8 linkgraph_colours ; ///< linkgraph overlay colours
2021-01-29 18:16:42 +00:00
uint8 vehicle_names ; ///< Vehicle naming scheme
2021-02-26 18:03:00 +00:00
bool shade_trees_on_slopes ; ///< Shade trees on slopes
2021-06-15 01:00:58 +00:00
uint8 station_rating_tooltip_mode ; ///< Station rating tooltip mode
2021-06-15 17:46:12 +00:00
uint8 demolish_confirm_mode ; ///< Demolition confirmation mode
2021-08-04 16:34:50 +00:00
bool dual_pane_train_purchase_window ; ///< Dual pane train purchase window
2008-08-12 20:49:27 +00:00
uint16 console_backlog_timeout ; ///< the minimum amount of time items should be in the console backlog before they will be removed in ~3 seconds granularity.
uint16 console_backlog_length ; ///< the minimum amount of items in the console backlog before items will be removed.
2013-06-09 13:08:52 +00:00
uint8 station_gui_group_order ; ///< the order of grouping cargo entries in the station gui
uint8 station_gui_sort_by ; ///< sort cargo entries in the station gui by station name or amount
uint8 station_gui_sort_order ; ///< the sort order of entries in the station gui - ascending or descending
2015-02-12 20:00:23 +00:00
uint16 network_chat_box_width_pct ; ///< width of the chat box in percent
2008-08-12 12:23:05 +00:00
uint8 network_chat_box_height ; ///< height of the chat box in lines
2010-12-14 15:00:43 +00:00
uint16 network_chat_timeout ; ///< timeout of chat messages in seconds
2009-09-09 15:11:46 +00:00
2010-02-10 17:01:03 +00:00
uint8 developer ; ///< print non-fatal warnings in console (>= 1), copy debug output to console (== 2)
2009-09-09 15:11:46 +00:00
bool show_date_in_logs ; ///< whether to show dates in console logs
2010-11-07 21:46:41 +00:00
bool newgrf_developer_tools ; ///< activate NewGRF developer tools and allow modifying NewGRFs in an existing game
2010-04-03 17:22:24 +00:00
bool ai_developer_tools ; ///< activate AI developer tools
2010-11-07 21:46:41 +00:00
bool scenario_developer ; ///< activate scenario developer: allow modifying NewGRFs in an existing game
2012-11-08 11:20:32 +00:00
uint8 settings_restriction_mode ; ///< selected restriction mode in adv. settings GUI. @see RestrictionMode
2010-07-31 14:40:50 +00:00
bool newgrf_show_old_versions ; ///< whether to show old versions in the NewGRF list
2011-05-03 20:30:26 +00:00
uint8 newgrf_default_palette ; ///< default palette to use for NewGRFs without action 14 palette information
2020-08-13 17:57:42 +00:00
bool console_show_unlisted ; ///< whether to show unlisted console commands
2010-11-07 21:46:41 +00:00
/**
* Returns true when the user has sufficient privileges to edit newgrfs on a running game
* @ return whether the user has sufficient privileges to edit newgrfs in an existing game
*/
bool UserIsAllowedToChangeNewGRFs ( ) const
{
return this - > scenario_developer | | this - > newgrf_developer_tools ;
}
2008-06-05 11:26:38 +00:00
} ;
2012-12-23 21:08:42 +00:00
/** Settings related to sound effects. */
struct SoundSettings {
bool news_ticker ; ///< Play a ticker sound when a news item is published.
2012-12-23 21:09:09 +00:00
bool news_full ; ///< Play sound effects associated to certain news types.
bool new_year ; ///< Play sound on new year, summarising the performance during the last year.
2019-09-29 20:27:32 +00:00
bool confirm ; ///< Play sound effect on successful constructions or other actions.
2012-12-23 21:09:09 +00:00
bool click_beep ; ///< Beep on a random selection of buttons.
bool disaster ; ///< Play disaster and accident sounds.
bool vehicle ; ///< Play vehicle sound effects.
bool ambient ; ///< Play ambient, industry and town sounds.
2012-12-23 21:08:42 +00:00
} ;
2011-03-05 18:00:48 +00:00
/** Settings related to music. */
struct MusicSettings {
byte playlist ; ///< The playlist (number) to play
byte music_vol ; ///< The requested music volume
byte effect_vol ; ///< The requested effects volume
byte custom_1 [ 33 ] ; ///< The order of the first custom playlist
byte custom_2 [ 33 ] ; ///< The order of the second custom playlist
bool playing ; ///< Whether music is playing
bool shuffle ; ///< Whether to shuffle the music
} ;
2008-06-05 11:26:38 +00:00
/** Settings related to currency/unit systems. */
struct LocaleSettings {
2008-05-25 22:36:44 +00:00
byte currency ; ///< currency we currently use
2013-06-29 09:47:18 +00:00
byte units_velocity ; ///< unit system for velocity
byte units_power ; ///< unit system for power
byte units_weight ; ///< unit system for weight
byte units_volume ; ///< unit system for volume
byte units_force ; ///< unit system for force
byte units_height ; ///< unit system for height
2009-04-23 21:05:00 +00:00
char * digit_group_separator ; ///< thousand separator for non-currencies
char * digit_group_separator_currency ; ///< thousand separator for currencies
2009-08-12 01:28:11 +00:00
char * digit_decimal_separator ; ///< decimal separator
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2012-12-23 21:07:12 +00:00
/** Settings related to news */
struct NewsSettings {
uint8 arrival_player ; ///< NewsDisplay of vehicles arriving at new stations of current player
uint8 arrival_other ; ///< NewsDisplay of vehicles arriving at new stations of other players
uint8 accident ; ///< NewsDisplay of accidents that occur
uint8 company_info ; ///< NewsDisplay of general company information
uint8 open ; ///< NewsDisplay on new industry constructions
uint8 close ; ///< NewsDisplay about closing industries
uint8 economy ; ///< NewsDisplay on economical changes
uint8 production_player ; ///< NewsDisplay of production changes of industries affecting current player
uint8 production_other ; ///< NewsDisplay of production changes of industries affecting competitors
uint8 production_nobody ; ///< NewsDisplay of production changes of industries affecting no one
uint8 advice ; ///< NewsDisplay on advice affecting the player's vehicles
uint8 new_vehicles ; ///< NewsDisplay of new vehicles becoming available
uint8 acceptance ; ///< NewsDisplay on changes affecting the acceptance of cargo at stations
uint8 subsidies ; ///< NewsDisplay of changes on subsidies
uint8 general ; ///< NewsDisplay of other topics
} ;
2008-05-29 20:21:28 +00:00
/** All settings related to the network. */
struct NetworkSettings {
2008-05-29 21:36:29 +00:00
uint16 sync_freq ; ///< how often do we check whether we are still in-sync
uint8 frame_freq ; ///< how often do we send commands to the clients
2010-08-19 08:59:36 +00:00
uint16 commands_per_frame ; ///< how many commands may be sent each frame_freq frames?
uint16 max_commands_in_queue ; ///< how many commands may there be in the incoming queue before dropping the connection?
2010-11-30 20:01:26 +00:00
uint16 bytes_per_frame ; ///< how many bytes may, over a long period, be received per frame?
uint16 bytes_per_frame_burst ; ///< how many bytes may, over a short period, be received?
2012-01-07 14:43:45 +00:00
uint16 max_init_time ; ///< maximum amount of time, in game ticks, a client may take to initiate joining
uint16 max_join_time ; ///< maximum amount of time, in game ticks, a client may take to sync up during joining
2012-01-06 21:49:06 +00:00
uint16 max_download_time ; ///< maximum amount of time, in game ticks, a client may take to download the map
uint16 max_password_time ; ///< maximum amount of time, in game ticks, a client may take to enter the password
2012-01-07 14:43:45 +00:00
uint16 max_lag_time ; ///< maximum amount of time, in game ticks, a client may be lagging behind the server
2008-05-29 21:36:29 +00:00
bool pause_on_join ; ///< pause the game when people join
uint16 server_port ; ///< port the server listens on
2010-10-17 17:35:42 +00:00
uint16 server_admin_port ; ///< port the server listens on for the admin network
2010-10-17 17:40:18 +00:00
bool server_admin_chat ; ///< allow private chat for the server to be distributed to the admin network
2008-05-29 21:36:29 +00:00
char server_name [ NETWORK_NAME_LENGTH ] ; ///< name of the server
2010-10-17 17:34:48 +00:00
char server_password [ NETWORK_PASSWORD_LENGTH ] ; ///< password for joining this server
char rcon_password [ NETWORK_PASSWORD_LENGTH ] ; ///< password for rconsole (server side)
2010-10-17 17:31:03 +00:00
char admin_password [ NETWORK_PASSWORD_LENGTH ] ; ///< password for the admin network
2019-08-20 19:42:17 +00:00
char settings_password [ NETWORK_PASSWORD_LENGTH ] ; ///< password for game settings (server side)
2008-05-29 21:36:29 +00:00
bool server_advertise ; ///< advertise the server to the masterserver
2009-04-08 19:39:03 +00:00
char client_name [ NETWORK_CLIENT_NAME_LENGTH ] ; ///< name of the player (as client)
2008-05-29 21:36:29 +00:00
char default_company_pass [ NETWORK_PASSWORD_LENGTH ] ; ///< default password for new companies in encrypted form
char connect_to_ip [ NETWORK_HOSTNAME_LENGTH ] ; ///< default for the "Add server" query
2010-01-21 11:17:40 +00:00
char network_id [ NETWORK_SERVER_ID_LENGTH ] ; ///< network ID for servers
2008-05-29 21:36:29 +00:00
bool autoclean_companies ; ///< automatically remove companies that are not in use
uint8 autoclean_unprotected ; ///< remove passwordless companies after this many months
uint8 autoclean_protected ; ///< remove the password from passworded companies after this many months
2009-03-25 16:30:33 +00:00
uint8 autoclean_novehicles ; ///< remove companies with no vehicles after this many months
2008-05-29 21:36:29 +00:00
uint8 max_companies ; ///< maximum amount of companies
uint8 max_clients ; ///< maximum amount of clients
uint8 max_spectators ; ///< maximum amount of spectators
Year restart_game_year ; ///< year the server restarts
2008-09-30 20:39:50 +00:00
uint8 min_active_clients ; ///< minimum amount of active clients to unpause the game
2008-05-29 21:36:29 +00:00
bool reload_cfg ; ///< reload the config file before restarting
char last_host [ NETWORK_HOSTNAME_LENGTH ] ; ///< IP address of the last joined server
uint16 last_port ; ///< port of the last joined server
2010-02-03 18:42:23 +00:00
bool no_http_content_downloads ; ///< do not do content downloads over HTTP
2008-05-29 20:21:28 +00:00
} ;
2008-05-25 19:17:03 +00:00
/** Settings related to the creation of games. */
struct GameCreationSettings {
uint32 generation_seed ; ///< noise seed for world generation
2018-11-19 15:03:52 +00:00
uint32 generation_unique_id ; ///< random id to differentiate savegames
2008-05-25 19:17:03 +00:00
Year starting_year ; ///< starting date
2019-09-18 18:18:45 +00:00
Year ending_year ; ///< scoring end date
2008-05-25 19:17:03 +00:00
uint8 map_x ; ///< X size of map
uint8 map_y ; ///< Y size of map
byte land_generator ; ///< the landscape generator
byte oil_refinery_limit ; ///< distance oil refineries allowed from map edge
2021-03-24 13:48:12 +00:00
byte snow_line_height ; ///< the configured snow line height (deduced from "snow_coverage")
byte snow_coverage ; ///< the amount of snow coverage on the map
2021-03-20 10:23:22 +00:00
byte rainforest_line_height ; ///< the configured rainforest line height
2021-03-24 15:38:36 +00:00
byte desert_coverage ; ///< the amount of desert coverage on the map
2021-04-10 17:29:36 +00:00
byte climate_threshold_mode ; ///< climate threshold mode
2021-03-24 19:51:41 +00:00
byte heightmap_height ; ///< highest mountain for heightmap (towards what it scales)
2008-05-25 19:17:03 +00:00
byte tgen_smoothness ; ///< how rough is the terrain from 0-3
byte tree_placer ; ///< the tree placer algorithm
byte heightmap_rotation ; ///< rotation director for the heightmap
byte se_flat_world_height ; ///< land height a flat world gets in SE
2008-05-25 22:36:44 +00:00
byte town_name ; ///< the town name generator used for town names
byte landscape ; ///< the landscape we're currently in
2009-01-21 02:31:55 +00:00
byte water_borders ; ///< bitset of the borders that are water
2009-03-12 23:54:20 +00:00
uint16 custom_town_number ; ///< manually entered number of towns
2009-12-19 18:00:38 +00:00
byte variety ; ///< variety level applied to TGP
2021-03-24 22:25:51 +00:00
byte custom_terrain_type ; ///< manually entered height for TGP to aim for
2010-09-20 18:56:35 +00:00
byte custom_sea_level ; ///< manually entered percentage of water in the map
2011-08-20 14:14:17 +00:00
byte min_river_length ; ///< the minimum river length
byte river_route_random ; ///< the amount of randomicity for the route finding
byte amount_of_rivers ; ///< the amount of rivers
2021-03-28 22:45:08 +00:00
bool rivers_top_of_hill ; ///< do rivers require starting near the tops of hills?
uint8 river_tropics_width ; ///< the configured width of tropics around rivers
uint8 lake_size ; ///< how large can lakes get?
bool lakes_allowed_in_deserts ; ///< are lakes allowed in deserts?
2021-03-27 00:13:48 +00:00
uint8 amount_of_rocks ; ///< the amount of rocks
2021-03-28 21:39:56 +00:00
uint8 height_affects_rocks ; ///< the affect that map height has on rocks
2021-06-12 07:56:59 +00:00
uint8 build_public_roads ; ///< build public roads connecting towns
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to construction in-game */
struct ConstructionSettings {
2021-03-24 08:42:54 +00:00
uint8 map_height_limit ; ///< the maximum allowed heightlevel
2008-05-25 19:17:03 +00:00
bool build_on_slopes ; ///< allow building on slopes
bool autoslope ; ///< allow terraforming under things
2011-02-04 15:37:23 +00:00
uint16 max_bridge_length ; ///< maximum length of bridges
2014-09-21 11:27:34 +00:00
byte max_bridge_height ; ///< maximum height of bridges
2011-02-04 15:37:23 +00:00
uint16 max_tunnel_length ; ///< maximum length of tunnels
2012-05-01 15:53:51 +00:00
byte train_signal_side ; ///< show signals on left / driving / right side
2008-05-25 19:17:03 +00:00
bool extra_dynamite ; ///< extra dynamite
bool road_stop_on_town_road ; ///< allow building of drive-through road stops on town owned roads
2009-03-02 22:57:47 +00:00
bool road_stop_on_competitor_road ; ///< allow building of drive-through road stops on roads owned by competitors
2008-05-25 19:17:03 +00:00
uint8 raw_industry_construction ; ///< type of (raw) industry construction (none, "normal", prospecting)
2010-08-28 18:37:49 +00:00
uint8 industry_platform ; ///< the amount of flat land around an industry
2009-01-21 02:31:55 +00:00
bool freeform_edges ; ///< allow terraforming the tiles at the map edges
2009-12-17 16:59:33 +00:00
uint8 extra_tree_placement ; ///< (dis)allow building extra trees in-game
2015-08-21 17:16:15 +00:00
uint8 trees_around_snow_line_range ; ///< range around snowline for mixed and arctic forest.
2015-08-21 20:11:43 +00:00
bool trees_around_snow_line_enabled ; ///< enable mixed and arctic forest around snowline, and no trees above snowline
2010-12-07 21:08:08 +00:00
uint8 command_pause_level ; ///< level/amount of commands that can't be executed while paused
2019-12-05 18:13:35 +00:00
uint16 maximum_signal_evaluations ; ///< maximum number of programmable pre-signals which may be evaluated in one pass
2015-08-25 22:44:28 +00:00
bool enable_build_river ; ///< enable building rivers in-game
2017-07-30 13:27:42 +00:00
bool enable_remove_water ; ///< enable removing sea and rivers in-game
2017-02-05 12:47:34 +00:00
uint8 road_custom_bridge_heads ; ///< allow construction of road custom bridge heads
2017-03-04 13:23:52 +00:00
bool chunnel ; ///< allow construction of tunnels under water
2018-07-03 18:09:10 +00:00
uint8 rail_custom_bridge_heads ; ///< allow construction of rail custom bridge heads
2018-07-24 02:02:18 +00:00
bool allow_grf_objects_under_bridges ; ///< allow all NewGRF objects under bridges
2019-11-19 22:51:45 +00:00
bool allow_stations_under_bridges ; ///< allow NewGRF rail station/waypoint tiles that do not specify clearance under bridges
bool allow_road_stops_under_bridges ; ///< allow road/tram stops under bridges
bool allow_docks_under_bridges ; ///< allow docks under bridges
2018-11-26 18:25:17 +00:00
byte purchase_land_permitted ; ///< whether and how purchasing land is permitted
2020-09-14 22:19:45 +00:00
bool build_object_area_permitted ; ///< whether building objects by area is permitted
2011-01-04 22:50:09 +00:00
uint32 terraform_per_64k_frames ; ///< how many tile heights may, over a long period, be terraformed per 65536 frames?
uint16 terraform_frame_burst ; ///< how many tile heights may, over a short period, be terraformed?
uint32 clear_per_64k_frames ; ///< how many tiles may, over a long period, be cleared per 65536 frames?
uint16 clear_frame_burst ; ///< how many tiles may, over a short period, be cleared?
2012-04-17 19:43:52 +00:00
uint32 tree_per_64k_frames ; ///< how many trees may, over a long period, be planted per 65536 frames?
uint16 tree_frame_burst ; ///< how many trees may, over a short period, be planted?
2018-11-23 18:47:36 +00:00
uint32 purchase_land_per_64k_frames ; ///< how many tiles may, over a long period, be purchased per 65536 frames?
uint16 purchase_land_frame_burst ; ///< how many tiles may, over a short period, be purchased?
2020-09-14 22:06:49 +00:00
uint32 build_object_per_64k_frames ; ///< how many tiles may, over a long period, have objects built on them per 65536 frames?
uint16 build_object_frame_burst ; ///< how many tiles may, over a short period, have objects built on them?
2016-01-25 23:27:08 +00:00
uint8 tree_growth_rate ; ///< tree growth rate
2020-11-21 17:43:55 +00:00
byte old_simulated_wormhole_signals ; ///< moved to company settings: simulate signals in tunnel
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to the AI. */
struct AISettings {
bool ai_in_multiplayer ; ///< so we allow AIs in multiplayer
bool ai_disable_veh_train ; ///< disable types for AI
bool ai_disable_veh_roadveh ; ///< disable types for AI
bool ai_disable_veh_aircraft ; ///< disable types for AI
bool ai_disable_veh_ship ; ///< disable types for AI
2011-12-01 12:04:22 +00:00
} ;
/** Settings related to scripts. */
struct ScriptSettings {
2012-12-05 19:36:04 +00:00
uint8 settings_profile ; ///< difficulty profile to set initial settings of scripts, esp. random AIs
2011-12-01 12:04:22 +00:00
uint32 script_max_opcode_till_suspend ; ///< max opcode calls till scripts will suspend
2019-04-15 17:49:30 +00:00
uint32 script_max_memory_megabytes ; ///< limit on memory a single script instance may have allocated
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to the new pathfinder. */
struct NPFSettings {
2008-01-07 00:19:09 +00:00
/**
* The maximum amount of search nodes a single NPF run should take . This
* limit should make sure performance stays at acceptable levels at the cost
2008-05-25 19:17:03 +00:00
* of not being perfect anymore .
2008-01-07 00:19:09 +00:00
*/
uint32 npf_max_search_nodes ;
2009-12-13 10:48:44 +00:00
uint32 maximum_go_to_depot_penalty ; ///< What is the maximum penalty that may be endured for going to a depot
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
uint32 npf_rail_firstred_penalty ; ///< the penalty for when the first signal is red (and it is not an exit or combo signal)
uint32 npf_rail_firstred_exit_penalty ; ///< the penalty for when the first signal is red (and it is an exit or combo signal)
uint32 npf_rail_lastred_penalty ; ///< the penalty for when the last signal is red
uint32 npf_rail_station_penalty ; ///< the penalty for station tiles
uint32 npf_rail_slope_penalty ; ///< the penalty for sloping upwards
uint32 npf_rail_curve_penalty ; ///< the penalty for curves
uint32 npf_rail_depot_reverse_penalty ; ///< the penalty for reversing in depots
2008-08-02 22:52:36 +00:00
uint32 npf_rail_pbs_cross_penalty ; ///< the penalty for crossing a reserved rail track
uint32 npf_rail_pbs_signal_back_penalty ; ///< the penalty for passing a pbs signal from the backside
2008-05-25 19:17:03 +00:00
uint32 npf_buoy_penalty ; ///< the penalty for going over (through) a buoy
uint32 npf_water_curve_penalty ; ///< the penalty for curves
uint32 npf_road_curve_penalty ; ///< the penalty for curves
uint32 npf_crossing_penalty ; ///< the penalty for level crossings
uint32 npf_road_drive_through_penalty ; ///< the penalty for going through a drive-through road stop
2009-12-04 20:52:19 +00:00
uint32 npf_road_dt_occupied_penalty ; ///< the penalty multiplied by the fill percentage of a drive-through road stop
uint32 npf_road_bay_occupied_penalty ; ///< the penalty multiplied by the fill percentage of a road bay
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to the yet another pathfinder. */
struct YAPFSettings {
bool disable_node_optimization ; ///< whether to use exit-dir instead of trackdir in node key
uint32 max_search_nodes ; ///< stop path-finding when this number of nodes visited
2009-12-13 10:48:44 +00:00
uint32 maximum_go_to_depot_penalty ; ///< What is the maximum penalty that may be endured for going to a depot
2008-05-25 19:17:03 +00:00
bool ship_use_yapf ; ///< use YAPF for ships
bool road_use_yapf ; ///< use YAPF for road
bool rail_use_yapf ; ///< use YAPF for rail
uint32 road_slope_penalty ; ///< penalty for up-hill slope
uint32 road_curve_penalty ; ///< penalty for curves
uint32 road_crossing_penalty ; ///< penalty for level crossing
uint32 road_stop_penalty ; ///< penalty for going through a drive-through road stop
2009-12-04 20:52:19 +00:00
uint32 road_stop_occupied_penalty ; ///< penalty multiplied by the fill percentage of a drive-through road stop
uint32 road_stop_bay_occupied_penalty ; ///< penalty multiplied by the fill percentage of a road bay
2008-05-25 19:17:03 +00:00
bool rail_firstred_twoway_eol ; ///< treat first red two-way signal as dead end
uint32 rail_firstred_penalty ; ///< penalty for first red signal
uint32 rail_firstred_exit_penalty ; ///< penalty for first red exit signal
uint32 rail_lastred_penalty ; ///< penalty for last red signal
uint32 rail_lastred_exit_penalty ; ///< penalty for last red exit signal
uint32 rail_station_penalty ; ///< penalty for non-target station tile
uint32 rail_slope_penalty ; ///< penalty for up-hill slope
uint32 rail_curve45_penalty ; ///< penalty for curve
uint32 rail_curve90_penalty ; ///< penalty for 90-deg curve
uint32 rail_depot_reverse_penalty ; ///< penalty for reversing in the depot
uint32 rail_crossing_penalty ; ///< penalty for level crossing
uint32 rail_look_ahead_max_signals ; ///< max. number of signals taken into consideration in look-ahead load balancer
int32 rail_look_ahead_signal_p0 ; ///< constant in polynomial penalty function
int32 rail_look_ahead_signal_p1 ; ///< constant in polynomial penalty function
int32 rail_look_ahead_signal_p2 ; ///< constant in polynomial penalty function
2008-08-02 22:51:07 +00:00
uint32 rail_pbs_cross_penalty ; ///< penalty for crossing a reserved tile
2008-08-02 22:51:38 +00:00
uint32 rail_pbs_station_penalty ; ///< penalty for crossing a reserved station tile
2008-08-02 22:51:07 +00:00
uint32 rail_pbs_signal_back_penalty ; ///< penalty for passing a pbs signal from the backside
2008-08-02 22:51:23 +00:00
uint32 rail_doubleslip_penalty ; ///< penalty for passing a double slip switch
2008-05-25 19:17:03 +00:00
uint32 rail_longer_platform_penalty ; ///< penalty for longer station platform than train
uint32 rail_longer_platform_per_tile_penalty ; ///< penalty for longer station platform than train (per tile)
uint32 rail_shorter_platform_penalty ; ///< penalty for shorter station platform than train
uint32 rail_shorter_platform_per_tile_penalty ; ///< penalty for shorter station platform than train (per tile)
2019-02-14 23:12:26 +00:00
uint32 ship_curve45_penalty ; ///< penalty for 45-deg curve for ships
uint32 ship_curve90_penalty ; ///< penalty for 90-deg curve for ships
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to all pathfinders. */
struct PathfinderSettings {
uint8 pathfinder_for_trains ; ///< the pathfinder to use for trains
uint8 pathfinder_for_roadvehs ; ///< the pathfinder to use for roadvehicles
uint8 pathfinder_for_ships ; ///< the pathfinder to use for ships
bool new_pathfinding_all ; ///< use the newest pathfinding algorithm for all
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
bool roadveh_queue ; ///< buggy road vehicle queueing
bool forbid_90_deg ; ///< forbid trains to make 90 deg turns
2021-06-09 19:43:57 +00:00
bool back_of_one_way_pbs_waiting_point ; ///< whether the back of one-way PBS signals is a safe waiting point
2020-07-02 16:47:26 +00:00
uint8 reroute_rv_on_layout_change ; ///< whether to re-route road vehicles when the layout changes
2008-01-07 00:19:09 +00:00
2011-02-04 16:40:38 +00:00
bool reverse_at_signals ; ///< whether to reverse at signals at all
2008-05-25 19:17:03 +00:00
byte wait_oneway_signal ; ///< waitingtime in days before a oneway signal
byte wait_twoway_signal ; ///< waitingtime in days before a twoway signal
2008-01-07 00:19:09 +00:00
2008-08-02 22:53:51 +00:00
bool reserve_paths ; ///< always reserve paths regardless of signal type.
byte wait_for_pbs_path ; ///< how long to wait for a path reservation.
byte path_backoff_interval ; ///< ticks between checks for a free path.
2008-05-25 19:17:03 +00:00
NPFSettings npf ; ///< pathfinder settings for the new pathfinder
YAPFSettings yapf ; ///< pathfinder settings for the yet another pathfinder
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to orders. */
struct OrderSettings {
bool improved_load ; ///< improved loading algorithm
bool gradual_loading ; ///< load vehicles gradually
bool selectgoods ; ///< only send the goods to station if a train has been there
2013-01-08 22:46:42 +00:00
bool no_servicing_if_no_breakdowns ; ///< don't send vehicles to depot when breakdowns are disabled
2008-05-25 19:17:03 +00:00
bool serviceathelipad ; ///< service helicopters at helipads automatically (no need to send to depot)
2019-02-17 19:56:49 +00:00
bool nonstop_only ; ///< allow non-stop orders only
2015-10-25 21:37:27 +00:00
uint8 old_occupancy_smoothness ; ///< moved to company settings: percentage smoothness of occupancy measurement changes
2016-05-07 00:15:46 +00:00
bool old_timetable_separation ; ///< moved to company settings: whether to perform automatic separation based on timetable
2015-10-25 12:47:23 +00:00
uint8 old_timetable_separation_rate ; ///< moved to company settings: percentage of timetable separation change to apply
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to vehicles. */
struct VehicleSettings {
2011-02-04 15:40:35 +00:00
uint8 max_train_length ; ///< maximum length for trains
2010-08-05 12:09:08 +00:00
uint8 smoke_amount ; ///< amount of smoke/sparks locomotives produce
2009-01-23 20:53:43 +00:00
uint8 train_acceleration_model ; ///< realistic acceleration for trains
2021-01-25 02:33:14 +00:00
uint8 train_braking_model ; ///< braking model for trains
2010-03-06 12:56:57 +00:00
uint8 roadveh_acceleration_model ; ///< realistic acceleration for road vehicles
2009-12-31 10:41:03 +00:00
uint8 train_slope_steepness ; ///< Steepness of hills for trains when using realistic acceleration
2010-03-06 12:58:33 +00:00
uint8 roadveh_slope_steepness ; ///< Steepness of hills for road vehicles when using realistic acceleration
2008-05-25 19:17:03 +00:00
bool wagon_speed_limits ; ///< enable wagon speed limits
2021-06-27 02:47:18 +00:00
bool train_speed_adaptation ; ///< Faster trains slow down when behind slower trains
2021-06-17 13:30:06 +00:00
bool slow_road_vehicles_in_curves ; ///< Road vehicles slow down in curves.
2008-05-25 19:17:03 +00:00
bool disable_elrails ; ///< when true, the elrails are disabled
2008-09-30 20:39:50 +00:00
UnitID max_trains ; ///< max trains in game per company
UnitID max_roadveh ; ///< max trucks in game per company
UnitID max_aircraft ; ///< max planes in game per company
UnitID max_ships ; ///< max ships in game per company
2008-05-25 19:17:03 +00:00
uint8 plane_speed ; ///< divisor for speed of aircraft
uint8 freight_trains ; ///< value to multiply the weight of cargo by
bool dynamic_engines ; ///< enable dynamic allocation of engine data
bool never_expire_vehicles ; ///< never expire vehicles
2020-07-01 19:36:40 +00:00
Year no_expire_vehicles_after ; ///< do not expire vehicles ater this year
2021-03-17 18:51:19 +00:00
Year no_introduce_vehicles_after ; ///< do not introduce vehicles ater this year
2008-05-25 19:17:03 +00:00
byte extend_vehicle_life ; ///< extend vehicle life by this many years
2008-05-25 22:36:44 +00:00
byte road_side ; ///< the side of the road vehicles drive on
2010-01-28 22:34:14 +00:00
uint8 plane_crashes ; ///< number of plane crashes, 0 = none, 1 = reduced, 2 = normal
2015-08-02 16:49:25 +00:00
bool adjacent_crossings ; ///< enable closing of adjacent level crossings
2017-05-07 18:33:59 +00:00
bool safer_crossings ; ///< enable safer level crossings
2016-01-18 18:27:51 +00:00
bool improved_breakdowns ; ///< different types, chances and severities of breakdowns
2015-08-04 22:38:31 +00:00
bool pay_for_repair ; ///< pay for repairing vehicle
uint8 repair_cost ; ///< cost of repairing vehicle
2016-01-19 22:37:23 +00:00
bool ship_collision_avoidance ; ///< ships try to avoid colliding with each other
2016-02-25 22:08:27 +00:00
bool no_train_crash_other_company ; ///< trains cannot crash with trains from other companies
2018-09-11 05:08:02 +00:00
bool flip_direction_all_trains ; ///< enable flipping direction in depot for all train engine types
2019-04-27 12:56:49 +00:00
bool roadveh_articulated_overtaking ; ///< enable articulated road vehicles overtaking other vehicles
2020-09-26 16:56:58 +00:00
bool drive_through_train_depot ; ///< enable drive-through train depot emulation
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2008-05-25 19:17:03 +00:00
/** Settings related to the economy. */
struct EconomySettings {
bool inflation ; ///< disable inflation
2021-01-30 19:59:00 +00:00
bool inflation_fixed_dates ; ///< whether inflation is applied between fixed dates
2008-05-25 19:17:03 +00:00
bool bribe ; ///< enable bribing the local authority
2020-12-14 22:35:07 +00:00
EconomyType type ; ///< economy type (original/smooth/frozen)
2008-05-25 19:17:03 +00:00
bool allow_shares ; ///< allow the buying/selling of shares
2019-10-18 00:47:29 +00:00
uint8 min_years_for_shares ; ///< minimum age of a company for it to trade shares
2010-01-03 21:29:20 +00:00
uint8 feeder_payment_share ; ///< percentage of leg payment to virtually pay in feeder systems
2008-05-25 19:17:03 +00:00
byte dist_local_authority ; ///< distance for town local authority, default 20
bool exclusive_rights ; ///< allow buying exclusive rights
2011-11-23 16:10:18 +00:00
bool fund_buildings ; ///< allow funding new buildings
2011-02-05 13:46:09 +00:00
bool fund_roads ; ///< allow funding local road reconstruction
2008-09-30 20:39:50 +00:00
bool give_money ; ///< allow giving other companies money
2013-01-08 22:46:42 +00:00
bool mod_road_rebuild ; ///< roadworks remove unnecessary RoadBits
2008-05-25 19:17:03 +00:00
bool multiple_industry_per_town ; ///< allow many industries of the same type per town
2017-08-20 10:14:43 +00:00
int8 town_growth_rate ; ///< town growth rate
2017-08-26 00:15:16 +00:00
uint8 town_growth_cargo_transported ; ///< percentage of town growth rate which depends on proportion of transported cargo in the last month
2021-03-25 12:17:59 +00:00
bool town_zone_calc_mode ; ///< calc mode for town zones
2021-04-10 05:45:16 +00:00
uint16 town_zone_0_mult ; ///< multiplier for the size of town zone 0
uint16 town_zone_1_mult ; ///< multiplier for the size of town zone 1
uint16 town_zone_2_mult ; ///< multiplier for the size of town zone 2
uint16 town_zone_3_mult ; ///< multiplier for the size of town zone 3
uint16 town_zone_4_mult ; ///< multiplier for the size of town zone 4
uint16 city_zone_0_mult ; ///< multiplier for the size of city zone 0
uint16 city_zone_1_mult ; ///< multiplier for the size of city zone 1
uint16 city_zone_2_mult ; ///< multiplier for the size of city zone 2
uint16 city_zone_3_mult ; ///< multiplier for the size of city zone 3
uint16 city_zone_4_mult ; ///< multiplier for the size of city zone 4
2008-05-25 19:17:03 +00:00
uint8 larger_towns ; ///< the number of cities to build. These start off larger and grow twice as fast
uint8 initial_city_size ; ///< multiplier for the initial size of the cities compared to towns
2019-04-21 21:56:35 +00:00
TownLayout town_layout ; ///< select town layout, @see TownLayout
2018-11-07 18:06:39 +00:00
TownCargoGenMode town_cargogen_mode ; ///< algorithm for generating cargo from houses, @see TownCargoGenMode
2009-02-04 20:17:25 +00:00
bool allow_town_roads ; ///< towns are allowed to build roads (always allowed when generating world / in SE)
2017-02-28 23:36:46 +00:00
uint16 town_min_distance ; ///< minimum distance between towns
2021-06-19 01:48:05 +00:00
uint8 max_town_heightlevel ; ///< maximum height level for towns
2019-04-21 21:39:32 +00:00
TownFounding found_town ; ///< town founding.
2008-05-25 19:17:03 +00:00
bool station_noise_level ; ///< build new airports when the town noise level is still within accepted limits
uint16 town_noise_population [ 3 ] ; ///< population to base decision on noise evaluation (@see town_council_tolerance)
2015-08-06 21:24:24 +00:00
bool infrastructure_sharing [ 4 ] ; ///< enable infrastructure sharing for rail/road/water/air
uint sharing_fee [ 4 ] ; ///< fees for infrastructure sharing for rail/road/water/air
bool sharing_payment_in_debt ; ///< allow fee payment for companies with more loan than money (switch off to prevent MP exploits)
2010-07-02 16:34:07 +00:00
bool allow_town_level_crossings ; ///< towns are allowed to build level crossings
2016-11-25 23:24:41 +00:00
int8 old_town_cargo_factor ; ///< old power-of-two multiplier for town (passenger, mail) generation. May be negative.
int16 town_cargo_scale_factor ; ///< scaled power-of-two multiplier for town (passenger, mail) generation. May be negative.
2020-12-21 20:47:44 +00:00
int16 industry_cargo_scale_factor ; ///< scaled power-of-two multiplier for primary industry generation. May be negative.
2011-12-03 23:40:46 +00:00
bool infrastructure_maintenance ; ///< enable monthly maintenance fee for owner infrastructure
2015-08-09 10:23:07 +00:00
uint8 day_length_factor ; ///< factor which the length of day is multiplied
2016-09-19 22:07:09 +00:00
uint16 random_road_reconstruction ; ///< chance out of 1000 per tile loop for towns to start random road re-construction
2008-05-25 19:17:03 +00:00
} ;
2008-01-07 00:19:09 +00:00
2013-06-09 12:56:35 +00:00
struct LinkGraphSettings {
uint16 recalc_time ; ///< time (in days) for recalculating each link graph component.
uint16 recalc_interval ; ///< time (in days) between subsequent checks for link graphs to be calculated.
2016-01-29 00:26:47 +00:00
bool recalc_not_scaled_by_daylength ; ///< whether the time should be in daylength-scaled days (false) or unscaled days (true)
2019-04-29 17:36:51 +00:00
DistributionType distribution_pax ; ///< distribution type for passengers
DistributionType distribution_mail ; ///< distribution type for mail
DistributionType distribution_armoured ; ///< distribution type for armoured cargo class
DistributionType distribution_default ; ///< distribution type for all other goods
2019-04-30 22:11:11 +00:00
DistributionType distribution_per_cargo [ NUM_CARGO ] ; ///< per cargo distribution types
2013-06-09 12:56:35 +00:00
uint8 accuracy ; ///< accuracy when calculating things on the link graph. low accuracy => low running time
uint8 demand_size ; ///< influence of supply ("station size") on the demand function
uint8 demand_distance ; ///< influence of distance between stations on the demand function
uint8 short_path_saturation ; ///< percentage up to which short paths are saturated before saturating most capacious paths
inline DistributionType GetDistributionType ( CargoID cargo ) const {
2019-04-30 22:11:11 +00:00
if ( this - > distribution_per_cargo [ cargo ] ! = DT_PER_CARGO_DEFAULT ) return this - > distribution_per_cargo [ cargo ] ;
2013-06-09 12:56:35 +00:00
if ( IsCargoInClass ( cargo , CC_PASSENGERS ) ) return this - > distribution_pax ;
if ( IsCargoInClass ( cargo , CC_MAIL ) ) return this - > distribution_mail ;
if ( IsCargoInClass ( cargo , CC_ARMOURED ) ) return this - > distribution_armoured ;
return this - > distribution_default ;
}
} ;
2008-05-25 19:17:03 +00:00
/** Settings related to stations. */
struct StationSettings {
bool modified_catchment ; ///< different-size catchment areas
2019-03-08 18:30:44 +00:00
bool serve_neutral_industries ; ///< company stations can serve industries with attached neutral stations
2008-05-25 19:17:03 +00:00
bool adjacent_stations ; ///< allow stations to be built directly adjacent to other stations
2009-01-08 16:35:45 +00:00
bool distant_join_stations ; ///< allow to join non-adjacent stations
2009-06-21 13:26:30 +00:00
bool never_expire_airports ; ///< never expire airports
2008-05-25 19:17:03 +00:00
byte station_spread ; ///< amount a station may spread
2016-11-20 01:49:10 +00:00
byte catchment_increase ; ///< amount by which station catchment is increased
2020-06-07 14:11:44 +00:00
bool cargo_class_rating_wait_time ; ///< station rating tolerance to time since last cargo pickup depends on cargo class
bool station_size_rating_cargo_amount ; ///< station rating tolerance to waiting cargo amount depends on station size
2008-05-25 19:17:03 +00:00
} ;
2008-04-29 21:31:29 +00:00
2009-05-26 21:59:49 +00:00
/** Default settings for vehicles. */
struct VehicleDefaultSettings {
bool servint_ispercent ; ///< service intervals are in percents
uint16 servint_trains ; ///< service interval for trains
uint16 servint_roadveh ; ///< service interval for road vehicles
uint16 servint_aircraft ; ///< service interval for aircraft
uint16 servint_ships ; ///< service interval for ships
2015-09-03 22:27:26 +00:00
bool auto_timetable_by_default ; ///< use automatic timetables by default
2016-05-07 00:15:46 +00:00
bool auto_separation_by_default ; ///< use automatic timetable separation by default
2009-05-26 21:59:49 +00:00
} ;
2009-05-15 23:55:06 +00:00
/** Settings that can be set per company. */
struct CompanySettings {
bool engine_renew ; ///< is autorenew enabled
int16 engine_renew_months ; ///< months before/after the maximum vehicle age a vehicle should be renewed
uint32 engine_renew_money ; ///< minimum amount of money before autorenew is used
bool renew_keep_length ; ///< sell some wagons if after autoreplace the train is longer than before
2009-05-26 21:59:49 +00:00
VehicleDefaultSettings vehicle ; ///< default settings for vehicles
2015-10-25 21:37:27 +00:00
uint8 order_occupancy_smoothness ; ///< percentage smoothness of occupancy measurement changes
2015-10-25 12:47:23 +00:00
uint8 auto_timetable_separation_rate ; ///< percentage of auto timetable separation change to apply
2016-02-13 16:51:19 +00:00
bool infra_others_buy_in_depot [ 4 ] ; ///< other companies can buy/autorenew in this companies depots (where infra sharing enabled)
2016-05-06 22:16:17 +00:00
uint16 timetable_autofill_rounding ; ///< round up timetable times to be a multiple of this number of ticks
2019-02-26 01:05:29 +00:00
bool advance_order_on_clone ; ///< when cloning a vehicle or copying/sharing an order list, advance the current order to a suitable point
2020-10-12 17:11:14 +00:00
bool copy_clone_add_to_group ; ///< whether to add cloned vehicles to the source vehicle's group, when cloning a vehicle without sharing orders
2020-11-21 17:43:55 +00:00
byte simulated_wormhole_signals ; ///< tunnel/bridge signal simulation spacing
2009-05-15 23:55:06 +00:00
} ;
2019-08-28 18:10:34 +00:00
/** Debug settings. */
struct DebugSettings {
uint32 chicken_bits ; ///< chicken bits
} ;
2020-08-03 17:32:27 +00:00
/** Scenario editor settings. */
struct ScenarioSettings {
2020-08-03 17:46:52 +00:00
bool multiple_buildings ; ///< allow manually adding more than one church/stadium
2020-08-03 17:57:55 +00:00
bool house_ignore_dates ; ///< allow manually adding houses regardless of date restrictions
2020-08-03 18:37:50 +00:00
uint8 house_ignore_zones ; ///< allow manually adding houses regardless of zone restrictions
2020-08-03 17:57:55 +00:00
bool house_ignore_grf ; ///< allow manually adding houses regardless of GRF restrictions
2020-08-03 17:32:27 +00:00
} ;
2008-05-29 15:13:28 +00:00
/** All settings together for the game. */
struct GameSettings {
2008-05-25 22:36:44 +00:00
DifficultySettings difficulty ; ///< settings related to the difficulty
2008-05-25 19:17:03 +00:00
GameCreationSettings game_creation ; ///< settings used during the creation of a game (map)
ConstructionSettings construction ; ///< construction of things in-game
AISettings ai ; ///< what may the AI do?
2011-12-01 12:04:22 +00:00
ScriptSettings script ; ///< settings for scripts
2009-01-12 17:11:45 +00:00
class AIConfig * ai_config [ MAX_COMPANIES ] ; ///< settings per company
2011-12-19 20:55:56 +00:00
class GameConfig * game_config ; ///< settings for gamescript
2008-05-25 19:17:03 +00:00
PathfinderSettings pf ; ///< settings for all pathfinders
OrderSettings order ; ///< settings related to orders
VehicleSettings vehicle ; ///< options for vehicles
EconomySettings economy ; ///< settings to change the economy
2013-06-09 12:56:35 +00:00
LinkGraphSettings linkgraph ; ///< settings for link graph calculations
2008-05-25 19:17:03 +00:00
StationSettings station ; ///< settings related to station management
2008-06-05 11:26:38 +00:00
LocaleSettings locale ; ///< settings related to used currency/unit system in the current game
2019-08-28 18:10:34 +00:00
DebugSettings debug ; ///< debug settings
2020-06-23 20:05:21 +00:00
TimeSettings game_time ; ///< time display settings.
2008-01-07 00:19:09 +00:00
} ;
2008-05-29 15:13:28 +00:00
/** All settings that are only important for the local client. */
struct ClientSettings {
GUISettings gui ; ///< settings related to the GUI
2008-05-29 20:21:28 +00:00
NetworkSettings network ; ///< settings related to the network
2009-05-15 23:55:06 +00:00
CompanySettings company ; ///< default values for per-company settings
2012-12-23 21:08:42 +00:00
SoundSettings sound ; ///< sound effect settings
2011-03-05 18:00:48 +00:00
MusicSettings music ; ///< settings related to music/sound
2012-12-23 21:07:12 +00:00
NewsSettings news_display ; ///< news display settings.
2020-08-03 17:32:27 +00:00
ScenarioSettings scenario ; ///< scenario editor settings
2008-05-29 15:13:28 +00:00
} ;
/** The current settings for this game. */
extern ClientSettings _settings_client ;
/** The current settings for this game. */
extern GameSettings _settings_game ;
2008-01-07 00:19:09 +00:00
2008-05-29 15:13:28 +00:00
/** The settings values that are used for new games and/or modified in config file. */
extern GameSettings _settings_newgame ;
2008-01-07 00:19:09 +00:00
2020-06-23 20:05:21 +00:00
/** The effective settings that are used for time display. */
extern TimeSettings _settings_time ;
2011-07-03 10:59:25 +00:00
/** Old vehicle settings, which were game settings before, and are company settings now. (Needed for savegame conversion) */
extern VehicleDefaultSettings _old_vds ;
2011-01-02 00:34:21 +00:00
/**
* Get the settings - object applicable for the current situation : the newgame settings
* when we ' re in the main menu and otherwise the settings of the current game .
*/
static inline GameSettings & GetGameSettings ( )
{
return ( _game_mode = = GM_MENU ) ? _settings_newgame : _settings_game ;
}
2008-01-07 00:19:09 +00:00
# endif /* SETTINGS_TYPE_H */