factorio-types 1.2.58 → 1.2.60

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.8
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
  /**
@@ -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 {
@@ -4194,12 +4700,17 @@ interface LogisticFilter {
4194
4700
  * The space location to import from.
4195
4701
  */
4196
4702
  import_from?: SpaceLocationID;
4703
+ /**
4704
+ * From which sources items should be requested for space platforms. Defaults to `"planet"`.
4705
+ */
4706
+ request_from?: RequestFromLocation;
4197
4707
  }
4198
4708
  type LogisticFilterIndex = uint16;
4199
4709
  interface LogisticGroup {
4200
4710
  members: LuaLogisticSection[];
4201
4711
  filters: LogisticFilter[];
4202
4712
  }
4713
+ type LogisticMode = 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
4203
4714
  interface LogisticSection {
4204
4715
  index: uint8;
4205
4716
  filters?: BlueprintLogisticFilter[];
@@ -4244,24 +4755,6 @@ interface LogisticsNetworkSupplyPoints {
4244
4755
  buffer: LuaLogisticPoint[];
4245
4756
  'active-provider': LuaLogisticPoint[];
4246
4757
  }
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
4758
  interface BaseLuaEntityClonedEventFilter {
4266
4759
  /**
4267
4760
  * The condition to filter on.
@@ -6341,7 +6834,6 @@ interface MapAndDifficultySettings {
6341
6834
  enemy_evolution: EnemyEvolutionMapSettings;
6342
6835
  enemy_expansion: EnemyExpansionMapSettings;
6343
6836
  unit_group: UnitGroupMapSettings;
6344
- steering: SteeringMapSettings;
6345
6837
  path_finder: PathFinderMapSettings;
6346
6838
  asteroids: AsteroidMapSettings;
6347
6839
  /**
@@ -6352,7 +6844,7 @@ interface MapAndDifficultySettings {
6352
6844
  }
6353
6845
  interface MapDifficultySettings {
6354
6846
  /**
6355
- * A value in range [0.001, 1000].
6847
+ * A value in range [0.001, 100000].
6356
6848
  */
6357
6849
  technology_price_multiplier: double;
6358
6850
  /**
@@ -6551,7 +7043,6 @@ interface MapSettings {
6551
7043
  max_failed_behavior_count: uint32;
6552
7044
  path_finder: PathFinderMapSettings;
6553
7045
  pollution: PollutionMapSettings;
6554
- steering: SteeringMapSetting;
6555
7046
  unit_group: UnitGroupMapSettings;
6556
7047
  }
6557
7048
  /**
@@ -6656,6 +7147,8 @@ interface MineableProperties {
6656
7147
  mining_trigger?: TriggerItem[];
6657
7148
  }
6658
7149
  interface MiningDrillBlueprintControlBehavior {
7150
+ input_networks?: CircuitNetworkSelection;
7151
+ output_networks?: CircuitNetworkSelection;
6659
7152
  circuit_read_resources: boolean;
6660
7153
  circuit_resource_read_mode: defines.control_behavior.mining_drill.resource_read_mode;
6661
7154
  /**
@@ -6745,17 +7238,15 @@ interface ModSettingPrototypeFilterType extends BaseModSettingPrototypeFilter {
6745
7238
  /**
6746
7239
  * Used by {@link TechnologyModifier | runtime:TechnologyModifier}.
6747
7240
  */
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';
7241
+ 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
7242
  /**
6750
7243
  * 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
7244
  */
6754
7245
  type ModuleEffectValue = float;
6755
7246
  /**
6756
7247
  * @example ```
6757
7248
  -- These are the effects of the vanilla Speed Module 3
6758
- {speed = 0.5, consumption = 0.7, quality = -0.25}
7249
+ {speed = 0.5, consumption = 0.7, quality = -0.025}
6759
7250
  ```
6760
7251
  */
6761
7252
  interface ModuleEffects {
@@ -6776,9 +7267,25 @@ interface NeighbourConnectable {
6776
7267
  neighbour_search_distance: float;
6777
7268
  connections: NeighbourConnectableConnectionDefinition[];
6778
7269
  }
6779
- interface NeighbourConnectableConnectionDefinition {
6780
- location: MapLocation;
6781
- category: string;
7270
+ interface NeighbourConnectableConnection {
7271
+ position: MapPosition;
7272
+ direction: defines.direction;
7273
+ /**
7274
+ * Entity to which this connection is connected to, if any.
7275
+ */
7276
+ target?: LuaEntity;
7277
+ /**
7278
+ * Whether connected entity is real or ghost.
7279
+ */
7280
+ target_real?: boolean;
7281
+ /**
7282
+ * If multiple connections are connected to the same target, only one connection is marked as first and provides neighbour bonuses.
7283
+ */
7284
+ first?: boolean;
7285
+ }
7286
+ interface NeighbourConnectableConnectionDefinition {
7287
+ location: MapLocation;
7288
+ category: string;
6782
7289
  neighbour_category: string[];
6783
7290
  }
6784
7291
  /**
@@ -6812,6 +7319,28 @@ interface OldTileAndPosition {
6812
7319
  old_tile: LuaTilePrototype;
6813
7320
  position: TilePosition;
6814
7321
  }
7322
+ interface OrientedCliffPrototypeSet {
7323
+ west_to_east: BoundingBox;
7324
+ north_to_south: BoundingBox;
7325
+ east_to_west: BoundingBox;
7326
+ south_to_north: BoundingBox;
7327
+ west_to_north: BoundingBox;
7328
+ north_to_east: BoundingBox;
7329
+ east_to_south: BoundingBox;
7330
+ south_to_west: BoundingBox;
7331
+ west_to_south: BoundingBox;
7332
+ north_to_west: BoundingBox;
7333
+ east_to_north: BoundingBox;
7334
+ south_to_east: BoundingBox;
7335
+ west_to_none: BoundingBox;
7336
+ none_to_east: BoundingBox;
7337
+ north_to_none: BoundingBox;
7338
+ none_to_south: BoundingBox;
7339
+ east_to_none: BoundingBox;
7340
+ none_to_west: BoundingBox;
7341
+ south_to_none: BoundingBox;
7342
+ none_to_north: BoundingBox;
7343
+ }
6815
7344
  /**
6816
7345
  * A particle prototype may be specified in one of two ways.
6817
7346
  */
@@ -7014,7 +7543,7 @@ interface PipeConnection {
7014
7543
  /**
7015
7544
  * The connected fluidbox, if any.
7016
7545
  */
7017
- target?: LuaFluidBox;
7546
+ target?: LuaEntity;
7018
7547
  /**
7019
7548
  * The index of the target fluidbox, if any.
7020
7549
  */
@@ -7037,10 +7566,19 @@ interface PipeConnectionDefinition {
7037
7566
  flow_direction: FluidFlowDirection;
7038
7567
  direction: defines.direction;
7039
7568
  connection_category: string[];
7569
+ hide_connection_info: boolean;
7040
7570
  /**
7041
- * Only supplied if `connection_type` is `"linked"`.
7571
+ * Only provided if `connection_type` is `"linked"`.
7042
7572
  */
7043
7573
  linked_connection_id?: uint32;
7574
+ /**
7575
+ * Only provided if different from `direction`.
7576
+ */
7577
+ alt_direction?: defines.direction;
7578
+ /**
7579
+ * Only provided if different from first position inside of `positions`.
7580
+ */
7581
+ alt_position?: MapPosition;
7044
7582
  }
7045
7583
  type PipeConnectionType = /**
7046
7584
  * 2 connections are required to be adjacent tiles next to each other on their respective directions.
@@ -7063,6 +7601,49 @@ interface PlaceAsTileResult {
7063
7601
  invert: boolean;
7064
7602
  tile_condition: LuaTilePrototype[];
7065
7603
  }
7604
+ interface PlatformBackdrop {
7605
+ position: Vector;
7606
+ radius: float;
7607
+ rotation_seconds: float;
7608
+ planet_axis: Vector;
7609
+ planet_axis_deviation_amplitude: Vector;
7610
+ planet_axis_deviation_seconds: Vector;
7611
+ parallax_strength: Vector;
7612
+ flight_approach_speed: float;
7613
+ emission_scales_with_shadow: boolean;
7614
+ hero_clouds_are_emissive: boolean;
7615
+ atmosphere_thickness: float;
7616
+ atmosphere_color: Color;
7617
+ specular_color: Color;
7618
+ light_color: Color;
7619
+ light_direction: Vector3D;
7620
+ atmosphere_ray_light_color_1: Color;
7621
+ atmosphere_ray_light_color_2: Color;
7622
+ surface_normal_intensity: float;
7623
+ cloud_normal_intensity: float;
7624
+ specular_intensity: float;
7625
+ cloudiness: float;
7626
+ emission_scalar: float;
7627
+ light_radius: float;
7628
+ light_intensity_contrast: float;
7629
+ surface_vertical_offset: float;
7630
+ cloud_vertical_offset: float;
7631
+ cloud_flow_intensity: float;
7632
+ cloud_flow_seconds: float;
7633
+ cloud_panning_rate: float;
7634
+ hero_clouds: PlatformBackdropHeroCloud[];
7635
+ }
7636
+ interface PlatformBackdropHeroCloud {
7637
+ sprite_index: uint8;
7638
+ rotation_speed: float;
7639
+ rotate_with_planet: boolean;
7640
+ size: Vector;
7641
+ positions: Vector[];
7642
+ starting_frame_offset: uint16;
7643
+ rotation_deviation: float;
7644
+ position_deviation: Vector;
7645
+ projection_style: 'none' | 'front-only' | 'front-and-back' | 'front-and-back-inverted';
7646
+ }
7066
7647
  interface PlatformSchedule {
7067
7648
  /**
7068
7649
  * Index of the currently active record
@@ -7070,6 +7651,36 @@ interface PlatformSchedule {
7070
7651
  current: uint32;
7071
7652
  records: ScheduleRecord[];
7072
7653
  }
7654
+ interface PlayMusicSpecification {
7655
+ /**
7656
+ * The name of ambient sound to play.
7657
+ */
7658
+ name: string;
7659
+ /**
7660
+ * Skip the natural pause between music tracks. If there is currently a track playing, this has no effect. Defaults to `false`.
7661
+ */
7662
+ skip_natural_pause?: boolean;
7663
+ /**
7664
+ * Don't transition from this music track on surface change. Defaults to `false`.
7665
+ */
7666
+ dont_transition_from?: boolean;
7667
+ /**
7668
+ * Number of ticks for the music transition delay.
7669
+ */
7670
+ delay_duration?: uint32;
7671
+ /**
7672
+ * Number of ticks for the music transition fade out.
7673
+ */
7674
+ fade_out_duration?: uint32;
7675
+ /**
7676
+ * Number of ticks for the music transition pause.
7677
+ */
7678
+ pause_duration?: uint32;
7679
+ /**
7680
+ * Number of ticks for the music transition fade in.
7681
+ */
7682
+ fade_in_duration?: uint32;
7683
+ }
7073
7684
  interface PlaySoundSpecification {
7074
7685
  /**
7075
7686
  * The sound to play.
@@ -7088,6 +7699,11 @@ interface PlaySoundSpecification {
7088
7699
  */
7089
7700
  override_sound_type?: SoundType;
7090
7701
  }
7702
+ interface PlayerColorData {
7703
+ name: string;
7704
+ player_color: Color;
7705
+ chat_color: Color;
7706
+ }
7091
7707
  /**
7092
7708
  * A player may be specified in one of three ways.
7093
7709
  */
@@ -7101,6 +7717,12 @@ string | /**
7101
7717
  * A reference to {@link LuaPlayer | runtime:LuaPlayer} may be passed directly.
7102
7718
  */
7103
7719
  LuaPlayer;
7720
+ interface Pollutant {
7721
+ /**
7722
+ * If nil, pollution is disabled.
7723
+ */
7724
+ pollutant?: LuaAirbornePollutantPrototype;
7725
+ }
7104
7726
  /**
7105
7727
  * These values are for the time frame of one second (60 ticks).
7106
7728
  */
@@ -7167,18 +7789,6 @@ interface PostSegmentDiedData {
7167
7789
  */
7168
7790
  orientation?: RealOrientation;
7169
7791
  }
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
7792
  interface PrintSettings {
7183
7793
  /**
7184
7794
  * Color of the message to print. Defaults to white.
@@ -7205,6 +7815,21 @@ interface PrintSettings {
7205
7815
  */
7206
7816
  game_state?: boolean;
7207
7817
  }
7818
+ /**
7819
+ * The name of a {@link ProcessionPrototype | prototype:ProcessionPrototype}.
7820
+ */
7821
+ type ProcessionID = string;
7822
+ interface ProcessionSet {
7823
+ arrival: ProcessionID[];
7824
+ departure: ProcessionID[];
7825
+ }
7826
+ interface ProcessionTimeline {
7827
+ duration: MapTick;
7828
+ special_action_tick: MapTick;
7829
+ draw_switch_tick: MapTick;
7830
+ intermezzo_min_duration: MapTick;
7831
+ intermezzo_max_duration: MapTick;
7832
+ }
7208
7833
  /**
7209
7834
  * Returns one of the subtypes, depending on the value of `type`.
7210
7835
  * @example ```
@@ -7299,7 +7924,7 @@ type PropertyExpressionNames = Record<string, string>;
7299
7924
  *
7300
7925
  * 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
7926
  */
7302
- type PrototypeFilter = (ModSettingPrototypeFilter | SpaceLocationPrototypeFilter | DecorativePrototypeFilter | TilePrototypeFilter | AsteroidChunkPrototypeFilter | ItemPrototypeFilter | TechnologyPrototypeFilter | RecipePrototypeFilter | AchievementPrototypeFilter | EquipmentPrototypeFilter | FluidPrototypeFilter | EntityPrototypeFilter)[];
7927
+ type PrototypeFilter = (ModSettingPrototypeFilter | SpaceLocationPrototypeFilter | DecorativePrototypeFilter | TilePrototypeFilter | AsteroidChunkPrototypeFilter | ItemPrototypeFilter | TechnologyPrototypeFilter | RecipePrototypeFilter | AchievementPrototypeFilter | VirtualSignalPrototypeFilter | EquipmentPrototypeFilter | FluidPrototypeFilter | EntityPrototypeFilter)[];
7303
7928
  type PrototypeFilterMode = 'none' | 'whitelist' | 'blacklist';
7304
7929
  interface PrototypeHistory {
7305
7930
  /**
@@ -7311,6 +7936,16 @@ interface PrototypeHistory {
7311
7936
  */
7312
7937
  changed: string[];
7313
7938
  }
7939
+ interface PrototypeStrafeSettings {
7940
+ max_distance: double;
7941
+ ideal_distance: double;
7942
+ ideal_distance_tolerance: double;
7943
+ ideal_distance_variance: double;
7944
+ ideal_distance_importance: float;
7945
+ ideal_distance_importance_variance: float;
7946
+ clockwise_chance: float;
7947
+ face_target: boolean;
7948
+ }
7314
7949
  interface PrototypeWithQuality {
7315
7950
  /**
7316
7951
  * Name of a prototype.
@@ -7322,12 +7957,14 @@ interface PrototypeWithQuality {
7322
7957
  quality?: string;
7323
7958
  }
7324
7959
  interface ProxyContainerBlueprintControlBehavior {
7960
+ output_networks?: CircuitNetworkSelection;
7325
7961
  /**
7326
7962
  * Defaults to `true`.
7327
7963
  */
7328
7964
  read_contents?: boolean;
7329
7965
  }
7330
7966
  interface PumpBlueprintControlBehavior {
7967
+ input_networks?: CircuitNetworkSelection;
7331
7968
  /**
7332
7969
  * Defaults to `false`.
7333
7970
  */
@@ -7366,11 +8003,41 @@ LuaQualityPrototype | /**
7366
8003
  * The prototype name.
7367
8004
  */
7368
8005
  string;
8006
+ interface QuickBarSlot {
8007
+ /**
8008
+ * Type of slot content
8009
+ */
8010
+ type: 'record' | 'remote' | 'filter' | 'item';
8011
+ /**
8012
+ * Only present and mandatory when `type` is `record`.
8013
+ */
8014
+ record?: LuaRecord;
8015
+ /**
8016
+ * Only present and mandatory when `type` is `remote` or `filter`. Name must be present (cannot be a quality only item filter).
8017
+ */
8018
+ filter?: ItemFilter;
8019
+ /**
8020
+ * Only present and mandatory when `type` is `remote`. Entities must be spider-vehicles.
8021
+ */
8022
+ selection?: LuaEntity[];
8023
+ /**
8024
+ * Only present and mandatory when `type` is `item`.
8025
+ */
8026
+ item?: LuaItem;
8027
+ }
8028
+ interface RadarBlueprintControlBehavior {
8029
+ /**
8030
+ * Defaults to `defines.control_behavior.radar.mode.surface`.
8031
+ */
8032
+ mode?: defines.control_behavior.radar.mode;
8033
+ universe_channel?: SignalID;
8034
+ }
7369
8035
  interface RadiusVisualisationSpecification {
7370
8036
  distance: double;
7371
8037
  offset: Vector;
7372
8038
  draw_in_cursor: boolean;
7373
8039
  draw_on_selection: boolean;
8040
+ distance_quality_multiplier?: Record<string, double>;
7374
8041
  }
7375
8042
  interface RailEndGoal {
7376
8043
  /**
@@ -7423,6 +8090,8 @@ interface RailLocation {
7423
8090
  rail_layer: defines.rail_layer;
7424
8091
  }
7425
8092
  interface RailSignalBaseBlueprintControlBehavior {
8093
+ input_networks?: CircuitNetworkSelection;
8094
+ output_networks?: CircuitNetworkSelection;
7426
8095
  circuit_close_signal: boolean;
7427
8096
  circuit_read_signal: boolean;
7428
8097
  red_output_signal?: SignalID;
@@ -7433,10 +8102,11 @@ interface RailSignalBaseBlueprintControlBehavior {
7433
8102
  }
7434
8103
  type RangeMode = 'center-to-center' | 'bounding-box-to-bounding-box' | 'center-to-bounding-box';
7435
8104
  interface ReactorBlueprintControlBehavior {
8105
+ output_networks?: CircuitNetworkSelection;
7436
8106
  /**
7437
8107
  * Defaults to `false`.
7438
8108
  */
7439
- read_burner_fuel?: boolean;
8109
+ read_fuel?: boolean;
7440
8110
  /**
7441
8111
  * Defaults to `false`.
7442
8112
  */
@@ -7489,7 +8159,7 @@ interface BaseRecipePrototypeFilter {
7489
8159
  /**
7490
8160
  * The condition to filter on.
7491
8161
  */
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';
8162
+ 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
8163
  /**
7494
8164
  * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
7495
8165
  */
@@ -7724,7 +8394,16 @@ LuaSchedule | /**
7724
8394
  LuaTerritory | /**
7725
8395
  * Target type {@link segmented_unit | runtime:defines.target_type.segmented_unit}; `useful_id` {@link LuaSegmentedUnit::unit_number | runtime:LuaSegmentedUnit::unit_number}
7726
8396
  */
7727
- LuaSegmentedUnit;
8397
+ LuaSegmentedUnit | /**
8398
+ * Target type {@link electric_network | runtime:defines.target_type.electric_network}
8399
+ */
8400
+ LuaElectricNetwork | /**
8401
+ * Target type {@link electric_sub_network | runtime:defines.target_type.electric_sub_network}; `useful_id` {@link LuaElectricSubNetwork::id | runtime:LuaElectricSubNetwork::id}
8402
+ */
8403
+ LuaElectricSubNetwork | /**
8404
+ * Target type {@link force | runtime:defines.target_type.force}; `useful_id` {@link LuaForce::index | runtime:LuaForce::index}
8405
+ */
8406
+ LuaForce;
7728
8407
  /**
7729
8408
  * 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
8409
  */
@@ -7945,6 +8624,18 @@ string | /**
7945
8624
  * 226
7946
8625
  */
7947
8626
  'cursor';
8627
+ type RequestFromLocation = 'planet' | 'platforms' | 'all';
8628
+ interface ResearchCondition {
8629
+ condition?: CircuitCondition;
8630
+ /**
8631
+ * The technology to research when the condition passes.
8632
+ */
8633
+ name?: string;
8634
+ /**
8635
+ * The technology level to research (only applicable for infinite technologies) defaults to 0.
8636
+ */
8637
+ count?: uint32;
8638
+ }
7948
8639
  interface ResearchIngredient {
7949
8640
  /**
7950
8641
  * Prototype name of the required item.
@@ -8032,6 +8723,7 @@ interface RidingState {
8032
8723
  direction: defines.riding.direction;
8033
8724
  }
8034
8725
  interface RoboportBlueprintControlBehavior {
8726
+ output_networks?: CircuitNetworkSelection;
8035
8727
  read_items_mode?: boolean;
8036
8728
  read_robot_stats?: boolean;
8037
8729
  available_logistic_output_signal?: SignalID;
@@ -8041,6 +8733,7 @@ interface RoboportBlueprintControlBehavior {
8041
8733
  roboport_count_output_signal?: SignalID;
8042
8734
  }
8043
8735
  interface RocketSiloBlueprintControlBehavior {
8736
+ output_networks?: CircuitNetworkSelection;
8044
8737
  /**
8045
8738
  * Defaults to `logistic_inventory`.
8046
8739
  */
@@ -8052,6 +8745,22 @@ interface RollingStockDrawData {
8052
8745
  slope: float;
8053
8746
  height: float;
8054
8747
  }
8748
+ interface RuntimeTooltipField {
8749
+ id?: uint32;
8750
+ name: LocalisedString;
8751
+ value: LocalisedString;
8752
+ order?: uint8;
8753
+ }
8754
+ interface SavedLogisticFilters {
8755
+ trash_not_requested: boolean;
8756
+ sections: SavedLogisticSection[];
8757
+ }
8758
+ interface SavedLogisticSection {
8759
+ group?: string;
8760
+ filters?: LogisticFilter[];
8761
+ multiplier?: float;
8762
+ active?: boolean;
8763
+ }
8055
8764
  interface ScheduleInterrupt {
8056
8765
  /**
8057
8766
  * Defaults to an empty string.
@@ -8107,11 +8816,20 @@ interface ScriptPosition {
8107
8816
  color: Color;
8108
8817
  id: uint32;
8109
8818
  }
8110
- type ScriptRenderMode = 'game' | 'chart';
8819
+ type ScriptRenderMode = /**
8820
+ * Draw the object in the game world.
8821
+ */
8822
+ 'game' | /**
8823
+ * Draw the object on the map.
8824
+ */
8825
+ 'chart' | /**
8826
+ * Draw the object only when the player holds a buildable item trying to build an entity.
8827
+ */
8828
+ 'build-cursor';
8111
8829
  /**
8112
8830
  * When writing it is possible to give LuaEntity or MapPosition directly. However, reading always returns the full ScriptRenderTargetTable.
8113
8831
  *
8114
- * The full ScriptRenderTargetTable allows specifying an offset for entity targets.
8832
+ * The full ScriptRenderTargetTable allows specifying cursor targets and an offset for entity targets.
8115
8833
  *
8116
8834
  * If an entity target of an object (except its `orientation_target`) is destroyed or changes surface, then the object is also destroyed.
8117
8835
  * @example ```
@@ -8121,32 +8839,72 @@ target = some_lua_entity
8121
8839
  target = {1, 4}
8122
8840
  ```
8123
8841
  * @example ```
8124
- target = {entity = another_lua_entity, offset = {-0.5, 1}}
8842
+ target = {type = "entity", entity = another_lua_entity, offset = {-0.5, 1}}
8125
8843
  ```
8126
8844
  * @example ```
8127
- target = {position = {2.5, 3}}
8845
+ target = {type = "position", position = {2.5, 3}}
8846
+ ```
8847
+ * @example ```
8848
+ target = {type = "cursor", offset = {6, 7}}
8849
+ ```
8850
+ * @example ```
8851
+ target = {type = "build-cursor", offset = {3.2, -4.5}}
8128
8852
  ```
8129
8853
  */
8130
8854
  type ScriptRenderTarget = LuaEntity | MapPosition | ScriptRenderTargetTable;
8131
8855
  /**
8856
+ * If an entity target of an object (except its `orientation_target`) is destroyed or changes surface, then the object is also destroyed.
8857
+ *
8858
+ * Targets of type `"cursor"` draw at the position of the player's cursor.
8859
+ *
8860
+ * 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}.
8861
+ * @example ```
8862
+ {type = "entity", entity = some_lua_entity, offset = {-0.5, 1}}
8863
+ ```
8864
+ * @example ```
8865
+ {entity = some_lua_entity, offset = {-0.5, 1}} -- same target as previous example
8866
+ ```
8867
+ * @example ```
8868
+ {type = "position", position = {2.5, 3}}
8869
+ ```
8870
+ * @example ```
8871
+ {position = {2.5, 3}} -- same target as previous example
8872
+ ```
8132
8873
  * @example ```
8133
- {entity = some_lua_entity, offset = {-0.5, 1}}
8874
+ {type = "cursor", offset = {6, 7}}
8134
8875
  ```
8135
8876
  * @example ```
8136
- {position = {2.5, 3}}
8877
+ {type = "build-cursor", offset = {3.2, -4.5}}
8137
8878
  ```
8138
8879
  */
8139
8880
  interface ScriptRenderTargetTable {
8881
+ /**
8882
+ * Defaults to `"entity"` if `entity` is given. Defaults to `"position"` if `position` is given.
8883
+ */
8884
+ type?: 'entity' | 'position' | 'cursor' | 'build-cursor';
8885
+ /**
8886
+ * Only used, and mandatory if `type` is `entity`.
8887
+ */
8140
8888
  entity?: LuaEntity;
8141
8889
  /**
8142
- * Only used if `entity` was given.
8890
+ * Only used if `type` is `entity`, `cursor` or `build-cursor`. Defaults to `{0, 0}`.
8143
8891
  */
8144
8892
  offset?: Vector;
8145
8893
  /**
8146
- * Only used, and mandatory if `entity` is not given.
8894
+ * Only used, and mandatory if `type` is `position`.
8147
8895
  */
8148
8896
  position?: MapPosition;
8149
8897
  }
8898
+ type ScriptSpriteLightMode = /**
8899
+ * Draw as a regular sprite which occludes light under it if this option is enabled in graphics settings.
8900
+ */
8901
+ 'occluder' | /**
8902
+ * Draw as light.
8903
+ */
8904
+ 'light' | /**
8905
+ * Draw as both occluder and light at once to make the sprite visible during the day and glow at night.
8906
+ */
8907
+ 'glow';
8150
8908
  /**
8151
8909
  * Scroll policy of a {@link scroll pane | runtime:LuaGuiElement}.
8152
8910
  */
@@ -8314,13 +9072,13 @@ interface SelectedPrototypeData {
8314
9072
  * 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
9073
  */
8316
9074
  type SelectionModeFlags = Record</**
8317
- * Selects entities and tiles as if selecting them for a blueprint.
9075
+ * Excludes entities and tiles that can't be selected for blueprinting.
8318
9076
  */
8319
9077
  'blueprint' | /**
8320
- * Selects entities and tiles as if selecting them for deconstruction.
9078
+ * Excludes entities and tiles that can't be selected for deconstruction.
8321
9079
  */
8322
9080
  'deconstruct' | /**
8323
- * Selects entities and tiles as if selecting them for deconstruction cancellation.
9081
+ * Excludes entities that can't be selected for deconstruction cancellation.
8324
9082
  */
8325
9083
  'cancel-deconstruct' | /**
8326
9084
  * Selects items on the ground.
@@ -8356,13 +9114,13 @@ type SelectionModeFlags = Record</**
8356
9114
  * Selects entities from an {@link enemy | runtime:LuaForce::is_enemy} force.
8357
9115
  */
8358
9116
  'enemy' | /**
8359
- * Selects entities as if selecting them for upgrading.
9117
+ * Excludes entities that can't be selected for upgrading.
8360
9118
  */
8361
9119
  'upgrade' | /**
8362
- * Selects entities as if selecting them for upgrade cancellation.
9120
+ * Excludes entities that can't be selected for upgrade cancellation.
8363
9121
  */
8364
9122
  'cancel-upgrade' | /**
8365
- * Selects entities as if selecting them for downgrading.
9123
+ * Excludes entities that can't be selected for downgrading.
8366
9124
  */
8367
9125
  'downgrade' | /**
8368
9126
  * Selects entities that are {@link entities with health | runtime:LuaEntity::is_entity_with_health}.
@@ -8383,14 +9141,14 @@ type SelectionModeFlags = Record</**
8383
9141
  * Selects entities that are `tile-ghost`s.
8384
9142
  */
8385
9143
  'tile-ghost', true>;
8386
- type SelectorCombinatorParameterOperation = 'select' | 'count' | 'random' | 'quality-transfer' | 'rocket-capacity' | 'stack-size' | 'quality-filter';
9144
+ type SelectorCombinatorParameterOperation = 'select' | 'count' | 'random' | 'quality-transfer' | 'rocket-capacity' | 'stack-size' | 'quality-filter' | 'time';
8387
9145
  interface BaseSelectorCombinatorParameters {
8388
9146
  /**
8389
9147
  * Defaults to `"select"`.
8390
9148
  */
8391
9149
  operation?: SelectorCombinatorParameterOperation;
8392
9150
  }
8393
- type SelectorCombinatorParameters = BaseSelectorCombinatorParameters | SelectorCombinatorParametersCount | SelectorCombinatorParametersQualityFilter | SelectorCombinatorParametersQualityTransfer | SelectorCombinatorParametersRandom | SelectorCombinatorParametersSelect;
9151
+ type SelectorCombinatorParameters = BaseSelectorCombinatorParameters | SelectorCombinatorParametersCount | SelectorCombinatorParametersQualityFilter | SelectorCombinatorParametersQualityTransfer | SelectorCombinatorParametersRandom | SelectorCombinatorParametersSelect | SelectorCombinatorParametersTime;
8394
9152
  /**
8395
9153
  *
8396
9154
  * Applies to variant case `count`
@@ -8472,6 +9230,38 @@ interface SelectorCombinatorParametersSelect extends BaseSelectorCombinatorParam
8472
9230
  */
8473
9231
  'select_max'?: boolean;
8474
9232
  }
9233
+ /**
9234
+ *
9235
+ * Applies to variant case `time`
9236
+ */
9237
+ interface SelectorCombinatorParametersTime extends BaseSelectorCombinatorParameters {
9238
+ /**
9239
+ * Defaults to `"select"`.
9240
+ */
9241
+ 'operation'?: 'time';
9242
+ /**
9243
+ * ;
9244
+ */
9245
+ 'day_length_signal'?: SignalID;
9246
+ /**
9247
+ * ;
9248
+ */
9249
+ 'day_tick_signal'?: SignalID;
9250
+ /**
9251
+ * ;
9252
+ */
9253
+ 'game_tick_signal'?: SignalID;
9254
+ }
9255
+ interface SharedProbabilityDefinition {
9256
+ /**
9257
+ * Lower end of the range of shared roll values that will allow product to be given. Must be >= `0` and <= `max`.
9258
+ */
9259
+ min: double;
9260
+ /**
9261
+ * Upper end of the range of shared roll values that will allow product to be given. Must be >= `min` and <= `1`.
9262
+ */
9263
+ max: double;
9264
+ }
8475
9265
  /**
8476
9266
  * An actual signal transmitted by the network.
8477
9267
  */
@@ -8492,7 +9282,7 @@ interface Signal {
8492
9282
  */
8493
9283
  type SignalFilter = {
8494
9284
  /**
8495
- * The type of the signal filter.
9285
+ * 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
9286
  */
8497
9287
  type?: SignalIDType;
8498
9288
  /**
@@ -8533,7 +9323,42 @@ interface SignalIDBase {
8533
9323
  name?: string;
8534
9324
  }
8535
9325
  type SignalIDType = 'item' | 'fluid' | 'virtual' | 'entity' | 'recipe' | 'space-location' | 'asteroid-chunk' | 'quality';
9326
+ interface SimpleBoundingBox {
9327
+ left_top: MapPosition;
9328
+ right_bottom: MapPosition;
9329
+ }
9330
+ interface SimulationDefinition {
9331
+ planet: SpaceLocationID;
9332
+ game_view_settings: GameViewSettings;
9333
+ save: string;
9334
+ init: string;
9335
+ update: string;
9336
+ mods: string[];
9337
+ init_update_count: uint32;
9338
+ length: uint32;
9339
+ generate_map: boolean;
9340
+ checkboard: boolean;
9341
+ hide_health_bars: boolean;
9342
+ mute_technology_finished_sound: boolean;
9343
+ mute_alert_sounds: boolean;
9344
+ volume_modifier?: float;
9345
+ override_volume?: boolean;
9346
+ mute_wind_sounds?: boolean;
9347
+ hide_factoriopedia_gradient?: boolean;
9348
+ }
8536
9349
  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';
9350
+ interface SingleFluidBoxBlueprintControlBehavior {
9351
+ output_networks?: CircuitNetworkSelection;
9352
+ /**
9353
+ * Defaults to `send_contents`.
9354
+ */
9355
+ circuit_mode_of_operation?: defines.control_behavior.single_fluid_box.exclusive_mode;
9356
+ /**
9357
+ * Defaults to `false`.
9358
+ */
9359
+ read_temperature?: boolean;
9360
+ temperature_signal: SignalID;
9361
+ }
8537
9362
  interface SlotFilter {
8538
9363
  /**
8539
9364
  * Position of the corresponding filter slot.
@@ -8573,7 +9398,7 @@ interface SmokeSource {
8573
9398
  * The utility and ambient types each contain general use sound prototypes defined by the game itself.
8574
9399
  *
8575
9400
  * - `"utility"` - Uses {@link UtilitySounds | prototype:UtilitySounds}. Example: `"utility/wire_connect_pole"`
8576
- * - `"ambient"` - Uses {@link AmbientSound | prototype:AmbientSound}. Example: `"ambient/resource-deficiency"`
9401
+ * - `"ambient"` - Uses {@link AmbientSound::sound | prototype:AmbientSound::sound}. Variable sounds cannot be used. Example: `"ambient/resource-deficiency"`
8577
9402
  * The following types can be combined with any tile name as long as its prototype defines the corresponding sound.
8578
9403
  *
8579
9404
  * - `"tile-walking"` - Uses {@link TilePrototype::walking_sound | prototype:TilePrototype::walking_sound}. Example: `"tile-walking/concrete"`
@@ -8628,6 +9453,9 @@ LuaSpaceConnectionPrototype | /**
8628
9453
  * The prototype name.
8629
9454
  */
8630
9455
  string;
9456
+ interface SpaceDustEffectProperties {
9457
+ animation_speed: float;
9458
+ }
8631
9459
  interface SpaceLocationAsteroidSpawnDefinition {
8632
9460
  /**
8633
9461
  * `asteroid-chunk` or `entity`
@@ -8696,10 +9524,16 @@ interface SpaceLocationPrototypeFilterType extends BaseSpaceLocationPrototypeFil
8696
9524
  'type': string | string[];
8697
9525
  }
8698
9526
  interface SpacePlatformHubBlueprintControlBehavior {
9527
+ input_networks?: CircuitNetworkSelection;
9528
+ output_networks?: CircuitNetworkSelection;
8699
9529
  /**
8700
9530
  * Defaults to `true`.
8701
9531
  */
8702
9532
  read_contents?: boolean;
9533
+ /**
9534
+ * Defaults to `false`.
9535
+ */
9536
+ set_requests?: boolean;
8703
9537
  /**
8704
9538
  * Defaults to `true`.
8705
9539
  */
@@ -8737,6 +9571,11 @@ interface SpawnPointDefinition {
8737
9571
  */
8738
9572
  weight: double;
8739
9573
  }
9574
+ interface SpentFluidSpecification {
9575
+ name: string;
9576
+ amount: double;
9577
+ temperature: float;
9578
+ }
8740
9579
  interface SpiderEngineSpecification {
8741
9580
  legs: SpiderLegSpecification[];
8742
9581
  walking_group_overlap: float;
@@ -8753,6 +9592,7 @@ interface SpiderLegSpecification {
8753
9592
  walking_group: uint8;
8754
9593
  }
8755
9594
  interface SplitterBlueprintControlBehavior {
9595
+ input_networks?: CircuitNetworkSelection;
8756
9596
  /**
8757
9597
  * Defaults to `false`.
8758
9598
  */
@@ -8771,7 +9611,7 @@ interface SplitterBlueprintControlBehavior {
8771
9611
  set_filter?: boolean;
8772
9612
  }
8773
9613
  type SplitterPriority = 'left' | 'none' | 'right';
8774
- type SpoilPriority = 'fresh_first' | 'none' | 'spoiled_first';
9614
+ type SpoilPriority = 'fresh-first' | 'none' | 'spoiled-first';
8775
9615
  interface SpoilToTriggerResult {
8776
9616
  /**
8777
9617
  * The trigger items that are run.
@@ -8811,27 +9651,21 @@ interface SpoilToTriggerResult {
8811
9651
  * - `"utility"` - sprite defined in the utility-sprites object, these are the pictures used by the game internally for the UI.
8812
9652
  */
8813
9653
  type SpritePath = string;
8814
- interface SteeringMapSetting {
9654
+ interface StateSteeringSettings {
8815
9655
  /**
8816
- * Does not include the radius of the unit.
9656
+ * Not including the radius of the unit.
8817
9657
  */
8818
9658
  radius: double;
8819
9659
  separation_factor: double;
8820
9660
  separation_force: double;
8821
- /**
8822
- * Used to make steering look better for aesthetic purposes.
8823
- */
8824
- force_unit_fuzzy_goto_behavior: boolean;
8825
- }
8826
- interface SteeringMapSettings {
8827
- default: SteeringMapSetting;
8828
- moving: SteeringMapSetting;
8829
9661
  }
8830
- interface StorageTankBlueprintControlBehavior {
9662
+ interface SteeringSettings {
9663
+ stay: StateSteeringSettings;
9664
+ move: StateSteeringSettings;
8831
9665
  /**
8832
- * Defaults to `true`.
9666
+ * Used only for special "to look good" purposes (like in trailer).
8833
9667
  */
8834
- read_contents?: boolean;
9668
+ force_unit_fuzzy_goto_behavior: boolean;
8835
9669
  }
8836
9670
  interface SurfaceCondition {
8837
9671
  property: string;
@@ -8861,6 +9695,14 @@ LuaSurfacePropertyPrototype | /**
8861
9695
  * The prototype name.
8862
9696
  */
8863
9697
  string;
9698
+ interface SurfaceRenderParameters {
9699
+ clouds: CloudsEffectProperties;
9700
+ fog: FogEffectProperties;
9701
+ terrain_tint_effect: GlobalTintEffectProperties;
9702
+ space_dust_background: SpaceDustEffectProperties;
9703
+ space_dust_foreground: SpaceDustEffectProperties;
9704
+ platform_backdrop: PlatformBackdrop;
9705
+ }
8864
9706
  /**
8865
9707
  * State of a GUI {@link switch | runtime:LuaGuiElement::switch_state}.
8866
9708
  */
@@ -8918,7 +9760,7 @@ interface BaseTechnologyModifier {
8918
9760
  /**
8919
9761
  * The effect that is applied when a technology is researched.
8920
9762
  */
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;
9763
+ 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
9764
  /**
8923
9765
  *
8924
9766
  * Applies to variant case `ammo-damage`
@@ -9345,6 +10187,20 @@ interface TechnologyModifierLaboratorySpeed extends BaseTechnologyModifier {
9345
10187
  */
9346
10188
  'modifier': double;
9347
10189
  }
10190
+ /**
10191
+ *
10192
+ * Applies to variant case `max-cargo-bay-unloading-distance`
10193
+ */
10194
+ interface TechnologyModifierMaxCargoBayUnloadingDistance extends BaseTechnologyModifier {
10195
+ /**
10196
+ * Modifier type. Specifies which of the other fields will be available.
10197
+ */
10198
+ 'type': 'max-cargo-bay-unloading-distance';
10199
+ /**
10200
+ * The amount to increase the current max cargo bay unloading distance by upon researching.
10201
+ */
10202
+ 'modifier': double;
10203
+ }
9348
10204
  /**
9349
10205
  *
9350
10206
  * Applies to variant case `max-failed-attempts-per-tick-per-construction-queue`
@@ -9503,6 +10359,20 @@ interface TechnologyModifierUnlockCircuitNetwork extends BaseTechnologyModifier
9503
10359
  */
9504
10360
  'modifier': boolean;
9505
10361
  }
10362
+ /**
10363
+ *
10364
+ * Applies to variant case `unlock-logistic-network`
10365
+ */
10366
+ interface TechnologyModifierUnlockLogisticNetwork extends BaseTechnologyModifier {
10367
+ /**
10368
+ * Modifier type. Specifies which of the other fields will be available.
10369
+ */
10370
+ 'type': 'unlock-logistic-network';
10371
+ /**
10372
+ * The state this modifier will be in upon researching.
10373
+ */
10374
+ 'modifier': boolean;
10375
+ }
9506
10376
  /**
9507
10377
  *
9508
10378
  * Applies to variant case `unlock-quality`
@@ -9559,6 +10429,20 @@ interface TechnologyModifierUnlockSpacePlatforms extends BaseTechnologyModifier
9559
10429
  */
9560
10430
  'modifier': boolean;
9561
10431
  }
10432
+ /**
10433
+ *
10434
+ * Applies to variant case `unlock-travel-to-space-platforms`
10435
+ */
10436
+ interface TechnologyModifierUnlockTravelToSpacePlatforms extends BaseTechnologyModifier {
10437
+ /**
10438
+ * Modifier type. Specifies which of the other fields will be available.
10439
+ */
10440
+ 'type': 'unlock-travel-to-space-platforms';
10441
+ /**
10442
+ * The state this modifier will be in upon researching.
10443
+ */
10444
+ 'modifier': boolean;
10445
+ }
9562
10446
  /**
9563
10447
  *
9564
10448
  * Applies to variant case `vehicle-logistics`
@@ -9709,6 +10593,7 @@ interface TerritorySettings {
9709
10593
  territory_variation_expression: string;
9710
10594
  minimum_territory_size: uint32;
9711
10595
  }
10596
+ type TerritoryVisibilityCondition = 'never' | 'has-unit' | 'always';
9712
10597
  /**
9713
10598
  * The text is aligned so that the target position is at the given side of the text.
9714
10599
  *
@@ -9751,6 +10636,12 @@ interface TileBuildabilityRule {
9751
10636
  */
9752
10637
  remove_on_collision: boolean;
9753
10638
  }
10639
+ interface TileCollisionMask {
10640
+ /**
10641
+ * 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.
10642
+ */
10643
+ layers: Record<string, true>;
10644
+ }
9754
10645
  /**
9755
10646
  * A tile may be specified in one of three ways.
9756
10647
  */
@@ -9966,6 +10857,20 @@ interface TrainPathAllGoalsResult {
9966
10857
  */
9967
10858
  steps_count: uint32;
9968
10859
  }
10860
+ interface TrainPathFinderConstants {
10861
+ train_stop_penalty: uint32;
10862
+ stopped_manually_controlled_train_penalty: uint32;
10863
+ stopped_manually_controlled_train_without_passenger_penalty: uint32;
10864
+ signal_reserved_by_circuit_network_penalty: uint32;
10865
+ train_in_station_penalty: uint32;
10866
+ train_in_station_with_no_other_valid_stops_in_schedule: uint32;
10867
+ train_arriving_to_station_penalty: uint32;
10868
+ train_arriving_to_signal_penalty: uint32;
10869
+ train_waiting_at_signal_penalty: uint32;
10870
+ train_waiting_at_signal_tick_multiplier_penalty: float;
10871
+ train_with_no_path_penalty: uint32;
10872
+ train_auto_without_schedule_penalty: uint32;
10873
+ }
9969
10874
  type TrainPathFinderGoal = TrainStopGoal | RailEndGoal | LuaRailEnd | /**
9970
10875
  * Only if it points at train-stop that is connected to a rail.
9971
10876
  */
@@ -10028,6 +10933,8 @@ interface TrainSchedule {
10028
10933
  records: ScheduleRecord[];
10029
10934
  }
10030
10935
  interface TrainStopBlueprintControlBehavior {
10936
+ input_networks?: CircuitNetworkSelection;
10937
+ output_networks?: CircuitNetworkSelection;
10031
10938
  /**
10032
10939
  * Defaults to `true`.
10033
10940
  */
@@ -10111,7 +11018,21 @@ interface TrainStopGoal {
10111
11018
  */
10112
11019
  priority?: uint8;
10113
11020
  }
11021
+ interface TrainVisualizationConstants {
11022
+ not_last_box_color: Color;
11023
+ last_box_color: Color;
11024
+ reverse_box_color: Color;
11025
+ last_reverse_box_color: Color;
11026
+ box_width: float;
11027
+ box_length: float;
11028
+ joint_distance: float;
11029
+ connection_distance: float;
11030
+ final_margin: float;
11031
+ stock_number_scale: float;
11032
+ }
10114
11033
  interface TransportBeltBlueprintControlBehavior {
11034
+ input_networks?: CircuitNetworkSelection;
11035
+ output_networks?: CircuitNetworkSelection;
10115
11036
  circuit_read_hand_contents: boolean;
10116
11037
  circuit_contents_read_mode: defines.control_behavior.transport_belt.content_read_mode;
10117
11038
  /**
@@ -10180,6 +11101,7 @@ interface TriggerDeliveryDelayed extends BaseTriggerDelivery {
10180
11101
  interface TriggerDeliveryProjectile extends BaseTriggerDelivery {
10181
11102
  'type': 'projectile';
10182
11103
  'direction_deviation': float;
11104
+ 'inherit_speed': boolean;
10183
11105
  'max_range': double;
10184
11106
  'min_range': double;
10185
11107
  'projectile': string;
@@ -10205,7 +11127,7 @@ interface BaseTriggerEffectItem {
10205
11127
  show_in_tooltip: boolean;
10206
11128
  damage_type_filters?: DamageTypeFilters;
10207
11129
  }
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;
11130
+ 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
11131
  /**
10210
11132
  *
10211
11133
  * Applies to variant case `activate-impact`
@@ -10351,6 +11273,16 @@ interface TriggerEffectItemCreateParticle extends BaseTriggerEffectItem {
10351
11273
  'tile_collision_mask': CollisionMask;
10352
11274
  'tint'?: Color;
10353
11275
  }
11276
+ /**
11277
+ *
11278
+ * Applies to variant case `create-pollution`
11279
+ */
11280
+ interface TriggerEffectItemCreatePollution extends BaseTriggerEffectItem {
11281
+ 'type': 'create-pollution';
11282
+ 'amount': double;
11283
+ 'entity'?: string;
11284
+ 'use_entity_from_trigger': boolean;
11285
+ }
10354
11286
  /**
10355
11287
  *
10356
11288
  * Applies to variant case `create-smoke`
@@ -10530,7 +11462,7 @@ interface TriggerEffectItemShowExplosionOnChart extends BaseTriggerEffectItem {
10530
11462
  /**
10531
11463
  * Used by {@link TriggerEffectItem | runtime:TriggerEffectItem}.
10532
11464
  */
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';
11465
+ 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
11466
  interface TriggerEffectWithCooldown {
10535
11467
  /**
10536
11468
  * The travel distance between triggers that the triggerer must travel between effects.
@@ -10632,6 +11564,8 @@ LuaTrivialSmokePrototype | /**
10632
11564
  */
10633
11565
  string;
10634
11566
  interface TurretBlueprintControlBehavior {
11567
+ input_networks?: CircuitNetworkSelection;
11568
+ output_networks?: CircuitNetworkSelection;
10635
11569
  /**
10636
11570
  * Defaults to `false`.
10637
11571
  */
@@ -10873,6 +11807,33 @@ interface UndoRedoActionWireRemoved extends BaseUndoRedoAction {
10873
11807
  'a': BlueprintWireEnd;
10874
11808
  'b': BlueprintWireEnd;
10875
11809
  }
11810
+ interface UnitAISettings {
11811
+ /**
11812
+ * If enabled, units that repeatedly fail to succeed at commands will be destroyed.
11813
+ */
11814
+ destroy_when_commands_fail: boolean;
11815
+ /**
11816
+ * If enabled, units that have nothing else to do will attempt to return to a spawner.
11817
+ */
11818
+ allow_try_return_to_spawner: boolean;
11819
+ /**
11820
+ * If enabled, units will try to separate themselves from nearby friendly units.
11821
+ */
11822
+ do_separation: boolean;
11823
+ /**
11824
+ * Must be between -8 and 8.
11825
+ */
11826
+ path_resolution_modifier: int8;
11827
+ strafe_settings?: PrototypeStrafeSettings;
11828
+ /**
11829
+ * 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.
11830
+ */
11831
+ size_in_group: float;
11832
+ /**
11833
+ * If enabled, the unit is permitted to join attack groups.
11834
+ */
11835
+ join_attacks: boolean;
11836
+ }
10876
11837
  interface UnitGroupMapSettings {
10877
11838
  /**
10878
11839
  * 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 +11895,14 @@ interface UnitSpawnDefinition {
10934
11895
  */
10935
11896
  spawn_points: SpawnPointDefinition[];
10936
11897
  }
11898
+ interface UnlockableID {
11899
+ type: UnlockableIDType;
11900
+ /**
11901
+ * 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"`
11902
+ */
11903
+ name?: string;
11904
+ }
11905
+ 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
11906
  interface UpgradeMapperDestination {
10938
11907
  type: 'item' | 'entity';
10939
11908
  /**
@@ -10972,6 +11941,350 @@ interface UpgradeMapperSource {
10972
11941
  */
10973
11942
  module_filter?: EntityIDFilter;
10974
11943
  }
11944
+ /**
11945
+ * 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.
11946
+ *
11947
+ * Note that this is actually implemented as a {@link LuaCustomTable | runtime:LuaCustomTable}, not a regular table.
11948
+ */
11949
+ interface UtilityConstants {
11950
+ /**
11951
+ * Chart means map and minimap.
11952
+ */
11953
+ chart: ChartUtilityConstants;
11954
+ /**
11955
+ * The base game uses more entries here that are applied via the `ammo-category.lua` file.
11956
+ */
11957
+ bonus_gui_ordering: BonusUtilityConstants;
11958
+ map_editor: EditorUtilityConstants;
11959
+ entity_button_background_color: Color;
11960
+ building_buildable_too_far_tint: Color;
11961
+ building_buildable_tint: Color;
11962
+ building_not_buildable_tint: Color;
11963
+ building_ignorable_tint: Color;
11964
+ building_no_tint: Color;
11965
+ /**
11966
+ * Tall entities will be tinted with this value when "Hide tall entities" mode is active.
11967
+ */
11968
+ tall_entity_tint: Color;
11969
+ /**
11970
+ * All trivial smoke will be tinted with this value when "Hide tall entities" mode is active.
11971
+ */
11972
+ tall_entity_smoke_tint: Color;
11973
+ underground_belt_max_distance_tint: Color;
11974
+ underground_pipe_max_distance_tint: Color;
11975
+ ghost_shader_tint: GhostTintSet;
11976
+ ghost_shaderless_tint: GhostTintSet;
11977
+ ghost_shimmer_settings: GhostShimmerConfig;
11978
+ probability_product_count_tint: Color;
11979
+ ghost_product_count_tint: Color;
11980
+ zero_count_value_tint: Color;
11981
+ equipment_default_background_color: Color;
11982
+ equipment_default_background_border_color: Color;
11983
+ equipment_default_grabbed_background_color: Color;
11984
+ equipment_disabled_background_tint: Color;
11985
+ equipment_disabled_tint: Color;
11986
+ turret_range_visualization_color: Color;
11987
+ capsule_range_visualization_color: Color;
11988
+ agricultural_range_visualization_color: Color;
11989
+ artillery_range_visualization_color: Color;
11990
+ gui_remark_color: Color;
11991
+ gui_search_match_foreground_color: Color;
11992
+ gui_search_match_background_color: Color;
11993
+ default_player_force_color: Color;
11994
+ default_enemy_force_color: Color;
11995
+ default_other_force_color: Color;
11996
+ deconstruct_mark_tint: Color;
11997
+ rail_planner_count_button_color: Color;
11998
+ count_button_size: int32;
11999
+ logistic_gui_unselected_network_highlight_tint: Color;
12000
+ logistic_gui_selected_network_highlight_tint: Color;
12001
+ chart_search_highlight: Color;
12002
+ selected_chart_search_highlight: Color;
12003
+ zoom_to_world_can_use_nightvision: boolean;
12004
+ zoom_to_world_effect_strength: float;
12005
+ max_logistic_filter_count: LogisticFilterIndex;
12006
+ /**
12007
+ * Will be clamped to the range [1, 100].
12008
+ */
12009
+ select_group_row_count: uint8;
12010
+ /**
12011
+ * Will be clamped to the range [1, 100].
12012
+ */
12013
+ select_slot_row_count: uint8;
12014
+ /**
12015
+ * Will be clamped to the range [2, 100].
12016
+ */
12017
+ logistic_slots_per_row: uint8;
12018
+ /**
12019
+ * Will be clamped to the range [1, 100].
12020
+ */
12021
+ crafting_queue_slots_per_row: uint8;
12022
+ /**
12023
+ * Will be clamped to the range [2, 100].
12024
+ */
12025
+ blueprint_big_slots_per_row: uint8;
12026
+ /**
12027
+ * Will be clamped to the range [2, 100].
12028
+ */
12029
+ blueprint_small_slots_per_row: uint8;
12030
+ /**
12031
+ * Will be clamped to the range [1, 100].
12032
+ */
12033
+ inventory_width: uint8;
12034
+ /**
12035
+ * Will be clamped to the range [1, 100].
12036
+ */
12037
+ module_inventory_width: uint8;
12038
+ /**
12039
+ * Will be clamped to the range [1, 100].
12040
+ */
12041
+ trash_inventory_width: uint8;
12042
+ max_terrain_building_size: uint8;
12043
+ small_area_size: float;
12044
+ medium_area_size: float;
12045
+ large_area_size: float;
12046
+ huge_area_size: float;
12047
+ huge_platform_animation_sound_area: float;
12048
+ small_blueprint_area_size: float;
12049
+ medium_blueprint_area_size: float;
12050
+ large_blueprint_area_size: float;
12051
+ enabled_recipe_slot_tint: Color;
12052
+ disabled_recipe_slot_tint: Color;
12053
+ disabled_recipe_slot_background_tint: Color;
12054
+ forced_enabled_recipe_slot_background_tint: Color;
12055
+ rail_segment_colors: Color[];
12056
+ /**
12057
+ * The table with `name = "default"` must exist and be the first member of the array.
12058
+ */
12059
+ player_colors: PlayerColorData[];
12060
+ server_command_console_chat_color: Color;
12061
+ script_command_console_chat_color: Color;
12062
+ default_alert_icon_scale: float;
12063
+ default_alert_icon_shift_by_type?: Record<string, Vector>;
12064
+ default_alert_icon_scale_by_type?: Record<string, float>;
12065
+ /**
12066
+ * If not set, defaults to `true` when modded and `false` when vanilla.
12067
+ */
12068
+ merge_bonus_gui_production_bonuses?: boolean;
12069
+ daytime_color_lookup: DaytimeColorLookupTable;
12070
+ zoom_to_world_daytime_color_lookup: DaytimeColorLookupTable;
12071
+ frozen_color_lookup: ColorLookupTable;
12072
+ default_platform_surface_render_parameters: SurfaceRenderParameters;
12073
+ drop_item_radius: double;
12074
+ checkerboard_white: Color;
12075
+ checkerboard_black: Color;
12076
+ item_outline_color: Color;
12077
+ item_outline_radius: float;
12078
+ item_outline_inset: float;
12079
+ item_outline_sharpness: float;
12080
+ item_default_random_tint_strength: Color;
12081
+ spawner_evolution_factor_health_modifier: float;
12082
+ /**
12083
+ * There must be one array item with a threshold of `0`.
12084
+ */
12085
+ item_health_bar_colors: ItemHealthColorData[];
12086
+ item_ammo_magazine_left_bar_color: Color;
12087
+ item_tool_durability_bar_color: Color;
12088
+ filter_outline_color: Color;
12089
+ icon_shadow_radius: float;
12090
+ icon_shadow_inset: float;
12091
+ icon_shadow_sharpness: float;
12092
+ icon_shadow_color: Color;
12093
+ clipboard_history_size: uint32;
12094
+ recipe_step_limit: uint32;
12095
+ manual_rail_building_reach_modifier: double;
12096
+ train_temporary_stop_wait_time: uint32;
12097
+ train_time_wait_condition_default: uint32;
12098
+ train_inactivity_wait_condition_default: uint32;
12099
+ /**
12100
+ * The strings are entity types.
12101
+ */
12102
+ default_trigger_target_mask_by_type?: Record<string, TriggerTargetMask>;
12103
+ unit_group_pathfind_resolution: int8;
12104
+ unit_group_max_pursue_distance: double;
12105
+ dynamic_recipe_overload_factor: double;
12106
+ minimum_recipe_overload_multiplier: uint32;
12107
+ maximum_recipe_overload_multiplier: uint32;
12108
+ entity_renderer_search_box_limits: EntityRendererSearchBoxLimits;
12109
+ /**
12110
+ * 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).
12111
+ */
12112
+ light_renderer_search_distance_limit: uint8;
12113
+ far_away_chunk_generation_radius: uint8;
12114
+ tree_leaf_distortion_strength_far: Vector;
12115
+ tree_leaf_distortion_distortion_far: Vector;
12116
+ tree_leaf_distortion_speed_far: Vector;
12117
+ tree_leaf_distortion_strength_near: Vector;
12118
+ tree_leaf_distortion_distortion_near: Vector;
12119
+ tree_leaf_distortion_speed_near: Vector;
12120
+ tree_shadow_roughness: float;
12121
+ tree_shadow_speed: float;
12122
+ missing_preview_sprite_location: string;
12123
+ main_menu_background_image_location: string;
12124
+ /**
12125
+ * The strings represent the names of the simulations.
12126
+ */
12127
+ main_menu_simulations?: Record<string, SimulationDefinition>;
12128
+ main_menu_background_vignette_intensity: float;
12129
+ main_menu_background_vignette_sharpness: float;
12130
+ feedback_screenshot_subfolder_name: string;
12131
+ feedback_screenshot_file_name: string;
12132
+ default_scorch_mark_color: Color;
12133
+ color_filters?: ColorFilterData[];
12134
+ clear_cursor_volume_modifier: float;
12135
+ weapons_in_simulation_volume_modifier: float;
12136
+ explosions_in_simulation_volume_modifier: float;
12137
+ enemies_in_simulation_volume_modifier: float;
12138
+ low_energy_robot_estimate_multiplier: double;
12139
+ asteroid_spawning_offset: SimpleBoundingBox;
12140
+ asteroid_fading_range: float;
12141
+ asteroid_spawning_with_random_orientation_max_speed: double;
12142
+ asteroid_position_offset_to_speed_coefficient: double;
12143
+ asteroid_collector_navmesh_refresh_tick_interval: uint32;
12144
+ asteroid_collector_blockage_update_tile_distance: uint32;
12145
+ asteroid_collector_max_nurbs_control_point_separation: double;
12146
+ asteroid_collector_static_head_swing_strength_scale: float;
12147
+ asteroid_collector_static_head_swing_segment_count: uint32;
12148
+ /**
12149
+ * Variables: `speed, thrust, weight, width, height`
12150
+ */
12151
+ space_platform_acceleration_expression: MathExpression;
12152
+ space_platform_relative_speed_factor: double;
12153
+ space_platform_starfield_movement_vector: Vector;
12154
+ space_platform_max_size: SimpleBoundingBox;
12155
+ /**
12156
+ * Determines how fast space platforms will send items in drop slots to the surface. Each item type has its own cooldown.
12157
+ */
12158
+ space_platform_dump_cooldown: uint32;
12159
+ /**
12160
+ * Delay after manual transfer until space platform sends items in drop slots to the surface. Overrides remaining space_platform_dump_cooldown in this instance.
12161
+ */
12162
+ space_platform_manual_dump_cooldown: uint32;
12163
+ /**
12164
+ * 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.
12165
+ */
12166
+ space_platform_max_relative_speed_deviation_for_asteroid_chunks_update: float;
12167
+ /**
12168
+ * 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}.
12169
+ */
12170
+ space_platform_asteroid_chunk_trajectory_updates_per_tick: uint32;
12171
+ default_item_weight: Weight;
12172
+ /**
12173
+ * Used for "Rocket capacity" item tooltip and for comparing rocket silo lift weight in GUI to this value.
12174
+ */
12175
+ default_rocket_lift_weight: Weight;
12176
+ factoriopedia_recycling_recipe_categories: RecipeCategoryID[];
12177
+ /**
12178
+ * The default value of {@link FluidBox::max_pipeline_extent | prototype:FluidBox::max_pipeline_extent}.
12179
+ */
12180
+ default_pipeline_extent: double;
12181
+ /**
12182
+ * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
12183
+ */
12184
+ default_platform_procession_set: ProcessionSet;
12185
+ /**
12186
+ * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
12187
+ */
12188
+ default_planet_procession_set: ProcessionSet;
12189
+ /**
12190
+ * Radius of area where cargo pods won't land.
12191
+ */
12192
+ landing_area_clear_zone_radius: float;
12193
+ /**
12194
+ * Max radius where cargo pods will land.
12195
+ */
12196
+ landing_area_max_radius: float;
12197
+ lightning_attractor_collection_range_color: Color;
12198
+ lightning_attractor_protection_range_color: Color;
12199
+ landing_squash_immunity: MapTick;
12200
+ /**
12201
+ * Silently clamped to be between 1 tick and 5 minutes (`5 * 60 * 60` ticks).
12202
+ */
12203
+ ejected_item_lifetime: MapTick;
12204
+ /**
12205
+ * Silently clamped to be between 0 and 1/60.
12206
+ */
12207
+ ejected_item_speed: double;
12208
+ /**
12209
+ * Silently clamped to be between 0 and 0.99.
12210
+ */
12211
+ ejected_item_direction_variation: double;
12212
+ /**
12213
+ * Silently clamped to be between 0 and 1.
12214
+ */
12215
+ ejected_item_friction: double;
12216
+ train_visualization: TrainVisualizationConstants;
12217
+ /**
12218
+ * The strings can be entity types or custom strings.
12219
+ */
12220
+ default_collision_masks: Record<string, CollisionMask>;
12221
+ show_chunk_components_collision_mask: CollisionMask;
12222
+ building_collision_mask: CollisionMask;
12223
+ water_collision_mask: TileCollisionMask;
12224
+ ghost_layer: CollisionLayerID;
12225
+ train_pushed_by_player_max_speed: double;
12226
+ train_pushed_by_player_max_acceleration: double;
12227
+ train_pushed_by_player_ignores_friction: boolean;
12228
+ /**
12229
+ * Must be >= 1.
12230
+ */
12231
+ tooltip_monitor_edge_border: int32;
12232
+ /**
12233
+ * Must be >= 1.
12234
+ */
12235
+ flying_text_ttl: int32;
12236
+ train_path_finding: TrainPathFinderConstants;
12237
+ /**
12238
+ * Will be clamped to a positive number, starting at 0.
12239
+ */
12240
+ freezing_temperature: double;
12241
+ train_on_elevated_rail_shadow_shift_multiplier: Vector;
12242
+ /**
12243
+ * Must be >= 1.
12244
+ */
12245
+ max_belt_stack_size: uint8;
12246
+ /**
12247
+ * Must be >= 1.
12248
+ */
12249
+ inserter_hand_stack_items_per_sprite: ItemCountType;
12250
+ /**
12251
+ * Must be >= 1.
12252
+ */
12253
+ inserter_hand_stack_max_sprites: ItemCountType;
12254
+ remote_view_LPF_min_cutoff_frequency: float;
12255
+ remote_view_LPF_max_cutoff_frequency: float;
12256
+ space_LPF_min_cutoff_frequency: float;
12257
+ space_LPF_max_cutoff_frequency: float;
12258
+ /**
12259
+ * Silently clamped to be between 0 and 1.
12260
+ */
12261
+ walking_sound_count_reduction_rate: float;
12262
+ /**
12263
+ * Silently clamped to be between 0 and 1.
12264
+ */
12265
+ moving_sound_count_reduction_rate: float;
12266
+ environment_sounds_transition_fade_in_ticks: uint32;
12267
+ sound_fade_ticks: uint32;
12268
+ starmap_orbit_default_color: Color;
12269
+ starmap_orbit_hovered_color: Color;
12270
+ starmap_orbit_clicked_color: Color;
12271
+ starmap_orbit_disabled_color: Color;
12272
+ /**
12273
+ * The number of ticks to show a segmented unit's health bar after fully regenerating.
12274
+ */
12275
+ time_to_show_full_health_bar: MapTick;
12276
+ /**
12277
+ * 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`.
12278
+ */
12279
+ capture_water_mask_at_layer: uint8;
12280
+ logistic_robots_use_busy_robots_queue: boolean;
12281
+ construction_robots_use_busy_robots_queue: boolean;
12282
+ quality_selector_dropdown_threshold: uint8;
12283
+ /**
12284
+ * Cap for how many steps of quality the output of something (miner/crafter) may be higher than the input (resource/ingredients). Must be >= 1.
12285
+ */
12286
+ maximum_quality_jump: uint8;
12287
+ }
10975
12288
  /**
10976
12289
  * Defines the mode of operation for a {@link ValvePrototype | prototype:ValvePrototype}.
10977
12290
  */
@@ -11032,6 +12345,20 @@ LuaVirtualSignalPrototype | /**
11032
12345
  * The prototype name.
11033
12346
  */
11034
12347
  string;
12348
+ interface VirtualSignalPrototypeFilter {
12349
+ /**
12350
+ * The condition to filter on.
12351
+ */
12352
+ filter: 'special-signal';
12353
+ /**
12354
+ * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
12355
+ */
12356
+ mode?: 'or' | 'and';
12357
+ /**
12358
+ * Inverts the condition. Default is `false`.
12359
+ */
12360
+ invert?: boolean;
12361
+ }
11035
12362
  interface WaitCondition {
11036
12363
  type: WaitConditionType;
11037
12364
  /**
@@ -11064,6 +12391,8 @@ interface WaitCondition {
11064
12391
  */
11065
12392
  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
12393
  interface WallBlueprintControlBehavior {
12394
+ input_networks?: CircuitNetworkSelection;
12395
+ output_networks?: CircuitNetworkSelection;
11067
12396
  circuit_open_gate: boolean;
11068
12397
  circuit_read_sensor: boolean;
11069
12398
  output_signal?: SignalID;
@@ -11197,7 +12526,7 @@ type nil = null;
11197
12526
  /**
11198
12527
  * Tables are enclosed in curly brackets, like this `{}`.
11199
12528
  *
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.
12529
+ * 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
12530
  */
11202
12531
  type table = Table;
11203
12532
  /**