Prototype/UtilityConstants: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(0.17.47)
(Removed old prototype docs)
Tag: Replaced
 
(21 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Basics ==
<div class="stub"><p>'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/prototypes/UtilityConstants.html https://lua-api.factorio.com/latest/prototypes/UtilityConstants.html]
Prototype type: '''utility-constants'''


Constants used by the game that are not specific to certain prototypes. See [https://github.com/wube/factorio-data/blob/master/core/prototypes/utility-constants.lua utility-constants.lua] for the values used by the base game.
</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>
 
== General mandatory properties ==
 
=== type ===
'''Type''': [[Types/string]]
 
Must be "utility-constants".
 
=== name ===
'''Type''': [[Types/string]]
 
The base uses <code>"default"</code> and only one instance of UtilityConstants can be defined, so unless the base game definition is completely removed, <code>name</code> will have to be <code>"default"</code>.
 
== The constants ==
Every property is mandatory if not listed otherwise.
 
* "entity_button_background_color" - [[Types/Color]]
* "building_buildable_too_far_tint" - [[Types/Color]]
* "building_buildable_tint" - [[Types/Color]]
* "building_not_buildable_tint" - [[Types/Color]]
* "building_ignorable_tint" - [[Types/Color]]
* "building_no_tint" - [[Types/Color]]
* "ghost_tint" - [[Types/Color]]
* "turret_range_visualization_color" - [[Types/Color]]
* "capsule_range_visualization_color" - [[Types/Color]]
** "artillery_range_visualization_color" - [[Types/Color]]
* "chart" - [[Types/table]] - Table with the following key/value pairs. Note: Chart = map + minimap.
** "electric_lines_color" - [[Types/Color]]
** "electric_lines_color_switch_enabled" - [[Types/Color]]
** "electric_lines_color_switch_disabled" - [[Types/Color]]
** "electric_power_pole_color" - [[Types/Color]]
** "switch_color" - [[Types/Color]]
** "electric_line_width" - [[Types/double]]
** "electric_line_minimum_absolute_width" - [[Types/double]]
** "turret_range_color" - [[Types/Color]]
** "artillery_range_color" - [[Types/Color]]
** "default_friendly_color" - [[Types/Color]]
** "default_enemy_color" - [[Types/Color]]
** "rail_color" - [[Types/Color]]
** "vehicle_outer_color" - [[Types/Color]]
** "vehicle_outer_color_selected" - [[Types/Color]]
** "vehicle_inner_color" - [[Types/Color]]
** "vehicle_cargo_wagon_color" - [[Types/Color]]
** "vehicle_fluid_wagon_color" - [[Types/Color]]
** "vehicle_wagon_connection_color" - [[Types/Color]]
** "resource_outline_selection_color" - [[Types/Color]]
** "chart_train_stop_disabled_text_color" - [[Types/Color]]
** "red_signal_color" - [[Types/Color]]
** "green_signal_color" - [[Types/Color]]
** "blue_signal_color" - [[Types/Color]]
** "yellow_signal_color" - [[Types/Color]]
** "default_friendly_color_by_type" - [[Types/table]] (array) of [[Types/string]] to [[Types/Color]] - Optional. The strings are entity types.
** "default_color_by_type" - [[Types/table]] (array) of [[Types/string]] to [[Types/Color]] - Optional. The strings are entity types.
** "explosion_visualization_duration" - [[Types/uint32]]
** "train_path_color" - [[Types/Color]]
** "train_preview_path_outline_color" - [[Types/Color]]
** "train_current_path_outline_color" - [[Types/Color]]
** "custom_tag_scale" - [[Types/float]] - Optional. Default 0.6
** "custom_tag_selected_overlay_tint" - [[Types/Color]]
* "default_player_force_color" - [[Types/Color]]
* "default_enemy_force_color" - [[Types/Color]]
* "default_other_force_color" - [[Types/Color]]
* "deconstruct_mark_tint" - [[Types/Color]]
* "zoom_to_world_can_use_nightvision" - [[Types/bool]]
* "zoom_to_world_darkness_multiplier" - [[Types/float]]
* "zoom_to_world_effect_strength" - [[Types/float]]
* "max_terrain_building_size" - [[Types/uint8]]
* "enabled_recipe_slot_tint" - [[Types/Color]]
* "disabled_recipe_slot_tint" - [[Types/Color]]
* "forced_enabled_recipe_slot_tint" - [[Types/Color]]
* "rail_segment_colors" - [[Types/table]] (array) of [[Types/Color]]
* "player_colors" - [[Types/table]] (array) of [[Types/table]]s with the following key/value pairs. The table with name = "default" must exist and be the first member of the array.
** name - [[Types/string]]
** player_color - [[Types/Color]]
** chat_color - [[Types/Color]]
* "server_command_console_chat_color" - [[Types/Color]]
* "script_command_console_chat_color" - [[Types/Color]]
* "default_alert_icon_scale" - [[Types/float]]
* "default_alert_icon_shift_by_type" - [[Types/table]] (array) of [[Types/string]] to [[Types/vector]] - Optional.
* "default_alert_icon_scale_by_type" - [[Types/table]] (array) of [[Types/string]] to [[Types/float]] - Optional.
* "item_outline_color" - [[Types/Color]]
* "item_outline_radius" - [[Types/float]]
* "item_outline_inset" - [[Types/float]]
* "item_outline_sharpness" - [[Types/float]]
* "filter_outline_color" - [[Types/Color]]
* "icon_shadow_radius" - [[Types/float]]
* "icon_shadow_inset" - [[Types/float]]
* "icon_shadow_sharpness" - [[Types/float]]
* "icon_shadow_color" - [[Types/Color]]
* "clipboard_history_size" - [[Types/uint32]]
* "recipe_step_limit" - [[Types/uint32]]
* "manual_rail_building_reach_modifier" - [[Types/double]]
* "train_temporary_stop_wait_time" - [[Types/uint32]]
* "train_time_wait_condition_default" - [[Types/uint32]]
* "train_inactivity_wait_condition_default" - [[Types/uint32]]
* "default_trigger_target_mask_by_type" - [[Types/table]] (array) of [[Types/string]] to [[Types/TriggerTargetMask]] - Optional. The strings are entity types.
* "bonus_gui_ordering" - [[Types/table]] - Table with the following key/value pairs. Note that the base game uses more entries here [https://github.com/wube/factorio-data/blob/master/base/prototypes/categories/ammo-category.lua#L72-L76 that are applied via the ammo categories].
** "artillery_range" - [[Types/Order]]
** "worker_robots" - [[Types/Order]]
** "character" - [[Types/Order]]
** "follower_robots" - [[Types/Order]]
** "research_speed" - [[Types/Order]]
** "inserter" - [[Types/Order]]
** "stack_inserter" - [[Types/Order]]
** "turret_attack" - [[Types/Order]]
** "mining_productivity" - [[Types/Order]]
** "train_braking_force" - [[Types/Order]]
* "train_path_finding" - [[Types/table]] - Table with the following key/value pairs.
** "train_stop_penalty" - [[Types/uint32]]
** "stopped_manually_controlled_train_penalty" - [[Types/uint32]]
** "stopped_manually_controlled_train_without_passenger_penalty" - [[Types/uint32]]
** "signal_reserved_by_circuit_network_penalty" - [[Types/uint32]]
** "train_in_station_penalty" - [[Types/uint32]]
** "train_in_station_with_no_other_valid_stops_in_schedule" - [[Types/uint32]]
** "train_arriving_to_station_penalty" - [[Types/uint32]]
** "train_arriving_to_signal_penalty" - [[Types/uint32]]
** "train_waiting_at_signal_penalty" - [[Types/uint32]]
** "train_waiting_at_signal_tick_multiplier_penalty" - [[Types/float]] - Most be >= 0.
** "train_with_no_path_penalty" - [[Types/uint32]]
* "map_editor" - [[Types/table]] - Table with the following key/value pairs.
** "clone_editor_copy_source_color" - [[Types/Color]]
** "clone_editor_copy_destination_allowed_color" - [[Types/Color]]
** "clone_editor_copy_destination_not_allowed_color" - [[Types/Color]]
** "script_editor_select_area_color" - [[Types/Color]]
** "script_editor_drag_area_color" - [[Types/Color]]
** "force_editor_select_area_color" - [[Types/Color]]
** "cliff_editor_remove_cliffs_color" - [[Types/Color]]
** "tile_editor_selection_preview_tint" - [[Types/Color]]
** "decorative_editor_selection_preview_tint" - [[Types/Color]]
** "tile_editor_selection_preview_radius" - [[Types/uint8]]
** "decorative_editor_selection_preview_radius" - [[Types/uint8]]

Latest revision as of 14:33, 25 October 2024

The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/UtilityConstants.html

This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.