factorio-types 1.2.58 → 1.2.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,11 +2,12 @@
2
2
  // Factorio API reference https://lua-api.factorio.com/latest/index.html
3
3
  // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
4
4
  // Definition source https://github.com/sguest/factorio-types
5
- // Factorio version 2.0.77
5
+ // Factorio version 2.1.7
6
6
  // API version 6
7
7
 
8
8
  declare namespace runtime {
9
9
  interface AccumulatorBlueprintControlBehavior {
10
+ output_networks?: CircuitNetworkSelection;
10
11
  output_signal: SignalID;
11
12
  /**
12
13
  * Defaults to `true`.
@@ -78,6 +79,8 @@ interface AdvancedMapGenSettings {
78
79
  difficulty_settings: DifficultySettings;
79
80
  }
80
81
  interface AgriculturalTowerBlueprintControlBehavior {
82
+ input_networks?: CircuitNetworkSelection;
83
+ output_networks?: CircuitNetworkSelection;
81
84
  /**
82
85
  * Defaults to `false`.
83
86
  */
@@ -92,6 +95,16 @@ interface AgriculturalTowerBlueprintControlBehavior {
92
95
  */
93
96
  connect_to_logistic_network?: boolean;
94
97
  logistic_condition?: CircuitCondition;
98
+ /**
99
+ * Defaults to `false`.
100
+ */
101
+ enable_harvesting_condition?: boolean;
102
+ harvesting_condition?: CircuitCondition;
103
+ /**
104
+ * Defaults to `false`.
105
+ */
106
+ enable_planting_condition?: boolean;
107
+ planting_condition?: CircuitCondition;
95
108
  }
96
109
  interface Alert {
97
110
  /**
@@ -110,6 +123,15 @@ interface Alert {
110
123
  */
111
124
  message?: LocalisedString;
112
125
  }
126
+ interface AlertFilter {
127
+ entity?: LuaEntity;
128
+ prototype?: EntityID;
129
+ position?: MapPosition;
130
+ type?: defines.alert_type;
131
+ surface?: SurfaceIdentification;
132
+ icon?: SignalID;
133
+ message?: LocalisedString;
134
+ }
113
135
  /**
114
136
  * A string that specifies where a GUI element should be.
115
137
  */
@@ -123,6 +145,16 @@ type Alignment = 'top-left' | 'middle-left' | /**
123
145
  * The same as `"middle-right"`
124
146
  */
125
147
  'right' | 'bottom-right';
148
+ /**
149
+ * An ammo category may be specified in one of two ways.
150
+ */
151
+ type AmmoCategoryID = /**
152
+ * By ammo category prototype.
153
+ */
154
+ LuaAmmoCategoryPrototype | /**
155
+ * By name of the ammo category prototype.
156
+ */
157
+ string;
126
158
  interface AmmoType {
127
159
  action?: TriggerItem[];
128
160
  target_type: TargetType;
@@ -193,6 +225,8 @@ interface ArithmeticCombinatorParameters {
193
225
  output_signal?: SignalID;
194
226
  }
195
227
  interface ArtilleryTurretBlueprintControlBehavior {
228
+ input_networks?: CircuitNetworkSelection;
229
+ output_networks?: CircuitNetworkSelection;
196
230
  read_ammo?: boolean;
197
231
  /**
198
232
  * Defaults to `false`.
@@ -206,6 +240,8 @@ interface ArtilleryTurretBlueprintControlBehavior {
206
240
  logistic_condition?: CircuitCondition;
207
241
  }
208
242
  interface AssemblingMachineBlueprintControlBehavior {
243
+ input_networks?: CircuitNetworkSelection;
244
+ output_networks?: CircuitNetworkSelection;
209
245
  /**
210
246
  * Defaults to `false`.
211
247
  */
@@ -221,7 +257,7 @@ interface AssemblingMachineBlueprintControlBehavior {
221
257
  /**
222
258
  * Defaults to `false`.
223
259
  */
224
- include_fuel?: boolean;
260
+ read_fuel?: boolean;
225
261
  /**
226
262
  * Defaults to `false`.
227
263
  */
@@ -280,6 +316,8 @@ interface AsteroidChunkPrototypeFilter {
280
316
  invert?: boolean;
281
317
  }
282
318
  interface AsteroidCollectorBlueprintControlBehavior {
319
+ input_networks?: CircuitNetworkSelection;
320
+ output_networks?: CircuitNetworkSelection;
283
321
  /**
284
322
  * Defaults to `false`.
285
323
  */
@@ -343,9 +381,13 @@ interface BaseAttackParameters {
343
381
  */
344
382
  rotate_penalty: float;
345
383
  /**
346
- * When searching for an enemy to attack, a higher `health_penalty` will discourage targeting enemies with high health. A negative penalty will do the opposite.
384
+ * When searching for an enemy to attack, a higher `health_penalty` will discourage targeting enemies with high health ratio. A negative penalty will do the opposite.
347
385
  */
348
386
  health_penalty: float;
387
+ /**
388
+ * When searching for an enemy to attack, a higher `threatening_asteroid_penalty` will discourage targeting asteroids that pose a threat. A negative penalty will do the opposite.
389
+ */
390
+ threatening_asteroid_penalty: float;
349
391
  /**
350
392
  * If less than `range`, the entity will choose a random distance between `range` and `min_attack_distance` and attack from that distance. Used for spitters.
351
393
  */
@@ -524,7 +566,7 @@ interface BaseBlueprintEntity {
524
566
  /**
525
567
  * The representation of an entity inside of a blueprint.
526
568
  */
527
- type BlueprintEntity = BaseBlueprintEntity | BlueprintEntityAccumulator | BlueprintEntityAgriculturalTower | BlueprintEntityAmmoTurret | BlueprintEntityArithmeticCombinator | BlueprintEntityArtilleryTurret | BlueprintEntityArtilleryWagon | BlueprintEntityAssemblingMachine | BlueprintEntityAsteroidCollector | BlueprintEntityCar | BlueprintEntityCargoLandingPad | BlueprintEntityCargoWagon | BlueprintEntityConstantCombinator | BlueprintEntityContainer | BlueprintEntityDeciderCombinator | BlueprintEntityDisplayPanel | BlueprintEntityElectricEnergyInterface | BlueprintEntityElectricTurret | BlueprintEntityFluidTurret | BlueprintEntityFluidWagon | BlueprintEntityFurnace | BlueprintEntityHeatInterface | BlueprintEntityInfinityCargoWagon | BlueprintEntityInfinityContainer | BlueprintEntityInfinityPipe | BlueprintEntityInserter | BlueprintEntityLamp | BlueprintEntityLaneSplitter | BlueprintEntityLinkedBelt | BlueprintEntityLinkedContainer | BlueprintEntityLoader | BlueprintEntityLoader1x1 | BlueprintEntityLocomotive | BlueprintEntityLogisticContainer | BlueprintEntityMiningDrill | BlueprintEntityPowerSwitch | BlueprintEntityProgrammableSpeaker | BlueprintEntityProxyContainer | BlueprintEntityPump | BlueprintEntityRailChainSignal | BlueprintEntityRailSignal | BlueprintEntityReactor | BlueprintEntityRoboport | BlueprintEntityRocketSilo | BlueprintEntitySelectorCombinator | BlueprintEntitySpacePlatformHub | BlueprintEntitySpiderVehicle | BlueprintEntitySplitter | BlueprintEntityStorageTank | BlueprintEntityTrainStop | BlueprintEntityTransportBelt | BlueprintEntityTurret | BlueprintEntityUndergroundBelt | BlueprintEntityValve | BlueprintEntityWall;
569
+ type BlueprintEntity = BaseBlueprintEntity | BlueprintEntityAccumulator | BlueprintEntityAgriculturalTower | BlueprintEntityAmmoTurret | BlueprintEntityArithmeticCombinator | BlueprintEntityArtilleryTurret | BlueprintEntityArtilleryWagon | BlueprintEntityAssemblingMachine | BlueprintEntityAsteroidCollector | BlueprintEntityBoiler | BlueprintEntityCar | BlueprintEntityCargoLandingPad | BlueprintEntityCargoWagon | BlueprintEntityConstantCombinator | BlueprintEntityContainer | BlueprintEntityDeciderCombinator | BlueprintEntityDisplayPanel | BlueprintEntityElectricEnergyInterface | BlueprintEntityElectricTurret | BlueprintEntityFluidTurret | BlueprintEntityFluidWagon | BlueprintEntityFurnace | BlueprintEntityHeatInterface | BlueprintEntityHeatPipe | BlueprintEntityInfinityCargoWagon | BlueprintEntityInfinityContainer | BlueprintEntityInfinityPipe | BlueprintEntityInserter | BlueprintEntityLab | BlueprintEntityLamp | BlueprintEntityLandMine | BlueprintEntityLaneSplitter | BlueprintEntityLinkedBelt | BlueprintEntityLinkedContainer | BlueprintEntityLoader | BlueprintEntityLoader1x1 | BlueprintEntityLocomotive | BlueprintEntityLogisticContainer | BlueprintEntityMiningDrill | BlueprintEntityOffshorePump | BlueprintEntityPipe | BlueprintEntityPipeToGround | BlueprintEntityPowerSwitch | BlueprintEntityProgrammableSpeaker | BlueprintEntityProxyContainer | BlueprintEntityPump | BlueprintEntityRadar | BlueprintEntityRailChainSignal | BlueprintEntityRailSignal | BlueprintEntityReactor | BlueprintEntityRoboport | BlueprintEntityRocketSilo | BlueprintEntitySelectorCombinator | BlueprintEntitySpacePlatformHub | BlueprintEntitySpiderVehicle | BlueprintEntitySplitter | BlueprintEntityStorageTank | BlueprintEntityTrainStop | BlueprintEntityTransportBelt | BlueprintEntityTurret | BlueprintEntityUndergroundBelt | BlueprintEntityValve | BlueprintEntityWall;
528
570
  /**
529
571
  *
530
572
  * Applies to variant case `accumulator`
@@ -604,6 +646,13 @@ interface BlueprintEntityAsteroidCollector extends BaseBlueprintEntity {
604
646
  'control_behavior'?: AsteroidCollectorBlueprintControlBehavior;
605
647
  'result-inventory': BlueprintInventory;
606
648
  }
649
+ /**
650
+ *
651
+ * Applies to variant case `boiler`
652
+ */
653
+ interface BlueprintEntityBoiler extends BaseBlueprintEntity {
654
+ 'control_behavior'?: BoilerBlueprintControlBehavior;
655
+ }
607
656
  /**
608
657
  *
609
658
  * Applies to variant case `car`
@@ -653,7 +702,7 @@ interface BlueprintEntityConstantCombinator extends BaseBlueprintEntity {
653
702
  * Applies to variant case `container`
654
703
  */
655
704
  interface BlueprintEntityContainer extends BaseBlueprintEntity {
656
- 'bar'?: uint32;
705
+ 'bar'?: ItemStackIndex;
657
706
  'control_behavior'?: ContainerBlueprintControlBehavior;
658
707
  'filters'?: BlueprintItemFilter[];
659
708
  }
@@ -742,6 +791,13 @@ interface BlueprintEntityHeatInterface extends BaseBlueprintEntity {
742
791
  'mode'?: HeatSettingMode;
743
792
  'temperature'?: double;
744
793
  }
794
+ /**
795
+ *
796
+ * Applies to variant case `heat-pipe`
797
+ */
798
+ interface BlueprintEntityHeatPipe extends BaseBlueprintEntity {
799
+ 'control_behavior'?: HeatPipeBlueprintControlBehavior;
800
+ }
745
801
  /**
746
802
  *
747
803
  * Applies to variant case `infinity-cargo-wagon`
@@ -761,11 +817,16 @@ interface BlueprintEntityInfinityCargoWagon extends BaseBlueprintEntity {
761
817
  * Applies to variant case `infinity-container`
762
818
  */
763
819
  interface BlueprintEntityInfinityContainer extends BaseBlueprintEntity {
764
- 'bar'?: uint32;
820
+ 'bar'?: ItemStackIndex;
765
821
  'control_behavior'?: LogisticContainerBlueprintControlBehavior;
766
822
  'filters'?: BlueprintItemFilter[];
767
823
  'infinity_settings': BlueprintInfinityInventorySettings;
768
- 'request_filters': BlueprintLogisticSections;
824
+ 'override_logistic_mode'?: LogisticMode;
825
+ 'request_filters'?: BlueprintLogisticSections;
826
+ 'saved_request_filters'?: LogisticSections;
827
+ 'saved_request_from_buffers'?: boolean;
828
+ 'saved_set_requests'?: boolean;
829
+ 'saved_storage_filters'?: LogisticSections;
769
830
  }
770
831
  /**
771
832
  *
@@ -800,6 +861,13 @@ interface BlueprintEntityInserter extends BaseBlueprintEntity {
800
861
  */
801
862
  'use_filters'?: boolean;
802
863
  }
864
+ /**
865
+ *
866
+ * Applies to variant case `lab`
867
+ */
868
+ interface BlueprintEntityLab extends BaseBlueprintEntity {
869
+ 'control_behavior'?: LabBlueprintControlBehavior;
870
+ }
803
871
  /**
804
872
  *
805
873
  * Applies to variant case `lamp`
@@ -812,6 +880,13 @@ interface BlueprintEntityLamp extends BaseBlueprintEntity {
812
880
  'color'?: Color;
813
881
  'control_behavior'?: LampBlueprintControlBehavior;
814
882
  }
883
+ /**
884
+ *
885
+ * Applies to variant case `land-mine`
886
+ */
887
+ interface BlueprintEntityLandMine extends BaseBlueprintEntity {
888
+ 'control_behavior'?: LandMineBlueprintControlBehavior;
889
+ }
815
890
  /**
816
891
  *
817
892
  * Applies to variant case `lane-splitter`
@@ -882,7 +957,7 @@ interface BlueprintEntityLocomotive extends BaseBlueprintEntity {
882
957
  * Applies to variant case `logistic-container`
883
958
  */
884
959
  interface BlueprintEntityLogisticContainer extends BaseBlueprintEntity {
885
- 'bar'?: uint32;
960
+ 'bar'?: ItemStackIndex;
886
961
  'control_behavior'?: LogisticContainerBlueprintControlBehavior;
887
962
  'filters'?: BlueprintItemFilter[];
888
963
  'request_filters': BlueprintLogisticSections;
@@ -895,12 +970,33 @@ interface BlueprintEntityMiningDrill extends BaseBlueprintEntity {
895
970
  'control_behavior'?: MiningDrillBlueprintControlBehavior;
896
971
  'filter'?: BlueprintMiningDrillFilter;
897
972
  }
973
+ /**
974
+ *
975
+ * Applies to variant case `offshore-pump`
976
+ */
977
+ interface BlueprintEntityOffshorePump extends BaseBlueprintEntity {
978
+ 'control_behavior'?: GenericOnOffBlueprintControlBehavior;
979
+ }
980
+ /**
981
+ *
982
+ * Applies to variant case `pipe`
983
+ */
984
+ interface BlueprintEntityPipe extends BaseBlueprintEntity {
985
+ 'control_behavior'?: SingleFluidBoxBlueprintControlBehavior;
986
+ }
987
+ /**
988
+ *
989
+ * Applies to variant case `pipe-to-ground`
990
+ */
991
+ interface BlueprintEntityPipeToGround extends BaseBlueprintEntity {
992
+ 'control_behavior'?: SingleFluidBoxBlueprintControlBehavior;
993
+ }
898
994
  /**
899
995
  *
900
996
  * Applies to variant case `power-switch`
901
997
  */
902
998
  interface BlueprintEntityPowerSwitch extends BaseBlueprintEntity {
903
- 'control_behavior'?: PowerSwitchBlueprintControlBehavior;
999
+ 'control_behavior'?: GenericOnOffBlueprintControlBehavior;
904
1000
  'switch_state'?: boolean;
905
1001
  }
906
1002
  /**
@@ -927,6 +1023,13 @@ interface BlueprintEntityPump extends BaseBlueprintEntity {
927
1023
  'control_behavior'?: PumpBlueprintControlBehavior;
928
1024
  'fluid_filter'?: string;
929
1025
  }
1026
+ /**
1027
+ *
1028
+ * Applies to variant case `radar`
1029
+ */
1030
+ interface BlueprintEntityRadar extends BaseBlueprintEntity {
1031
+ 'control_behavior'?: RadarBlueprintControlBehavior;
1032
+ }
930
1033
  /**
931
1034
  *
932
1035
  * Applies to variant case `rail-chain-signal`
@@ -990,6 +1093,7 @@ interface BlueprintEntitySelectorCombinator extends BaseBlueprintEntity {
990
1093
  interface BlueprintEntitySpacePlatformHub extends BaseBlueprintEntity {
991
1094
  'bar'?: uint32;
992
1095
  'control_behavior'?: SpacePlatformHubBlueprintControlBehavior;
1096
+ 'providing_to_other_platforms'?: boolean;
993
1097
  'request_filters': BlueprintLogisticSections;
994
1098
  'request_missing_construction_materials': boolean;
995
1099
  }
@@ -1024,7 +1128,7 @@ interface BlueprintEntitySplitter extends BaseBlueprintEntity {
1024
1128
  * Applies to variant case `storage-tank`
1025
1129
  */
1026
1130
  interface BlueprintEntityStorageTank extends BaseBlueprintEntity {
1027
- 'control_behavior'?: StorageTankBlueprintControlBehavior;
1131
+ 'control_behavior'?: SingleFluidBoxBlueprintControlBehavior;
1028
1132
  }
1029
1133
  /**
1030
1134
  *
@@ -1155,10 +1259,14 @@ interface BlueprintLogisticFilter {
1155
1259
  count: int32;
1156
1260
  max_count?: ItemCountType;
1157
1261
  /**
1158
- * Defaults to 0.
1262
+ * Defaults to `0`.
1159
1263
  */
1160
1264
  minimum_delivery_count?: ItemCountType;
1161
1265
  import_from?: string;
1266
+ /**
1267
+ * From which sources items should be requested for space platforms. Defaults to `"planet"`.
1268
+ */
1269
+ request_from?: RequestFromLocation;
1162
1270
  }
1163
1271
  interface BlueprintLogisticSections {
1164
1272
  sections?: LogisticSection[];
@@ -1258,6 +1366,38 @@ interface BlueprintWireEnd {
1258
1366
  surface_index?: uint32;
1259
1367
  connector: defines.wire_connector_id;
1260
1368
  }
1369
+ interface BoilerBlueprintControlBehavior {
1370
+ input_networks?: CircuitNetworkSelection;
1371
+ output_networks?: CircuitNetworkSelection;
1372
+ /**
1373
+ * Defaults to `false`.
1374
+ */
1375
+ read_fuel?: boolean;
1376
+ /**
1377
+ * Defaults to `false`.
1378
+ */
1379
+ circuit_enabled?: boolean;
1380
+ circuit_condition?: CircuitCondition;
1381
+ /**
1382
+ * Defaults to `false`.
1383
+ */
1384
+ connect_to_logistic_network?: boolean;
1385
+ logistic_condition?: CircuitCondition;
1386
+ }
1387
+ interface BonusUtilityConstants {
1388
+ artillery_range: string;
1389
+ worker_robots: string;
1390
+ character: string;
1391
+ follower_robots: string;
1392
+ research_speed: string;
1393
+ beacon_distribution: string;
1394
+ inserter: string;
1395
+ stack_inserter: string;
1396
+ bulk_inserter: string;
1397
+ turret_attack: string;
1398
+ mining_productivity: string;
1399
+ train_braking_force: string;
1400
+ }
1261
1401
  /**
1262
1402
  * Two positions, specifying the top-left and bottom-right corner of the box respectively. Like with {@link MapPosition | runtime:MapPosition}, the names of the members may be omitted. When read from the game, the third member `orientation` is present if it is non-zero.
1263
1403
  * @example ```
@@ -1370,11 +1510,29 @@ interface CargoDestination {
1370
1510
  */
1371
1511
  space_platform?: LuaSpacePlatform;
1372
1512
  }
1513
+ interface CargoHatchDefinition {
1514
+ busy_timeout_ticks: uint32;
1515
+ hatch_opening_ticks: uint32;
1516
+ cargo_unit_entity_to_spawn: EntityID;
1517
+ receiving_cargo_units: EntityID[];
1518
+ }
1373
1519
  interface CargoLandingPadBlueprintControlBehavior {
1520
+ input_networks?: CircuitNetworkSelection;
1521
+ output_networks?: CircuitNetworkSelection;
1374
1522
  /**
1375
- * Defaults to `send_contents`.
1523
+ * Defaults to `true`.
1524
+ */
1525
+ read_contents?: boolean;
1526
+ /**
1527
+ * Defaults to `false`.
1376
1528
  */
1377
- circuit_mode_of_operation?: defines.control_behavior.cargo_landing_pad.exclusive_mode;
1529
+ set_requests?: boolean;
1530
+ }
1531
+ interface CargoStationParameters {
1532
+ prefer_packed_cargo_units: boolean;
1533
+ is_input_station: boolean;
1534
+ is_output_station: boolean;
1535
+ hatch_definitions: CargoHatchDefinition[];
1378
1536
  }
1379
1537
  /**
1380
1538
  * Either `icon`, `text`, or both must be provided.
@@ -1385,6 +1543,73 @@ interface ChartTagSpec {
1385
1543
  text?: string;
1386
1544
  last_user?: PlayerIdentification;
1387
1545
  }
1546
+ interface ChartUtilityConstants {
1547
+ copper_wire_color: Color;
1548
+ electric_power_pole_color: Color;
1549
+ enabled_switch_color: Color;
1550
+ disabled_switch_color: Color;
1551
+ electric_line_width: float;
1552
+ electric_line_minimum_absolute_width: float;
1553
+ red_wire_color: Color;
1554
+ green_wire_color: Color;
1555
+ circuit_network_member_color: Color;
1556
+ turret_range_color: Color;
1557
+ artillery_range_color: Color;
1558
+ default_friendly_color: Color;
1559
+ default_enemy_color: Color;
1560
+ default_enemy_territory_color: Color;
1561
+ rail_color: Color;
1562
+ elevated_rail_color: Color;
1563
+ rail_ramp_color: Color;
1564
+ entity_ghost_color: Color;
1565
+ tile_ghost_color: Color;
1566
+ vehicle_outer_color: Color;
1567
+ vehicle_outer_color_selected: Color;
1568
+ vehicle_inner_color: Color;
1569
+ vehicle_wagon_connection_color: Color;
1570
+ resource_outline_selection_color: Color;
1571
+ chart_train_stop_text_color: Color;
1572
+ chart_train_stop_disabled_text_color: Color;
1573
+ chart_train_stop_full_text_color: Color;
1574
+ red_signal_color: Color;
1575
+ green_signal_color: Color;
1576
+ blue_signal_color: Color;
1577
+ yellow_signal_color: Color;
1578
+ chart_deconstruct_tint: Color;
1579
+ chart_deconstruct_active_color: Color;
1580
+ /**
1581
+ * The strings are entity types.
1582
+ */
1583
+ default_friendly_color_by_type?: Record<string, Color>;
1584
+ /**
1585
+ * The strings are entity types.
1586
+ */
1587
+ default_color_by_type?: Record<string, Color>;
1588
+ explosion_visualization_duration: MapTick;
1589
+ train_path_color: Color;
1590
+ train_preview_path_outline_color: Color;
1591
+ train_current_path_outline_color: Color;
1592
+ chart_logistic_robot_color: Color;
1593
+ chart_construction_robot_color: Color;
1594
+ chart_mobile_construction_robot_color: Color;
1595
+ chart_personal_construction_robot_color: Color;
1596
+ chart_delivery_to_me_logistic_robot_color: Color;
1597
+ zoom_threshold_to_draw_spider_path: double;
1598
+ chart_player_circle_size: float;
1599
+ /**
1600
+ * Defaults to `1.0`.
1601
+ */
1602
+ custom_tag_scale?: float;
1603
+ /**
1604
+ * Defaults to `1.0`.
1605
+ */
1606
+ custom_tag_max_scale?: float;
1607
+ custom_tag_selected_overlay_tint?: Color;
1608
+ /**
1609
+ * Must be larger than 0. This number is multiplied by the crafting machine's {@link radius | runtime:LuaEntityPrototype::radius} to get the final recipe icon scale for the chart.
1610
+ */
1611
+ recipe_icon_scale: float;
1612
+ }
1388
1613
  /**
1389
1614
  * Coordinates of a chunk in a {@link LuaSurface | runtime:LuaSurface} where each integer `x`/`y` represents a different chunk. This uses the same format as {@link MapPosition | runtime:MapPosition}, meaning it can be specified either with or without explicit keys. A {@link MapPosition | runtime:MapPosition} can be translated to a ChunkPosition by dividing the `x`/`y` values by 32.
1390
1615
  */
@@ -1504,6 +1729,21 @@ interface CliffPlacementSettings {
1504
1729
  */
1505
1730
  richness: MapGenSize;
1506
1731
  }
1732
+ interface CloudsEffectProperties {
1733
+ scale: float;
1734
+ clouds_movement_speed_multiplier: float;
1735
+ shape_warp_strength: float;
1736
+ shape_warp_weight: float;
1737
+ opacity_at_day: float;
1738
+ opacity_at_night: float;
1739
+ density_at_day: float;
1740
+ density_at_night: float;
1741
+ detail_factor_at_day: float;
1742
+ detail_factor_at_night: float;
1743
+ shape_factor: float;
1744
+ detail_exponent: float;
1745
+ detail_morph_duration: uint32;
1746
+ }
1507
1747
  /**
1508
1748
  * The name of a {@link LuaCollisionLayerPrototype | runtime:LuaCollisionLayerPrototype}.
1509
1749
  * @example ```
@@ -1557,6 +1797,19 @@ type Color = {
1557
1797
  float,
1558
1798
  float
1559
1799
  ];
1800
+ interface ColorFilterData {
1801
+ name: string;
1802
+ localised_name: LocalisedString;
1803
+ matrix: float[];
1804
+ }
1805
+ interface ColorHintSpecification {
1806
+ text: string;
1807
+ text_color: Color;
1808
+ }
1809
+ /**
1810
+ * Does not return the value at runtime.
1811
+ */
1812
+ type ColorLookupTable = nil;
1560
1813
  /**
1561
1814
  * Same as {@link Color | runtime:Color}, but red, green, blue and alpha values can be any floating point number, without any special handling of the range [1, 255].
1562
1815
  */
@@ -1638,10 +1891,6 @@ interface CommandBuildBase extends BaseCommand {
1638
1891
  * Defaults to `defines.distraction.by_enemy`.
1639
1892
  */
1640
1893
  'distraction'?: defines.distraction;
1641
- /**
1642
- * Whether the units should ignore expansion candidate chunks. When `false`, they will obey and not build a base in a non-candidate chunk. Defaults to `false`.
1643
- */
1644
- 'ignore_planner'?: boolean;
1645
1894
  }
1646
1895
  /**
1647
1896
  *
@@ -1832,6 +2081,10 @@ interface CompiledLogisticFilter {
1832
2081
  * Defaults to 0.
1833
2082
  */
1834
2083
  minimum_delivery_count?: ItemCountType;
2084
+ /**
2085
+ * From which sources items should be requested for space platforms.
2086
+ */
2087
+ request_from?: RequestFromLocation;
1835
2088
  }
1836
2089
  interface ConfigurationChangedData {
1837
2090
  /**
@@ -1855,7 +2108,7 @@ interface ConfigurationChangedData {
1855
2108
  */
1856
2109
  migration_applied: boolean;
1857
2110
  /**
1858
- * Dictionary of prototype changes due to {@link migrations | runtime:migrations}. The inner dictionary maps the old prototype name to the new prototype name. The new name will be an empty string if the prototype was removed. Entries are omitted if the old and new prototype name are the same.
2111
+ * Dictionary of prototype changes due to {@link migrations | auxiliary:migrations}. The inner dictionary maps the old prototype name to the new prototype name. The new name will be an empty string if the prototype was removed. Entries are omitted if the old and new prototype name are the same.
1859
2112
  */
1860
2113
  migrations: LuaTable<IDType, Record<string, string>>;
1861
2114
  }
@@ -1867,6 +2120,7 @@ interface ConstantCombinatorBlueprintControlBehavior {
1867
2120
  is_on?: boolean;
1868
2121
  }
1869
2122
  interface ContainerBlueprintControlBehavior {
2123
+ output_networks?: CircuitNetworkSelection;
1870
2124
  /**
1871
2125
  * Defaults to `true`.
1872
2126
  */
@@ -1890,6 +2144,15 @@ interface CraftingQueueItem {
1890
2144
  */
1891
2145
  prerequisite: boolean;
1892
2146
  }
2147
+ interface CraterPlacementDefinition {
2148
+ minimum_segments_to_place: uint32;
2149
+ segment_probability: float;
2150
+ segments: CraterSegment[];
2151
+ }
2152
+ interface CraterSegment {
2153
+ orientation: float;
2154
+ offset: Vector;
2155
+ }
1893
2156
  type CursorBoxRenderType = /**
1894
2157
  * The normal entity selection box. Yellow by default.
1895
2158
  */
@@ -2001,6 +2264,50 @@ LuaDamagePrototype | /**
2001
2264
  * The prototype name.
2002
2265
  */
2003
2266
  string;
2267
+ /**
2268
+ * Returns an empty table at runtime.
2269
+ */
2270
+ type DaytimeColorLookupTable = '{}';
2271
+ /**
2272
+ * The supported subset of {@link DebugAdapter Variable | https://microsoft.github.io/debug-adapter-protocol/specification#Types_Variable}
2273
+ */
2274
+ interface DebugVariable {
2275
+ name: string;
2276
+ value: string;
2277
+ type?: string;
2278
+ variablesReference?: int32;
2279
+ namedVariables?: int32;
2280
+ indexedVariables?: int32;
2281
+ presentationHint?: DebugVariablePresentationHint;
2282
+ }
2283
+ /**
2284
+ * The supported subset of {@link DebugAdapter VariablePresentationHint | https://microsoft.github.io/debug-adapter-protocol/specification#Types_VariablePresentationHint}
2285
+ */
2286
+ interface DebugVariablePresentationHint {
2287
+ /**
2288
+ * The only supported kind is "virtual".
2289
+ */
2290
+ kind?: 'virtual';
2291
+ /**
2292
+ * The only supported attribute is "readOnly".
2293
+ */
2294
+ attributes?: ('readOnly')[];
2295
+ lazy?: boolean;
2296
+ }
2297
+ interface DebugVariablesFilter {
2298
+ /**
2299
+ * The kind of filter applied to this request. Default "all".
2300
+ */
2301
+ filter?: 'indexed' | 'named' | 'all';
2302
+ /**
2303
+ * When `filter` is "indexed", the index to start at.
2304
+ */
2305
+ start?: int32;
2306
+ /**
2307
+ * When `filter` is "indexed", the size of the requested page.
2308
+ */
2309
+ count?: int32;
2310
+ }
2004
2311
  interface DeciderCombinatorBlueprintControlBehavior {
2005
2312
  decider_conditions: DeciderCombinatorParameters;
2006
2313
  }
@@ -2129,6 +2436,10 @@ interface DetailedItemOnLine {
2129
2436
  */
2130
2437
  unique_id: uint32;
2131
2438
  }
2439
+ interface DeviatedValue {
2440
+ value: float;
2441
+ deviation: float;
2442
+ }
2132
2443
  /**
2133
2444
  * Technology difficulty settings. Updating any of the attributes will immediately take effect in the game engine.
2134
2445
  */
@@ -2170,6 +2481,24 @@ interface DragTarget {
2170
2481
  */
2171
2482
  wire_connector_id: defines.wire_connector_id;
2172
2483
  }
2484
+ interface EditorUtilityConstants {
2485
+ clone_editor_copy_source_color: Color;
2486
+ clone_editor_copy_destination_allowed_color: Color;
2487
+ clone_editor_copy_destination_not_allowed_color: Color;
2488
+ clone_editor_brush_source_color: Color;
2489
+ clone_editor_brush_destination_color: Color;
2490
+ clone_editor_brush_cursor_preview_tint: Color;
2491
+ clone_editor_brush_world_preview_tint: Color;
2492
+ script_editor_select_area_color: Color;
2493
+ script_editor_drag_area_color: Color;
2494
+ force_editor_select_area_color: Color;
2495
+ cliff_editor_remove_cliffs_color: Color;
2496
+ tile_editor_selection_preview_tint: Color;
2497
+ tile_editor_area_selection_color: Color;
2498
+ decorative_editor_selection_preview_tint: Color;
2499
+ tile_editor_selection_preview_radius: uint8;
2500
+ decorative_editor_selection_preview_radius: uint8;
2501
+ }
2173
2502
  interface EffectReceiver {
2174
2503
  base_effect: ModuleEffects;
2175
2504
  uses_module_effects: boolean;
@@ -2178,6 +2507,15 @@ interface EffectReceiver {
2178
2507
  * Controls whether {@link LuaSurface::global_effect | runtime:LuaSurface::global_effect} affects this receiver.
2179
2508
  */
2180
2509
  uses_surface_effects: boolean;
2510
+ consumption_limits: EffectValueRange;
2511
+ speed_limits: EffectValueRange;
2512
+ productivity_limits: EffectValueRange;
2513
+ pollution_limits: EffectValueRange;
2514
+ quality_limits: EffectValueRange;
2515
+ }
2516
+ interface EffectValueRange {
2517
+ low: double;
2518
+ high: double;
2181
2519
  }
2182
2520
  /**
2183
2521
  * An item thrown overboard on a space platform.
@@ -2209,6 +2547,20 @@ interface ElemID {
2209
2547
  * A {@link string | runtime:string} specifying a type for {@link choose elem buttons | runtime:LuaGuiElement::elem_type}. It's also used by {@link ElemID | runtime:ElemID} for {@link LuaGuiElement::elem_tooltip | runtime:LuaGuiElement::elem_tooltip}.
2210
2548
  */
2211
2549
  type ElemType = 'achievement' | 'decorative' | 'entity' | 'equipment' | 'fluid' | 'item' | 'item-group' | 'recipe' | 'signal' | 'technology' | 'tile' | 'asteroid-chunk' | 'space-location' | 'item-with-quality' | 'entity-with-quality' | 'recipe-with-quality' | 'equipment-with-quality';
2550
+ interface EmptySlotInfo {
2551
+ /**
2552
+ * The icon to use.
2553
+ */
2554
+ sprite?: SpritePath;
2555
+ /**
2556
+ * The tooltip caption to use.
2557
+ */
2558
+ caption?: LocalisedString;
2559
+ /**
2560
+ * The tooltip text to use.
2561
+ */
2562
+ text?: LocalisedString;
2563
+ }
2212
2564
  /**
2213
2565
  * These values represent a percentual increase in evolution. This means a value of `0.1` would increase evolution by 10%.
2214
2566
  */
@@ -2231,21 +2583,21 @@ interface EnemyEvolutionMapSettings {
2231
2583
  pollution_factor: double;
2232
2584
  }
2233
2585
  /**
2234
- * Candidate chunks are given scores to determine which one of them should be expanded into. This score takes into account various settings noted below. The iteration is over a square region centered around the chunk for which the calculation is done, and includes the central chunk as well. Distances are calculated as {@link Manhattan distance | https://en.wikipedia.org/wiki/Taxicab_geometry}.
2586
+ * Candidate chunks are given scores to determine which one of them should be expanded into. This score takes into account various settings noted below. The iteration is over a square region centered around the chunk for which the calculation is done, and includes the central chunk as well. Distances are calculated as {@link Euclidean distance | https://en.wikipedia.org/wiki/Euclidean_distance}.
2235
2587
  *
2236
2588
  * The pseudocode algorithm to determine a chunk's score is as follows:
2237
2589
  *
2238
2590
  * ```
2239
2591
  * player = 0
2240
- * for neighbour in all chunks within enemy_building_influence_radius from chunk:
2241
- * player += number of player buildings on neighbour
2242
- * * building_coefficient
2243
- * * neighbouring_chunk_coefficient^distance(chunk, neighbour)
2592
+ * for neighbour in all chunks within enemy_building_influence_radius from chunk :
2593
+ * if neighbour has player buildings :
2594
+ * player += neighbouring_chunk_coefficient ^ distance(chunk, neighbour)
2595
+ * * building_coefficient
2244
2596
  * base = 0
2245
- * for neighbour in all chunk within friendly_base_influence_radius from chunk:
2246
- * base += num of enemy bases on neighbour
2247
- * * other_base_coefficient
2248
- * * neighbouring_base_chunk_coefficient^distance(chunk, neighbour)
2597
+ * for neighbour in all chunks within friendly_base_influence_radius from chunk :
2598
+ * if neighbour has enemy bases :
2599
+ * base += neighbouring_base_chunk_coefficient ^ distance(chunk, neighbour)
2600
+ * * other_base_coefficient
2249
2601
  * score(chunk) = 1 / (1 + player + base)
2250
2602
  * ```
2251
2603
  */
@@ -2255,23 +2607,27 @@ interface EnemyExpansionMapSettings {
2255
2607
  */
2256
2608
  enabled: boolean;
2257
2609
  /**
2258
- * Distance in chunks from the furthest base around to prevent expansions from reaching too far into the player's territory. Defaults to `7`.
2610
+ * Distance in chunks from the furthest base around to prevent expansions from reaching too far into the player's territory. Defaults to `5`.
2259
2611
  */
2260
2612
  max_expansion_distance: uint32;
2261
2613
  /**
2262
- * Defaults to `2`.
2614
+ * Distance in chunks from the furthest base around to prevent expansions from being too close to existing bases. Defaults to `3`.
2615
+ */
2616
+ min_expansion_distance: uint32;
2617
+ /**
2618
+ * Defaults to `6`.
2263
2619
  */
2264
2620
  friendly_base_influence_radius: uint32;
2265
2621
  /**
2266
- * Defaults to `2`.
2622
+ * Defaults to `3`.
2267
2623
  */
2268
2624
  enemy_building_influence_radius: uint32;
2269
2625
  /**
2270
- * Defaults to `0.1`.
2626
+ * Defaults to `0.5`.
2271
2627
  */
2272
2628
  building_coefficient: double;
2273
2629
  /**
2274
- * Defaults to `2.0`.
2630
+ * Defaults to `3.0`.
2275
2631
  */
2276
2632
  other_base_coefficient: double;
2277
2633
  /**
@@ -2279,11 +2635,11 @@ interface EnemyExpansionMapSettings {
2279
2635
  */
2280
2636
  neighbouring_chunk_coefficient: double;
2281
2637
  /**
2282
- * Defaults to `0.4`.
2638
+ * Defaults to `0.5`.
2283
2639
  */
2284
2640
  neighbouring_base_chunk_coefficient: double;
2285
2641
  /**
2286
- * A chunk has to have at most this high of a percentage of unbuildable tiles for it to be considered a candidate to avoid chunks full of water as candidates. Defaults to `0.9`, or 90%.
2642
+ * A chunk has to have at most this high of a percentage of unbuildable tiles for it to be considered a candidate to avoid chunks full of water as candidates. Defaults to `0.8`, or 80%.
2287
2643
  */
2288
2644
  max_colliding_tiles_coefficient: double;
2289
2645
  /**
@@ -2303,6 +2659,20 @@ interface EnemyExpansionMapSettings {
2303
2659
  */
2304
2660
  max_expansion_cooldown: uint32;
2305
2661
  }
2662
+ interface EnemySpawnerAbsorption {
2663
+ absolute: double;
2664
+ proportional: double;
2665
+ }
2666
+ interface EnergyAndCapacityPair {
2667
+ /**
2668
+ * Total energy stored inside of matching accumulators
2669
+ */
2670
+ energy: double;
2671
+ /**
2672
+ * Total capacity of matching accumulators
2673
+ */
2674
+ capacity: double;
2675
+ }
2306
2676
  /**
2307
2677
  * An entity prototype may be specified in one of three ways.
2308
2678
  */
@@ -2347,7 +2717,7 @@ interface BaseEntityPrototypeFilter {
2347
2717
  /**
2348
2718
  * The condition to filter on.
2349
2719
  */
2350
- filter: 'flying-robot' | 'robot-with-logistics-interface' | 'rail' | 'ghost' | 'explosion' | 'vehicle' | 'crafting-machine' | 'rolling-stock' | 'turret' | 'transport-belt-connectable' | 'wall-connectable' | 'buildable' | 'placable-in-editor' | 'clonable' | 'selectable' | 'hidden' | 'entity-with-health' | 'building' | 'fast-replaceable' | 'uses-direction' | 'minable' | 'circuit-connectable' | 'autoplace' | 'blueprintable' | 'item-to-place' | 'name' | 'type' | 'collision-mask' | 'flag' | 'build-base-evolution-requirement' | 'selection-priority' | 'emissions-per-second' | 'crafting-category';
2720
+ filter: 'flying-robot' | 'robot-with-logistics-interface' | 'rail' | 'ghost' | 'explosion' | 'vehicle' | 'crafting-machine' | 'rolling-stock' | 'turret' | 'transport-belt-connectable' | 'wall-connectable' | 'buildable' | 'placable-in-editor' | 'clonable' | 'selectable' | 'hidden' | 'entity-with-health' | 'building' | 'fast-replaceable' | 'uses-direction' | 'minable' | 'circuit-connectable' | 'autoplace' | 'blueprintable' | 'item-to-place' | 'name' | 'type' | 'collision-mask' | 'flag' | 'selection-priority' | 'emissions-per-second' | 'crafting-category';
2351
2721
  /**
2352
2722
  * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
2353
2723
  */
@@ -2357,22 +2727,7 @@ interface BaseEntityPrototypeFilter {
2357
2727
  */
2358
2728
  invert?: boolean;
2359
2729
  }
2360
- type EntityPrototypeFilter = BaseEntityPrototypeFilter | EntityPrototypeFilterBuildBaseEvolutionRequirement | EntityPrototypeFilterCollisionMask | EntityPrototypeFilterCraftingCategory | EntityPrototypeFilterEmissionsPerSecond | EntityPrototypeFilterFlag | EntityPrototypeFilterName | EntityPrototypeFilterSelectionPriority | EntityPrototypeFilterType;
2361
- /**
2362
- *
2363
- * Applies to variant case `build-base-evolution-requirement`
2364
- */
2365
- interface EntityPrototypeFilterBuildBaseEvolutionRequirement extends BaseEntityPrototypeFilter {
2366
- /**
2367
- * The condition to filter on.
2368
- */
2369
- 'filter': 'build-base-evolution-requirement';
2370
- 'comparison': ComparatorString;
2371
- /**
2372
- * The value to compare against.
2373
- */
2374
- 'value': double;
2375
- }
2730
+ type EntityPrototypeFilter = BaseEntityPrototypeFilter | EntityPrototypeFilterCollisionMask | EntityPrototypeFilterCraftingCategory | EntityPrototypeFilterEmissionsPerSecond | EntityPrototypeFilterFlag | EntityPrototypeFilterName | EntityPrototypeFilterSelectionPriority | EntityPrototypeFilterType;
2376
2731
  /**
2377
2732
  * Usage example:
2378
2733
  *
@@ -2534,6 +2889,9 @@ type EntityPrototypeFlag = /**
2534
2889
  * Prevents the entity from being part of a blueprint.
2535
2890
  */
2536
2891
  'not-blueprintable' | /**
2892
+ * Always show the entity in selection lists/Factoriopedia.
2893
+ */
2894
+ 'always-show' | /**
2537
2895
  * Hides the alt-info of this entity when in alt-mode.
2538
2896
  */
2539
2897
  'hide-alt-info' | /**
@@ -2557,16 +2915,31 @@ type EntityPrototypeFlag = /**
2557
2915
  'not-upgradable' | /**
2558
2916
  * Prevents the entity from being shown in the kill statistics.
2559
2917
  */
2560
- 'not-in-kill-statistics' | 'building-direction-16-way' | 'snap-to-rail-support-spot' | /**
2561
- * Prevents the entity from being shown in the "made in" list in recipe tooltips.
2918
+ 'not-in-kill-statistics' | 'building-direction-16-way' | /**
2919
+ * For entities with control behavior that supports logistic connection, if this flag is set then entity will not be able to connect to logistic network.
2920
+ */
2921
+ 'no-logistic-connection' | 'snap-to-rail-support-spot' | /**
2922
+ * Prevents the entity from being shown in the "made in" list in recipe tooltips and Factoriopedia.
2923
+ */
2924
+ 'not-in-made-in' | /**
2925
+ * Prevents the entity from being shown in the bonus GUI.
2562
2926
  */
2563
- 'not-in-made-in';
2927
+ 'not-in-bonus-gui' | /**
2928
+ * Prevents the entity from being shown in the mined-by tooltip of resources.
2929
+ */
2930
+ 'not-in-mined-by';
2564
2931
  /**
2565
2932
  * A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
2566
2933
  *
2567
2934
  * By default, none of these flags are set.
2568
2935
  */
2569
2936
  type EntityPrototypeFlags = Record<EntityPrototypeFlag, true>;
2937
+ interface EntityRendererSearchBoxLimits {
2938
+ left: uint8;
2939
+ top: uint8;
2940
+ right: uint8;
2941
+ bottom: uint8;
2942
+ }
2570
2943
  interface EntitySearchFilters {
2571
2944
  area?: BoundingBox;
2572
2945
  /**
@@ -2756,7 +3129,7 @@ interface EventData {
2756
3129
  *
2757
3130
  * Filters are always used as an array of filters of a specific type. Every filter can only be used with its corresponding event, and different types of event filters can not be mixed.
2758
3131
  */
2759
- type EventFilter = (LuaSegmentedUnitDiedEventFilter | LuaScriptRaisedTeleportedEventFilter | LuaPreRobotMinedEntityEventFilter | LuaScriptRaisedBuiltEventFilter | LuaPlatformMinedEntityEventFilter | LuaRobotBuiltEntityEventFilter | LuaPrePlayerMinedEntityEventFilter | LuaEntityDeconstructionCancelledEventFilter | LuaPreGhostUpgradedEventFilter | LuaPlatformBuiltEntityEventFilter | LuaPrePlatformMinedEntityEventFilter | LuaEntityClonedEventFilter | LuaPlayerRepairedEntityEventFilter | LuaPostEntityDiedEventFilter | LuaScriptRaisedDestroySegmentedUnitEventFilter | LuaSegmentedUnitDamagedEventFilter | LuaPreGhostDeconstructedEventFilter | LuaPlayerMinedEntityEventFilter | LuaSectorScannedEventFilter | LuaRobotMinedEntityEventFilter | LuaEntityMarkedForDeconstructionEventFilter | LuaPostSegmentedUnitDiedEventFilter | LuaScriptRaisedReviveEventFilter | LuaPlayerBuiltEntityEventFilter | LuaUpgradeCancelledEventFilter | LuaEntityDamagedEventFilter | LuaEntityDiedEventFilter | LuaEntityMarkedForUpgradeEventFilter | LuaSegmentedUnitCreatedEventFilter | LuaScriptRaisedDestroyEventFilter)[];
3132
+ type EventFilter = (LuaEntityClonedEventFilter | LuaEntityDamagedEventFilter | LuaEntityDeconstructionCancelledEventFilter | LuaEntityDiedEventFilter | LuaEntityMarkedForDeconstructionEventFilter | LuaEntityMarkedForUpgradeEventFilter | LuaPlatformBuiltEntityEventFilter | LuaPlatformMinedEntityEventFilter | LuaPlayerBuiltEntityEventFilter | LuaPlayerMinedEntityEventFilter | LuaPlayerRepairedEntityEventFilter | LuaPostEntityDiedEventFilter | LuaPostSegmentedUnitDiedEventFilter | LuaPreGhostDeconstructedEventFilter | LuaPreGhostUpgradedEventFilter | LuaPrePlatformMinedEntityEventFilter | LuaPrePlayerMinedEntityEventFilter | LuaPreRobotMinedEntityEventFilter | LuaRobotBuiltEntityEventFilter | LuaRobotMinedEntityEventFilter | LuaScriptRaisedBuiltEventFilter | LuaScriptRaisedDestroyEventFilter | LuaScriptRaisedDestroySegmentedUnitEventFilter | LuaScriptRaisedReviveEventFilter | LuaScriptRaisedTeleportedEventFilter | LuaSectorScannedEventFilter | LuaSegmentedUnitCreatedEventFilter | LuaSegmentedUnitDamagedEventFilter | LuaSegmentedUnitDiedEventFilter | LuaUpgradeCancelledEventFilter)[];
2760
3133
  interface ExplosionDefinition {
2761
3134
  name: LuaEntityPrototype;
2762
3135
  offset: Vector;
@@ -2791,7 +3164,7 @@ interface Fluid {
2791
3164
  */
2792
3165
  amount: double;
2793
3166
  /**
2794
- * The temperature. When reading from {@link LuaFluidBox | runtime:LuaFluidBox}, this field will always be present. It is not necessary to specify it when writing, however. When not specified, the fluid will be set to the fluid's default temperature as specified in the fluid's prototype.
3167
+ * The temperature. When reading this field will always be present. It is not necessary to specify it when writing, however. When not specified, the fluid will be set to the fluid's default temperature as specified in the fluid's prototype.
2795
3168
  */
2796
3169
  temperature?: float;
2797
3170
  }
@@ -2804,37 +3177,20 @@ interface FluidBoxConnectionRecord {
2804
3177
  other_entity: LuaEntity;
2805
3178
  other_linked_connection_id: uint32;
2806
3179
  }
2807
- interface FluidBoxFilter {
2808
- /**
2809
- * Fluid prototype name of the filtered fluid.
2810
- */
2811
- name: string;
2812
- /**
2813
- * The minimum temperature allowed into the fluidbox.
2814
- */
2815
- minimum_temperature: float;
2816
- /**
2817
- * The maximum temperature allowed into the fluidbox.
2818
- */
2819
- maximum_temperature: float;
3180
+ interface FluidBoxNeighbourRecord {
3181
+ entity: LuaEntity;
3182
+ index: FluidStorageIndex;
2820
3183
  }
2821
- interface FluidBoxFilterSpec {
2822
- /**
2823
- * Fluid prototype name of the filtered fluid.
2824
- */
2825
- name: string;
3184
+ interface FluidFilter {
3185
+ fluid?: FluidID;
2826
3186
  /**
2827
- * The minimum temperature allowed into the fluidbox.
3187
+ * The minimum fluid temperature required.
2828
3188
  */
2829
3189
  minimum_temperature?: float;
2830
3190
  /**
2831
- * The maximum temperature allowed into the fluidbox.
3191
+ * The maximum fluid temperature allowed.
2832
3192
  */
2833
3193
  maximum_temperature?: float;
2834
- /**
2835
- * Force the filter to be set, regardless of current fluid content.
2836
- */
2837
- force?: boolean;
2838
3194
  }
2839
3195
  type FluidFlowDirection = 'input-output' | 'input' | 'output';
2840
3196
  /**
@@ -2879,7 +3235,8 @@ interface FluidProduct {
2879
3235
  /**
2880
3236
  * A value in range `[0, 1]`. Fluid is only given with this probability; otherwise no product is produced.
2881
3237
  */
2882
- probability: double;
3238
+ independent_probability: double;
3239
+ shared_probability: SharedProbabilityDefinition;
2883
3240
  /**
2884
3241
  * How much of this product is ignored by statistics.
2885
3242
  */
@@ -3029,6 +3386,15 @@ interface FluidPrototypeFilterSubgroup extends BaseFluidPrototypeFilter {
3029
3386
  */
3030
3387
  'subgroup': string;
3031
3388
  }
3389
+ /**
3390
+ * Valid values are from 1 up to {@link LuaEntity::fluids_count | runtime:LuaEntity::fluids_count}.
3391
+ */
3392
+ type FluidStorageIndex = uint32;
3393
+ interface FogEffectProperties {
3394
+ color1: Color;
3395
+ color2: Color;
3396
+ tick_factor: float;
3397
+ }
3032
3398
  type ForceCondition = /**
3033
3399
  * All forces pass.
3034
3400
  */
@@ -3075,6 +3441,8 @@ ForceID[] | /**
3075
3441
  */
3076
3442
  ForceID;
3077
3443
  interface FurnaceBlueprintControlBehavior {
3444
+ input_networks?: CircuitNetworkSelection;
3445
+ output_networks?: CircuitNetworkSelection;
3078
3446
  /**
3079
3447
  * Defaults to `false`.
3080
3448
  */
@@ -3086,7 +3454,7 @@ interface FurnaceBlueprintControlBehavior {
3086
3454
  /**
3087
3455
  * Defaults to `false`.
3088
3456
  */
3089
- include_fuel?: boolean;
3457
+ read_fuel?: boolean;
3090
3458
  /**
3091
3459
  * Defaults to `false`.
3092
3460
  */
@@ -3116,6 +3484,10 @@ interface FurnaceBlueprintControlBehavior {
3116
3484
  * Parameters that affect the look and control of the game. Updating any of the member attributes here will immediately take effect in the game engine.
3117
3485
  */
3118
3486
  interface GameViewSettings {
3487
+ /**
3488
+ * Makes tall entities translucent and unselectable.
3489
+ */
3490
+ hide_tall_entities: boolean;
3119
3491
  /**
3120
3492
  * Show the flashing alert icons next to the player's toolbar.
3121
3493
  */
@@ -3148,6 +3520,10 @@ interface GameViewSettings {
3148
3520
  * Show the chart in the upper right-hand corner of the screen.
3149
3521
  */
3150
3522
  show_minimap: boolean;
3523
+ /**
3524
+ * Shows or hides the pins GUI on the right side of the screen.
3525
+ */
3526
+ show_pins_gui: boolean;
3151
3527
  /**
3152
3528
  * Shows or hides quickbar of shortcuts.
3153
3529
  */
@@ -3181,6 +3557,56 @@ interface GameViewSettings {
3181
3557
  */
3182
3558
  update_entity_selection: boolean;
3183
3559
  }
3560
+ interface GenericOnOffBlueprintControlBehavior {
3561
+ input_networks?: CircuitNetworkSelection;
3562
+ /**
3563
+ * Defaults to `false`.
3564
+ */
3565
+ circuit_enabled?: boolean;
3566
+ circuit_condition?: CircuitCondition;
3567
+ /**
3568
+ * Defaults to `false`.
3569
+ */
3570
+ connect_to_logistic_network?: boolean;
3571
+ logistic_condition?: CircuitCondition;
3572
+ }
3573
+ interface GhostShimmerConfig {
3574
+ tint: Color;
3575
+ distortion: float;
3576
+ blend_mode: int32;
3577
+ visualize_borders: boolean;
3578
+ proportional_distortion: boolean;
3579
+ world_uv_modulo: float;
3580
+ overlay_layers: GhostShimmerOverlayData[];
3581
+ distortion_layers: GhostShimmerDistortionData[];
3582
+ }
3583
+ interface GhostShimmerDistortionData {
3584
+ shape: int32;
3585
+ intensity: float;
3586
+ x: float;
3587
+ y: float;
3588
+ }
3589
+ interface GhostShimmerOverlayData {
3590
+ blend_mode: int32;
3591
+ shape: int32;
3592
+ x: float;
3593
+ y: float;
3594
+ tint: Color;
3595
+ cutoff: float;
3596
+ }
3597
+ interface GhostTintSet {
3598
+ ghost_tint: Color;
3599
+ ghost_delivery_tint: Color;
3600
+ tile_ghost_tint: Color;
3601
+ tile_ghost_delivery_tint: Color;
3602
+ wire_tint: Color;
3603
+ }
3604
+ interface GlobalTintEffectProperties {
3605
+ global_intensity: float;
3606
+ global_scale: float;
3607
+ zoom_factor: float;
3608
+ zoom_intensity: float;
3609
+ }
3184
3610
  interface GuiAnchor {
3185
3611
  gui: defines.relative_gui_type;
3186
3612
  position: defines.relative_gui_position;
@@ -3362,7 +3788,7 @@ type GuiElementType = /**
3362
3788
  'tab' | /**
3363
3789
  * A switch with three possible states. Can have labels attached to either side. Relevant event: {@link on_gui_switch_state_changed | runtime:on_gui_switch_state_changed}
3364
3790
  */
3365
- 'switch';
3791
+ 'switch' | 'inventory';
3366
3792
  /**
3367
3793
  * Screen coordinates of a GUI element in a {@link LuaGui | runtime:LuaGui}. This uses the same format as {@link TilePosition | runtime:TilePosition}, meaning it can be specified either with or without explicit keys.
3368
3794
  */
@@ -3379,10 +3805,18 @@ interface GunShift4Way {
3379
3805
  south: Vector;
3380
3806
  west: Vector;
3381
3807
  }
3382
- interface HeatConnection {
3808
+ interface HeatConnectionDefinition {
3383
3809
  position: Vector;
3384
3810
  direction: defines.direction;
3385
3811
  }
3812
+ interface HeatPipeBlueprintControlBehavior {
3813
+ output_networks?: CircuitNetworkSelection;
3814
+ /**
3815
+ * Defaults to `false`.
3816
+ */
3817
+ read_temperature?: boolean;
3818
+ temperature_signal: SignalID;
3819
+ }
3386
3820
  /**
3387
3821
  * The settings used by a heat-interface type entity.
3388
3822
  */
@@ -3400,7 +3834,7 @@ type HeatSettingMode = 'at-least' | 'at-most' | 'exactly' | 'add' | 'remove';
3400
3834
  /**
3401
3835
  * All base prototype types.
3402
3836
  */
3403
- type IDType = 'custom-input' | 'equipment-grid' | 'entity' | 'particle' | 'item' | 'collision-layer' | 'airborne-pollutant' | 'tile' | 'decorative' | 'recipe-category' | 'item-group' | 'item-subgroup' | 'recipe' | 'fluid' | 'ammo-category' | 'fuel-category' | 'resource-category' | 'technology' | 'noise-function' | 'noise-expression' | 'autoplace-control' | 'equipment' | 'damage-type' | 'virtual-signal' | 'achievement' | 'module-category' | 'equipment-category' | 'mod-setting' | 'trivial-smoke' | 'asteroid-chunk' | 'quality' | 'surface-property' | 'procession-layer-inheritance-group' | 'procession' | 'space-location' | 'space-connection' | 'active-trigger' | 'shortcut' | 'burner-usage' | 'surface' | 'mod-data' | 'custom-event';
3837
+ type IDType = 'custom-input' | 'equipment-grid' | 'entity' | 'particle' | 'item' | 'collision-layer' | 'airborne-pollutant' | 'tile' | 'decorative' | 'recipe-category' | 'item-group' | 'item-subgroup' | 'recipe' | 'fluid' | 'ammo-category' | 'fuel-category' | 'resource-category' | 'technology' | 'noise-function' | 'noise-expression' | 'autoplace-control' | 'equipment' | 'damage-type' | 'virtual-signal' | 'achievement' | 'module-category' | 'equipment-category' | 'mod-setting' | 'trivial-smoke' | 'asteroid-chunk' | 'quality' | 'surface-property' | 'space-location' | 'space-connection' | 'procession-layer-inheritance-group' | 'procession' | 'active-trigger' | 'shortcut' | 'burner-usage' | 'surface' | 'mod-data' | 'custom-event';
3404
3838
  interface IconDrawSpecification {
3405
3839
  shift: Vector;
3406
3840
  scale: float;
@@ -3477,7 +3911,7 @@ interface BaseIngredient {
3477
3911
  */
3478
3912
  ignored_by_stats?: uint32 | double;
3479
3913
  }
3480
- type Ingredient = BaseIngredient | IngredientFluid;
3914
+ type Ingredient = BaseIngredient | IngredientFluid | IngredientItem;
3481
3915
  /**
3482
3916
  *
3483
3917
  * Applies to variant case `fluid`
@@ -3499,7 +3933,20 @@ interface IngredientFluid extends BaseIngredient {
3499
3933
  */
3500
3934
  'temperature'?: float;
3501
3935
  }
3936
+ /**
3937
+ *
3938
+ * Applies to variant case `item`
3939
+ */
3940
+ interface IngredientItem extends BaseIngredient {
3941
+ 'type': 'item';
3942
+ 'quality_change'?: int8;
3943
+ 'quality_max'?: QualityID;
3944
+ 'quality_min'?: QualityID;
3945
+ 'spoil_weight'?: float;
3946
+ }
3502
3947
  interface InserterBlueprintControlBehavior {
3948
+ input_networks?: CircuitNetworkSelection;
3949
+ output_networks?: CircuitNetworkSelection;
3503
3950
  /**
3504
3951
  * Defaults to `false`.
3505
3952
  */
@@ -3568,6 +4015,10 @@ type ItemFilter = {
3568
4015
  */
3569
4016
  comparator?: ComparatorString;
3570
4017
  } | string;
4018
+ interface ItemHealthColorData {
4019
+ color: Color;
4020
+ threshold: float;
4021
+ }
3571
4022
  /**
3572
4023
  * An item prototype may be specified in one of four ways.
3573
4024
  */
@@ -3660,7 +4111,8 @@ interface ItemProduct {
3660
4111
  /**
3661
4112
  * A value in range `[0, 1]`. Item is only given with this probability; otherwise no product is produced.
3662
4113
  */
3663
- probability: double;
4114
+ independent_probability: double;
4115
+ shared_probability: SharedProbabilityDefinition;
3664
4116
  /**
3665
4117
  * How much of this product is ignored by statistics.
3666
4118
  */
@@ -3674,12 +4126,17 @@ interface ItemProduct {
3674
4126
  */
3675
4127
  extra_count_fraction?: float;
3676
4128
  percent_spoiled?: float;
4129
+ always_fresh?: boolean;
4130
+ quality_min?: QualityID;
4131
+ quality_max?: QualityID;
4132
+ quality_change?: int8;
4133
+ affected_by_quality: boolean;
3677
4134
  }
3678
4135
  interface BaseItemPrototypeFilter {
3679
4136
  /**
3680
4137
  * The condition to filter on.
3681
4138
  */
3682
- filter: 'tool' | 'mergeable' | 'hidden' | 'hidden-in-factoriopedia' | 'is-parameter' | 'item-with-inventory' | 'selection-tool' | 'item-with-label' | 'has-rocket-launch-products' | 'fuel' | 'place-result' | 'burnt-result' | 'place-as-tile' | 'placed-as-equipment-result' | 'plant-result' | 'spoil-result' | 'name' | 'type' | 'flag' | 'subgroup' | 'fuel-category' | 'stack-size' | 'fuel-value' | 'fuel-acceleration-multiplier' | 'fuel-top-speed-multiplier' | 'fuel-emissions-multiplier';
4139
+ filter: 'tool' | 'mergeable' | 'hidden' | 'hidden-in-factoriopedia' | 'is-parameter' | 'item-with-inventory' | 'selection-tool' | 'item-with-label' | 'has-rocket-launch-products' | 'fuel' | 'used-by-labs' | 'place-result' | 'burnt-result' | 'place-as-tile' | 'placed-as-equipment-result' | 'plant-result' | 'spoil-result' | 'name' | 'type' | 'flag' | 'subgroup' | 'fuel-category' | 'stack-size' | 'fuel-value' | 'fuel-acceleration-multiplier' | 'fuel-top-speed-multiplier' | 'fuel-emissions-multiplier';
3683
4140
  /**
3684
4141
  * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
3685
4142
  */
@@ -3935,6 +4392,9 @@ type ItemPrototypeFlag = /**
3935
4392
  * If this item is skipped by the trash-unrequested logic.
3936
4393
  */
3937
4394
  'excluded-from-trash-unrequested' | /**
4395
+ * Whether the rocket passenger feature skips this item when checking lift weight.
4396
+ */
4397
+ 'excluded-from-character-lift-weight' | /**
3938
4398
  * Always shows the item in the logistic requests and filters GUIs (among others) even when the recipe for that item is locked.
3939
4399
  */
3940
4400
  'always-show' | /**
@@ -3961,7 +4421,7 @@ type ItemPrototypeFlag = /**
3961
4421
  'spawnable' | 'spoil-result' | /**
3962
4422
  * Controls whether the spoil time ignores the spoil time modifier in the {@link DifficultySettings | runtime:DifficultySettings}.
3963
4423
  */
3964
- 'ignore-spoil-time-modifier';
4424
+ 'ignore-spoil-time-modifier' | 'hide-health-bar-in-world' | 'hide-spoilage-bar-in-world';
3965
4425
  /**
3966
4426
  * A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
3967
4427
  *
@@ -4076,7 +4536,29 @@ string | /**
4076
4536
  * A table of item prototype and quality.
4077
4537
  */
4078
4538
  ItemIDAndQualityIDPair;
4539
+ interface LabBlueprintControlBehavior {
4540
+ input_networks?: CircuitNetworkSelection;
4541
+ output_networks?: CircuitNetworkSelection;
4542
+ read_contents?: boolean;
4543
+ read_fuel?: boolean;
4544
+ read_research_cost?: boolean;
4545
+ set_research?: boolean;
4546
+ read_technology_level?: boolean;
4547
+ technology_level_signal: SignalID;
4548
+ conditions?: ResearchCondition[];
4549
+ }
4550
+ interface LabStoredDurability {
4551
+ /**
4552
+ * Quality of the currently consumed item.
4553
+ */
4554
+ quality?: QualityID;
4555
+ /**
4556
+ * Amount of durability stored. Must be >= 0.
4557
+ */
4558
+ durability: double;
4559
+ }
4079
4560
  interface LampBlueprintControlBehavior {
4561
+ input_networks?: CircuitNetworkSelection;
4080
4562
  /**
4081
4563
  * Defaults to `false`.
4082
4564
  */
@@ -4100,14 +4582,29 @@ interface LampBlueprintControlBehavior {
4100
4582
  connect_to_logistic_network?: boolean;
4101
4583
  logistic_condition?: CircuitCondition;
4102
4584
  }
4585
+ interface LandMineBlueprintControlBehavior {
4586
+ input_networks?: CircuitNetworkSelection;
4587
+ /**
4588
+ * Defaults to `false`.
4589
+ */
4590
+ circuit_enabled?: boolean;
4591
+ circuit_condition?: CircuitCondition;
4592
+ /**
4593
+ * Defaults to `false`.
4594
+ */
4595
+ connect_to_logistic_network?: boolean;
4596
+ logistic_condition?: CircuitCondition;
4597
+ }
4103
4598
  /**
4104
4599
  * The internal name of a game control (key binding).
4105
4600
  */
4106
- type LinkedGameControl = 'move-up' | 'move-down' | 'move-left' | 'move-right' | 'alternative-gui-move-up' | 'alternative-gui-move-down' | 'alternative-gui-move-left' | 'alternative-gui-move-right' | 'open-character-gui' | 'open-gui' | 'confirm-gui' | 'toggle-free-cursor' | 'mine' | 'build' | 'build-ghost' | 'super-forced-build' | 'clear-cursor' | 'pipette' | 'rotate' | 'reverse-rotate' | 'flip-horizontal' | 'flip-vertical' | 'pick-items' | 'drop-cursor' | 'show-info' | 'shoot-enemy' | 'shoot-selected' | 'next-weapon' | 'toggle-driving' | 'zoom-in' | 'zoom-out' | 'use-item' | 'alternative-use-item' | 'toggle-console' | 'copy-entity-settings' | 'paste-entity-settings' | 'controller-gui-logistics-tab' | 'controller-gui-character-tab' | 'controller-gui-crafting-tab' | 'toggle-rail-layer' | 'select-for-blueprint' | 'select-for-cancel-deconstruct' | 'select-for-super-forced-deconstruct' | 'reverse-select' | 'alt-reverse-select' | 'deselect' | 'cycle-blueprint-forwards' | 'cycle-blueprint-backwards' | 'focus-search' | 'larger-terrain-building-area' | 'smaller-terrain-building-area' | 'remove-pole-cables' | 'build-with-obstacle-avoidance' | 'add-station' | 'add-temporary-station' | 'rename-all' | 'fast-wait-condition' | 'drag-map' | 'move-tag' | 'place-in-chat' | 'place-ping' | 'pin' | 'activate-tooltip' | 'next-surface' | 'previous-surface' | 'cycle-quality-up' | 'cycle-quality-down' | 'scroll-tooltip-up' | 'scroll-tooltip-down' | 'craft' | 'craft-5' | 'craft-all' | 'cancel-craft' | 'cancel-craft-5' | 'cancel-craft-all' | 'pick-item' | 'stack-transfer' | 'inventory-transfer' | 'fast-entity-transfer' | 'cursor-split' | 'stack-split' | 'inventory-split' | 'fast-entity-split' | 'toggle-filter' | 'open-item' | 'copy-inventory-filter' | 'paste-inventory-filter' | 'show-quick-panel' | 'next-quick-panel-page' | 'previous-quick-panel-page' | 'next-quick-panel-tab' | 'previous-quick-panel-tab' | 'rotate-active-quick-bars' | 'next-active-quick-bar' | 'previous-active-quick-bar' | 'quick-bar-button-1' | 'quick-bar-button-2' | 'quick-bar-button-3' | 'quick-bar-button-4' | 'quick-bar-button-5' | 'quick-bar-button-6' | 'quick-bar-button-7' | 'quick-bar-button-8' | 'quick-bar-button-9' | 'quick-bar-button-10' | 'quick-bar-button-1-secondary' | 'quick-bar-button-2-secondary' | 'quick-bar-button-3-secondary' | 'quick-bar-button-4-secondary' | 'quick-bar-button-5-secondary' | 'quick-bar-button-6-secondary' | 'quick-bar-button-7-secondary' | 'quick-bar-button-8-secondary' | 'quick-bar-button-9-secondary' | 'quick-bar-button-10-secondary' | 'action-bar-select-page-1' | 'action-bar-select-page-2' | 'action-bar-select-page-3' | 'action-bar-select-page-4' | 'action-bar-select-page-5' | 'action-bar-select-page-6' | 'action-bar-select-page-7' | 'action-bar-select-page-8' | 'action-bar-select-page-9' | 'action-bar-select-page-10' | 'copy' | 'cut' | 'paste' | 'cycle-clipboard-forwards' | 'cycle-clipboard-backwards' | 'undo' | 'redo' | 'toggle-menu' | 'toggle-map' | 'close-menu' | 'open-technology-gui' | 'production-statistics' | 'logistic-networks' | 'toggle-blueprint-library' | 'open-trains-gui' | 'open-factoriopedia' | 'back' | 'forward' | 'pause-game' | 'confirm-message' | 'previous-mod' | 'connect-train' | 'disconnect-train' | 'submit-feedback' | 'editor-next-variation' | 'editor-previous-variation' | 'editor-clone-item' | 'editor-delete-item' | 'editor-toggle-pause' | 'editor-tick-once' | 'editor-speed-up' | 'editor-speed-down' | 'editor-reset-speed' | 'editor-set-clone-brush-source' | 'editor-set-clone-brush-destination' | 'editor-switch-to-surface' | 'editor-remove-scripting-object' | 'debug-toggle-atlas-gui' | 'debug-toggle-gui-visibility' | 'debug-toggle-debug-settings' | 'debug-toggle-basic' | 'debug-reset-zoom' | 'debug-reset-zoom-2x' | 'toggle-gui-debug' | 'toggle-gui-style-view' | 'toggle-gui-shadows' | 'toggle-gui-glows' | 'open-prototypes-gui' | 'open-prototype-explorer-gui' | 'increase-ui-scale' | 'decrease-ui-scale' | 'reset-ui-scale' | 'slash-editor' | 'toggle-entity' | 'next-player-in-replay' | 'move-blueprint-absolute-grid-up' | 'move-blueprint-absolute-grid-down' | 'move-blueprint-absolute-grid-left' | 'move-blueprint-absolute-grid-right' | 'move-blueprint-entities-up' | 'move-blueprint-entities-down' | 'move-blueprint-entities-left' | 'move-blueprint-entities-right' | 'play-next-track' | 'play-previous-track' | 'pause-resume-music' | /**
4601
+ type LinkedGameControl = 'move-up' | 'move-down' | 'move-left' | 'move-right' | 'alternative-gui-move-up' | 'alternative-gui-move-down' | 'alternative-gui-move-left' | 'alternative-gui-move-right' | 'open-character-gui' | 'open-gui' | 'confirm-gui' | 'toggle-free-cursor' | 'mine' | 'build' | 'build-ghost' | 'super-forced-build' | 'clear-cursor' | 'pipette' | 'rotate' | 'reverse-rotate' | 'flip-horizontal' | 'flip-vertical' | 'pick-items' | 'drop-cursor' | 'show-info' | 'hide-tall-entities' | 'shoot-enemy' | 'shoot-selected' | 'next-weapon' | 'toggle-driving' | 'zoom-in' | 'zoom-out' | 'use-item' | 'alternative-use-item' | 'toggle-console' | 'copy-entity-settings' | 'paste-entity-settings' | 'controller-gui-logistics-tab' | 'controller-gui-character-tab' | 'controller-gui-crafting-tab' | 'toggle-rail-layer' | 'select-for-blueprint' | 'select-for-cancel-deconstruct' | 'select-for-super-forced-deconstruct' | 'reverse-select' | 'alt-reverse-select' | 'deselect' | 'cycle-blueprint-forwards' | 'cycle-blueprint-backwards' | 'focus-search' | 'larger-terrain-building-area' | 'smaller-terrain-building-area' | 'remove-pole-cables' | 'build-with-obstacle-avoidance' | 'add-station' | 'add-temporary-station' | 'rename-all' | 'fast-wait-condition' | 'drag-map' | 'move-tag' | 'place-in-chat' | 'place-ping' | 'pin' | 'activate-tooltip' | 'next-surface' | 'previous-surface' | 'cycle-quality-up' | 'cycle-quality-down' | 'scroll-tooltip-up' | 'scroll-tooltip-down' | 'visualize-entity-fluid-segments' | 'craft' | 'craft-5' | 'craft-all' | 'cancel-craft' | 'cancel-craft-5' | 'cancel-craft-all' | 'pick-item' | 'stack-transfer' | 'inventory-transfer' | 'fast-entity-transfer' | 'cursor-split' | 'stack-split' | 'inventory-split' | 'fast-entity-split' | 'toggle-filter' | 'open-item' | 'copy-inventory-filter' | 'paste-inventory-filter' | 'show-quick-panel' | 'next-quick-panel-page' | 'previous-quick-panel-page' | 'next-quick-panel-tab' | 'previous-quick-panel-tab' | 'rotate-active-quick-bars' | 'next-active-quick-bar' | 'previous-active-quick-bar' | 'quick-bar-button-1' | 'quick-bar-button-2' | 'quick-bar-button-3' | 'quick-bar-button-4' | 'quick-bar-button-5' | 'quick-bar-button-6' | 'quick-bar-button-7' | 'quick-bar-button-8' | 'quick-bar-button-9' | 'quick-bar-button-10' | 'quick-bar-button-1-secondary' | 'quick-bar-button-2-secondary' | 'quick-bar-button-3-secondary' | 'quick-bar-button-4-secondary' | 'quick-bar-button-5-secondary' | 'quick-bar-button-6-secondary' | 'quick-bar-button-7-secondary' | 'quick-bar-button-8-secondary' | 'quick-bar-button-9-secondary' | 'quick-bar-button-10-secondary' | 'action-bar-select-page-1' | 'action-bar-select-page-2' | 'action-bar-select-page-3' | 'action-bar-select-page-4' | 'action-bar-select-page-5' | 'action-bar-select-page-6' | 'action-bar-select-page-7' | 'action-bar-select-page-8' | 'action-bar-select-page-9' | 'action-bar-select-page-10' | 'copy' | 'cut' | 'paste' | 'cycle-clipboard-forwards' | 'cycle-clipboard-backwards' | 'undo' | 'redo' | 'toggle-menu' | 'toggle-map' | 'close-menu' | 'open-technology-gui' | 'production-statistics' | 'logistic-networks' | 'toggle-blueprint-library' | 'open-trains-gui' | 'open-factoriopedia' | 'back' | 'forward' | 'pause-game' | 'confirm-message' | 'previous-mod' | 'connect-train' | 'disconnect-train' | 'submit-feedback' | 'editor-next-variation' | 'editor-previous-variation' | 'editor-clone-item' | 'editor-delete-item' | 'editor-toggle-pause' | 'editor-tick-once' | 'editor-speed-up' | 'editor-speed-down' | 'editor-reset-speed' | 'editor-set-clone-brush-source' | 'editor-set-clone-brush-destination' | 'editor-switch-to-surface' | 'editor-remove-scripting-object' | 'debug-toggle-atlas-gui' | 'debug-toggle-gui-visibility' | 'debug-toggle-debug-settings' | 'debug-toggle-basic' | 'debug-reset-zoom' | 'debug-reset-zoom-2x' | 'toggle-gui-debug' | 'toggle-gui-style-view' | 'toggle-gui-shadows' | 'toggle-gui-glows' | 'open-prototypes-gui' | 'open-prototype-explorer-gui' | 'increase-ui-scale' | 'decrease-ui-scale' | 'reset-ui-scale' | 'slash-editor' | 'toggle-entity' | 'next-player-in-replay' | 'move-blueprint-absolute-grid-up' | 'move-blueprint-absolute-grid-down' | 'move-blueprint-absolute-grid-left' | 'move-blueprint-absolute-grid-right' | 'move-blueprint-entities-up' | 'move-blueprint-entities-down' | 'move-blueprint-entities-left' | 'move-blueprint-entities-right' | 'toggle-blueprint-snap-to-grid' | 'play-next-track' | 'play-previous-track' | 'pause-resume-music' | /**
4107
4602
  * Indicates no linked game control.
4108
4603
  */
4109
4604
  '';
4110
4605
  interface LoaderBlueprintControlBehavior {
4606
+ input_networks?: CircuitNetworkSelection;
4607
+ output_networks?: CircuitNetworkSelection;
4111
4608
  /**
4112
4609
  * Defaults to `false`.
4113
4610
  */
@@ -4166,11 +4663,20 @@ game.print({"", {"item-name.iron-plate"}, ": ", 60})
4166
4663
  */
4167
4664
  type LocalisedString = string | number | boolean | LuaObject | nil | LocalisedString[];
4168
4665
  interface LogisticContainerBlueprintControlBehavior {
4666
+ input_networks?: CircuitNetworkSelection;
4667
+ output_networks?: CircuitNetworkSelection;
4169
4668
  /**
4170
- * Defaults to `send_contents`.
4669
+ * Defaults to `true`.
4171
4670
  */
4172
- circuit_mode_of_operation?: defines.control_behavior.logistic_container.exclusive_mode;
4173
- circuit_condition_enabled: boolean;
4671
+ read_contents?: boolean;
4672
+ /**
4673
+ * Defaults to `false`.
4674
+ */
4675
+ set_requests?: boolean;
4676
+ /**
4677
+ * Defaults to `false`.
4678
+ */
4679
+ circuit_condition_enabled?: boolean;
4174
4680
  circuit_condition?: CircuitCondition;
4175
4681
  }
4176
4682
  interface LogisticFilter {
@@ -4200,6 +4706,7 @@ interface LogisticGroup {
4200
4706
  members: LuaLogisticSection[];
4201
4707
  filters: LogisticFilter[];
4202
4708
  }
4709
+ type LogisticMode = 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
4203
4710
  interface LogisticSection {
4204
4711
  index: uint8;
4205
4712
  filters?: BlueprintLogisticFilter[];
@@ -4244,24 +4751,6 @@ interface LogisticsNetworkSupplyPoints {
4244
4751
  buffer: LuaLogisticPoint[];
4245
4752
  'active-provider': LuaLogisticPoint[];
4246
4753
  }
4247
- interface Loot {
4248
- /**
4249
- * Item prototype name of the result.
4250
- */
4251
- item: string;
4252
- /**
4253
- * Probability that any loot at all will drop, as a number in range [0, 1].
4254
- */
4255
- probability: double;
4256
- /**
4257
- * Minimum amount of loot to drop.
4258
- */
4259
- count_min: double;
4260
- /**
4261
- * Maximum amount of loot to drop.
4262
- */
4263
- count_max: double;
4264
- }
4265
4754
  interface BaseLuaEntityClonedEventFilter {
4266
4755
  /**
4267
4756
  * The condition to filter on.
@@ -6341,7 +6830,6 @@ interface MapAndDifficultySettings {
6341
6830
  enemy_evolution: EnemyEvolutionMapSettings;
6342
6831
  enemy_expansion: EnemyExpansionMapSettings;
6343
6832
  unit_group: UnitGroupMapSettings;
6344
- steering: SteeringMapSettings;
6345
6833
  path_finder: PathFinderMapSettings;
6346
6834
  asteroids: AsteroidMapSettings;
6347
6835
  /**
@@ -6551,7 +7039,6 @@ interface MapSettings {
6551
7039
  max_failed_behavior_count: uint32;
6552
7040
  path_finder: PathFinderMapSettings;
6553
7041
  pollution: PollutionMapSettings;
6554
- steering: SteeringMapSetting;
6555
7042
  unit_group: UnitGroupMapSettings;
6556
7043
  }
6557
7044
  /**
@@ -6656,6 +7143,8 @@ interface MineableProperties {
6656
7143
  mining_trigger?: TriggerItem[];
6657
7144
  }
6658
7145
  interface MiningDrillBlueprintControlBehavior {
7146
+ input_networks?: CircuitNetworkSelection;
7147
+ output_networks?: CircuitNetworkSelection;
6659
7148
  circuit_read_resources: boolean;
6660
7149
  circuit_resource_read_mode: defines.control_behavior.mining_drill.resource_read_mode;
6661
7150
  /**
@@ -6745,17 +7234,15 @@ interface ModSettingPrototypeFilterType extends BaseModSettingPrototypeFilter {
6745
7234
  /**
6746
7235
  * Used by {@link TechnologyModifier | runtime:TechnologyModifier}.
6747
7236
  */
6748
- type ModifierType = 'inserter-stack-size-bonus' | 'bulk-inserter-capacity-bonus' | 'laboratory-speed' | 'character-logistic-trash-slots' | 'maximum-following-robots-count' | 'worker-robot-speed' | 'worker-robot-storage' | 'turret-attack' | 'ammo-damage' | 'give-item' | 'gun-speed' | 'unlock-recipe' | 'character-crafting-speed' | 'character-mining-speed' | 'character-running-speed' | 'character-build-distance' | 'character-item-drop-distance' | 'character-reach-distance' | 'character-resource-reach-distance' | 'character-item-pickup-distance' | 'character-loot-pickup-distance' | 'character-inventory-slots-bonus' | 'deconstruction-time-to-live' | 'max-failed-attempts-per-tick-per-construction-queue' | 'max-successful-attempts-per-tick-per-construction-queue' | 'character-health-bonus' | 'mining-drill-productivity-bonus' | 'train-braking-force-bonus' | 'worker-robot-battery' | 'laboratory-productivity' | 'follower-robot-lifetime' | 'artillery-range' | 'nothing' | 'character-logistic-requests' | 'unlock-space-location' | 'unlock-quality' | 'unlock-space-platforms' | 'unlock-circuit-network' | 'cargo-landing-pad-count' | 'change-recipe-productivity' | 'cliff-deconstruction-enabled' | 'mining-with-fluid' | 'rail-support-on-deep-oil-ocean' | 'rail-planner-allow-elevated-rails' | 'beacon-distribution' | 'create-ghost-on-entity-death' | 'belt-stack-size-bonus' | 'vehicle-logistics';
7237
+ type ModifierType = 'inserter-stack-size-bonus' | 'bulk-inserter-capacity-bonus' | 'laboratory-speed' | 'character-logistic-trash-slots' | 'maximum-following-robots-count' | 'worker-robot-speed' | 'worker-robot-storage' | 'turret-attack' | 'ammo-damage' | 'give-item' | 'gun-speed' | 'unlock-recipe' | 'character-crafting-speed' | 'character-mining-speed' | 'character-running-speed' | 'character-build-distance' | 'character-item-drop-distance' | 'character-reach-distance' | 'character-resource-reach-distance' | 'character-item-pickup-distance' | 'character-loot-pickup-distance' | 'character-inventory-slots-bonus' | 'deconstruction-time-to-live' | 'max-failed-attempts-per-tick-per-construction-queue' | 'max-successful-attempts-per-tick-per-construction-queue' | 'character-health-bonus' | 'mining-drill-productivity-bonus' | 'train-braking-force-bonus' | 'worker-robot-battery' | 'laboratory-productivity' | 'follower-robot-lifetime' | 'artillery-range' | 'nothing' | 'character-logistic-requests' | 'unlock-space-location' | 'unlock-quality' | 'unlock-space-platforms' | 'unlock-circuit-network' | 'cargo-landing-pad-count' | 'max-cargo-bay-unloading-distance' | 'change-recipe-productivity' | 'cliff-deconstruction-enabled' | 'mining-with-fluid' | 'rail-support-on-deep-oil-ocean' | 'rail-planner-allow-elevated-rails' | 'beacon-distribution' | 'create-ghost-on-entity-death' | 'belt-stack-size-bonus' | 'vehicle-logistics' | 'unlock-logistic-network' | 'unlock-travel-to-space-platforms';
6749
7238
  /**
6750
7239
  * The percentual increase of the attribute. A value of `0.6` means a 60% increase.
6751
- *
6752
- * Quality values are multiplied by {@link LuaQualityPrototype::next_probability | runtime:LuaQualityPrototype::next_probability}. For example, if a module's quality effect is 0.2 and the current quality's next_probability is 0.1, then the chance to get the next quality item is 2%.
6753
7240
  */
6754
7241
  type ModuleEffectValue = float;
6755
7242
  /**
6756
7243
  * @example ```
6757
7244
  -- These are the effects of the vanilla Speed Module 3
6758
- {speed = 0.5, consumption = 0.7, quality = -0.25}
7245
+ {speed = 0.5, consumption = 0.7, quality = -0.025}
6759
7246
  ```
6760
7247
  */
6761
7248
  interface ModuleEffects {
@@ -6776,12 +7263,28 @@ interface NeighbourConnectable {
6776
7263
  neighbour_search_distance: float;
6777
7264
  connections: NeighbourConnectableConnectionDefinition[];
6778
7265
  }
6779
- interface NeighbourConnectableConnectionDefinition {
6780
- location: MapLocation;
6781
- category: string;
6782
- neighbour_category: string[];
6783
- }
6784
- /**
7266
+ interface NeighbourConnectableConnection {
7267
+ position: MapPosition;
7268
+ direction: defines.direction;
7269
+ /**
7270
+ * Entity to which this connection is connected to, if any.
7271
+ */
7272
+ target?: LuaEntity;
7273
+ /**
7274
+ * Whether connected entity is real or ghost.
7275
+ */
7276
+ target_real?: boolean;
7277
+ /**
7278
+ * If multiple connections are connected to the same target, only one connection is marked as first and provides neighbour bonuses.
7279
+ */
7280
+ first?: boolean;
7281
+ }
7282
+ interface NeighbourConnectableConnectionDefinition {
7283
+ location: MapLocation;
7284
+ category: string;
7285
+ neighbour_category: string[];
7286
+ }
7287
+ /**
6785
7288
  * The string representation of a noise expression. More detailed information is found on the {@link prototype docs | prototype:NamedNoiseExpression}.
6786
7289
  */
6787
7290
  type NoiseExpressionSourceString = string;
@@ -6812,6 +7315,28 @@ interface OldTileAndPosition {
6812
7315
  old_tile: LuaTilePrototype;
6813
7316
  position: TilePosition;
6814
7317
  }
7318
+ interface OrientedCliffPrototypeSet {
7319
+ west_to_east: BoundingBox;
7320
+ north_to_south: BoundingBox;
7321
+ east_to_west: BoundingBox;
7322
+ south_to_north: BoundingBox;
7323
+ west_to_north: BoundingBox;
7324
+ north_to_east: BoundingBox;
7325
+ east_to_south: BoundingBox;
7326
+ south_to_west: BoundingBox;
7327
+ west_to_south: BoundingBox;
7328
+ north_to_west: BoundingBox;
7329
+ east_to_north: BoundingBox;
7330
+ south_to_east: BoundingBox;
7331
+ west_to_none: BoundingBox;
7332
+ none_to_east: BoundingBox;
7333
+ north_to_none: BoundingBox;
7334
+ none_to_south: BoundingBox;
7335
+ east_to_none: BoundingBox;
7336
+ none_to_west: BoundingBox;
7337
+ south_to_none: BoundingBox;
7338
+ none_to_north: BoundingBox;
7339
+ }
6815
7340
  /**
6816
7341
  * A particle prototype may be specified in one of two ways.
6817
7342
  */
@@ -7014,7 +7539,7 @@ interface PipeConnection {
7014
7539
  /**
7015
7540
  * The connected fluidbox, if any.
7016
7541
  */
7017
- target?: LuaFluidBox;
7542
+ target?: LuaEntity;
7018
7543
  /**
7019
7544
  * The index of the target fluidbox, if any.
7020
7545
  */
@@ -7037,10 +7562,19 @@ interface PipeConnectionDefinition {
7037
7562
  flow_direction: FluidFlowDirection;
7038
7563
  direction: defines.direction;
7039
7564
  connection_category: string[];
7565
+ hide_connection_info: boolean;
7040
7566
  /**
7041
- * Only supplied if `connection_type` is `"linked"`.
7567
+ * Only provided if `connection_type` is `"linked"`.
7042
7568
  */
7043
7569
  linked_connection_id?: uint32;
7570
+ /**
7571
+ * Only provided if different from `direction`.
7572
+ */
7573
+ alt_direction?: defines.direction;
7574
+ /**
7575
+ * Only provided if different from first position inside of `positions`.
7576
+ */
7577
+ alt_position?: MapPosition;
7044
7578
  }
7045
7579
  type PipeConnectionType = /**
7046
7580
  * 2 connections are required to be adjacent tiles next to each other on their respective directions.
@@ -7063,6 +7597,49 @@ interface PlaceAsTileResult {
7063
7597
  invert: boolean;
7064
7598
  tile_condition: LuaTilePrototype[];
7065
7599
  }
7600
+ interface PlatformBackdrop {
7601
+ position: Vector;
7602
+ radius: float;
7603
+ rotation_seconds: float;
7604
+ planet_axis: Vector;
7605
+ planet_axis_deviation_amplitude: Vector;
7606
+ planet_axis_deviation_seconds: Vector;
7607
+ parallax_strength: Vector;
7608
+ flight_approach_speed: float;
7609
+ emission_scales_with_shadow: boolean;
7610
+ hero_clouds_are_emissive: boolean;
7611
+ atmosphere_thickness: float;
7612
+ atmosphere_color: Color;
7613
+ specular_color: Color;
7614
+ light_color: Color;
7615
+ light_direction: Vector3D;
7616
+ atmosphere_ray_light_color_1: Color;
7617
+ atmosphere_ray_light_color_2: Color;
7618
+ surface_normal_intensity: float;
7619
+ cloud_normal_intensity: float;
7620
+ specular_intensity: float;
7621
+ cloudiness: float;
7622
+ emission_scalar: float;
7623
+ light_radius: float;
7624
+ light_intensity_contrast: float;
7625
+ surface_vertical_offset: float;
7626
+ cloud_vertical_offset: float;
7627
+ cloud_flow_intensity: float;
7628
+ cloud_flow_seconds: float;
7629
+ cloud_panning_rate: float;
7630
+ hero_clouds: PlatformBackdropHeroCloud[];
7631
+ }
7632
+ interface PlatformBackdropHeroCloud {
7633
+ sprite_index: uint8;
7634
+ rotation_speed: float;
7635
+ rotate_with_planet: boolean;
7636
+ size: Vector;
7637
+ positions: Vector[];
7638
+ starting_frame_offset: uint16;
7639
+ rotation_deviation: float;
7640
+ position_deviation: Vector;
7641
+ projection_style: 'none' | 'front-only' | 'front-and-back' | 'front-and-back-inverted';
7642
+ }
7066
7643
  interface PlatformSchedule {
7067
7644
  /**
7068
7645
  * Index of the currently active record
@@ -7070,6 +7647,36 @@ interface PlatformSchedule {
7070
7647
  current: uint32;
7071
7648
  records: ScheduleRecord[];
7072
7649
  }
7650
+ interface PlayMusicSpecification {
7651
+ /**
7652
+ * The name of ambient sound to play.
7653
+ */
7654
+ name: string;
7655
+ /**
7656
+ * Skip the natural pause between music tracks. If there is currently a track playing, this has no effect. Defaults to `false`.
7657
+ */
7658
+ skip_natural_pause?: boolean;
7659
+ /**
7660
+ * Don't transition from this music track on surface change. Defaults to `false`.
7661
+ */
7662
+ dont_transition_from?: boolean;
7663
+ /**
7664
+ * Number of ticks for the music transition delay.
7665
+ */
7666
+ delay_duration?: uint32;
7667
+ /**
7668
+ * Number of ticks for the music transition fade out.
7669
+ */
7670
+ fade_out_duration?: uint32;
7671
+ /**
7672
+ * Number of ticks for the music transition pause.
7673
+ */
7674
+ pause_duration?: uint32;
7675
+ /**
7676
+ * Number of ticks for the music transition fade in.
7677
+ */
7678
+ fade_in_duration?: uint32;
7679
+ }
7073
7680
  interface PlaySoundSpecification {
7074
7681
  /**
7075
7682
  * The sound to play.
@@ -7088,6 +7695,11 @@ interface PlaySoundSpecification {
7088
7695
  */
7089
7696
  override_sound_type?: SoundType;
7090
7697
  }
7698
+ interface PlayerColorData {
7699
+ name: string;
7700
+ player_color: Color;
7701
+ chat_color: Color;
7702
+ }
7091
7703
  /**
7092
7704
  * A player may be specified in one of three ways.
7093
7705
  */
@@ -7101,6 +7713,12 @@ string | /**
7101
7713
  * A reference to {@link LuaPlayer | runtime:LuaPlayer} may be passed directly.
7102
7714
  */
7103
7715
  LuaPlayer;
7716
+ interface Pollutant {
7717
+ /**
7718
+ * If nil, pollution is disabled.
7719
+ */
7720
+ pollutant?: LuaAirbornePollutantPrototype;
7721
+ }
7104
7722
  /**
7105
7723
  * These values are for the time frame of one second (60 ticks).
7106
7724
  */
@@ -7167,18 +7785,6 @@ interface PostSegmentDiedData {
7167
7785
  */
7168
7786
  orientation?: RealOrientation;
7169
7787
  }
7170
- interface PowerSwitchBlueprintControlBehavior {
7171
- /**
7172
- * Defaults to `false`.
7173
- */
7174
- circuit_enabled?: boolean;
7175
- circuit_condition?: CircuitCondition;
7176
- /**
7177
- * Defaults to `false`.
7178
- */
7179
- connect_to_logistic_network?: boolean;
7180
- logistic_condition?: CircuitCondition;
7181
- }
7182
7788
  interface PrintSettings {
7183
7789
  /**
7184
7790
  * Color of the message to print. Defaults to white.
@@ -7205,6 +7811,21 @@ interface PrintSettings {
7205
7811
  */
7206
7812
  game_state?: boolean;
7207
7813
  }
7814
+ /**
7815
+ * The name of a {@link ProcessionPrototype | prototype:ProcessionPrototype}.
7816
+ */
7817
+ type ProcessionID = string;
7818
+ interface ProcessionSet {
7819
+ arrival: ProcessionID[];
7820
+ departure: ProcessionID[];
7821
+ }
7822
+ interface ProcessionTimeline {
7823
+ duration: MapTick;
7824
+ special_action_tick: MapTick;
7825
+ draw_switch_tick: MapTick;
7826
+ intermezzo_min_duration: MapTick;
7827
+ intermezzo_max_duration: MapTick;
7828
+ }
7208
7829
  /**
7209
7830
  * Returns one of the subtypes, depending on the value of `type`.
7210
7831
  * @example ```
@@ -7299,7 +7920,7 @@ type PropertyExpressionNames = Record<string, string>;
7299
7920
  *
7300
7921
  * Filters are always used as an array of filters of a specific type. Every filter can only be used with its corresponding prototype type, and different types of prototype filters can not be mixed.
7301
7922
  */
7302
- type PrototypeFilter = (ModSettingPrototypeFilter | SpaceLocationPrototypeFilter | DecorativePrototypeFilter | TilePrototypeFilter | AsteroidChunkPrototypeFilter | ItemPrototypeFilter | TechnologyPrototypeFilter | RecipePrototypeFilter | AchievementPrototypeFilter | EquipmentPrototypeFilter | FluidPrototypeFilter | EntityPrototypeFilter)[];
7923
+ type PrototypeFilter = (AchievementPrototypeFilter | AsteroidChunkPrototypeFilter | DecorativePrototypeFilter | EquipmentPrototypeFilter | FluidPrototypeFilter | ModSettingPrototypeFilter | RecipePrototypeFilter | SpaceLocationPrototypeFilter | TechnologyPrototypeFilter | TilePrototypeFilter | VirtualSignalPrototypeFilter | EntityPrototypeFilter | ItemPrototypeFilter)[];
7303
7924
  type PrototypeFilterMode = 'none' | 'whitelist' | 'blacklist';
7304
7925
  interface PrototypeHistory {
7305
7926
  /**
@@ -7311,6 +7932,16 @@ interface PrototypeHistory {
7311
7932
  */
7312
7933
  changed: string[];
7313
7934
  }
7935
+ interface PrototypeStrafeSettings {
7936
+ max_distance: double;
7937
+ ideal_distance: double;
7938
+ ideal_distance_tolerance: double;
7939
+ ideal_distance_variance: double;
7940
+ ideal_distance_importance: float;
7941
+ ideal_distance_importance_variance: float;
7942
+ clockwise_chance: float;
7943
+ face_target: boolean;
7944
+ }
7314
7945
  interface PrototypeWithQuality {
7315
7946
  /**
7316
7947
  * Name of a prototype.
@@ -7322,12 +7953,14 @@ interface PrototypeWithQuality {
7322
7953
  quality?: string;
7323
7954
  }
7324
7955
  interface ProxyContainerBlueprintControlBehavior {
7956
+ output_networks?: CircuitNetworkSelection;
7325
7957
  /**
7326
7958
  * Defaults to `true`.
7327
7959
  */
7328
7960
  read_contents?: boolean;
7329
7961
  }
7330
7962
  interface PumpBlueprintControlBehavior {
7963
+ input_networks?: CircuitNetworkSelection;
7331
7964
  /**
7332
7965
  * Defaults to `false`.
7333
7966
  */
@@ -7366,11 +7999,41 @@ LuaQualityPrototype | /**
7366
7999
  * The prototype name.
7367
8000
  */
7368
8001
  string;
8002
+ interface QuickBarSlot {
8003
+ /**
8004
+ * Type of slot content
8005
+ */
8006
+ type: 'record' | 'remote' | 'filter' | 'item';
8007
+ /**
8008
+ * Only present and mandatory when `type` is `record`.
8009
+ */
8010
+ record?: LuaRecord;
8011
+ /**
8012
+ * Only present and mandatory when `type` is `remote` or `filter`. Name must be present (cannot be a quality only item filter).
8013
+ */
8014
+ filter?: ItemFilter;
8015
+ /**
8016
+ * Only present and mandatory when `type` is `remote`. Entities must be spider-vehicles.
8017
+ */
8018
+ selection?: LuaEntity[];
8019
+ /**
8020
+ * Only present and mandatory when `type` is `item`.
8021
+ */
8022
+ item?: LuaItem;
8023
+ }
8024
+ interface RadarBlueprintControlBehavior {
8025
+ /**
8026
+ * Defaults to `defines.control_behavior.radar.mode.surface`.
8027
+ */
8028
+ mode?: defines.control_behavior.radar.mode;
8029
+ universe_channel?: SignalID;
8030
+ }
7369
8031
  interface RadiusVisualisationSpecification {
7370
8032
  distance: double;
7371
8033
  offset: Vector;
7372
8034
  draw_in_cursor: boolean;
7373
8035
  draw_on_selection: boolean;
8036
+ distance_quality_multiplier?: Record<string, double>;
7374
8037
  }
7375
8038
  interface RailEndGoal {
7376
8039
  /**
@@ -7423,6 +8086,8 @@ interface RailLocation {
7423
8086
  rail_layer: defines.rail_layer;
7424
8087
  }
7425
8088
  interface RailSignalBaseBlueprintControlBehavior {
8089
+ input_networks?: CircuitNetworkSelection;
8090
+ output_networks?: CircuitNetworkSelection;
7426
8091
  circuit_close_signal: boolean;
7427
8092
  circuit_read_signal: boolean;
7428
8093
  red_output_signal?: SignalID;
@@ -7433,10 +8098,11 @@ interface RailSignalBaseBlueprintControlBehavior {
7433
8098
  }
7434
8099
  type RangeMode = 'center-to-center' | 'bounding-box-to-bounding-box' | 'center-to-bounding-box';
7435
8100
  interface ReactorBlueprintControlBehavior {
8101
+ output_networks?: CircuitNetworkSelection;
7436
8102
  /**
7437
8103
  * Defaults to `false`.
7438
8104
  */
7439
- read_burner_fuel?: boolean;
8105
+ read_fuel?: boolean;
7440
8106
  /**
7441
8107
  * Defaults to `false`.
7442
8108
  */
@@ -7489,7 +8155,7 @@ interface BaseRecipePrototypeFilter {
7489
8155
  /**
7490
8156
  * The condition to filter on.
7491
8157
  */
7492
- filter: 'enabled' | 'hidden' | 'hidden-from-flow-stats' | 'hidden-from-player-crafting' | 'allow-as-intermediate' | 'allow-intermediates' | 'allow-decomposition' | 'always-show-made-in' | 'always-show-products' | 'show-amount-in-title' | 'has-ingredients' | 'has-products' | 'has-ingredient-item' | 'has-ingredient-fluid' | 'has-product-item' | 'has-product-fluid' | 'subgroup' | 'category' | 'energy' | 'emissions-multiplier' | 'request-paste-multiplier' | 'overload-multiplier';
8158
+ filter: 'enabled' | 'hidden' | 'hidden-from-flow-stats' | 'hidden-from-player-crafting' | 'allow-as-intermediate' | 'allow-intermediates' | 'allow-decomposition' | 'always-show-made-in' | 'has-ingredients' | 'has-products' | 'has-ingredient-item' | 'has-ingredient-fluid' | 'has-product-item' | 'has-product-fluid' | 'subgroup' | 'category' | 'energy' | 'emissions-multiplier' | 'request-paste-multiplier' | 'overload-multiplier';
7493
8159
  /**
7494
8160
  * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
7495
8161
  */
@@ -7724,7 +8390,16 @@ LuaSchedule | /**
7724
8390
  LuaTerritory | /**
7725
8391
  * Target type {@link segmented_unit | runtime:defines.target_type.segmented_unit}; `useful_id` {@link LuaSegmentedUnit::unit_number | runtime:LuaSegmentedUnit::unit_number}
7726
8392
  */
7727
- LuaSegmentedUnit;
8393
+ LuaSegmentedUnit | /**
8394
+ * Target type {@link electric_network | runtime:defines.target_type.electric_network}
8395
+ */
8396
+ LuaElectricNetwork | /**
8397
+ * Target type {@link electric_sub_network | runtime:defines.target_type.electric_sub_network}; `useful_id` {@link LuaElectricSubNetwork::id | runtime:LuaElectricSubNetwork::id}
8398
+ */
8399
+ LuaElectricSubNetwork | /**
8400
+ * Target type {@link force | runtime:defines.target_type.force}; `useful_id` {@link LuaForce::index | runtime:LuaForce::index}
8401
+ */
8402
+ LuaForce;
7728
8403
  /**
7729
8404
  * A number between 0 and 255 inclusive, represented by one of the following named strings or the string version of the number. For example `"10"` and `"decals"` are both valid. Higher values are rendered above lower values.
7730
8405
  */
@@ -7945,6 +8620,18 @@ string | /**
7945
8620
  * 226
7946
8621
  */
7947
8622
  'cursor';
8623
+ type RequestFromLocation = 'planet' | 'platforms' | 'all';
8624
+ interface ResearchCondition {
8625
+ condition?: CircuitCondition;
8626
+ /**
8627
+ * The technology to research when the condition passes.
8628
+ */
8629
+ name?: string;
8630
+ /**
8631
+ * The technology level to research (only applicable for infinite technologies) defaults to 0.
8632
+ */
8633
+ count?: uint32;
8634
+ }
7948
8635
  interface ResearchIngredient {
7949
8636
  /**
7950
8637
  * Prototype name of the required item.
@@ -8032,6 +8719,7 @@ interface RidingState {
8032
8719
  direction: defines.riding.direction;
8033
8720
  }
8034
8721
  interface RoboportBlueprintControlBehavior {
8722
+ output_networks?: CircuitNetworkSelection;
8035
8723
  read_items_mode?: boolean;
8036
8724
  read_robot_stats?: boolean;
8037
8725
  available_logistic_output_signal?: SignalID;
@@ -8041,6 +8729,7 @@ interface RoboportBlueprintControlBehavior {
8041
8729
  roboport_count_output_signal?: SignalID;
8042
8730
  }
8043
8731
  interface RocketSiloBlueprintControlBehavior {
8732
+ output_networks?: CircuitNetworkSelection;
8044
8733
  /**
8045
8734
  * Defaults to `logistic_inventory`.
8046
8735
  */
@@ -8052,6 +8741,22 @@ interface RollingStockDrawData {
8052
8741
  slope: float;
8053
8742
  height: float;
8054
8743
  }
8744
+ interface RuntimeTooltipField {
8745
+ id?: uint32;
8746
+ name: LocalisedString;
8747
+ value: LocalisedString;
8748
+ order?: uint8;
8749
+ }
8750
+ interface SavedLogisticFilters {
8751
+ trash_not_requested: boolean;
8752
+ sections: SavedLogisticSection[];
8753
+ }
8754
+ interface SavedLogisticSection {
8755
+ group: string;
8756
+ filters: LogisticFilter[];
8757
+ multiplier: float;
8758
+ active: boolean;
8759
+ }
8055
8760
  interface ScheduleInterrupt {
8056
8761
  /**
8057
8762
  * Defaults to an empty string.
@@ -8107,11 +8812,20 @@ interface ScriptPosition {
8107
8812
  color: Color;
8108
8813
  id: uint32;
8109
8814
  }
8110
- type ScriptRenderMode = 'game' | 'chart';
8815
+ type ScriptRenderMode = /**
8816
+ * Draw the object in the game world.
8817
+ */
8818
+ 'game' | /**
8819
+ * Draw the object on the map.
8820
+ */
8821
+ 'chart' | /**
8822
+ * Draw the object only when the player holds a buildable item trying to build an entity.
8823
+ */
8824
+ 'build-cursor';
8111
8825
  /**
8112
8826
  * When writing it is possible to give LuaEntity or MapPosition directly. However, reading always returns the full ScriptRenderTargetTable.
8113
8827
  *
8114
- * The full ScriptRenderTargetTable allows specifying an offset for entity targets.
8828
+ * The full ScriptRenderTargetTable allows specifying cursor targets and an offset for entity targets.
8115
8829
  *
8116
8830
  * If an entity target of an object (except its `orientation_target`) is destroyed or changes surface, then the object is also destroyed.
8117
8831
  * @example ```
@@ -8121,32 +8835,72 @@ target = some_lua_entity
8121
8835
  target = {1, 4}
8122
8836
  ```
8123
8837
  * @example ```
8124
- target = {entity = another_lua_entity, offset = {-0.5, 1}}
8838
+ target = {type = "entity", entity = another_lua_entity, offset = {-0.5, 1}}
8839
+ ```
8840
+ * @example ```
8841
+ target = {type = "position", position = {2.5, 3}}
8842
+ ```
8843
+ * @example ```
8844
+ target = {type = "cursor", offset = {6, 7}}
8125
8845
  ```
8126
8846
  * @example ```
8127
- target = {position = {2.5, 3}}
8847
+ target = {type = "build-cursor", offset = {3.2, -4.5}}
8128
8848
  ```
8129
8849
  */
8130
8850
  type ScriptRenderTarget = LuaEntity | MapPosition | ScriptRenderTargetTable;
8131
8851
  /**
8852
+ * If an entity target of an object (except its `orientation_target`) is destroyed or changes surface, then the object is also destroyed.
8853
+ *
8854
+ * Targets of type `"cursor"` draw at the position of the player's cursor.
8855
+ *
8856
+ * Targets of type `"build-cursor"` draw at the position of the player's build cursor, including snapping to the build position. The offset is rotated by the entity's direction and mirrored if the entity to be built is mirrored. Recommended to be combined with {@link ScriptRenderMode::build-cursor | runtime:ScriptRenderMode::build-cursor}.
8857
+ * @example ```
8858
+ {type = "entity", entity = some_lua_entity, offset = {-0.5, 1}}
8859
+ ```
8132
8860
  * @example ```
8133
- {entity = some_lua_entity, offset = {-0.5, 1}}
8861
+ {entity = some_lua_entity, offset = {-0.5, 1}} -- same target as previous example
8134
8862
  ```
8135
8863
  * @example ```
8136
- {position = {2.5, 3}}
8864
+ {type = "position", position = {2.5, 3}}
8865
+ ```
8866
+ * @example ```
8867
+ {position = {2.5, 3}} -- same target as previous example
8868
+ ```
8869
+ * @example ```
8870
+ {type = "cursor", offset = {6, 7}}
8871
+ ```
8872
+ * @example ```
8873
+ {type = "build-cursor", offset = {3.2, -4.5}}
8137
8874
  ```
8138
8875
  */
8139
8876
  interface ScriptRenderTargetTable {
8877
+ /**
8878
+ * Defaults to `"entity"` if `entity` is given. Defaults to `"position"` if `position` is given.
8879
+ */
8880
+ type?: 'entity' | 'position' | 'cursor' | 'build-cursor';
8881
+ /**
8882
+ * Only used, and mandatory if `type` is `entity`.
8883
+ */
8140
8884
  entity?: LuaEntity;
8141
8885
  /**
8142
- * Only used if `entity` was given.
8886
+ * Only used if `type` is `entity`, `cursor` or `build-cursor`. Defaults to `{0, 0}`.
8143
8887
  */
8144
8888
  offset?: Vector;
8145
8889
  /**
8146
- * Only used, and mandatory if `entity` is not given.
8890
+ * Only used, and mandatory if `type` is `position`.
8147
8891
  */
8148
8892
  position?: MapPosition;
8149
8893
  }
8894
+ type ScriptSpriteLightMode = /**
8895
+ * Draw as a regular sprite which occludes light under it if this option is enabled in graphics settings.
8896
+ */
8897
+ 'occluder' | /**
8898
+ * Draw as light.
8899
+ */
8900
+ 'light' | /**
8901
+ * Draw as both occluder and light at once to make the sprite visible during the day and glow at night.
8902
+ */
8903
+ 'glow';
8150
8904
  /**
8151
8905
  * Scroll policy of a {@link scroll pane | runtime:LuaGuiElement}.
8152
8906
  */
@@ -8314,13 +9068,13 @@ interface SelectedPrototypeData {
8314
9068
  * A set of flags on a selection tool that define how entities and tiles are selected. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
8315
9069
  */
8316
9070
  type SelectionModeFlags = Record</**
8317
- * Selects entities and tiles as if selecting them for a blueprint.
9071
+ * Excludes entities and tiles that can't be selected for blueprinting.
8318
9072
  */
8319
9073
  'blueprint' | /**
8320
- * Selects entities and tiles as if selecting them for deconstruction.
9074
+ * Excludes entities and tiles that can't be selected for deconstruction.
8321
9075
  */
8322
9076
  'deconstruct' | /**
8323
- * Selects entities and tiles as if selecting them for deconstruction cancellation.
9077
+ * Excludes entities that can't be selected for deconstruction cancellation.
8324
9078
  */
8325
9079
  'cancel-deconstruct' | /**
8326
9080
  * Selects items on the ground.
@@ -8356,13 +9110,13 @@ type SelectionModeFlags = Record</**
8356
9110
  * Selects entities from an {@link enemy | runtime:LuaForce::is_enemy} force.
8357
9111
  */
8358
9112
  'enemy' | /**
8359
- * Selects entities as if selecting them for upgrading.
9113
+ * Excludes entities that can't be selected for upgrading.
8360
9114
  */
8361
9115
  'upgrade' | /**
8362
- * Selects entities as if selecting them for upgrade cancellation.
9116
+ * Excludes entities that can't be selected for upgrade cancellation.
8363
9117
  */
8364
9118
  'cancel-upgrade' | /**
8365
- * Selects entities as if selecting them for downgrading.
9119
+ * Excludes entities that can't be selected for downgrading.
8366
9120
  */
8367
9121
  'downgrade' | /**
8368
9122
  * Selects entities that are {@link entities with health | runtime:LuaEntity::is_entity_with_health}.
@@ -8383,14 +9137,14 @@ type SelectionModeFlags = Record</**
8383
9137
  * Selects entities that are `tile-ghost`s.
8384
9138
  */
8385
9139
  'tile-ghost', true>;
8386
- type SelectorCombinatorParameterOperation = 'select' | 'count' | 'random' | 'quality-transfer' | 'rocket-capacity' | 'stack-size' | 'quality-filter';
9140
+ type SelectorCombinatorParameterOperation = 'select' | 'count' | 'random' | 'quality-transfer' | 'rocket-capacity' | 'stack-size' | 'quality-filter' | 'time';
8387
9141
  interface BaseSelectorCombinatorParameters {
8388
9142
  /**
8389
9143
  * Defaults to `"select"`.
8390
9144
  */
8391
9145
  operation?: SelectorCombinatorParameterOperation;
8392
9146
  }
8393
- type SelectorCombinatorParameters = BaseSelectorCombinatorParameters | SelectorCombinatorParametersCount | SelectorCombinatorParametersQualityFilter | SelectorCombinatorParametersQualityTransfer | SelectorCombinatorParametersRandom | SelectorCombinatorParametersSelect;
9147
+ type SelectorCombinatorParameters = BaseSelectorCombinatorParameters | SelectorCombinatorParametersCount | SelectorCombinatorParametersQualityFilter | SelectorCombinatorParametersQualityTransfer | SelectorCombinatorParametersRandom | SelectorCombinatorParametersSelect | SelectorCombinatorParametersTime;
8394
9148
  /**
8395
9149
  *
8396
9150
  * Applies to variant case `count`
@@ -8472,6 +9226,38 @@ interface SelectorCombinatorParametersSelect extends BaseSelectorCombinatorParam
8472
9226
  */
8473
9227
  'select_max'?: boolean;
8474
9228
  }
9229
+ /**
9230
+ *
9231
+ * Applies to variant case `time`
9232
+ */
9233
+ interface SelectorCombinatorParametersTime extends BaseSelectorCombinatorParameters {
9234
+ /**
9235
+ * Defaults to `"select"`.
9236
+ */
9237
+ 'operation'?: 'time';
9238
+ /**
9239
+ * ;
9240
+ */
9241
+ 'day_length_signal'?: SignalID;
9242
+ /**
9243
+ * ;
9244
+ */
9245
+ 'day_tick_signal'?: SignalID;
9246
+ /**
9247
+ * ;
9248
+ */
9249
+ 'game_tick_signal'?: SignalID;
9250
+ }
9251
+ interface SharedProbabilityDefinition {
9252
+ /**
9253
+ * Lower end of the range of shared roll values that will allow product to be given. Must be >= `0` and <= `max`.
9254
+ */
9255
+ min: double;
9256
+ /**
9257
+ * Upper end of the range of shared roll values that will allow product to be given. Must be >= `min` and <= `1`.
9258
+ */
9259
+ max: double;
9260
+ }
8475
9261
  /**
8476
9262
  * An actual signal transmitted by the network.
8477
9263
  */
@@ -8492,7 +9278,7 @@ interface Signal {
8492
9278
  */
8493
9279
  type SignalFilter = {
8494
9280
  /**
8495
- * The type of the signal filter.
9281
+ * The type of the signal filter. If not provided, and `name` is the name of a {@link SignalIDType | runtime:SignalIDType}-type prototype, its type is used. Defaults to `"item"` otherwise.
8496
9282
  */
8497
9283
  type?: SignalIDType;
8498
9284
  /**
@@ -8533,7 +9319,42 @@ interface SignalIDBase {
8533
9319
  name?: string;
8534
9320
  }
8535
9321
  type SignalIDType = 'item' | 'fluid' | 'virtual' | 'entity' | 'recipe' | 'space-location' | 'asteroid-chunk' | 'quality';
9322
+ interface SimpleBoundingBox {
9323
+ left_top: MapPosition;
9324
+ right_bottom: MapPosition;
9325
+ }
9326
+ interface SimulationDefinition {
9327
+ planet: SpaceLocationID;
9328
+ game_view_settings: GameViewSettings;
9329
+ save: string;
9330
+ init: string;
9331
+ update: string;
9332
+ mods: string[];
9333
+ init_update_count: uint32;
9334
+ length: uint32;
9335
+ generate_map: boolean;
9336
+ checkboard: boolean;
9337
+ hide_health_bars: boolean;
9338
+ mute_technology_finished_sound: boolean;
9339
+ mute_alert_sounds: boolean;
9340
+ volume_modifier?: float;
9341
+ override_volume?: boolean;
9342
+ mute_wind_sounds?: boolean;
9343
+ hide_factoriopedia_gradient?: boolean;
9344
+ }
8536
9345
  type SimulationWidgetType = 'signal-id' | 'signal-id-base' | 'signal-or-number' | 'simple-slot' | 'simple-item-slot' | 'recipe-slot' | 'quickbar-slot' | 'logistics-button' | 'logistics-button-space' | 'text-button-localised-substring' | 'text-button' | 'text-button-substring' | 'inventory-limit-slot-button' | 'train-schedule-action-button' | 'choose-button' | 'textfield' | 'item-group-tab' | 'drop-down' | 'check-box' | 'switch' | 'label';
9346
+ interface SingleFluidBoxBlueprintControlBehavior {
9347
+ output_networks?: CircuitNetworkSelection;
9348
+ /**
9349
+ * Defaults to `send_contents`.
9350
+ */
9351
+ circuit_mode_of_operation?: defines.control_behavior.single_fluid_box.exclusive_mode;
9352
+ /**
9353
+ * Defaults to `false`.
9354
+ */
9355
+ read_temperature?: boolean;
9356
+ temperature_signal: SignalID;
9357
+ }
8537
9358
  interface SlotFilter {
8538
9359
  /**
8539
9360
  * Position of the corresponding filter slot.
@@ -8573,7 +9394,7 @@ interface SmokeSource {
8573
9394
  * The utility and ambient types each contain general use sound prototypes defined by the game itself.
8574
9395
  *
8575
9396
  * - `"utility"` - Uses {@link UtilitySounds | prototype:UtilitySounds}. Example: `"utility/wire_connect_pole"`
8576
- * - `"ambient"` - Uses {@link AmbientSound | prototype:AmbientSound}. Example: `"ambient/resource-deficiency"`
9397
+ * - `"ambient"` - Uses {@link AmbientSound::sound | prototype:AmbientSound::sound}. Variable sounds cannot be used. Example: `"ambient/resource-deficiency"`
8577
9398
  * The following types can be combined with any tile name as long as its prototype defines the corresponding sound.
8578
9399
  *
8579
9400
  * - `"tile-walking"` - Uses {@link TilePrototype::walking_sound | prototype:TilePrototype::walking_sound}. Example: `"tile-walking/concrete"`
@@ -8628,6 +9449,9 @@ LuaSpaceConnectionPrototype | /**
8628
9449
  * The prototype name.
8629
9450
  */
8630
9451
  string;
9452
+ interface SpaceDustEffectProperties {
9453
+ animation_speed: float;
9454
+ }
8631
9455
  interface SpaceLocationAsteroidSpawnDefinition {
8632
9456
  /**
8633
9457
  * `asteroid-chunk` or `entity`
@@ -8696,10 +9520,16 @@ interface SpaceLocationPrototypeFilterType extends BaseSpaceLocationPrototypeFil
8696
9520
  'type': string | string[];
8697
9521
  }
8698
9522
  interface SpacePlatformHubBlueprintControlBehavior {
9523
+ input_networks?: CircuitNetworkSelection;
9524
+ output_networks?: CircuitNetworkSelection;
8699
9525
  /**
8700
9526
  * Defaults to `true`.
8701
9527
  */
8702
9528
  read_contents?: boolean;
9529
+ /**
9530
+ * Defaults to `false`.
9531
+ */
9532
+ set_requests?: boolean;
8703
9533
  /**
8704
9534
  * Defaults to `true`.
8705
9535
  */
@@ -8737,6 +9567,11 @@ interface SpawnPointDefinition {
8737
9567
  */
8738
9568
  weight: double;
8739
9569
  }
9570
+ interface SpentFluidSpecification {
9571
+ name: string;
9572
+ amount: double;
9573
+ temperature: float;
9574
+ }
8740
9575
  interface SpiderEngineSpecification {
8741
9576
  legs: SpiderLegSpecification[];
8742
9577
  walking_group_overlap: float;
@@ -8753,6 +9588,7 @@ interface SpiderLegSpecification {
8753
9588
  walking_group: uint8;
8754
9589
  }
8755
9590
  interface SplitterBlueprintControlBehavior {
9591
+ input_networks?: CircuitNetworkSelection;
8756
9592
  /**
8757
9593
  * Defaults to `false`.
8758
9594
  */
@@ -8771,7 +9607,7 @@ interface SplitterBlueprintControlBehavior {
8771
9607
  set_filter?: boolean;
8772
9608
  }
8773
9609
  type SplitterPriority = 'left' | 'none' | 'right';
8774
- type SpoilPriority = 'fresh_first' | 'none' | 'spoiled_first';
9610
+ type SpoilPriority = 'fresh-first' | 'none' | 'spoiled-first';
8775
9611
  interface SpoilToTriggerResult {
8776
9612
  /**
8777
9613
  * The trigger items that are run.
@@ -8811,27 +9647,21 @@ interface SpoilToTriggerResult {
8811
9647
  * - `"utility"` - sprite defined in the utility-sprites object, these are the pictures used by the game internally for the UI.
8812
9648
  */
8813
9649
  type SpritePath = string;
8814
- interface SteeringMapSetting {
9650
+ interface StateSteeringSettings {
8815
9651
  /**
8816
- * Does not include the radius of the unit.
9652
+ * Not including the radius of the unit.
8817
9653
  */
8818
9654
  radius: double;
8819
9655
  separation_factor: double;
8820
9656
  separation_force: double;
8821
- /**
8822
- * Used to make steering look better for aesthetic purposes.
8823
- */
8824
- force_unit_fuzzy_goto_behavior: boolean;
8825
9657
  }
8826
- interface SteeringMapSettings {
8827
- default: SteeringMapSetting;
8828
- moving: SteeringMapSetting;
8829
- }
8830
- interface StorageTankBlueprintControlBehavior {
9658
+ interface SteeringSettings {
9659
+ stay: StateSteeringSettings;
9660
+ move: StateSteeringSettings;
8831
9661
  /**
8832
- * Defaults to `true`.
9662
+ * Used only for special "to look good" purposes (like in trailer).
8833
9663
  */
8834
- read_contents?: boolean;
9664
+ force_unit_fuzzy_goto_behavior: boolean;
8835
9665
  }
8836
9666
  interface SurfaceCondition {
8837
9667
  property: string;
@@ -8861,6 +9691,14 @@ LuaSurfacePropertyPrototype | /**
8861
9691
  * The prototype name.
8862
9692
  */
8863
9693
  string;
9694
+ interface SurfaceRenderParameters {
9695
+ clouds: CloudsEffectProperties;
9696
+ fog: FogEffectProperties;
9697
+ terrain_tint_effect: GlobalTintEffectProperties;
9698
+ space_dust_background: SpaceDustEffectProperties;
9699
+ space_dust_foreground: SpaceDustEffectProperties;
9700
+ platform_backdrop: PlatformBackdrop;
9701
+ }
8864
9702
  /**
8865
9703
  * State of a GUI {@link switch | runtime:LuaGuiElement::switch_state}.
8866
9704
  */
@@ -8918,7 +9756,7 @@ interface BaseTechnologyModifier {
8918
9756
  /**
8919
9757
  * The effect that is applied when a technology is researched.
8920
9758
  */
8921
- type TechnologyModifier = BaseTechnologyModifier | TechnologyModifierAmmoDamage | TechnologyModifierArtilleryRange | TechnologyModifierBeaconDistribution | TechnologyModifierBeltStackSizeBonus | TechnologyModifierBulkInserterCapacityBonus | TechnologyModifierCargoLandingPadCount | TechnologyModifierChangeRecipeProductivity | TechnologyModifierCharacterBuildDistance | TechnologyModifierCharacterCraftingSpeed | TechnologyModifierCharacterHealthBonus | TechnologyModifierCharacterInventorySlotsBonus | TechnologyModifierCharacterItemDropDistance | TechnologyModifierCharacterItemPickupDistance | TechnologyModifierCharacterLogisticRequests | TechnologyModifierCharacterLogisticTrashSlots | TechnologyModifierCharacterLootPickupDistance | TechnologyModifierCharacterMiningSpeed | TechnologyModifierCharacterReachDistance | TechnologyModifierCharacterResourceReachDistance | TechnologyModifierCharacterRunningSpeed | TechnologyModifierCliffDeconstructionEnabled | TechnologyModifierCreateGhostOnEntityDeath | TechnologyModifierDeconstructionTimeToLive | TechnologyModifierFollowerRobotLifetime | TechnologyModifierGiveItem | TechnologyModifierGunSpeed | TechnologyModifierInserterStackSizeBonus | TechnologyModifierLaboratoryProductivity | TechnologyModifierLaboratorySpeed | TechnologyModifierMaxFailedAttemptsPerTickPerConstructionQueue | TechnologyModifierMaxSuccessfulAttemptsPerTickPerConstructionQueue | TechnologyModifierMaximumFollowingRobotsCount | TechnologyModifierMiningDrillProductivityBonus | TechnologyModifierMiningWithFluid | TechnologyModifierNothing | TechnologyModifierRailPlannerAllowElevatedRails | TechnologyModifierRailSupportOnDeepOilOcean | TechnologyModifierTrainBrakingForceBonus | TechnologyModifierTurretAttack | TechnologyModifierUnlockCircuitNetwork | TechnologyModifierUnlockQuality | TechnologyModifierUnlockRecipe | TechnologyModifierUnlockSpaceLocation | TechnologyModifierUnlockSpacePlatforms | TechnologyModifierVehicleLogistics | TechnologyModifierWorkerRobotBattery | TechnologyModifierWorkerRobotSpeed | TechnologyModifierWorkerRobotStorage;
9759
+ type TechnologyModifier = BaseTechnologyModifier | TechnologyModifierAmmoDamage | TechnologyModifierArtilleryRange | TechnologyModifierBeaconDistribution | TechnologyModifierBeltStackSizeBonus | TechnologyModifierBulkInserterCapacityBonus | TechnologyModifierCargoLandingPadCount | TechnologyModifierChangeRecipeProductivity | TechnologyModifierCharacterBuildDistance | TechnologyModifierCharacterCraftingSpeed | TechnologyModifierCharacterHealthBonus | TechnologyModifierCharacterInventorySlotsBonus | TechnologyModifierCharacterItemDropDistance | TechnologyModifierCharacterItemPickupDistance | TechnologyModifierCharacterLogisticRequests | TechnologyModifierCharacterLogisticTrashSlots | TechnologyModifierCharacterLootPickupDistance | TechnologyModifierCharacterMiningSpeed | TechnologyModifierCharacterReachDistance | TechnologyModifierCharacterResourceReachDistance | TechnologyModifierCharacterRunningSpeed | TechnologyModifierCliffDeconstructionEnabled | TechnologyModifierCreateGhostOnEntityDeath | TechnologyModifierDeconstructionTimeToLive | TechnologyModifierFollowerRobotLifetime | TechnologyModifierGiveItem | TechnologyModifierGunSpeed | TechnologyModifierInserterStackSizeBonus | TechnologyModifierLaboratoryProductivity | TechnologyModifierLaboratorySpeed | TechnologyModifierMaxCargoBayUnloadingDistance | TechnologyModifierMaxFailedAttemptsPerTickPerConstructionQueue | TechnologyModifierMaxSuccessfulAttemptsPerTickPerConstructionQueue | TechnologyModifierMaximumFollowingRobotsCount | TechnologyModifierMiningDrillProductivityBonus | TechnologyModifierMiningWithFluid | TechnologyModifierNothing | TechnologyModifierRailPlannerAllowElevatedRails | TechnologyModifierRailSupportOnDeepOilOcean | TechnologyModifierTrainBrakingForceBonus | TechnologyModifierTurretAttack | TechnologyModifierUnlockCircuitNetwork | TechnologyModifierUnlockLogisticNetwork | TechnologyModifierUnlockQuality | TechnologyModifierUnlockRecipe | TechnologyModifierUnlockSpaceLocation | TechnologyModifierUnlockSpacePlatforms | TechnologyModifierUnlockTravelToSpacePlatforms | TechnologyModifierVehicleLogistics | TechnologyModifierWorkerRobotBattery | TechnologyModifierWorkerRobotSpeed | TechnologyModifierWorkerRobotStorage;
8922
9760
  /**
8923
9761
  *
8924
9762
  * Applies to variant case `ammo-damage`
@@ -9345,6 +10183,20 @@ interface TechnologyModifierLaboratorySpeed extends BaseTechnologyModifier {
9345
10183
  */
9346
10184
  'modifier': double;
9347
10185
  }
10186
+ /**
10187
+ *
10188
+ * Applies to variant case `max-cargo-bay-unloading-distance`
10189
+ */
10190
+ interface TechnologyModifierMaxCargoBayUnloadingDistance extends BaseTechnologyModifier {
10191
+ /**
10192
+ * Modifier type. Specifies which of the other fields will be available.
10193
+ */
10194
+ 'type': 'max-cargo-bay-unloading-distance';
10195
+ /**
10196
+ * The amount to increase the current max cargo bay unloading distance by upon researching.
10197
+ */
10198
+ 'modifier': double;
10199
+ }
9348
10200
  /**
9349
10201
  *
9350
10202
  * Applies to variant case `max-failed-attempts-per-tick-per-construction-queue`
@@ -9503,6 +10355,20 @@ interface TechnologyModifierUnlockCircuitNetwork extends BaseTechnologyModifier
9503
10355
  */
9504
10356
  'modifier': boolean;
9505
10357
  }
10358
+ /**
10359
+ *
10360
+ * Applies to variant case `unlock-logistic-network`
10361
+ */
10362
+ interface TechnologyModifierUnlockLogisticNetwork extends BaseTechnologyModifier {
10363
+ /**
10364
+ * Modifier type. Specifies which of the other fields will be available.
10365
+ */
10366
+ 'type': 'unlock-logistic-network';
10367
+ /**
10368
+ * The state this modifier will be in upon researching.
10369
+ */
10370
+ 'modifier': boolean;
10371
+ }
9506
10372
  /**
9507
10373
  *
9508
10374
  * Applies to variant case `unlock-quality`
@@ -9559,6 +10425,20 @@ interface TechnologyModifierUnlockSpacePlatforms extends BaseTechnologyModifier
9559
10425
  */
9560
10426
  'modifier': boolean;
9561
10427
  }
10428
+ /**
10429
+ *
10430
+ * Applies to variant case `unlock-travel-to-space-platforms`
10431
+ */
10432
+ interface TechnologyModifierUnlockTravelToSpacePlatforms extends BaseTechnologyModifier {
10433
+ /**
10434
+ * Modifier type. Specifies which of the other fields will be available.
10435
+ */
10436
+ 'type': 'unlock-travel-to-space-platforms';
10437
+ /**
10438
+ * The state this modifier will be in upon researching.
10439
+ */
10440
+ 'modifier': boolean;
10441
+ }
9562
10442
  /**
9563
10443
  *
9564
10444
  * Applies to variant case `vehicle-logistics`
@@ -9709,6 +10589,7 @@ interface TerritorySettings {
9709
10589
  territory_variation_expression: string;
9710
10590
  minimum_territory_size: uint32;
9711
10591
  }
10592
+ type TerritoryVisibilityCondition = 'never' | 'has-unit' | 'always';
9712
10593
  /**
9713
10594
  * The text is aligned so that the target position is at the given side of the text.
9714
10595
  *
@@ -9751,6 +10632,12 @@ interface TileBuildabilityRule {
9751
10632
  */
9752
10633
  remove_on_collision: boolean;
9753
10634
  }
10635
+ interface TileCollisionMask {
10636
+ /**
10637
+ * Every key in the dictionary is the name of one {@link layer | runtime:LuaCollisionLayerPrototype} the object collides with. The value is meaningless and always `true`. An empty table means that no layers are set.
10638
+ */
10639
+ layers: Record<string, true>;
10640
+ }
9754
10641
  /**
9755
10642
  * A tile may be specified in one of three ways.
9756
10643
  */
@@ -9966,6 +10853,20 @@ interface TrainPathAllGoalsResult {
9966
10853
  */
9967
10854
  steps_count: uint32;
9968
10855
  }
10856
+ interface TrainPathFinderConstants {
10857
+ train_stop_penalty: uint32;
10858
+ stopped_manually_controlled_train_penalty: uint32;
10859
+ stopped_manually_controlled_train_without_passenger_penalty: uint32;
10860
+ signal_reserved_by_circuit_network_penalty: uint32;
10861
+ train_in_station_penalty: uint32;
10862
+ train_in_station_with_no_other_valid_stops_in_schedule: uint32;
10863
+ train_arriving_to_station_penalty: uint32;
10864
+ train_arriving_to_signal_penalty: uint32;
10865
+ train_waiting_at_signal_penalty: uint32;
10866
+ train_waiting_at_signal_tick_multiplier_penalty: float;
10867
+ train_with_no_path_penalty: uint32;
10868
+ train_auto_without_schedule_penalty: uint32;
10869
+ }
9969
10870
  type TrainPathFinderGoal = TrainStopGoal | RailEndGoal | LuaRailEnd | /**
9970
10871
  * Only if it points at train-stop that is connected to a rail.
9971
10872
  */
@@ -10028,6 +10929,8 @@ interface TrainSchedule {
10028
10929
  records: ScheduleRecord[];
10029
10930
  }
10030
10931
  interface TrainStopBlueprintControlBehavior {
10932
+ input_networks?: CircuitNetworkSelection;
10933
+ output_networks?: CircuitNetworkSelection;
10031
10934
  /**
10032
10935
  * Defaults to `true`.
10033
10936
  */
@@ -10111,7 +11014,21 @@ interface TrainStopGoal {
10111
11014
  */
10112
11015
  priority?: uint8;
10113
11016
  }
11017
+ interface TrainVisualizationConstants {
11018
+ not_last_box_color: Color;
11019
+ last_box_color: Color;
11020
+ reverse_box_color: Color;
11021
+ last_reverse_box_color: Color;
11022
+ box_width: float;
11023
+ box_length: float;
11024
+ joint_distance: float;
11025
+ connection_distance: float;
11026
+ final_margin: float;
11027
+ stock_number_scale: float;
11028
+ }
10114
11029
  interface TransportBeltBlueprintControlBehavior {
11030
+ input_networks?: CircuitNetworkSelection;
11031
+ output_networks?: CircuitNetworkSelection;
10115
11032
  circuit_read_hand_contents: boolean;
10116
11033
  circuit_contents_read_mode: defines.control_behavior.transport_belt.content_read_mode;
10117
11034
  /**
@@ -10180,6 +11097,7 @@ interface TriggerDeliveryDelayed extends BaseTriggerDelivery {
10180
11097
  interface TriggerDeliveryProjectile extends BaseTriggerDelivery {
10181
11098
  'type': 'projectile';
10182
11099
  'direction_deviation': float;
11100
+ 'inherit_speed': boolean;
10183
11101
  'max_range': double;
10184
11102
  'min_range': double;
10185
11103
  'projectile': string;
@@ -10205,7 +11123,7 @@ interface BaseTriggerEffectItem {
10205
11123
  show_in_tooltip: boolean;
10206
11124
  damage_type_filters?: DamageTypeFilters;
10207
11125
  }
10208
- type TriggerEffectItem = BaseTriggerEffectItem | TriggerEffectItemActivateImpact | TriggerEffectItemCameraEffect | TriggerEffectItemCreateAsteroidChunk | TriggerEffectItemCreateDecorative | TriggerEffectItemCreateEntity | TriggerEffectItemCreateExplosion | TriggerEffectItemCreateFire | TriggerEffectItemCreateParticle | TriggerEffectItemCreateSmoke | TriggerEffectItemCreateSticker | TriggerEffectItemCreateTrivialSmoke | TriggerEffectItemDamage | TriggerEffectItemDamageTile | TriggerEffectItemDestroyCliffs | TriggerEffectItemDestroyDecoratives | TriggerEffectItemInsertItem | TriggerEffectItemInvokeTileTrigger | TriggerEffectItemNestedResult | TriggerEffectItemPlaySound | TriggerEffectItemPushBack | TriggerEffectItemScript | TriggerEffectItemSetTile | TriggerEffectItemShowExplosionOnChart;
11126
+ type TriggerEffectItem = BaseTriggerEffectItem | TriggerEffectItemActivateImpact | TriggerEffectItemCameraEffect | TriggerEffectItemCreateAsteroidChunk | TriggerEffectItemCreateDecorative | TriggerEffectItemCreateEntity | TriggerEffectItemCreateExplosion | TriggerEffectItemCreateFire | TriggerEffectItemCreateParticle | TriggerEffectItemCreatePollution | TriggerEffectItemCreateSmoke | TriggerEffectItemCreateSticker | TriggerEffectItemCreateTrivialSmoke | TriggerEffectItemDamage | TriggerEffectItemDamageTile | TriggerEffectItemDestroyCliffs | TriggerEffectItemDestroyDecoratives | TriggerEffectItemInsertItem | TriggerEffectItemInvokeTileTrigger | TriggerEffectItemNestedResult | TriggerEffectItemPlaySound | TriggerEffectItemPushBack | TriggerEffectItemScript | TriggerEffectItemSetTile | TriggerEffectItemShowExplosionOnChart;
10209
11127
  /**
10210
11128
  *
10211
11129
  * Applies to variant case `activate-impact`
@@ -10351,6 +11269,16 @@ interface TriggerEffectItemCreateParticle extends BaseTriggerEffectItem {
10351
11269
  'tile_collision_mask': CollisionMask;
10352
11270
  'tint'?: Color;
10353
11271
  }
11272
+ /**
11273
+ *
11274
+ * Applies to variant case `create-pollution`
11275
+ */
11276
+ interface TriggerEffectItemCreatePollution extends BaseTriggerEffectItem {
11277
+ 'type': 'create-pollution';
11278
+ 'amount': double;
11279
+ 'entity'?: string;
11280
+ 'use_entity_from_trigger': boolean;
11281
+ }
10354
11282
  /**
10355
11283
  *
10356
11284
  * Applies to variant case `create-smoke`
@@ -10530,7 +11458,7 @@ interface TriggerEffectItemShowExplosionOnChart extends BaseTriggerEffectItem {
10530
11458
  /**
10531
11459
  * Used by {@link TriggerEffectItem | runtime:TriggerEffectItem}.
10532
11460
  */
10533
- type TriggerEffectItemType = 'damage' | 'damage-tile' | 'create-entity' | 'create-explosion' | 'create-fire' | 'create-smoke' | 'create-trivial-smoke' | 'create-asteroid-chunk' | 'create-particle' | 'create-sticker' | 'create-decorative' | 'nested-result' | 'play-sound' | 'push-back' | 'destroy-cliffs' | 'show-explosion-on-chart' | 'insert-item' | 'script' | 'set-tile' | 'invoke-tile-trigger' | 'destroy-decoratives' | 'camera-effect' | 'activate-impact';
11461
+ type TriggerEffectItemType = 'damage' | 'damage-tile' | 'create-entity' | 'create-explosion' | 'create-fire' | 'create-smoke' | 'create-trivial-smoke' | 'create-asteroid-chunk' | 'create-particle' | 'create-sticker' | 'create-decorative' | 'nested-result' | 'play-sound' | 'push-back' | 'destroy-cliffs' | 'show-explosion-on-chart' | 'insert-item' | 'script' | 'set-tile' | 'invoke-tile-trigger' | 'destroy-decoratives' | 'camera-effect' | 'activate-impact' | 'create-pollution';
10534
11462
  interface TriggerEffectWithCooldown {
10535
11463
  /**
10536
11464
  * The travel distance between triggers that the triggerer must travel between effects.
@@ -10632,6 +11560,8 @@ LuaTrivialSmokePrototype | /**
10632
11560
  */
10633
11561
  string;
10634
11562
  interface TurretBlueprintControlBehavior {
11563
+ input_networks?: CircuitNetworkSelection;
11564
+ output_networks?: CircuitNetworkSelection;
10635
11565
  /**
10636
11566
  * Defaults to `false`.
10637
11567
  */
@@ -10873,6 +11803,33 @@ interface UndoRedoActionWireRemoved extends BaseUndoRedoAction {
10873
11803
  'a': BlueprintWireEnd;
10874
11804
  'b': BlueprintWireEnd;
10875
11805
  }
11806
+ interface UnitAISettings {
11807
+ /**
11808
+ * If enabled, units that repeatedly fail to succeed at commands will be destroyed.
11809
+ */
11810
+ destroy_when_commands_fail: boolean;
11811
+ /**
11812
+ * If enabled, units that have nothing else to do will attempt to return to a spawner.
11813
+ */
11814
+ allow_try_return_to_spawner: boolean;
11815
+ /**
11816
+ * If enabled, units will try to separate themselves from nearby friendly units.
11817
+ */
11818
+ do_separation: boolean;
11819
+ /**
11820
+ * Must be between -8 and 8.
11821
+ */
11822
+ path_resolution_modifier: int8;
11823
+ strafe_settings?: PrototypeStrafeSettings;
11824
+ /**
11825
+ * The amount of slots in a unit group this unit takes up. For example, a unit with `groupingSize` of 2 will count as 2 normal-sized units when filling up a unit group. Must be greater than 0.
11826
+ */
11827
+ size_in_group: float;
11828
+ /**
11829
+ * If enabled, the unit is permitted to join attack groups.
11830
+ */
11831
+ join_attacks: boolean;
11832
+ }
10876
11833
  interface UnitGroupMapSettings {
10877
11834
  /**
10878
11835
  * The minimum amount of time in ticks a group will spend gathering before setting off. The actual time is a random time between the minimum and maximum times. Defaults to `3 600` ticks.
@@ -10934,6 +11891,14 @@ interface UnitSpawnDefinition {
10934
11891
  */
10935
11892
  spawn_points: SpawnPointDefinition[];
10936
11893
  }
11894
+ interface UnlockableID {
11895
+ type: UnlockableIDType;
11896
+ /**
11897
+ * Name of a prototype as defined by `type`. Only used if the type is one of `"space-location"`, `"recipe"`, `"quality"`, `"item"`, `"entity"`, `"fluid"`, `"asteroid-chunk"`, `"tile"`, `"ammo-category"`
11898
+ */
11899
+ name?: string;
11900
+ }
11901
+ type UnlockableIDType = 'space-location' | 'recipe' | 'quality' | 'item' | 'entity' | 'fluid' | 'asteroid-chunk' | 'tile' | 'ammo-category' | 'mining-with-fluid' | 'space-platform-unlocked' | 'space-platforms-buildable' | 'space-platform-travel' | 'asteroid-collectors' | 'silo-unlocked' | 'starter-packs-available' | 'thrusters-available' | 'capture-robots-available';
10937
11902
  interface UpgradeMapperDestination {
10938
11903
  type: 'item' | 'entity';
10939
11904
  /**
@@ -10972,6 +11937,350 @@ interface UpgradeMapperSource {
10972
11937
  */
10973
11938
  module_filter?: EntityIDFilter;
10974
11939
  }
11940
+ /**
11941
+ * Constants used by the game that are not specific to certain prototypes. See {@link utility-constants.lua | https://github.com/wube/factorio-data/blob/master/core/prototypes/utility-constants.lua} for the values used by the base game.
11942
+ *
11943
+ * Note that this is actually implemented as a {@link LuaCustomTable | runtime:LuaCustomTable}, not a regular table.
11944
+ */
11945
+ interface UtilityConstants {
11946
+ /**
11947
+ * Chart means map and minimap.
11948
+ */
11949
+ chart: ChartUtilityConstants;
11950
+ /**
11951
+ * The base game uses more entries here that are applied via the `ammo-category.lua` file.
11952
+ */
11953
+ bonus_gui_ordering: BonusUtilityConstants;
11954
+ map_editor: EditorUtilityConstants;
11955
+ entity_button_background_color: Color;
11956
+ building_buildable_too_far_tint: Color;
11957
+ building_buildable_tint: Color;
11958
+ building_not_buildable_tint: Color;
11959
+ building_ignorable_tint: Color;
11960
+ building_no_tint: Color;
11961
+ /**
11962
+ * Tall entities will be tinted with this value when "Hide tall entities" mode is active.
11963
+ */
11964
+ tall_entity_tint: Color;
11965
+ /**
11966
+ * All trivial smoke will be tinted with this value when "Hide tall entities" mode is active.
11967
+ */
11968
+ tall_entity_smoke_tint: Color;
11969
+ underground_belt_max_distance_tint: Color;
11970
+ underground_pipe_max_distance_tint: Color;
11971
+ ghost_shader_tint: GhostTintSet;
11972
+ ghost_shaderless_tint: GhostTintSet;
11973
+ ghost_shimmer_settings: GhostShimmerConfig;
11974
+ probability_product_count_tint: Color;
11975
+ ghost_product_count_tint: Color;
11976
+ zero_count_value_tint: Color;
11977
+ equipment_default_background_color: Color;
11978
+ equipment_default_background_border_color: Color;
11979
+ equipment_default_grabbed_background_color: Color;
11980
+ equipment_disabled_background_tint: Color;
11981
+ equipment_disabled_tint: Color;
11982
+ turret_range_visualization_color: Color;
11983
+ capsule_range_visualization_color: Color;
11984
+ agricultural_range_visualization_color: Color;
11985
+ artillery_range_visualization_color: Color;
11986
+ gui_remark_color: Color;
11987
+ gui_search_match_foreground_color: Color;
11988
+ gui_search_match_background_color: Color;
11989
+ default_player_force_color: Color;
11990
+ default_enemy_force_color: Color;
11991
+ default_other_force_color: Color;
11992
+ deconstruct_mark_tint: Color;
11993
+ rail_planner_count_button_color: Color;
11994
+ count_button_size: int32;
11995
+ logistic_gui_unselected_network_highlight_tint: Color;
11996
+ logistic_gui_selected_network_highlight_tint: Color;
11997
+ chart_search_highlight: Color;
11998
+ selected_chart_search_highlight: Color;
11999
+ zoom_to_world_can_use_nightvision: boolean;
12000
+ zoom_to_world_effect_strength: float;
12001
+ max_logistic_filter_count: LogisticFilterIndex;
12002
+ /**
12003
+ * Will be clamped to the range [1, 100].
12004
+ */
12005
+ select_group_row_count: uint8;
12006
+ /**
12007
+ * Will be clamped to the range [1, 100].
12008
+ */
12009
+ select_slot_row_count: uint8;
12010
+ /**
12011
+ * Will be clamped to the range [2, 100].
12012
+ */
12013
+ logistic_slots_per_row: uint8;
12014
+ /**
12015
+ * Will be clamped to the range [1, 100].
12016
+ */
12017
+ crafting_queue_slots_per_row: uint8;
12018
+ /**
12019
+ * Will be clamped to the range [2, 100].
12020
+ */
12021
+ blueprint_big_slots_per_row: uint8;
12022
+ /**
12023
+ * Will be clamped to the range [2, 100].
12024
+ */
12025
+ blueprint_small_slots_per_row: uint8;
12026
+ /**
12027
+ * Will be clamped to the range [1, 100].
12028
+ */
12029
+ inventory_width: uint8;
12030
+ /**
12031
+ * Will be clamped to the range [1, 100].
12032
+ */
12033
+ module_inventory_width: uint8;
12034
+ /**
12035
+ * Will be clamped to the range [1, 100].
12036
+ */
12037
+ trash_inventory_width: uint8;
12038
+ max_terrain_building_size: uint8;
12039
+ small_area_size: float;
12040
+ medium_area_size: float;
12041
+ large_area_size: float;
12042
+ huge_area_size: float;
12043
+ huge_platform_animation_sound_area: float;
12044
+ small_blueprint_area_size: float;
12045
+ medium_blueprint_area_size: float;
12046
+ large_blueprint_area_size: float;
12047
+ enabled_recipe_slot_tint: Color;
12048
+ disabled_recipe_slot_tint: Color;
12049
+ disabled_recipe_slot_background_tint: Color;
12050
+ forced_enabled_recipe_slot_background_tint: Color;
12051
+ rail_segment_colors: Color[];
12052
+ /**
12053
+ * The table with `name = "default"` must exist and be the first member of the array.
12054
+ */
12055
+ player_colors: PlayerColorData[];
12056
+ server_command_console_chat_color: Color;
12057
+ script_command_console_chat_color: Color;
12058
+ default_alert_icon_scale: float;
12059
+ default_alert_icon_shift_by_type?: Record<string, Vector>;
12060
+ default_alert_icon_scale_by_type?: Record<string, float>;
12061
+ /**
12062
+ * If not set, defaults to `true` when modded and `false` when vanilla.
12063
+ */
12064
+ merge_bonus_gui_production_bonuses?: boolean;
12065
+ daytime_color_lookup: DaytimeColorLookupTable;
12066
+ zoom_to_world_daytime_color_lookup: DaytimeColorLookupTable;
12067
+ frozen_color_lookup: ColorLookupTable;
12068
+ default_platform_surface_render_parameters: SurfaceRenderParameters;
12069
+ drop_item_radius: double;
12070
+ checkerboard_white: Color;
12071
+ checkerboard_black: Color;
12072
+ item_outline_color: Color;
12073
+ item_outline_radius: float;
12074
+ item_outline_inset: float;
12075
+ item_outline_sharpness: float;
12076
+ item_default_random_tint_strength: Color;
12077
+ spawner_evolution_factor_health_modifier: float;
12078
+ /**
12079
+ * There must be one array item with a threshold of `0`.
12080
+ */
12081
+ item_health_bar_colors: ItemHealthColorData[];
12082
+ item_ammo_magazine_left_bar_color: Color;
12083
+ item_tool_durability_bar_color: Color;
12084
+ filter_outline_color: Color;
12085
+ icon_shadow_radius: float;
12086
+ icon_shadow_inset: float;
12087
+ icon_shadow_sharpness: float;
12088
+ icon_shadow_color: Color;
12089
+ clipboard_history_size: uint32;
12090
+ recipe_step_limit: uint32;
12091
+ manual_rail_building_reach_modifier: double;
12092
+ train_temporary_stop_wait_time: uint32;
12093
+ train_time_wait_condition_default: uint32;
12094
+ train_inactivity_wait_condition_default: uint32;
12095
+ /**
12096
+ * The strings are entity types.
12097
+ */
12098
+ default_trigger_target_mask_by_type?: Record<string, TriggerTargetMask>;
12099
+ unit_group_pathfind_resolution: int8;
12100
+ unit_group_max_pursue_distance: double;
12101
+ dynamic_recipe_overload_factor: double;
12102
+ minimum_recipe_overload_multiplier: uint32;
12103
+ maximum_recipe_overload_multiplier: uint32;
12104
+ entity_renderer_search_box_limits: EntityRendererSearchBoxLimits;
12105
+ /**
12106
+ * Can be set to anything from range 0 to 255, but larger values will be clamped to 160. Setting it to larger values can have performance impact (growing geometrically).
12107
+ */
12108
+ light_renderer_search_distance_limit: uint8;
12109
+ far_away_chunk_generation_radius: uint8;
12110
+ tree_leaf_distortion_strength_far: Vector;
12111
+ tree_leaf_distortion_distortion_far: Vector;
12112
+ tree_leaf_distortion_speed_far: Vector;
12113
+ tree_leaf_distortion_strength_near: Vector;
12114
+ tree_leaf_distortion_distortion_near: Vector;
12115
+ tree_leaf_distortion_speed_near: Vector;
12116
+ tree_shadow_roughness: float;
12117
+ tree_shadow_speed: float;
12118
+ missing_preview_sprite_location: string;
12119
+ main_menu_background_image_location: string;
12120
+ /**
12121
+ * The strings represent the names of the simulations.
12122
+ */
12123
+ main_menu_simulations?: Record<string, SimulationDefinition>;
12124
+ main_menu_background_vignette_intensity: float;
12125
+ main_menu_background_vignette_sharpness: float;
12126
+ feedback_screenshot_subfolder_name: string;
12127
+ feedback_screenshot_file_name: string;
12128
+ default_scorch_mark_color: Color;
12129
+ color_filters?: ColorFilterData[];
12130
+ clear_cursor_volume_modifier: float;
12131
+ weapons_in_simulation_volume_modifier: float;
12132
+ explosions_in_simulation_volume_modifier: float;
12133
+ enemies_in_simulation_volume_modifier: float;
12134
+ low_energy_robot_estimate_multiplier: double;
12135
+ asteroid_spawning_offset: SimpleBoundingBox;
12136
+ asteroid_fading_range: float;
12137
+ asteroid_spawning_with_random_orientation_max_speed: double;
12138
+ asteroid_position_offset_to_speed_coefficient: double;
12139
+ asteroid_collector_navmesh_refresh_tick_interval: uint32;
12140
+ asteroid_collector_blockage_update_tile_distance: uint32;
12141
+ asteroid_collector_max_nurbs_control_point_separation: double;
12142
+ asteroid_collector_static_head_swing_strength_scale: float;
12143
+ asteroid_collector_static_head_swing_segment_count: uint32;
12144
+ /**
12145
+ * Variables: `speed, thrust, weight, width, height`
12146
+ */
12147
+ space_platform_acceleration_expression: MathExpression;
12148
+ space_platform_relative_speed_factor: double;
12149
+ space_platform_starfield_movement_vector: Vector;
12150
+ space_platform_max_size: SimpleBoundingBox;
12151
+ /**
12152
+ * Determines how fast space platforms will send items in drop slots to the surface. Each item type has its own cooldown.
12153
+ */
12154
+ space_platform_dump_cooldown: uint32;
12155
+ /**
12156
+ * Delay after manual transfer until space platform sends items in drop slots to the surface. Overrides remaining space_platform_dump_cooldown in this instance.
12157
+ */
12158
+ space_platform_manual_dump_cooldown: uint32;
12159
+ /**
12160
+ * Space platform remembers relative speed range which asteroids use while it moves. When the range is larger than the specified deviation, the platform will start updating cached trajectories of all asteroid chunks over multiple ticks.
12161
+ */
12162
+ space_platform_max_relative_speed_deviation_for_asteroid_chunks_update: float;
12163
+ /**
12164
+ * How many asteroid chunks should be processed per tick, see {@link space_platform_max_relative_speed_deviation_for_asteroid_chunks_update | prototype:UtilityConstants::space_platform_max_relative_speed_deviation_for_asteroid_chunks_update}.
12165
+ */
12166
+ space_platform_asteroid_chunk_trajectory_updates_per_tick: uint32;
12167
+ default_item_weight: Weight;
12168
+ /**
12169
+ * Used for "Rocket capacity" item tooltip and for comparing rocket silo lift weight in GUI to this value.
12170
+ */
12171
+ default_rocket_lift_weight: Weight;
12172
+ factoriopedia_recycling_recipe_categories: RecipeCategoryID[];
12173
+ /**
12174
+ * The default value of {@link FluidBox::max_pipeline_extent | prototype:FluidBox::max_pipeline_extent}.
12175
+ */
12176
+ default_pipeline_extent: double;
12177
+ /**
12178
+ * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
12179
+ */
12180
+ default_platform_procession_set: ProcessionSet;
12181
+ /**
12182
+ * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
12183
+ */
12184
+ default_planet_procession_set: ProcessionSet;
12185
+ /**
12186
+ * Radius of area where cargo pods won't land.
12187
+ */
12188
+ landing_area_clear_zone_radius: float;
12189
+ /**
12190
+ * Max radius where cargo pods will land.
12191
+ */
12192
+ landing_area_max_radius: float;
12193
+ lightning_attractor_collection_range_color: Color;
12194
+ lightning_attractor_protection_range_color: Color;
12195
+ landing_squash_immunity: MapTick;
12196
+ /**
12197
+ * Silently clamped to be between 1 tick and 5 minutes (`5 * 60 * 60` ticks).
12198
+ */
12199
+ ejected_item_lifetime: MapTick;
12200
+ /**
12201
+ * Silently clamped to be between 0 and 1/60.
12202
+ */
12203
+ ejected_item_speed: double;
12204
+ /**
12205
+ * Silently clamped to be between 0 and 0.99.
12206
+ */
12207
+ ejected_item_direction_variation: double;
12208
+ /**
12209
+ * Silently clamped to be between 0 and 1.
12210
+ */
12211
+ ejected_item_friction: double;
12212
+ train_visualization: TrainVisualizationConstants;
12213
+ /**
12214
+ * The strings can be entity types or custom strings.
12215
+ */
12216
+ default_collision_masks: Record<string, CollisionMask>;
12217
+ show_chunk_components_collision_mask: CollisionMask;
12218
+ building_collision_mask: CollisionMask;
12219
+ water_collision_mask: TileCollisionMask;
12220
+ ghost_layer: CollisionLayerID;
12221
+ train_pushed_by_player_max_speed: double;
12222
+ train_pushed_by_player_max_acceleration: double;
12223
+ train_pushed_by_player_ignores_friction: boolean;
12224
+ /**
12225
+ * Must be >= 1.
12226
+ */
12227
+ tooltip_monitor_edge_border: int32;
12228
+ /**
12229
+ * Must be >= 1.
12230
+ */
12231
+ flying_text_ttl: int32;
12232
+ train_path_finding: TrainPathFinderConstants;
12233
+ /**
12234
+ * Will be clamped to a positive number, starting at 0.
12235
+ */
12236
+ freezing_temperature: double;
12237
+ train_on_elevated_rail_shadow_shift_multiplier: Vector;
12238
+ /**
12239
+ * Must be >= 1.
12240
+ */
12241
+ max_belt_stack_size: uint8;
12242
+ /**
12243
+ * Must be >= 1.
12244
+ */
12245
+ inserter_hand_stack_items_per_sprite: ItemCountType;
12246
+ /**
12247
+ * Must be >= 1.
12248
+ */
12249
+ inserter_hand_stack_max_sprites: ItemCountType;
12250
+ remote_view_LPF_min_cutoff_frequency: float;
12251
+ remote_view_LPF_max_cutoff_frequency: float;
12252
+ space_LPF_min_cutoff_frequency: float;
12253
+ space_LPF_max_cutoff_frequency: float;
12254
+ /**
12255
+ * Silently clamped to be between 0 and 1.
12256
+ */
12257
+ walking_sound_count_reduction_rate: float;
12258
+ /**
12259
+ * Silently clamped to be between 0 and 1.
12260
+ */
12261
+ moving_sound_count_reduction_rate: float;
12262
+ environment_sounds_transition_fade_in_ticks: uint32;
12263
+ sound_fade_ticks: uint32;
12264
+ starmap_orbit_default_color: Color;
12265
+ starmap_orbit_hovered_color: Color;
12266
+ starmap_orbit_clicked_color: Color;
12267
+ starmap_orbit_disabled_color: Color;
12268
+ /**
12269
+ * The number of ticks to show a segmented unit's health bar after fully regenerating.
12270
+ */
12271
+ time_to_show_full_health_bar: MapTick;
12272
+ /**
12273
+ * Layer within `ground-natural` {@link tile render layer | prototype:TileRenderLayer} group, before which terrain lightmap alpha channel is copied into water mask. Decals, which need to be masked by water should have their {@link DecorativePrototype::tile_layer | prototype:DecorativePrototype::tile_layer} set to only slightly larger value than `capture_water_mask_at_layer`, to avoid risk of undefined behavior caused by rendering tiles into layers between `capture_water_mask_at_layer` and decal's `tile_layer`.
12274
+ */
12275
+ capture_water_mask_at_layer: uint8;
12276
+ logistic_robots_use_busy_robots_queue: boolean;
12277
+ construction_robots_use_busy_robots_queue: boolean;
12278
+ quality_selector_dropdown_threshold: uint8;
12279
+ /**
12280
+ * Cap for how many steps of quality the output of something (miner/crafter) may be higher than the input (resource/ingredients). Must be >= 1.
12281
+ */
12282
+ maximum_quality_jump: uint8;
12283
+ }
10975
12284
  /**
10976
12285
  * Defines the mode of operation for a {@link ValvePrototype | prototype:ValvePrototype}.
10977
12286
  */
@@ -11032,6 +12341,20 @@ LuaVirtualSignalPrototype | /**
11032
12341
  * The prototype name.
11033
12342
  */
11034
12343
  string;
12344
+ interface VirtualSignalPrototypeFilter {
12345
+ /**
12346
+ * The condition to filter on.
12347
+ */
12348
+ filter: 'special-signal';
12349
+ /**
12350
+ * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
12351
+ */
12352
+ mode?: 'or' | 'and';
12353
+ /**
12354
+ * Inverts the condition. Default is `false`.
12355
+ */
12356
+ invert?: boolean;
12357
+ }
11035
12358
  interface WaitCondition {
11036
12359
  type: WaitConditionType;
11037
12360
  /**
@@ -11064,6 +12387,8 @@ interface WaitCondition {
11064
12387
  */
11065
12388
  type WaitConditionType = 'time' | 'full' | 'empty' | 'not_empty' | 'item_count' | 'circuit' | 'inactivity' | 'robots_inactive' | 'fluid_count' | 'passenger_present' | 'passenger_not_present' | 'fuel_item_count_all' | 'fuel_item_count_any' | 'fuel_full' | 'destination_full_or_no_path' | 'request_satisfied' | 'request_not_satisfied' | 'all_requests_satisfied' | 'any_request_not_satisfied' | 'any_request_zero' | 'any_planet_import_zero' | 'specific_destination_full' | 'specific_destination_not_full' | 'at_station' | 'not_at_station' | 'damage_taken';
11066
12389
  interface WallBlueprintControlBehavior {
12390
+ input_networks?: CircuitNetworkSelection;
12391
+ output_networks?: CircuitNetworkSelection;
11067
12392
  circuit_open_gate: boolean;
11068
12393
  circuit_read_sensor: boolean;
11069
12394
  output_signal?: SignalID;
@@ -11197,7 +12522,7 @@ type nil = null;
11197
12522
  /**
11198
12523
  * Tables are enclosed in curly brackets, like this `{}`.
11199
12524
  *
11200
- * Throughout the API docs, the terms "array" and "dictionary" are used. These are fundamentally just {@link Lua tables | http://www.lua.org/pil/2.5.html}, but have a limitation on which kind of table keys can be used. An array is a table that uses continuous integer keys starting at `1`, while a dictionary can use numeric or string keys in any order or combination.
12525
+ * Throughout the API docs, the terms "array" and "dictionary" are used. These are fundamentally just {@link Lua tables | https://www.lua.org/pil/2.5.html}, but have a limitation on which kind of table keys can be used. An array is a table that uses continuous integer keys starting at `1`, while a dictionary can use numeric or string keys in any order or combination.
11201
12526
  */
11202
12527
  type table = Table;
11203
12528
  /**