factorio-types 1.2.57 → 1.2.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
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/prototype-api.json
4
4
  // Definition source https://github.com/sguest/factorio-types
5
- // Factorio version 2.0.76
5
+ // Factorio version 2.1.7
6
6
  // API version 6
7
7
 
8
8
  declare namespace prototype {
@@ -149,6 +149,14 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
149
149
  * When missing, all items with {@link plant result | prototype:ItemPrototype::plant_result} will be accepted. When provided, only items on this list that have plant result will be accepted.
150
150
  */
151
151
  accepted_seeds?: ItemID[];
152
+ /**
153
+ * Sets the {@link modules | prototype:ModulePrototype} and {@link beacon | prototype:BeaconPrototype} effects that are allowed to be used on this machine.
154
+ */
155
+ allowed_effects?: EffectTypeLimitation;
156
+ /**
157
+ * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
158
+ */
159
+ allowed_module_categories?: ModuleCategoryID[];
152
160
  arm_extending_sound?: InterruptibleSound;
153
161
  arm_extending_sound_source?: string;
154
162
  central_orienting_sound?: InterruptibleSound;
@@ -165,6 +173,7 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
165
173
  crane_energy_usage: Energy;
166
174
  draw_circuit_wires?: boolean;
167
175
  draw_copper_wires?: boolean;
176
+ effect_receiver?: EffectReceiver;
168
177
  energy_source: EnergySource;
169
178
  /**
170
179
  * The amount of energy this agricultural tower uses for each planted or harvested {@link plant | prototype:PlantPrototype}.
@@ -178,7 +187,7 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
178
187
  /**
179
188
  * The minimum radius of empty space a {@link plant | prototype:PlantPrototype} requires around it to be planted.
180
189
  *
181
- * Must be >= 0 and <= growth_grid_tile_size / 2
190
+ * Must be greater than or equal to 0 and less than or equal to `growth_grid_tile_size / 2`.
182
191
  */
183
192
  growth_area_radius?: double;
184
193
  /**
@@ -190,9 +199,17 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
190
199
  harvesting_procedure_points?: Vector3D[];
191
200
  harvesting_sound?: Sound;
192
201
  input_inventory_size: ItemStackIndex;
202
+ /**
203
+ * The number of module slots in this machine.
204
+ */
205
+ module_slots?: ItemStackIndex;
193
206
  output_inventory_size?: ItemStackIndex;
194
207
  planting_procedure_points?: Vector3D[];
195
208
  planting_sound?: Sound;
209
+ /**
210
+ * If set, {@link QualityPrototype::mining_drill_module_slots_bonus | prototype:QualityPrototype::mining_drill_module_slots_bonus} will be added to module slots count.
211
+ */
212
+ quality_affects_module_slots?: boolean;
196
213
  /**
197
214
  * The radius represents {@link grid tiles | prototype:AgriculturalTowerPrototype::growth_grid_tile_size} which are created around the agricultural tower from its {@link collision box | prototype:EntityPrototype::collision_box}.
198
215
  *
@@ -203,7 +220,7 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
203
220
  /**
204
221
  * The maximum offset from the grid tile center which will be applied to the planting spot selected by this agricultural tower.
205
222
  *
206
- * Must be >= 0 and < 1.
223
+ * Must be greater than or equal to 0 and less than 1.
207
224
  */
208
225
  random_growth_offset?: double;
209
226
  /**
@@ -232,7 +249,7 @@ interface AirbornePollutantPrototype extends Prototype {
232
249
  localised_name_with_amount?: string;
233
250
  }
234
251
  /**
235
- * This prototype is used to make sound while playing the game. This includes the game's {@link music | https://store.steampowered.com/app/436090/Factorio__Soundtrack/}, composed by Daniel James Taylor.
252
+ * This prototype is used to make sound while playing the game. This includes the {@link base game's music | https://store.steampowered.com/app/436090/Factorio__Soundtrack/}, composed by Daniel James Taylor and the {@link Space Age's music | https://store.steampowered.com/app/3311770/Factorio_Space_Age__Soundtrack/}, composed by Petr Wajsar.
236
253
  * @example ```
237
254
  {
238
255
  type = "ambient-sound",
@@ -247,20 +264,64 @@ interface AirbornePollutantPrototype extends Prototype {
247
264
  ```
248
265
  */
249
266
  interface AmbientSound {
267
+ /**
268
+ * The track cannot play on specified planets.
269
+ *
270
+ * Can be used only if `play_on_all_surfaces` is true or `surface_names` are defined.
271
+ *
272
+ * Cannot be used when `planets` are defined.
273
+ */
274
+ exclude_planets?: SpaceLocationID[];
275
+ /**
276
+ * The track cannot play on surfaces with specified name. It's enough if the specified name is a sub-string of the surface name.
277
+ *
278
+ * Can be used only if `play_on_all_surfaces` is true or `surface_names` are defined.
279
+ *
280
+ * Cannot exclude a name given in `surface_names`.
281
+ */
282
+ exclude_surface_names?: string[];
250
283
  /**
251
284
  * Unique textual identification of the prototype.
252
285
  */
253
286
  name: string;
254
287
  /**
255
- * Track without a planet is bound to space platforms.
288
+ * The track can play only on specified planets.
289
+ *
290
+ * If neither `planets` nor `surface_names` is given, the track plays on space platforms and in the space map.
291
+ *
292
+ * Cannot be defined if `track_type` is `"script-track"`.
293
+ *
294
+ * Cannot be defined when `play_on_all_surfaces` is true.
295
+ */
296
+ planets?: SpaceLocationID[];
297
+ /**
298
+ * The track can play everywhere.
299
+ *
300
+ * Cannot be defined if `track_type` is `"hero-track"` or `"script-track"`.
301
+ *
302
+ * Cannot be true if `planets` or `surface_names` are defined.
256
303
  */
257
- planet?: SpaceLocationID;
304
+ play_on_all_surfaces?: boolean;
258
305
  /**
259
306
  * Static music track.
260
307
  *
261
308
  * One of `sound` or `variable_sound` must be defined. Both cannot be defined together.
262
309
  */
263
310
  sound?: Sound;
311
+ /**
312
+ * The track can play only on surfaces with specified names. It's enough if the specified name is a sub-string of the surface name.
313
+ *
314
+ * If neither `planets` nor `surface_names` is given, the track plays on space platforms and in the space map.
315
+ *
316
+ * Cannot be defined if `track_type` is `"hero-track"` or `"script-track"`.
317
+ *
318
+ * Cannot be defined when `play_on_all_surfaces` is true.
319
+ */
320
+ surface_names?: string[];
321
+ /**
322
+ * Alternative name of the track. It doesn't need to be unique.
323
+ */
324
+ title?: string;
264
325
  track_type: AmbientSoundType;
265
326
  /**
266
327
  * Specification of the type of the prototype.
@@ -275,7 +336,7 @@ interface AmbientSound {
275
336
  /**
276
337
  * Cannot be less than zero.
277
338
  *
278
- * Cannot be defined if `track_type` is `"hero-track"`.
339
+ * Cannot be defined if `track_type` is `"hero-track"` or `"script-track"`.
279
340
  */
280
341
  weight?: double;
281
342
  }
@@ -665,6 +726,12 @@ interface ArrowPrototype extends EntityPrototype {
665
726
  arrow_picture: Sprite;
666
727
  blinking?: boolean;
667
728
  circle_picture?: Sprite;
729
+ /**
730
+ * The entity with the higher number is selectable before the entity with the lower number.
731
+ *
732
+ * The value `0` will be treated the same as `nil`.
733
+ */
734
+ selection_priority?: uint8;
668
735
  }
669
736
  /**
670
737
  * The entity spawned by the {@link artillery targeting remote | https://wiki.factorio.com/Artillery_targeting_remote}.
@@ -733,6 +800,12 @@ interface ArtilleryProjectilePrototype extends EntityPrototype {
733
800
  * Whether the picture of the projectile is rotated to match the direction of travel.
734
801
  */
735
802
  rotatable?: boolean;
803
+ /**
804
+ * The entity with the higher number is selectable before the entity with the lower number.
805
+ *
806
+ * The value `0` will be treated the same as `nil`.
807
+ */
808
+ selection_priority?: uint8;
736
809
  shadow?: Sprite;
737
810
  }
738
811
  /**
@@ -872,9 +945,8 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
872
945
  disabled_when_recipe_not_researched?: boolean;
873
946
  draw_circuit_wires?: boolean;
874
947
  draw_copper_wires?: boolean;
875
- enable_logistic_control_behavior?: boolean;
876
948
  /**
877
- * Only loaded when fixed_recipe is provided.
949
+ * Only loaded if `fixed_recipe` is defined.
878
950
  */
879
951
  fixed_quality?: QualityID;
880
952
  /**
@@ -887,7 +959,7 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
887
959
  */
888
960
  gui_title_key?: string;
889
961
  /**
890
- * Sets the maximum number of ingredients this machine can craft with. Any recipe with more ingredients than this will be unavailable in this machine.
962
+ * Sets the maximum number of item ingredients this machine can craft with. Any recipe with more item ingredients than this will be unavailable in this machine.
891
963
  *
892
964
  * This only counts item ingredients, not fluid ingredients! This means if ingredient count is 2, and the recipe has 2 item ingredients and 1 fluid ingredient, it can still be crafted in the machine.
893
965
  */
@@ -969,12 +1041,15 @@ interface AsteroidCollectorPrototype extends EntityWithOwnerPrototype {
969
1041
  unpowered_arm_speed_scale?: float;
970
1042
  }
971
1043
  interface AsteroidPrototype extends EntityWithOwnerPrototype {
1044
+ /**
1045
+ * How much damage should entities and tiles get for each asteroid health point lost due to collision with these objects.
1046
+ */
1047
+ damage_per_hp?: float;
972
1048
  /**
973
1049
  * Emissions cannot be larger than zero, asteroids cannot produce pollution.
974
1050
  */
975
1051
  emissions_per_second?: Record<AirbornePollutantID, double>;
976
1052
  graphics_set?: AsteroidGraphicsSet;
977
- mass?: double;
978
1053
  }
979
1054
  /**
980
1055
  * A setting in the map creation GUI. Used by the {@link autoplace system | prototype:AutoplaceSpecification::control}.
@@ -1104,6 +1179,12 @@ interface BeamPrototype extends EntityPrototype {
1104
1179
  damage_interval: uint32;
1105
1180
  graphics_set: BeamGraphicsSet;
1106
1181
  random_target_offset?: boolean;
1182
+ /**
1183
+ * The entity with the higher number is selectable before the entity with the lower number.
1184
+ *
1185
+ * The value `0` will be treated the same as `nil`.
1186
+ */
1187
+ selection_priority?: uint8;
1107
1188
  target_offset?: Vector;
1108
1189
  width: float;
1109
1190
  }
@@ -1178,6 +1259,18 @@ interface BoilerPrototype extends EntityWithOwnerPrototype {
1178
1259
  * Note that `fire` and `fire_glow` alpha is set to the light intensity of the energy source, so 0 light intensity means the fire is invisible. For burner energy sources, the light intensity will reach zero rather quickly after the boiler runs out of fuel, effectively capping the time that `fire` and `fire_glow` will be shown after the boiler runs out of fuel.
1179
1260
  */
1180
1261
  burning_cooldown: uint16;
1262
+ circuit_connector?: [
1263
+ CircuitConnectorDefinition,
1264
+ CircuitConnectorDefinition,
1265
+ CircuitConnectorDefinition,
1266
+ CircuitConnectorDefinition
1267
+ ];
1268
+ /**
1269
+ * The maximum circuit wire distance for this entity.
1270
+ */
1271
+ circuit_wire_max_distance?: double;
1272
+ draw_circuit_wires?: boolean;
1273
+ draw_copper_wires?: boolean;
1181
1274
  energy_consumption: Energy;
1182
1275
  energy_source: EnergySource;
1183
1276
  /**
@@ -1322,6 +1415,10 @@ interface CarPrototype extends VehiclePrototype {
1322
1415
  auto_sort_inventory?: boolean;
1323
1416
  consumption: Energy;
1324
1417
  darkness_to_render_light_animation?: float;
1418
+ /**
1419
+ * Cannot be negative.
1420
+ */
1421
+ driving_sound_volume_modifier?: float;
1325
1422
  /**
1326
1423
  * Modifies the efficiency of energy transfer from burner output to wheels.
1327
1424
  */
@@ -1335,6 +1432,10 @@ interface CarPrototype extends VehiclePrototype {
1335
1432
  * If this car is immune to movement by belts.
1336
1433
  */
1337
1434
  has_belt_immunity?: boolean;
1435
+ /**
1436
+ * If this car gets damaged by driving into anything.
1437
+ */
1438
+ immune_to_all_impacts?: boolean;
1338
1439
  /**
1339
1440
  * If this car gets damaged by driving against {@link cliffs | prototype:CliffPrototype}.
1340
1441
  */
@@ -1383,11 +1484,16 @@ interface CarPrototype extends VehiclePrototype {
1383
1484
  turret_rotation_speed?: float;
1384
1485
  }
1385
1486
  interface CargoBayPrototype extends EntityWithOwnerPrototype {
1487
+ /**
1488
+ * When set to `true`, inserters will be able to take items out of this cargo bay when it is connected to a cargo landing pad.
1489
+ */
1490
+ allow_unloading?: boolean;
1386
1491
  /**
1387
1492
  * Has to be 2 for 2x2 grid.
1388
1493
  */
1389
1494
  build_grid_size?: 2;
1390
1495
  graphics_set?: CargoBayConnectableGraphicsSet;
1496
+ has_direction?: boolean;
1391
1497
  hatch_definitions?: CargoHatchDefinition[];
1392
1498
  /**
1393
1499
  * Cannot be 0.
@@ -1397,6 +1503,14 @@ interface CargoBayPrototype extends EntityWithOwnerPrototype {
1397
1503
  * A special variant which renders on space platforms. If not specified, the game will fall back to the regular graphics set.
1398
1504
  */
1399
1505
  platform_graphics_set?: CargoBayConnectableGraphicsSet;
1506
+ /**
1507
+ * Only relevant for cargo bays that have {@link allow_unloading | prototype:CargoBayPrototype::allow_unloading} set.
1508
+ *
1509
+ * When `false` this cargo bay will allow item unloading regardless of distance as long as it is connected to a cargo landing pad.
1510
+ *
1511
+ * When `true` this cargo bay will allow item unloading only when connected to a cargo landing pad and cargo bay is within distance limit set by {@link MaxCargoBayUnloadingDistanceModifier | prototype:MaxCargoBayUnloadingDistanceModifier} from that cargo landing pad.
1512
+ */
1513
+ use_unloading_distance_limit?: boolean;
1400
1514
  }
1401
1515
  interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
1402
1516
  cargo_station_parameters: CargoStationParameters;
@@ -1413,20 +1527,12 @@ interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
1413
1527
  * In chunks. The radius of how many chunks this cargo landing pad charts around itself.
1414
1528
  */
1415
1529
  radar_range?: uint32;
1416
- radar_visualisation_color?: Color;
1417
- /**
1418
- * Drawn when a robot brings/takes items from this landing pad.
1419
- */
1420
- robot_animation?: Animation;
1421
- /**
1422
- * Played when a robot brings/takes items from this landing pad. Only loaded if `robot_animation` is defined.
1423
- */
1424
- robot_animation_sound?: Sound;
1425
1530
  /**
1426
- * The offset from the center of this landing pad where a robot visually brings/takes items.
1531
+ * The visualisation used when showing cargo bay unloading distance limits.
1427
1532
  */
1428
- robot_landing_location_offset?: Vector;
1429
- robot_opened_duration?: uint8;
1533
+ radar_visualisation_color?: Color;
1534
+ radius_visualisation_picture?: Sprite;
1535
+ robot_door?: RobotDoorSpecification;
1430
1536
  trash_inventory_size?: ItemStackIndex;
1431
1537
  }
1432
1538
  interface CargoPodPrototype extends EntityWithOwnerPrototype {
@@ -1442,6 +1548,12 @@ interface CargoPodPrototype extends EntityWithOwnerPrototype {
1442
1548
  inventory_size: ItemStackIndex;
1443
1549
  procession_audio_catalogue?: ProcessionAudioCatalogue;
1444
1550
  procession_graphic_catalogue?: ProcessionGraphicCatalogue;
1551
+ /**
1552
+ * The entity with the higher number is selectable before the entity with the lower number.
1553
+ *
1554
+ * The value `0` will be treated the same as `nil`.
1555
+ */
1556
+ selection_priority?: uint8;
1445
1557
  shadow_slave_entity?: EntityID;
1446
1558
  spawned_container: EntityID;
1447
1559
  }
@@ -1512,7 +1624,9 @@ interface ChangedSurfaceAchievementPrototype extends AchievementPrototype {
1512
1624
  */
1513
1625
  interface CharacterCorpsePrototype extends EntityPrototype {
1514
1626
  /**
1515
- * Table of key value pairs, the keys are armor names and the values are numbers. The number is the Animation that is associated with the armor, e.g. using `1` will associate the armor with the first Animation in the pictures table.
1627
+ * A mapping of {@link ArmorPrototype | prototype:ArmorPrototype} name to a number. The number is the Animation that is associated with the armor, e.g. using `1` will associate the armor with the first Animation in the `pictures` table.
1628
+ *
1629
+ * This mapping can be empty to have no sprite changes based on armor.
1516
1630
  */
1517
1631
  armor_picture_mapping?: Record<ItemID, int32>;
1518
1632
  /**
@@ -1525,7 +1639,7 @@ interface CharacterCorpsePrototype extends EntityPrototype {
1525
1639
  pictures?: AnimationVariations;
1526
1640
  render_layer?: RenderLayer;
1527
1641
  /**
1528
- * 0 for infinite.
1642
+ * In ticks. 0 for infinite.
1529
1643
  */
1530
1644
  time_to_live: uint32;
1531
1645
  }
@@ -1614,6 +1728,9 @@ interface CharacterPrototype extends EntityWithOwnerPrototype {
1614
1728
  ```
1615
1729
  */
1616
1730
  mining_with_tool_particles_animation_positions: float[];
1731
+ /**
1732
+ * List of positions in the running animation when the moving sound is played.
1733
+ */
1617
1734
  moving_sound_animation_positions: float[];
1618
1735
  reach_distance: uint32;
1619
1736
  reach_resource_distance: double;
@@ -1699,7 +1816,21 @@ interface CombatRobotPrototype extends FlyingRobotPrototype {
1699
1816
  idle?: RotatedAnimation;
1700
1817
  in_motion?: RotatedAnimation;
1701
1818
  light?: LightDefinition;
1819
+ /**
1820
+ * The maximum force that can be applied to separate from other friendly combat robots.
1821
+ */
1822
+ max_separation_force?: double;
1702
1823
  range_from_player?: double;
1824
+ /**
1825
+ * A factor determining how strongly the robot will try to separate from other friendly combat robots.
1826
+ *
1827
+ * Higher values result in stronger separation forces.
1828
+ */
1829
+ separation_force_factor?: double;
1830
+ /**
1831
+ * The range within which the robot will try to separate itself from other friendly combat robots.
1832
+ */
1833
+ separation_range?: double;
1703
1834
  shadow_idle?: RotatedAnimation;
1704
1835
  shadow_in_motion?: RotatedAnimation;
1705
1836
  time_to_live: uint32;
@@ -1838,15 +1969,22 @@ interface ConstructionRobotPrototype extends RobotWithLogisticInterfacePrototype
1838
1969
  working_light?: LightDefinition;
1839
1970
  }
1840
1971
  /**
1841
- * A generic container, such as a chest. Cannot be rotated.
1972
+ * A generic container, such as a chest.
1842
1973
  */
1843
1974
  interface ContainerPrototype extends EntityWithOwnerPrototype {
1844
- circuit_connector?: CircuitConnectorDefinition;
1975
+ /**
1976
+ * If given, there must be exactly `direction_count` elements in the table.
1977
+ */
1978
+ circuit_connector?: CircuitConnectorDefinition[];
1845
1979
  /**
1846
1980
  * The maximum circuit wire distance for this container.
1847
1981
  */
1848
1982
  circuit_wire_max_distance?: double;
1849
1983
  default_status?: EntityStatus;
1984
+ /**
1985
+ * Amount of directions this container should have. Allowed values are 1, 2 and 4.
1986
+ */
1987
+ direction_count?: uint8;
1850
1988
  draw_circuit_wires?: boolean;
1851
1989
  draw_copper_wires?: boolean;
1852
1990
  /**
@@ -1868,7 +2006,7 @@ interface ContainerPrototype extends EntityWithOwnerPrototype {
1868
2006
  /**
1869
2007
  * The picture displayed for this entity.
1870
2008
  */
1871
- picture?: Sprite;
2009
+ picture?: Sprite4Way;
1872
2010
  quality_affects_inventory_size?: boolean;
1873
2011
  }
1874
2012
  /**
@@ -1944,6 +2082,12 @@ interface CorpsePrototype extends EntityPrototype {
1944
2082
  protected_from_tile_building?: boolean;
1945
2083
  remove_on_entity_placement?: boolean;
1946
2084
  remove_on_tile_placement?: boolean;
2085
+ /**
2086
+ * The entity with the higher number is selectable before the entity with the lower number.
2087
+ *
2088
+ * The value `0` will be treated the same as `nil`.
2089
+ */
2090
+ selection_priority?: uint8;
1947
2091
  /**
1948
2092
  * Defines after which frame in the `animation` the `direction_shuffle` should be applied. Can be set to `0`, frames are 1-indexed.
1949
2093
  */
@@ -2054,7 +2198,6 @@ interface CraftingMachinePrototype extends EntityWithOwnerPrototype {
2054
2198
  ```
2055
2199
  */
2056
2200
  fluid_boxes?: FluidBox[];
2057
- forced_symmetry?: Mirroring;
2058
2201
  graphics_set?: CraftingMachineGraphicsSet;
2059
2202
  graphics_set_flipped?: CraftingMachineGraphicsSet;
2060
2203
  ignore_output_full?: boolean;
@@ -2098,6 +2241,10 @@ interface CraftingMachinePrototype extends EntityWithOwnerPrototype {
2098
2241
  */
2099
2242
  show_recipe_icon_on_map?: boolean;
2100
2243
  trash_inventory_size?: ItemStackIndex;
2244
+ /**
2245
+ * Defaults to true if `vector_to_place_result` is given.
2246
+ */
2247
+ use_mirroring?: boolean;
2101
2248
  vector_to_place_result?: Vector;
2102
2249
  }
2103
2250
  /**
@@ -2447,16 +2594,13 @@ interface CustomInputPrototype extends Prototype {
2447
2594
  * - RALT
2448
2595
  * - RGUI
2449
2596
  * - MODE
2450
- * - AUDIONEXT
2451
- * - AUDIOPREV
2452
- * - AUDIOSTOP
2453
- * - AUDIOPLAY
2454
- * - AUDIOMUTE
2455
- * - MEDIASELECT
2456
- * - WWW
2457
- * - MAIL
2458
- * - CALCULATOR
2459
- * - COMPUTER
2597
+ * - MEDIA_NEXT_TRACK
2598
+ * - MEDIA_PREVIOUS_TRACK
2599
+ * - MEDIA_STOP
2600
+ * - MEDIA_PLAY
2601
+ * - MEDIA_PLAY_PAUSE
2602
+ * - MUTE
2603
+ * - MEDIA_SELECT
2460
2604
  * - AC_SEARCH
2461
2605
  * - AC_HOME
2462
2606
  * - AC_BACK
@@ -2464,18 +2608,10 @@ interface CustomInputPrototype extends Prototype {
2464
2608
  * - AC_STOP
2465
2609
  * - AC_REFRESH
2466
2610
  * - AC_BOOKMARKS
2467
- * - BRIGHTNESSDOWN
2468
- * - BRIGHTNESSUP
2469
- * - DISPLAYSWITCH
2470
- * - KBDILLUMTOGGLE
2471
- * - KBDILLUMDOWN
2472
- * - KBDILLUMUP
2473
- * - EJECT
2611
+ * - MEDIA_EJECT
2474
2612
  * - SLEEP
2475
- * - APP1
2476
- * - APP2
2477
- * - AUDIOREWIND
2478
- * - AUDIOFASTFORWARD
2613
+ * - MEDIA_REWIND
2614
+ * - MEDIA_FAST_FORWARD
2479
2615
  */
2480
2616
  key_sequence: string;
2481
2617
  /**
@@ -2542,10 +2678,6 @@ interface DeconstructionItemPrototype extends SelectionToolPrototype {
2542
2678
  * This property is hardcoded to `false`.
2543
2679
  */
2544
2680
  always_include_tiles?: boolean;
2545
- /**
2546
- * Can't be > 255.
2547
- */
2548
- entity_filter_count?: ItemStackIndex;
2549
2681
  /**
2550
2682
  * The {@link SelectionModeData::mode | prototype:SelectionModeData::mode} is hardcoded to `"deconstruct"`.
2551
2683
  *
@@ -2559,10 +2691,6 @@ interface DeconstructionItemPrototype extends SelectionToolPrototype {
2559
2691
  ```
2560
2692
  */
2561
2693
  stack_size: 1;
2562
- /**
2563
- * Can't be > 255.
2564
- */
2565
- tile_filter_count?: ItemStackIndex;
2566
2694
  }
2567
2695
  /**
2568
2696
  * Simple decorative purpose objects on the map, they have no health and some of them are removed when the player builds over. Usually used for grass patches, roots, small plants etc.
@@ -2737,6 +2865,14 @@ interface DisplayPanelPrototype extends EntityWithOwnerPrototype {
2737
2865
  circuit_wire_max_distance?: double;
2738
2866
  draw_circuit_wires?: boolean;
2739
2867
  draw_copper_wires?: boolean;
2868
+ /**
2869
+ * Maximum amount of message records that can be configured in this display panel when it is connected to circuit network. Must be >= 1.
2870
+ */
2871
+ max_records_count?: uint32;
2872
+ /**
2873
+ * Maximum length of the text. If the text exceeds this length all characters beyond the limit will be discarded.
2874
+ */
2875
+ max_text_length?: uint32;
2740
2876
  /**
2741
2877
  * The maximum display width of the text on the display panel. If the text exceeds this width it will be wrapped so that it continues on the next line.
2742
2878
  */
@@ -2882,6 +3018,27 @@ interface EditorControllerPrototype {
2882
3018
  show_status_icons: boolean;
2883
3019
  type: 'editor-controller';
2884
3020
  }
3021
+ /**
3022
+ * Provides or consumes power in equipment grids.
3023
+ */
3024
+ interface ElectricEnergyInterfaceEquipmentPrototype extends EquipmentPrototype {
3025
+ /**
3026
+ * @example ```
3027
+ energy_production = "500GW"
3028
+ ```
3029
+ */
3030
+ energy_production?: Energy;
3031
+ /**
3032
+ * @example ```
3033
+ energy_usage = "10kW"
3034
+ ```
3035
+ */
3036
+ energy_usage?: Energy;
3037
+ gui_mode?: 'all' | 'none' | 'admins';
3038
+ show_power_production_in_tooltip?: boolean;
3039
+ show_power_usage_in_tooltip?: boolean;
3040
+ show_stored_energy_in_tooltip?: boolean;
3041
+ }
2885
3042
  /**
2886
3043
  * Entity with electric energy source with that can have some of its values changed runtime. Useful for modding in energy consumers/producers.
2887
3044
  */
@@ -2976,6 +3133,16 @@ interface ElevatedCurvedRailAPrototype extends CurvedRailAPrototype {
2976
3133
  * Requires Space Age to create prototypes with name not starting with `dummy-`. Dummy prototypes cannot be built.
2977
3134
  */
2978
3135
  name: string;
3136
+ /**
3137
+ * The entity with the higher number is selectable before the entity with the lower number.
3138
+ *
3139
+ * The value `0` will be treated the same as `nil`.
3140
+ */
3141
+ selection_priority?: uint8;
3142
+ /**
3143
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3144
+ */
3145
+ tall?: boolean;
2979
3146
  }
2980
3147
  /**
2981
3148
  * An elevated curved-B rail.
@@ -2987,6 +3154,16 @@ interface ElevatedCurvedRailBPrototype extends CurvedRailBPrototype {
2987
3154
  * Requires Space Age to create prototypes with name not starting with `dummy-`. Dummy prototypes cannot be built.
2988
3155
  */
2989
3156
  name: string;
3157
+ /**
3158
+ * The entity with the higher number is selectable before the entity with the lower number.
3159
+ *
3160
+ * The value `0` will be treated the same as `nil`.
3161
+ */
3162
+ selection_priority?: uint8;
3163
+ /**
3164
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3165
+ */
3166
+ tall?: boolean;
2990
3167
  }
2991
3168
  /**
2992
3169
  * An elevated half diagonal rail.
@@ -2998,6 +3175,16 @@ interface ElevatedHalfDiagonalRailPrototype extends HalfDiagonalRailPrototype {
2998
3175
  * Requires Space Age to create prototypes with name not starting with `dummy-`. Dummy prototypes cannot be built.
2999
3176
  */
3000
3177
  name: string;
3178
+ /**
3179
+ * The entity with the higher number is selectable before the entity with the lower number.
3180
+ *
3181
+ * The value `0` will be treated the same as `nil`.
3182
+ */
3183
+ selection_priority?: uint8;
3184
+ /**
3185
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3186
+ */
3187
+ tall?: boolean;
3001
3188
  }
3002
3189
  /**
3003
3190
  * An elevated straight rail.
@@ -3009,6 +3196,16 @@ interface ElevatedStraightRailPrototype extends StraightRailPrototype {
3009
3196
  * Requires Space Age to create prototypes with name not starting with `dummy-`. Dummy prototypes cannot be built.
3010
3197
  */
3011
3198
  name: string;
3199
+ /**
3200
+ * The entity with the higher number is selectable before the entity with the lower number.
3201
+ *
3202
+ * The value `0` will be treated the same as `nil`.
3203
+ */
3204
+ selection_priority?: uint8;
3205
+ /**
3206
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3207
+ */
3208
+ tall?: boolean;
3012
3209
  }
3013
3210
  /**
3014
3211
  * Can spawn entities. Used for biter/spitter nests.
@@ -3045,7 +3242,7 @@ interface EnemySpawnerPrototype extends EntityWithOwnerPrototype {
3045
3242
  */
3046
3243
  max_friends_around_to_spawn: uint32;
3047
3244
  /**
3048
- * Max richness to determine spawn shift. Spawn shift is linear interpolation between 0 and max_spawn_shift.
3245
+ * Max richness to determine spawn shift. Spawn shift is a linear interpolation between 0 and max_spawn_shift.
3049
3246
  */
3050
3247
  max_richness_for_spawn_shift: double;
3051
3248
  /**
@@ -3057,6 +3254,10 @@ interface EnemySpawnerPrototype extends EntityWithOwnerPrototype {
3057
3254
  * Array of the {@link entities | prototype:EntityPrototype} that this spawner can spawn and their spawn probabilities. The sum of probabilities is expected to be 1.0. The array must not be empty.
3058
3255
  */
3059
3256
  result_units: UnitSpawnDefinition[];
3257
+ /**
3258
+ * Trigger that is activated when the spawner cannot find a valid spawn location.
3259
+ */
3260
+ spawn_blocked_trigger?: Trigger;
3060
3261
  /**
3061
3262
  * Decoratives to be created when the spawner is created by the {@link map generator | https://wiki.factorio.com/Map_generator}. Placed when enemies expand if `spawn_decorations_on_expansion` is set to true.
3062
3263
  */
@@ -3067,6 +3268,8 @@ interface EnemySpawnerPrototype extends EntityWithOwnerPrototype {
3067
3268
  spawn_decorations_on_expansion?: boolean;
3068
3269
  /**
3069
3270
  * Ticks for cooldown after unit is spawned. The first member of the tuple is min, the second member of the tuple is max.
3271
+ *
3272
+ * The resulting spawning cooldown is a linear interpolation between min and max based on the current evolution factor.
3070
3273
  */
3071
3274
  spawning_cooldown: [
3072
3275
  double,
@@ -3163,7 +3366,6 @@ interface EntityPrototype extends Prototype {
3163
3366
  * Used to specify the rules for placing this entity during map generation.
3164
3367
  */
3165
3368
  autoplace?: AutoplaceSpecification;
3166
- build_base_evolution_requirement?: double;
3167
3369
  /**
3168
3370
  * Supported values are 1 (for 1x1 grid) and 2 (for 2x2 grid, like rails).
3169
3371
  *
@@ -3323,6 +3525,19 @@ interface EntityPrototype extends Prototype {
3323
3525
  * When this is true, this entity prototype should be included during tile collision checks with tiles that have {@link TilePrototype::check_collision_with_entities | prototype:TilePrototype::check_collision_with_entities} set to true.
3324
3526
  */
3325
3527
  protected_from_tile_building?: boolean;
3528
+ /**
3529
+ * @example ```
3530
+ radius_visualisation_specification =
3531
+ {
3532
+ sprite =
3533
+ {
3534
+ filename = "__base__/graphics/entity/electric-mining-drill/electric-mining-drill-radius-visualization.png",
3535
+ size = 10
3536
+ },
3537
+ distance = 6
3538
+ }
3539
+ ```
3540
+ */
3326
3541
  radius_visualisation_specification?: RadiusVisualisationSpecification;
3327
3542
  /**
3328
3543
  * The entity that remains when this one is mined, deconstructed or fast-replaced. The entity wont actually be spawned if it would collide with the entity that is in the process of being mined.
@@ -3353,6 +3568,10 @@ interface EntityPrototype extends Prototype {
3353
3568
  * The cursor size used when shooting at this entity.
3354
3569
  */
3355
3570
  shooting_cursor_size?: double;
3571
+ /**
3572
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
3573
+ */
3574
+ show_fluid_visualization_when_in_cursor?: boolean;
3356
3575
  stateless_visualisation?: StatelessVisualisation | StatelessVisualisation[];
3357
3576
  /**
3358
3577
  * Used to specify the area where the {@link sticker | prototype:StickerPrototype} animation can appear for entities that can have stickers on them.
@@ -3362,6 +3581,10 @@ interface EntityPrototype extends Prototype {
3362
3581
  */
3363
3582
  sticker_box?: BoundingBox;
3364
3583
  surface_conditions?: SurfaceCondition[];
3584
+ /**
3585
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3586
+ */
3587
+ tall?: boolean;
3365
3588
  tile_buildability_rules?: TileBuildabilityRule[];
3366
3589
  tile_height?: int32;
3367
3590
  /**
@@ -3428,7 +3651,7 @@ interface EntityWithHealthPrototype extends EntityPrototype {
3428
3651
  dying_explosion?: ExplosionDefinition | ExplosionDefinition[];
3429
3652
  dying_trigger_effect?: TriggerEffect;
3430
3653
  /**
3431
- * The amount of health automatically regenerated per tick. The entity must be active for this to work.
3654
+ * The amount of health automatically regenerated per tick. If the value is in range [-0.0166, 0.0166], then healing is considered slow and will apply 60 * healing_per_tick once every second.
3432
3655
  * @example ```
3433
3656
  healing_per_tick = 0.01
3434
3657
  ```
@@ -3454,15 +3677,16 @@ interface EntityWithHealthPrototype extends EntityPrototype {
3454
3677
  loot =
3455
3678
  {
3456
3679
  {
3457
- count_max = 10,
3458
- count_min = 2,
3459
- item = "stone",
3460
- probability = 1
3680
+ type = "item",
3681
+ name = "stone",
3682
+ amount_min = 2,
3683
+ amount_max = 10,
3684
+ independent_probability = 1
3461
3685
  }
3462
3686
  }
3463
3687
  ```
3464
3688
  */
3465
- loot?: LootItem[];
3689
+ loot?: ItemProductPrototype[];
3466
3690
  /**
3467
3691
  * The unit health can never go over the maximum. Default health of units on creation is set to max. Must be greater than 0.
3468
3692
  * @example ```
@@ -3685,6 +3909,12 @@ interface ExplosionPrototype extends EntityPrototype {
3685
3909
  scale_initial?: float;
3686
3910
  scale_initial_deviation?: float;
3687
3911
  scale_out_duration?: uint8;
3912
+ /**
3913
+ * The entity with the higher number is selectable before the entity with the lower number.
3914
+ *
3915
+ * The value `0` will be treated the same as `nil`.
3916
+ */
3917
+ selection_priority?: uint8;
3688
3918
  /**
3689
3919
  * Mandatory if `smoke_count` > 0.
3690
3920
  */
@@ -3750,6 +3980,12 @@ interface FireFlamePrototype extends EntityPrototype {
3750
3980
  secondary_picture_fade_out_start?: uint32;
3751
3981
  secondary_pictures?: AnimationVariations;
3752
3982
  secondary_render_layer?: RenderLayer;
3983
+ /**
3984
+ * The entity with the higher number is selectable before the entity with the lower number.
3985
+ *
3986
+ * The value `0` will be treated the same as `nil`.
3987
+ */
3988
+ selection_priority?: uint8;
3753
3989
  small_tree_fire_pictures?: AnimationVariations;
3754
3990
  smoke?: SmokeSource[];
3755
3991
  smoke_fade_in_duration?: uint32;
@@ -3767,7 +4003,7 @@ interface FireFlamePrototype extends EntityPrototype {
3767
4003
  uses_alternative_behavior?: boolean;
3768
4004
  }
3769
4005
  /**
3770
- * Entity that spawns in water tiles, which can be mined. Moves around unless deactivated with {@link LuaEntity::active | runtime:LuaEntity::active} = false.
4006
+ * Entity that spawns in water tiles, which can be mined. Moves around unless it is {@link LuaEntity::disabled_by_script | runtime:LuaEntity::disabled_by_script} or marked for deconstruction.
3771
4007
  * @example ```
3772
4008
  {
3773
4009
  type = "fish",
@@ -3836,6 +4072,10 @@ interface FluidPrototype extends Prototype {
3836
4072
  * Also the minimum temperature of the fluid. Has to be lower than `max_temperature`.
3837
4073
  */
3838
4074
  default_temperature: float;
4075
+ /**
4076
+ * Whether the fluid should glow in pipe and storage tank windows.
4077
+ */
4078
+ draw_as_glow?: boolean;
3839
4079
  /**
3840
4080
  * Scales pollution generated when the fluid is consumed.
3841
4081
  */
@@ -3882,6 +4122,10 @@ interface FluidPrototype extends Prototype {
3882
4122
  */
3883
4123
  icons?: IconData[];
3884
4124
  max_temperature?: float;
4125
+ /**
4126
+ * Fluid and amount produced per 1 unit of fluid consumed. Used by Generator only if {@link GeneratorPrototype::spent_fluid | prototype:GeneratorPrototype::spent_fluid} is not set and it has {@link GeneratorPrototype::output_fluid_box | prototype:GeneratorPrototype::output_fluid_box}. Used by FluidEnergySource only if {@link FluidEnergySource::spent_fluid | prototype:FluidEnergySource::spent_fluid} is not set and it has {@link FluidEnergySource::output_fluid_box | prototype:FluidEnergySource::output_fluid_box}.
4127
+ */
4128
+ spent_fluid?: SpentFluidSpecification;
3885
4129
  /**
3886
4130
  * Color to use for visualization. This color should be vibrant and easily distinguished.
3887
4131
  *
@@ -3944,6 +4188,12 @@ interface FluidStreamPrototype extends EntityPrototype {
3944
4188
  * The point in the particles projectile arc to start spawning smoke. 0.5 (the default) starts spawning smoke at the halfway point between the source and target.
3945
4189
  */
3946
4190
  progress_to_create_smoke?: float;
4191
+ /**
4192
+ * The entity with the higher number is selectable before the entity with the lower number.
4193
+ *
4194
+ * The value `0` will be treated the same as `nil`.
4195
+ */
4196
+ selection_priority?: uint8;
3947
4197
  shadow?: Animation;
3948
4198
  shadow_scale_enabled?: boolean;
3949
4199
  /**
@@ -3972,7 +4222,7 @@ interface FluidTurretPrototype extends TurretPrototype {
3972
4222
  attacking_muzzle_animation_shift?: AnimatedVector;
3973
4223
  ending_attack_muzzle_animation_shift?: AnimatedVector;
3974
4224
  enough_fuel_indicator_light?: LightDefinition;
3975
- enough_fuel_indicator_picture?: Sprite4Way;
4225
+ enough_fuel_indicator_picture?: Sprite8Way;
3976
4226
  fluid_box: FluidBox;
3977
4227
  fluid_buffer_input_flow: FluidAmount;
3978
4228
  fluid_buffer_size: FluidAmount;
@@ -3981,7 +4231,7 @@ interface FluidTurretPrototype extends TurretPrototype {
3981
4231
  muzzle_animation?: Animation;
3982
4232
  muzzle_light?: LightDefinition;
3983
4233
  not_enough_fuel_indicator_light?: LightDefinition;
3984
- not_enough_fuel_indicator_picture?: Sprite4Way;
4234
+ not_enough_fuel_indicator_picture?: Sprite8Way;
3985
4235
  /**
3986
4236
  * The sprite will be drawn on top of fluid turrets that are out of fluid ammunition. If the `out_of_ammo_alert_icon` is not set, {@link UtilitySprites::fluid_icon | prototype:UtilitySprites::fluid_icon} will be used instead.
3987
4237
  */
@@ -3998,6 +4248,22 @@ interface FluidTurretPrototype extends TurretPrototype {
3998
4248
  * A {@link fluid wagon | https://wiki.factorio.com/Fluid_wagon}.
3999
4249
  */
4000
4250
  interface FluidWagonPrototype extends RollingStockPrototype {
4251
+ /**
4252
+ * Horizontal (xy) offset of the central valve from the wagon position when it is oriented east/west.
4253
+ */
4254
+ base_valve_xy_offset_when_horizontal?: Vector;
4255
+ /**
4256
+ * Horizontal (xy) offset of the central valve from the wagon position when it is oriented north/south.
4257
+ */
4258
+ base_valve_xy_offset_when_vertical?: Vector;
4259
+ /**
4260
+ * Projected height of valves when the wagon is oriented east/west.
4261
+ */
4262
+ base_valve_z_offset_projected_when_horizontal?: float;
4263
+ /**
4264
+ * Projected height of valves when the wagon is oriented north/south.
4265
+ */
4266
+ base_valve_z_offset_projected_when_vertical?: float;
4001
4267
  capacity: FluidAmount;
4002
4268
  /**
4003
4269
  * Pumps are only allowed to connect to this fluid wagon if the pump's {@link fluid box connection | prototype:PipeConnectionDefinition} and this fluid wagon share a connection category. Pump may have different connection categories on the input and output side, connection categories will be taken from the connection that is facing towards fluid wagon.
@@ -4005,9 +4271,21 @@ interface FluidWagonPrototype extends RollingStockPrototype {
4005
4271
  connection_category?: string | string[];
4006
4272
  quality_affects_capacity?: boolean;
4007
4273
  /**
4008
- * Must be 1, 2 or 3.
4274
+ * Must be positive.
4009
4275
  */
4010
4276
  tank_count?: uint8;
4277
+ /**
4278
+ * Must be > 0.1.
4279
+ */
4280
+ tank_spacing?: float;
4281
+ /**
4282
+ * Projected offset between valves when the wagon is oriented east/west.
4283
+ */
4284
+ valve_to_valve_offset_when_horizontal?: Vector;
4285
+ /**
4286
+ * Projected offset between valves when the wagon is oriented north/south.
4287
+ */
4288
+ valve_to_valve_offset_when_vertical?: Vector;
4011
4289
  }
4012
4290
  /**
4013
4291
  * Abstract base for construction/logistics and combat robots.
@@ -4062,6 +4340,12 @@ interface FlyingRobotPrototype extends EntityWithOwnerPrototype {
4062
4340
  * Used only by {@link robots with logistic interface | prototype:RobotWithLogisticInterfacePrototype}.
4063
4341
  */
4064
4342
  min_to_charge?: float;
4343
+ /**
4344
+ * The entity with the higher number is selectable before the entity with the lower number.
4345
+ *
4346
+ * The value `0` will be treated the same as `nil`.
4347
+ */
4348
+ selection_priority?: uint8;
4065
4349
  /**
4066
4350
  * The flying speed of the robot, in tiles/tick.
4067
4351
  */
@@ -4125,7 +4409,9 @@ interface FuelCategory extends Prototype {
4125
4409
  fuel_value_type?: LocalisedString;
4126
4410
  }
4127
4411
  /**
4128
- * A furnace. Normal furnaces only process "smelting" category recipes, but you can make furnaces that process other {@link recipe categories | prototype:RecipeCategory}. The difference to assembling machines is that furnaces automatically choose their recipe based on input.
4412
+ * A furnace. Normal furnaces only process "smelting" category recipes, but you can make furnaces that process other {@link recipe categories | prototype:RecipeCategory}.
4413
+ *
4414
+ * The difference to assembling machines is that furnaces automatically choose their recipe based on input. See {@link Furnace Recipe Selection | auxiliary:furnace-recipe-selection} for how the recipe is chosen.
4129
4415
  */
4130
4416
  interface FurnacePrototype extends CraftingMachinePrototype {
4131
4417
  /**
@@ -4333,8 +4619,6 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4333
4619
  * The number of fluid units the generator uses per tick.
4334
4620
  */
4335
4621
  fluid_usage_per_tick: FluidAmount;
4336
- horizontal_animation?: Animation;
4337
- horizontal_frozen_patch?: Sprite;
4338
4622
  /**
4339
4623
  * The power production of the generator is capped to this value. This is also the value that is shown as the maximum power output in the tooltip of the generator.
4340
4624
  *
@@ -4347,10 +4631,12 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4347
4631
  * Used to calculate the `max_power_output` if it is not defined and `burns_fluid` is false. Then, the max power output is `(min(fluid_max_temp, maximum_temperature) - fluid_default_temp) × fluid_usage_per_tick × fluid_heat_capacity × effectivity`, the fluid is the filter specified on the `fluid_box`.
4348
4632
  */
4349
4633
  maximum_temperature: float;
4634
+ output_fluid_box?: FluidBox;
4350
4635
  /**
4351
4636
  * Affects animation speed and working sound.
4352
4637
  */
4353
4638
  perceived_performance?: PerceivedPerformance;
4639
+ pictures?: GeneratorPictureSet;
4354
4640
  /**
4355
4641
  * Scales the generator's fluid usage to its maximum power output.
4356
4642
  *
@@ -4360,8 +4646,11 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4360
4646
  */
4361
4647
  scale_fluid_usage?: boolean;
4362
4648
  smoke?: SmokeSource[];
4363
- vertical_animation?: Animation;
4364
- vertical_frozen_patch?: Sprite;
4649
+ /**
4650
+ * Fluid and amount produced per 1 unit of fluid consumed. Only used when `output_fluid_box` is defined. If this value is not provided, {@link FluidPrototype::spent_fluid | prototype:FluidPrototype::spent_fluid} will be used based on the input fluid being consumed.
4651
+ */
4652
+ spent_fluid?: SpentFluidSpecification;
4653
+ two_direction_only?: boolean;
4365
4654
  }
4366
4655
  /**
4367
4656
  * Properties of the god controller.
@@ -4448,20 +4737,43 @@ interface HeatInterfacePrototype extends EntityWithOwnerPrototype {
4448
4737
  * A {@link heat pipe | https://wiki.factorio.com/Heat_pipe}.
4449
4738
  */
4450
4739
  interface HeatPipePrototype extends EntityWithOwnerPrototype {
4740
+ /**
4741
+ * Set of 16 circuit connector definitions. They correspond to the following sprites in this exact order: {@link single | prototype:ConnectableEntityGraphics::single}, {@link ending_up | prototype:ConnectableEntityGraphics::ending_up}, {@link ending_right | prototype:ConnectableEntityGraphics::ending_right}, {@link corner_right_up | prototype:ConnectableEntityGraphics::corner_right_up}, {@link ending_down | prototype:ConnectableEntityGraphics::ending_down}, {@link straight_vertical | prototype:ConnectableEntityGraphics::straight_vertical}, {@link corner_right_down | prototype:ConnectableEntityGraphics::corner_right_down}, {@link t_right | prototype:ConnectableEntityGraphics::t_right}, {@link ending_left | prototype:ConnectableEntityGraphics::ending_left}, {@link corner_left_up | prototype:ConnectableEntityGraphics::corner_left_up}, {@link straight_horizontal | prototype:ConnectableEntityGraphics::straight_horizontal}, {@link t_up | prototype:ConnectableEntityGraphics::t_up}, {@link corner_left_down | prototype:ConnectableEntityGraphics::corner_left_down}, {@link t_left | prototype:ConnectableEntityGraphics::t_left}, {@link t_down | prototype:ConnectableEntityGraphics::t_down}, {@link cross | prototype:ConnectableEntityGraphics::cross}.
4742
+ */
4743
+ circuit_connector?: CircuitConnectorDefinition[];
4744
+ /**
4745
+ * The maximum circuit wire distance for this entity.
4746
+ */
4747
+ circuit_wire_max_distance?: double;
4451
4748
  connection_sprites?: ConnectableEntityGraphics;
4749
+ default_temperature_signal?: SignalIDConnector;
4750
+ draw_circuit_wires?: boolean;
4751
+ draw_copper_wires?: boolean;
4452
4752
  heat_buffer: HeatBuffer;
4453
4753
  heat_glow_sprites?: ConnectableEntityGraphics;
4454
4754
  /**
4455
4755
  * Must be >= 0.
4456
4756
  */
4457
4757
  heating_radius?: float;
4458
- }
4758
+ /**
4759
+ * The entity with the higher number is selectable before the entity with the lower number.
4760
+ *
4761
+ * The value `0` will be treated the same as `nil`.
4762
+ */
4763
+ selection_priority?: uint8;
4764
+ }
4459
4765
  /**
4460
4766
  * Used to attach graphics for {@link cursor boxes | prototype:CursorBoxType} to entities during runtime. HighlightBoxEntity can also be independent from entities so it is simply drawn somewhere in the world. See {@link LuaSurface::create_entity | runtime:LuaSurface::create_entity} for the available options for type "highlight-box".
4461
4767
  *
4462
4768
  * The {@link collision_box | prototype:EntityPrototype::collision_box} of the highlight box prototype is ignored during runtime, instead the "bounding_box" given in create_entity() or the selection box of the target entity is used.
4463
4769
  */
4464
4770
  interface HighlightBoxEntityPrototype extends EntityPrototype {
4771
+ /**
4772
+ * The entity with the higher number is selectable before the entity with the lower number.
4773
+ *
4774
+ * The value `0` will be treated the same as `nil`.
4775
+ */
4776
+ selection_priority?: uint8;
4465
4777
  }
4466
4778
  /**
4467
4779
  * @example ```
@@ -4508,7 +4820,7 @@ interface InfinityContainerPrototype extends LogisticContainerPrototype {
4508
4820
  /**
4509
4821
  * The way this chest interacts with the logistic network.
4510
4822
  */
4511
- logistic_mode?: 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
4823
+ logistic_mode?: LogisticMode;
4512
4824
  /**
4513
4825
  * When true, items created inside the infinity chest will not start to spoil until they have been removed from the chest.
4514
4826
  */
@@ -4550,6 +4862,12 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4550
4862
  CircuitConnectorDefinition,
4551
4863
  CircuitConnectorDefinition
4552
4864
  ];
4865
+ circuit_connector_flipped?: [
4866
+ CircuitConnectorDefinition,
4867
+ CircuitConnectorDefinition,
4868
+ CircuitConnectorDefinition,
4869
+ CircuitConnectorDefinition
4870
+ ];
4553
4871
  /**
4554
4872
  * The maximum circuit wire distance for this entity.
4555
4873
  */
@@ -4604,7 +4922,9 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4604
4922
  max_belt_stack_size?: uint8;
4605
4923
  pickup_position: Vector;
4606
4924
  platform_frozen?: Sprite4Way;
4925
+ platform_frozen_flipped?: Sprite4Way;
4607
4926
  platform_picture?: Sprite4Way;
4927
+ platform_picture_flipped?: Sprite4Way;
4608
4928
  rotation_speed: double;
4609
4929
  /**
4610
4930
  * Stack size bonus that is inherent to the prototype without having to be researched.
@@ -4615,6 +4935,7 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4615
4935
  * Whether the inserter should be able to fish {@link fish | https://wiki.factorio.com/Raw_fish}.
4616
4936
  */
4617
4937
  use_easter_egg?: boolean;
4938
+ use_mirroring?: boolean;
4618
4939
  /**
4619
4940
  * When set to false, then relevant value of inserter stack size bonus ({@link LuaForce::inserter_stack_size_bonus | runtime:LuaForce::inserter_stack_size_bonus} or {@link LuaForce::bulk_inserter_capacity_bonus | runtime:LuaForce::bulk_inserter_capacity_bonus}) will not affect inserter stack size.
4620
4941
  */
@@ -4690,7 +5011,7 @@ interface ItemGroup extends Prototype {
4690
5011
  */
4691
5012
  icons?: IconData[];
4692
5013
  /**
4693
- * Item ingredients in recipes are ordered by item group. The `order_in_recipe` property can be used to specify the ordering in recipes without affecting the inventory order.
5014
+ * Item ingredients in recipes are ordered by item group if {@link RecipePrototype::sort_item_ingredients | prototype:RecipePrototype::sort_item_ingredients} is set to `true`. The `order_in_recipe` property can be used to specify the ordering in recipes with sorted ingredients without affecting the item group's inventory order.
4694
5015
  */
4695
5016
  order_in_recipe?: Order;
4696
5017
  }
@@ -4807,6 +5128,7 @@ interface ItemPrototype extends Prototype {
4807
5128
  icons?: IconData[];
4808
5129
  ingredient_to_weight_coefficient?: double;
4809
5130
  inventory_move_sound?: Sound;
5131
+ lab_ignores_spoil_percent?: boolean;
4810
5132
  /**
4811
5133
  * Whether this item should be moved to the hub when space platform performs building, upgrade or deconstruction and is left with this item. The following items are considered valuable and moved to hub by default: {@link Modules | prototype:ModulePrototype}, {@link items that build entities | prototype:ItemPrototype::place_result}, {@link items that build tiles | prototype:ItemPrototype::place_as_tile} and items {@link not obtainable from asteroid chunks | prototype:AsteroidChunkPrototype::minable} that have {@link subgroup | prototype:PrototypeBase::subgroup} from a {@link group | prototype:ItemSubGroup::group} other than `"intermediate-products"`.
4812
5134
  */
@@ -4844,10 +5166,17 @@ interface ItemPrototype extends Prototype {
4844
5166
  * When "automated" is set, it will force the existence of "launch to orbit automatically" checkbox in the rocket silo which will then force the silo to automatically send the item to orbit when present.
4845
5167
  */
4846
5168
  send_to_orbit_mode?: SendToOrbitMode;
5169
+ /**
5170
+ * Used by space platforms to prioritize item requests and make sure there is enough space for priority items before requesting the rest.
5171
+ */
5172
+ space_platform_request_priority?: boolean;
4847
5173
  /**
4848
5174
  * Used by Inserters with spoil priority. Item with higher spoil level is considered more spoiled than item with lower spoil level regardless of progress of spoiling.
4849
5175
  */
4850
5176
  spoil_level?: uint8;
5177
+ spoil_quality_change?: int8;
5178
+ spoil_quality_max?: QualityID;
5179
+ spoil_quality_min?: QualityID;
4851
5180
  spoil_result?: ItemID;
4852
5181
  spoil_ticks?: uint32;
4853
5182
  spoil_to_trigger_result?: SpoilToTriggerResult;
@@ -4861,7 +5190,7 @@ interface ItemPrototype extends Prototype {
4861
5190
  /**
4862
5191
  * The default weight is calculated automatically from recipes and falls back to {@link UtilityConstants::default_item_weight | prototype:UtilityConstants::default_item_weight}.
4863
5192
  *
4864
- * More information on how item weight is determined can be found on its {@link auxiliary page | runtime:item-weight}.
5193
+ * More information on how item weight is determined can be found on its {@link auxiliary page | auxiliary:item-weight}.
4865
5194
  */
4866
5195
  weight?: Weight;
4867
5196
  }
@@ -4971,6 +5300,7 @@ interface ItemWithInventoryPrototype extends ItemWithLabelPrototype {
4971
5300
  ```
4972
5301
  */
4973
5302
  item_subgroup_filters?: ItemSubGroupID[];
5303
+ quality_affects_inventory_size?: boolean;
4974
5304
  /**
4975
5305
  * Count of items of the same name that can be stored in one inventory slot. Must be 1 when the `"not-stackable"` flag is set.
4976
5306
  * @example ```
@@ -5052,7 +5382,7 @@ interface KillAchievementPrototype extends AchievementPrototype {
5052
5382
  type_to_kill?: string;
5053
5383
  }
5054
5384
  /**
5055
- * A {@link lab | https://wiki.factorio.com/Lab}. It consumes {@link science packs | prototype:ToolPrototype} to research {@link technologies | prototype:TechnologyPrototype}.
5385
+ * A {@link lab | https://wiki.factorio.com/Lab}. It consumes science packs (items) to research {@link technologies | prototype:TechnologyPrototype}.
5056
5386
  */
5057
5387
  interface LabPrototype extends EntityWithOwnerPrototype {
5058
5388
  /**
@@ -5063,6 +5393,14 @@ interface LabPrototype extends EntityWithOwnerPrototype {
5063
5393
  * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
5064
5394
  */
5065
5395
  allowed_module_categories?: ModuleCategoryID[];
5396
+ circuit_connector?: CircuitConnectorDefinition;
5397
+ /**
5398
+ * The maximum circuit wire distance for this entity.
5399
+ */
5400
+ circuit_wire_max_distance?: double;
5401
+ default_technology_level_signal?: SignalIDConnector;
5402
+ draw_circuit_wires?: boolean;
5403
+ draw_copper_wires?: boolean;
5066
5404
  effect_receiver?: EffectReceiver;
5067
5405
  /**
5068
5406
  * Defines how this lab gets energy.
@@ -5255,6 +5593,13 @@ interface LampPrototype extends EntityWithOwnerPrototype {
5255
5593
  interface LandMinePrototype extends EntityWithOwnerPrototype {
5256
5594
  action?: Trigger;
5257
5595
  ammo_category?: AmmoCategoryID;
5596
+ circuit_connector?: CircuitConnectorDefinition;
5597
+ /**
5598
+ * The maximum circuit wire distance for this entity.
5599
+ */
5600
+ circuit_wire_max_distance?: double;
5601
+ draw_circuit_wires?: boolean;
5602
+ draw_copper_wires?: boolean;
5258
5603
  /**
5259
5604
  * Force the landmine to kill itself when exploding.
5260
5605
  */
@@ -5275,6 +5620,12 @@ interface LandMinePrototype extends EntityWithOwnerPrototype {
5275
5620
  * The sprite of the landmine of an enemy force when it is armed.
5276
5621
  */
5277
5622
  picture_set_enemy?: Sprite;
5623
+ /**
5624
+ * The entity with the higher number is selectable before the entity with the lower number.
5625
+ *
5626
+ * The value `0` will be treated the same as `nil`.
5627
+ */
5628
+ selection_priority?: uint8;
5278
5629
  /**
5279
5630
  * Time between placing and the landmine being armed, in ticks.
5280
5631
  */
@@ -5348,7 +5699,7 @@ interface LightningPrototype extends EntityPrototype {
5348
5699
  /**
5349
5700
  * When lightning strikes something that is not a lightning attractor, this damage is applied to the target.
5350
5701
  */
5351
- damage?: double;
5702
+ damage?: DamageParameters;
5352
5703
  effect_duration: uint16;
5353
5704
  /**
5354
5705
  * When lightning hits a {@link lightning attractor | prototype:LightningAttractorPrototype}, this amount of energy is transferred to the lightning attractor.
@@ -5513,32 +5864,20 @@ interface LocomotivePrototype extends RollingStockPrototype {
5513
5864
  * A generic container, such as a chest, that interacts with the logistics network.
5514
5865
  */
5515
5866
  interface LogisticContainerPrototype extends ContainerPrototype {
5516
- /**
5517
- * Drawn when a robot brings/takes items from this container.
5518
- */
5519
- animation?: Animation;
5520
- /**
5521
- * Played when a robot brings/takes items from this container. Only loaded if `animation` is defined.
5522
- */
5523
- animation_sound?: Sound;
5524
- /**
5525
- * The offset from the center of this container where a robot visually brings/takes items.
5526
- */
5527
- landing_location_offset?: Vector;
5528
5867
  /**
5529
5868
  * The way this chest interacts with the logistic network.
5530
5869
  * This property is required, but marked as optional due to typescript inheritance limitations
5531
5870
  */
5532
- logistic_mode?: 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
5871
+ logistic_mode?: LogisticMode;
5533
5872
  /**
5534
5873
  * The number of request slots this logistics container has. Requester-type containers must have > 0 slots and can have a maximum of {@link UtilityConstants::max_logistic_filter_count | prototype:UtilityConstants::max_logistic_filter_count} slots. Storage-type containers must have <= 1 slot.
5535
5874
  */
5536
5875
  max_logistic_slots?: uint16;
5537
- opened_duration?: uint8;
5538
5876
  /**
5539
5877
  * Whether the "no network" icon should be rendered on this entity if the entity is not within a logistics network.
5540
5878
  */
5541
5879
  render_not_in_network_icon?: boolean;
5880
+ robot_door?: RobotDoorSpecification;
5542
5881
  trash_inventory_size?: ItemStackIndex;
5543
5882
  /**
5544
5883
  * Whether logistic robots have to deliver the exact amount of items requested to this logistic container instead of over-delivering (within their cargo size).
@@ -5650,7 +5989,6 @@ interface MapSettings {
5650
5989
  name: string;
5651
5990
  path_finder: PathFinderSettings;
5652
5991
  pollution: PollutionSettings;
5653
- steering: SteeringSettings;
5654
5992
  type: 'map-settings';
5655
5993
  unit_group: UnitGroupSettings;
5656
5994
  }
@@ -5676,17 +6014,18 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5676
6014
  * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
5677
6015
  */
5678
6016
  allowed_module_categories?: ModuleCategoryID[];
5679
- /**
5680
- * Used by the {@link pumpjack | https://wiki.factorio.com/Pumpjack} to have a static 4 way sprite.
5681
- */
5682
- base_picture?: Sprite4Way;
5683
- base_render_layer?: RenderLayer;
5684
6017
  circuit_connector?: [
5685
6018
  CircuitConnectorDefinition,
5686
6019
  CircuitConnectorDefinition,
5687
6020
  CircuitConnectorDefinition,
5688
6021
  CircuitConnectorDefinition
5689
6022
  ];
6023
+ circuit_connector_flipped?: [
6024
+ CircuitConnectorDefinition,
6025
+ CircuitConnectorDefinition,
6026
+ CircuitConnectorDefinition,
6027
+ CircuitConnectorDefinition
6028
+ ];
5690
6029
  /**
5691
6030
  * The maximum circuit wire distance for this entity.
5692
6031
  */
@@ -5714,7 +6053,12 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5714
6053
  */
5715
6054
  filter_count?: uint8;
5716
6055
  graphics_set?: MiningDrillGraphicsSet;
6056
+ graphics_set_flipped?: MiningDrillGraphicsSet;
5717
6057
  input_fluid_box?: FluidBox;
6058
+ /**
6059
+ * When a save file from version 2.0.x or older is loaded and this property is `true`, entities facing east or west direction are migrated to flipped state.
6060
+ */
6061
+ migrate_horizontal_mirroring?: boolean;
5718
6062
  /**
5719
6063
  * The speed of this drill.
5720
6064
  */
@@ -5745,6 +6089,7 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5745
6089
  * The sprite used to show the range of the mining drill.
5746
6090
  */
5747
6091
  radius_visualisation_picture?: Sprite;
6092
+ require_resources_to_place?: boolean;
5748
6093
  /**
5749
6094
  * The names of the {@link ResourceCategory | prototype:ResourceCategory} that can be mined by this drill. For a list of built-in categories, see {@link here | https://wiki.factorio.com/Data.raw#resource-category}.
5750
6095
  *
@@ -5766,15 +6111,33 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5766
6111
  */
5767
6112
  resource_searching_radius: double;
5768
6113
  shuffle_resources_to_mine?: boolean;
6114
+ use_mirroring?: boolean;
5769
6115
  uses_force_mining_productivity_bonus?: boolean;
5770
6116
  /**
5771
6117
  * The position where any item results are placed, when the mining drill is facing north (default direction). If the drill does not produce any solid items but uses a fluidbox output instead (e.g. pumpjacks), a vector of `{0,0}` disables the yellow arrow alt-mode indicator for the placed item location.
5772
6118
  */
5773
6119
  vector_to_place_result: Vector;
5774
6120
  wet_mining_graphics_set?: MiningDrillGraphicsSet;
6121
+ wet_mining_graphics_set_flipped?: MiningDrillGraphicsSet;
5775
6122
  }
5776
6123
  /**
5777
- * Block of arbitrary data set by mods in data stage.
6124
+ * Block of arbitrary data set by mods in prototype stage.
6125
+ *
6126
+ * During runtime stage, this arbitrary data can be accessed through {@link LuaPrototypes::mod_data | runtime:LuaPrototypes::mod_data}.
6127
+ * @example ```
6128
+ {
6129
+ type = "mod-data",
6130
+ name = "my-own-great-mod-data",
6131
+ data_type = "my-mod.my-data-type",
6132
+ data =
6133
+ {
6134
+ a_string = "a string",
6135
+ a_number = 6.7,
6136
+ a_table = {x=2, y=3, z="yes"},
6137
+ a_bool = true,
6138
+ }
6139
+ }
6140
+ ```
5778
6141
  */
5779
6142
  interface ModData extends Prototype {
5780
6143
  data: Record<string, AnyBasic>;
@@ -5804,11 +6167,41 @@ interface ModulePrototype extends ItemPrototype {
5804
6167
  * Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules of the same category with higher tier modules.
5805
6168
  */
5806
6169
  category: ModuleCategoryID;
6170
+ /**
6171
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6172
+ *
6173
+ * Defaults to 1.0 if the module consumption effect is < 0, otherwise 0.0.
6174
+ */
6175
+ consumption_quality_multiplier?: float;
5807
6176
  /**
5808
6177
  * The effect of the module on the machine it's inserted in, such as increased pollution.
5809
6178
  */
5810
6179
  effect: Effect;
6180
+ /**
6181
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6182
+ *
6183
+ * Defaults to 1.0 if the module pollution effect is < 0, otherwise 0.0.
6184
+ */
6185
+ pollution_quality_multiplier?: float;
6186
+ /**
6187
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6188
+ *
6189
+ * Defaults to 1.0 if the module productivity effect is > 0, otherwise 0.0.
6190
+ */
6191
+ productivity_quality_multiplier?: float;
6192
+ /**
6193
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6194
+ *
6195
+ * Defaults to 1.0 if the module quality effect is > 0, otherwise 0.0.
6196
+ */
6197
+ quality_quality_multiplier?: float;
5811
6198
  requires_beacon_alt_mode?: boolean;
6199
+ /**
6200
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6201
+ *
6202
+ * Defaults to 1.0 if the module speed effect is > 0, otherwise 0.0.
6203
+ */
6204
+ speed_quality_multiplier?: float;
5812
6205
  /**
5813
6206
  * Tier of the module inside its category. Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules with higher tier modules if they have the same category.
5814
6207
  */
@@ -5893,7 +6286,7 @@ interface MovementBonusEquipmentPrototype extends EquipmentPrototype {
5893
6286
  *
5894
6287
  * Alternate expressions can be made available in the map generator GUI by setting their `intended_property` to the name of the property they should override.
5895
6288
  *
5896
- * Named noise expressions can also be used as {@link noise variables | runtime:noise-expressions} e.g. `var("my-noise-expression")`.
6289
+ * Named noise expressions can also be used as {@link noise variables | auxiliary:noise-expressions} e.g. `var("my-noise-expression")`.
5897
6290
  * @example ```
5898
6291
  {
5899
6292
  type = "noise-expression",
@@ -6037,6 +6430,10 @@ interface OffshorePumpPrototype extends EntityWithOwnerPrototype {
6037
6430
  */
6038
6431
  pumping_speed: FluidAmount;
6039
6432
  remove_on_tile_collision?: boolean;
6433
+ /**
6434
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6435
+ */
6436
+ show_fluid_visualization_when_in_cursor?: boolean;
6040
6437
  }
6041
6438
  /**
6042
6439
  * An entity with a limited lifetime that can use trigger effects.
@@ -6088,6 +6485,12 @@ interface ParticleSourcePrototype extends EntityPrototype {
6088
6485
  * Mandatory if `smoke` is not defined.
6089
6486
  */
6090
6487
  particle?: ParticleID;
6488
+ /**
6489
+ * The entity with the higher number is selectable before the entity with the lower number.
6490
+ *
6491
+ * The value `0` will be treated the same as `nil`.
6492
+ */
6493
+ selection_priority?: uint8;
6091
6494
  /**
6092
6495
  * Mandatory if `particle` is not defined.
6093
6496
  */
@@ -6103,6 +6506,16 @@ interface ParticleSourcePrototype extends EntityPrototype {
6103
6506
  * An entity to transport fluids over a distance and between machines.
6104
6507
  */
6105
6508
  interface PipePrototype extends EntityWithOwnerPrototype {
6509
+ circuit_connector?: [
6510
+ CircuitConnectorDefinition,
6511
+ CircuitConnectorDefinition,
6512
+ CircuitConnectorDefinition,
6513
+ CircuitConnectorDefinition
6514
+ ];
6515
+ circuit_wire_max_distance?: double;
6516
+ default_fluid_temperature_signal?: SignalIDConnector;
6517
+ draw_circuit_wires?: boolean;
6518
+ draw_copper_wires?: boolean;
6106
6519
  /**
6107
6520
  * The area of the entity where fluid/gas inputs, and outputs.
6108
6521
  */
@@ -6112,13 +6525,27 @@ interface PipePrototype extends EntityWithOwnerPrototype {
6112
6525
  * All graphics for this pipe.
6113
6526
  */
6114
6527
  pictures?: PipePictures;
6528
+ /**
6529
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6530
+ */
6531
+ show_fluid_visualization_when_in_cursor?: boolean;
6115
6532
  vertical_window_bounding_box: BoundingBox;
6116
6533
  }
6117
6534
  /**
6118
6535
  * A {@link pipe to ground | https://wiki.factorio.com/Pipe_to_ground}.
6119
6536
  */
6120
6537
  interface PipeToGroundPrototype extends EntityWithOwnerPrototype {
6538
+ circuit_connector?: [
6539
+ CircuitConnectorDefinition,
6540
+ CircuitConnectorDefinition,
6541
+ CircuitConnectorDefinition,
6542
+ CircuitConnectorDefinition
6543
+ ];
6544
+ circuit_wire_max_distance?: double;
6545
+ default_fluid_temperature_signal?: SignalIDConnector;
6121
6546
  disabled_visualization?: Sprite4Way;
6547
+ draw_circuit_wires?: boolean;
6548
+ draw_copper_wires?: boolean;
6122
6549
  /**
6123
6550
  * Causes fluid icon to always be drawn, ignoring the usual pair requirement.
6124
6551
  */
@@ -6126,6 +6553,10 @@ interface PipeToGroundPrototype extends EntityWithOwnerPrototype {
6126
6553
  fluid_box: FluidBox;
6127
6554
  frozen_patch?: Sprite4Way;
6128
6555
  pictures?: Sprite4Way;
6556
+ /**
6557
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6558
+ */
6559
+ show_fluid_visualization_when_in_cursor?: boolean;
6129
6560
  visualization?: Sprite4Way;
6130
6561
  }
6131
6562
  interface PlaceEquipmentAchievementPrototype extends AchievementPrototype {
@@ -6152,10 +6583,18 @@ interface PlanetPrototype extends SpaceLocationPrototype {
6152
6583
  }
6153
6584
  interface PlantPrototype extends TreePrototype {
6154
6585
  agricultural_tower_tint?: RecipeTints;
6586
+ /**
6587
+ * Mound sprite drawn under growing trees which fades close to full growth. If defined, it can't be empty.
6588
+ */
6589
+ growth_mounds?: Sprite[];
6155
6590
  /**
6156
6591
  * Must be positive.
6157
6592
  */
6158
6593
  growth_ticks: MapTick;
6594
+ /**
6595
+ * If defined, it can't be empty.
6596
+ */
6597
+ growth_variations?: TreeGrowth[];
6159
6598
  /**
6160
6599
  * The burst of pollution to emit when the plant is harvested.
6161
6600
  */
@@ -6191,6 +6630,12 @@ interface PlayerDamagedAchievementPrototype extends AchievementPrototype {
6191
6630
  * Deprecated in 2.0.
6192
6631
  */
6193
6632
  interface PlayerPortPrototype extends EntityWithOwnerPrototype {
6633
+ /**
6634
+ * The entity with the higher number is selectable before the entity with the lower number.
6635
+ *
6636
+ * The value `0` will be treated the same as `nil`.
6637
+ */
6638
+ selection_priority?: uint8;
6194
6639
  }
6195
6640
  /**
6196
6641
  * A {@link power switch | https://wiki.factorio.com/Power_switch}.
@@ -6369,6 +6814,12 @@ interface ProjectilePrototype extends EntityPrototype {
6369
6814
  * Whether the animation of the projectile is rotated to match the direction of travel.
6370
6815
  */
6371
6816
  rotatable?: boolean;
6817
+ /**
6818
+ * The entity with the higher number is selectable before the entity with the lower number.
6819
+ *
6820
+ * The value `0` will be treated the same as `nil`.
6821
+ */
6822
+ selection_priority?: uint8;
6372
6823
  shadow?: RotatedAnimationVariations;
6373
6824
  smoke?: SmokeSource[];
6374
6825
  speed_modifier?: Vector;
@@ -6462,6 +6913,8 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6462
6913
  * The animation for the pump.
6463
6914
  */
6464
6915
  animations?: Animation4Way;
6916
+ arm_orienting_sound?: InterruptibleSound;
6917
+ base_lifting_sound?: InterruptibleSound;
6465
6918
  circuit_connector?: [
6466
6919
  CircuitConnectorDefinition,
6467
6920
  CircuitConnectorDefinition,
@@ -6469,6 +6922,7 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6469
6922
  CircuitConnectorDefinition
6470
6923
  ];
6471
6924
  circuit_wire_max_distance?: double;
6925
+ clamp_sound?: Sound;
6472
6926
  draw_circuit_wires?: boolean;
6473
6927
  draw_copper_wires?: boolean;
6474
6928
  /**
@@ -6488,16 +6942,23 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6488
6942
  * The area of the entity where fluid travels.
6489
6943
  */
6490
6944
  fluid_box: FluidBox;
6491
- fluid_wagon_connector_alignment_tolerance?: double;
6492
6945
  fluid_wagon_connector_frame_count?: uint8;
6493
- fluid_wagon_connector_graphics?: FluidWagonConnectorGraphics;
6494
6946
  fluid_wagon_connector_speed?: double;
6947
+ /**
6948
+ * counts from the "start of the arm", which is `pump's position + wagon_connection_graphics.part1_to_2_shift + wagon_connection_graphics.top_pivot_shift (depending on direction)`
6949
+ */
6950
+ fluid_wagon_tank_valve_max_distance?: double;
6495
6951
  frozen_patch?: Sprite4Way;
6496
6952
  glass_pictures?: Sprite4Way;
6497
6953
  /**
6498
6954
  * The amount of fluid this pump transfers per tick.
6499
6955
  */
6500
6956
  pumping_speed: FluidAmount;
6957
+ /**
6958
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6959
+ */
6960
+ show_fluid_visualization_when_in_cursor?: boolean;
6961
+ wagon_connection_graphics?: PumpWagonConnectionGraphics;
6501
6962
  }
6502
6963
  /**
6503
6964
  * One quality step. Its effects are specified by the level and the various multiplier and bonus properties. Properties ending in `_multiplier` are applied multiplicatively to their base property, properties ending in `_bonus` are applied additively.
@@ -6518,7 +6979,7 @@ interface QualityPrototype extends Prototype {
6518
6979
  */
6519
6980
  beacon_module_slots_bonus?: ItemStackIndex;
6520
6981
  /**
6521
- * Must be >= 0.
6982
+ * Must be >= 0.01.
6522
6983
  */
6523
6984
  beacon_power_usage_multiplier?: float;
6524
6985
  /**
@@ -6527,6 +6988,16 @@ interface QualityPrototype extends Prototype {
6527
6988
  * Must be >= 0 and <= 64.
6528
6989
  */
6529
6990
  beacon_supply_area_distance_bonus?: float;
6991
+ /**
6992
+ * Must be >= 0.01.
6993
+ */
6994
+ cargo_wagon_inventory_size_multiplier?: double;
6995
+ /**
6996
+ * Probability of additional quality increase happening after quality was increased to reach this quality in the same crafting/mining operation.
6997
+ *
6998
+ * Must be in range `[0, 1]`.
6999
+ */
7000
+ chain_probability?: double;
6530
7001
  color: Color;
6531
7002
  /**
6532
7003
  * Must be >= 0.01.
@@ -6609,6 +7080,10 @@ interface QualityPrototype extends Prototype {
6609
7080
  * Requires Space Age to use level greater than `0`.
6610
7081
  */
6611
7082
  level: uint32;
7083
+ /**
7084
+ * Must be >= 0.01.
7085
+ */
7086
+ locomotive_power_multiplier?: double;
6612
7087
  /**
6613
7088
  * Must be >= 0.01.
6614
7089
  */
@@ -6633,6 +7108,26 @@ interface QualityPrototype extends Prototype {
6633
7108
  * Must be in range `[0, 1]`.
6634
7109
  */
6635
7110
  mining_drill_resource_drain_multiplier?: float;
7111
+ /**
7112
+ * Must be >= 0.01.
7113
+ */
7114
+ module_consumption_multiplier?: float;
7115
+ /**
7116
+ * Must be >= 0.01.
7117
+ */
7118
+ module_pollution_multiplier?: float;
7119
+ /**
7120
+ * Must be >= 0.01.
7121
+ */
7122
+ module_productivity_multiplier?: float;
7123
+ /**
7124
+ * Must be >= 0.01.
7125
+ */
7126
+ module_quality_multiplier?: float;
7127
+ /**
7128
+ * Must be >= 0.01.
7129
+ */
7130
+ module_speed_multiplier?: float;
6636
7131
  /**
6637
7132
  * Unique textual identification of the prototype. May only contain alphanumeric characters, dashes and underscores. May not exceed a length of 200 characters.
6638
7133
  *
@@ -6641,23 +7136,49 @@ interface QualityPrototype extends Prototype {
6641
7136
  name: string;
6642
7137
  next?: QualityID;
6643
7138
  /**
6644
- * The quality {@link effect of the module | prototype:ModulePrototype::effect} is multiplied by this. 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%.
7139
+ * Probability that a crafting machine affected by a 100% quality {@link effect from modules | prototype:ModulePrototype::effect} will cause quality to be increased.
6645
7140
  *
6646
- * Must be in range [0, 1.0].
7141
+ * Probability is scaled linearly with quality effect. E.g. for `next_probability = 1`, 100% quality effect means quality is always increased, at 50% quality effect the quality is increased 50% of the time and so on.
7142
+ *
7143
+ * Must be >= 0.
6647
7144
  */
6648
7145
  next_probability?: double;
7146
+ /**
7147
+ * Probability of additional quality decrease happening after quality was decreased to reach this quality in the same crafting/mining operation.
7148
+ *
7149
+ * Must be in range `[0, 1]`.
7150
+ */
7151
+ previous_chain_probability?: double;
7152
+ /**
7153
+ * Probability that a crafting machine affected by a -100% quality {@link effect from modules | prototype:ModulePrototype::effect} will cause quality to be decreased.
7154
+ *
7155
+ * Probability is scaled linearly with quality effect. E.g. for `previous_probability = 1`, -100% quality effect means quality is always decreased, at -50% quality effect the quality is decreased 50% of the time and so on.
7156
+ *
7157
+ * Must be >= 0.
7158
+ *
7159
+ * Note: for a machine to have a negative quality effect, {@link EffectReceiver::quality_limits | prototype:EffectReceiver::quality_limits} needs to be set.
7160
+ */
7161
+ previous_probability?: double;
6649
7162
  /**
6650
7163
  * Must be within `[1, 3]`.
6651
7164
  *
6652
7165
  * Affects the range of {@link attack parameters | prototype:AttackParameters}, e.g. those used by combat robots, units, guns and turrets.
6653
7166
  */
6654
7167
  range_multiplier?: double;
7168
+ /**
7169
+ * Must be >= 0.01.
7170
+ */
7171
+ rolling_stock_max_speed_multiplier?: double;
6655
7172
  /**
6656
7173
  * Must be in range `[0, 1]`.
6657
7174
  *
6658
7175
  * Only affects labs with {@link LabPrototype::uses_quality_drain_modifier | prototype:LabPrototype::uses_quality_drain_modifier} set.
6659
7176
  */
6660
7177
  science_pack_drain_multiplier?: float;
7178
+ /**
7179
+ * Must be >= 0.01.
7180
+ */
7181
+ spoil_ticks_multiplier?: float;
6661
7182
  /**
6662
7183
  * Must be >= 0.01.
6663
7184
  *
@@ -6678,6 +7199,10 @@ interface RadarPrototype extends EntityWithOwnerPrototype {
6678
7199
  * If set to true, radars on the same surface will connect to other radars on the same surface using hidden wires with {@link radar | runtime:defines.wire_origin.radars} origin.
6679
7200
  */
6680
7201
  connects_to_other_radars?: boolean;
7202
+ /**
7203
+ * The default channel for the circuit network connection in universe mode.
7204
+ */
7205
+ default_universe_channel?: SignalIDConnector;
6681
7206
  draw_circuit_wires?: boolean;
6682
7207
  draw_copper_wires?: boolean;
6683
7208
  /**
@@ -6744,7 +7269,7 @@ interface RailChainSignalPrototype extends RailSignalBasePrototype {
6744
7269
  interface RailPlannerPrototype extends ItemPrototype {
6745
7270
  manual_length_limit?: double;
6746
7271
  /**
6747
- * May not be an empty array. Entities must be rails and their first item-to-place must be this item.
7272
+ * May not be an empty array. Entities must be rails.
6748
7273
  */
6749
7274
  rails: EntityID[];
6750
7275
  /**
@@ -6769,12 +7294,18 @@ interface RailPrototype extends EntityWithOwnerPrototype {
6769
7294
  * Must be 0, 2 or 4. Can't be non-zero if `fence_pictures` is defined.
6770
7295
  */
6771
7296
  forced_fence_segment_count?: uint8;
6772
- pictures: RailPictureSet;
7297
+ pictures?: RailPictureSet;
6773
7298
  removes_soft_decoratives?: boolean;
6774
7299
  /**
6775
7300
  * The rail {@link selection_boxes | prototype:EntityPrototype::selection_box} are automatically calculated from the collision boxes, which are hardcoded. So effectively the selection boxes also hardcoded.
6776
7301
  */
6777
7302
  selection_box?: BoundingBox;
7303
+ /**
7304
+ * The entity with the higher number is selectable before the entity with the lower number.
7305
+ *
7306
+ * The value `0` will be treated the same as `nil`.
7307
+ */
7308
+ selection_priority?: uint8;
6778
7309
  /**
6779
7310
  * Sound played when a character walks over this rail.
6780
7311
  */
@@ -6802,6 +7333,10 @@ interface RailRampPrototype extends RailPrototype {
6802
7333
  * Must be lower than 500 and at least 1.
6803
7334
  */
6804
7335
  support_range?: float;
7336
+ /**
7337
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
7338
+ */
7339
+ tall?: boolean;
6805
7340
  }
6806
7341
  /**
6807
7342
  * Used for rail corpses.
@@ -6815,7 +7350,7 @@ interface RailRemnantsPrototype extends CorpsePrototype {
6815
7350
  * "Rail remnant entities must have a non-zero {@link collision_box | prototype:EntityPrototype::collision_box} defined.
6816
7351
  */
6817
7352
  collision_box?: BoundingBox;
6818
- pictures: RailPictureSet;
7353
+ pictures?: RailPictureSet;
6819
7354
  related_rail: EntityID;
6820
7355
  secondary_collision_box?: BoundingBox;
6821
7356
  }
@@ -6848,6 +7383,12 @@ interface RailSignalBasePrototype extends EntityWithOwnerPrototype {
6848
7383
  */
6849
7384
  flags?: EntityPrototypeFlags;
6850
7385
  ground_picture_set: RailSignalPictureSet;
7386
+ /**
7387
+ * The entity with the higher number is selectable before the entity with the lower number.
7388
+ *
7389
+ * The value `0` will be treated the same as `nil`.
7390
+ */
7391
+ selection_priority?: uint8;
6851
7392
  }
6852
7393
  /**
6853
7394
  * A {@link rail signal | https://wiki.factorio.com/Rail_signal}.
@@ -6939,11 +7480,19 @@ interface ReactorPrototype extends EntityWithOwnerPrototype {
6939
7480
  */
6940
7481
  meltdown_action?: Trigger;
6941
7482
  neighbour_bonus?: double;
7483
+ /**
7484
+ * Defines connection points to neighbours used to compute neighbour bonus.
7485
+ */
7486
+ neighbour_connectable?: NeighbourConnectable;
6942
7487
  picture?: Sprite;
6943
7488
  /**
6944
7489
  * When this is true, the reactor will stop consuming fuel/energy when the temperature has reached the maximum.
6945
7490
  */
6946
7491
  scale_energy_usage?: boolean;
7492
+ /**
7493
+ * The temperature above which energy icons are suppressed. Defaults to maximum double value.
7494
+ */
7495
+ temperature_to_suppress_energy_icons?: double;
6947
7496
  /**
6948
7497
  * Whether the reactor should use {@link fuel_glow_color | prototype:ItemPrototype::fuel_glow_color} from the fuel item prototype as light color and tint for `working_light_picture`. {@link Forum post. | https://forums.factorio.com/71121}
6949
7498
  */
@@ -6969,7 +7518,7 @@ interface RecipeCategory extends Prototype {
6969
7518
  {
6970
7519
  type = "recipe",
6971
7520
  name = "iron-plate",
6972
- category = "smelting",
7521
+ categories = {"smelting"},
6973
7522
  energy_required = 3.5,
6974
7523
  ingredients = {{type = "item", name = "iron-ore", amount = 1}},
6975
7524
  results = {{type = "item", name = "iron-plate", amount = 1}}
@@ -6979,7 +7528,7 @@ interface RecipeCategory extends Prototype {
6979
7528
  {
6980
7529
  type = "recipe",
6981
7530
  name = "coal-liquefaction",
6982
- category = "oil-processing",
7531
+ categories = {"oil-processing"},
6983
7532
  subgroup = "fluid-recipes",
6984
7533
  order = "a[oil-processing]-c[coal-liquefaction]",
6985
7534
  enabled = false,
@@ -7003,7 +7552,6 @@ interface RecipeCategory extends Prototype {
7003
7552
  ```
7004
7553
  */
7005
7554
  interface RecipePrototype extends Prototype {
7006
- additional_categories?: RecipeCategoryID[];
7007
7555
  /**
7008
7556
  * Whether the recipe can be used as an intermediate recipe in hand-crafting.
7009
7557
  */
@@ -7042,10 +7590,6 @@ interface RecipePrototype extends Prototype {
7042
7590
  * Whether the "Made in: <Machine>" part of the tool-tip should always be present, and not only when the recipe can't be hand-crafted.
7043
7591
  */
7044
7592
  always_show_made_in?: boolean;
7045
- /**
7046
- * Whether the products are always shown in the recipe tooltip.
7047
- */
7048
- always_show_products?: boolean;
7049
7593
  /**
7050
7594
  * Whether the recipe should be included in the recycling recipes automatically generated by the quality mod.
7051
7595
  *
@@ -7053,14 +7597,24 @@ interface RecipePrototype extends Prototype {
7053
7597
  */
7054
7598
  auto_recycle?: boolean;
7055
7599
  /**
7056
- * The {@link category | prototype:RecipeCategory} of this recipe. Controls which machines can craft this recipe.
7600
+ * When set to `true`, player can set quality of this recipe to craft. If set to `false` then this recipe can only be crafted at normal quality.
7601
+ *
7602
+ * Defaults to `true` if recipe is a parameter, or has at least one item ingredient that does not have any of {@link quality_min | prototype:ItemIngredientPrototype::quality_min}, {@link quality_max | prototype:ItemIngredientPrototype::quality_max}, or {@link quality_change | prototype:ItemIngredientPrototype::quality_change} set.
7603
+ *
7604
+ * This property also influences the automatic {@link Furnace Recipe Selection | auxiliary:furnace-recipe-selection}.
7605
+ */
7606
+ can_set_quality?: boolean;
7607
+ /**
7608
+ * The {@link categories | prototype:RecipeCategory} of this recipe. Controls which machines can craft this recipe.
7057
7609
  *
7058
7610
  * The built-in categories can be found {@link here | https://wiki.factorio.com/Data.raw#recipe-category}. The base `"crafting"` category can not contain recipes with fluid ingredients or products.
7611
+ *
7612
+ * The array must contain at least one category, it cannot be empty.
7059
7613
  * @example ```
7060
- category = "smelting"
7614
+ categories = {"smelting"}
7061
7615
  ```
7062
7616
  */
7063
- category?: RecipeCategoryID;
7617
+ categories?: RecipeCategoryID[];
7064
7618
  /**
7065
7619
  * Used by {@link WorkingVisualisations::working_visualisations | prototype:WorkingVisualisations::working_visualisations} to tint certain layers with the recipe color. {@link WorkingVisualisation::apply_recipe_tint | prototype:WorkingVisualisation::apply_recipe_tint} determines which of the four colors is used for that layer, if any.
7066
7620
  */
@@ -7117,9 +7671,9 @@ interface RecipePrototype extends Prototype {
7117
7671
  /**
7118
7672
  * A table containing ingredient names and amounts. Can also contain information about fluid temperature and whether some of the amount is ignored by production statistics.
7119
7673
  *
7120
- * The maximum ingredient amount is 65 535. Can be set to an empty table to create a recipe that needs no ingredients.
7674
+ * Can be set to an empty table to create a recipe that needs no ingredients. {@link Assembling machines | prototype:AssemblingMachinePrototype::ingredient_count} do not support recipes with more than 65 535 different item ingredients.
7121
7675
  *
7122
- * Duplicate ingredients, e.g. two entries with the same name, are *not* allowed. In-game, the item ingredients are ordered by {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe}.
7676
+ * Duplicate ingredients, e.g. two entries with the same name, are *not* allowed. In-game, the item ingredients are ordered by {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe} if {@link RecipePrototype::sort_item_ingredients | prototype:RecipePrototype::sort_item_ingredients} is set to `true`.
7123
7677
  * @example ```
7124
7678
  -- Recipe with items
7125
7679
  ingredients =
@@ -7157,17 +7711,15 @@ interface RecipePrototype extends Prototype {
7157
7711
  preserve_products_in_machine_output?: boolean;
7158
7712
  requester_paste_multiplier?: uint32;
7159
7713
  /**
7160
- * When set to true, if the recipe successfully finishes crafting without spoiling, the result is produced fresh (non-spoiled).
7714
+ * Whether enabling this recipe requires the ingredients be unlocked before the products are marked as unlocked.
7161
7715
  */
7162
- reset_freshness_on_craft?: boolean;
7163
- /**
7164
- * When set to true, the recipe will always produce fresh (non-spoiled) item even when the ingredients are spoiled.
7165
- */
7166
- result_is_always_fresh?: boolean;
7716
+ requires_ingredients_to_unlock_results?: boolean;
7167
7717
  /**
7168
7718
  * A table containing result names and amounts. Products also contain information such as fluid temperature, probability of results and whether some of the amount is ignored by productivity.
7169
7719
  *
7170
- * Can be set to an empty table to create a recipe that produces nothing. Duplicate results, e.g. two entries with the same name, are allowed.
7720
+ * Can be set to an empty table to create a recipe that produces nothing. {@link Assembling machines | prototype:AssemblingMachinePrototype::max_item_product_count} do not support recipes with more than 65 535 different item products.
7721
+ *
7722
+ * Duplicate results, e.g. two entries with the same name, are allowed.
7171
7723
  * @example ```
7172
7724
  results =
7173
7725
  {
@@ -7189,9 +7741,9 @@ interface RecipePrototype extends Prototype {
7189
7741
  */
7190
7742
  results?: ProductPrototype[];
7191
7743
  /**
7192
- * Whether the recipe name should have the product amount in front of it. E.g. "2x Transport belt".
7744
+ * When set to `true`, item ingredients will be sorted based on {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe}.
7193
7745
  */
7194
- show_amount_in_title?: boolean;
7746
+ sort_item_ingredients?: boolean;
7195
7747
  surface_conditions?: SurfaceCondition[];
7196
7748
  /**
7197
7749
  * Whether enabling this recipe unlocks its item products to show in selection lists (item filters, logistic requests, etc.).
@@ -7284,7 +7836,7 @@ interface ResourceCategory extends Prototype {
7284
7836
  name = "crude-oil",
7285
7837
  amount_min = 10,
7286
7838
  amount_max = 10,
7287
- probability = 1
7839
+ independent_probability = 1
7288
7840
  }
7289
7841
  }
7290
7842
  },
@@ -7391,6 +7943,12 @@ interface ResourceEntityPrototype extends EntityPrototype {
7391
7943
  * When hovering over this resource in the map view: How far to search for other resource patches of this type to display as one (summing amount, white outline).
7392
7944
  */
7393
7945
  resource_patch_search_radius?: uint32;
7946
+ /**
7947
+ * The entity with the higher number is selectable before the entity with the lower number.
7948
+ *
7949
+ * The value `0` will be treated the same as `nil`.
7950
+ */
7951
+ selection_priority?: uint8;
7394
7952
  /**
7395
7953
  * Number of stages the animation has.
7396
7954
  */
@@ -7660,6 +8218,10 @@ interface RobotWithLogisticInterfacePrototype extends FlyingRobotPrototype {
7660
8218
  * Must be >= max_payload_size.
7661
8219
  */
7662
8220
  max_payload_size_after_bonus?: ItemCountType;
8221
+ /**
8222
+ * If true, this can't be mined unless it has more than {@link FlyingRobotPrototype::max_to_charge | prototype:FlyingRobotPrototype::max_to_charge} energy, or the players personal roboports have enough energy to charge it.
8223
+ */
8224
+ require_charge_to_mine?: boolean;
7663
8225
  /**
7664
8226
  * Only the first frame of the animation is drawn. This means that the graphics for the idle state cannot be animated.
7665
8227
  */
@@ -7688,6 +8250,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7688
8250
  arm_01_back_animation?: Animation;
7689
8251
  arm_02_right_animation?: Animation;
7690
8252
  arm_03_front_animation?: Animation;
8253
+ /**
8254
+ * Must be >= 0.
8255
+ */
8256
+ arms_speed_modifier_per_quality_level?: double;
7691
8257
  base_day_sprite?: Sprite;
7692
8258
  base_engine_light?: LightDefinition;
7693
8259
  base_front_frozen?: Sprite;
@@ -7758,6 +8324,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7758
8324
  * The time to wait in the {@link launch_started | runtime:defines.rocket_silo_status.launch_started} state before switching to {@link engine_starting | runtime:defines.rocket_silo_status.engine_starting}.
7759
8325
  */
7760
8326
  launch_wait_time?: uint8;
8327
+ /**
8328
+ * When `launch_to_space_platforms` is false, the inventory has no weight restrictions, so this value is ignored.
8329
+ */
8330
+ lift_weight?: Weight;
7761
8331
  /**
7762
8332
  * The inverse of the duration in ticks of {@link lights_blinking_open | runtime:defines.rocket_silo_status.lights_blinking_open} and {@link lights_blinking_close | runtime:defines.rocket_silo_status.lights_blinking_close}.
7763
8333
  * @example ```
@@ -7790,6 +8360,11 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7790
8360
  * Whether the "no network" icon should be rendered on this entity if the entity is not within a logistics network.
7791
8361
  */
7792
8362
  render_not_in_network_icon?: boolean;
8363
+ robot_door?: RobotDoorSpecification;
8364
+ /**
8365
+ * Must be >= 0.
8366
+ */
8367
+ rocket_engine_starting_speed_modifier_per_quality_level?: double;
7793
8368
  /**
7794
8369
  * Name of a {@link RocketSiloRocketPrototype | prototype:RocketSiloRocketPrototype}.
7795
8370
  */
@@ -7808,6 +8383,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7808
8383
  * The time to wait in the {@link doors_opened | runtime:defines.rocket_silo_status.doors_opened} state before switching to {@link rocket_rising | runtime:defines.rocket_silo_status.rocket_rising}.
7809
8384
  */
7810
8385
  rocket_rising_delay?: uint8;
8386
+ /**
8387
+ * Must be >= 0.
8388
+ */
8389
+ rocket_rising_speed_modifier_per_quality_level?: double;
7811
8390
  rocket_shadow_overlay_sprite?: Sprite;
7812
8391
  satellite_animation?: Animation;
7813
8392
  satellite_shadow_animation?: Animation;
@@ -7820,6 +8399,9 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7820
8399
  * Does not affect the duration of the launch sequence.
7821
8400
  */
7822
8401
  times_to_blink: uint8;
8402
+ /**
8403
+ * When `launch_to_space_platforms` is true, the inventory has dynamic size and is weight-restricted, so this value is ignored.
8404
+ */
7823
8405
  to_be_inserted_to_rocket_inventory_size?: ItemStackIndex;
7824
8406
  }
7825
8407
  /**
@@ -7864,6 +8446,12 @@ interface RocketSiloRocketPrototype extends EntityPrototype {
7864
8446
  rocket_smoke_top3_animation?: Animation;
7865
8447
  rocket_sprite?: Sprite;
7866
8448
  rocket_visible_distance_from_center: float;
8449
+ /**
8450
+ * The entity with the higher number is selectable before the entity with the lower number.
8451
+ *
8452
+ * The value `0` will be treated the same as `nil`.
8453
+ */
8454
+ selection_priority?: uint8;
7867
8455
  shadow_fade_out_end_ratio: double;
7868
8456
  shadow_fade_out_start_ratio: double;
7869
8457
  shadow_slave_entity?: EntityID;
@@ -7883,6 +8471,12 @@ interface RocketSiloRocketPrototype extends EntityPrototype {
7883
8471
  ```
7884
8472
  */
7885
8473
  interface RocketSiloRocketShadowPrototype extends EntityPrototype {
8474
+ /**
8475
+ * The entity with the higher number is selectable before the entity with the lower number.
8476
+ *
8477
+ * The value `0` will be treated the same as `nil`.
8478
+ */
8479
+ selection_priority?: uint8;
7886
8480
  }
7887
8481
  /**
7888
8482
  * The abstract base of all rolling stock.
@@ -7932,10 +8526,11 @@ interface RollingStockPrototype extends VehiclePrototype {
7932
8526
  /**
7933
8527
  * Maximum speed of the rolling stock in tiles/tick.
7934
8528
  *
7935
- * In-game, the max speed of a train is `min(all_rolling_stock_max_speeds) × average(all_fuel_modifiers_in_all_locomotives)`. This calculated train speed is then silently capped to 7386.3km/h.
8529
+ * In-game, the max speed of a train is `average(all_rolling_stock_max_speeds) × average(all_fuel_modifiers_in_all_locomotives)`. If this value is not provided it is ignored for the average(all_rolling_stock_max_speed) calculation. This calculated train speed is then silently capped to 7386.3km/h.
7936
8530
  */
7937
- max_speed: double;
8531
+ max_speed?: double;
7938
8532
  pictures?: RollingStockRotatedSlopedGraphics;
8533
+ quality_affects_max_speed?: boolean;
7939
8534
  stand_by_light?: LightDefinition;
7940
8535
  /**
7941
8536
  * In tiles. Used to determine how often `drive_over_tie_trigger` is triggered.
@@ -8096,12 +8691,16 @@ interface SelectionToolPrototype extends ItemWithLabelPrototype {
8096
8691
  }
8097
8692
  interface SelectorCombinatorPrototype extends CombinatorPrototype {
8098
8693
  count_symbol_sprites?: Sprite4Way;
8694
+ default_day_length_output_signal?: SignalIDConnector;
8695
+ default_day_tick_output_signal?: SignalIDConnector;
8696
+ default_game_tick_output_signal?: SignalIDConnector;
8099
8697
  max_symbol_sprites?: Sprite4Way;
8100
8698
  min_symbol_sprites?: Sprite4Way;
8101
8699
  quality_symbol_sprites?: Sprite4Way;
8102
8700
  random_symbol_sprites?: Sprite4Way;
8103
8701
  rocket_capacity_sprites?: Sprite4Way;
8104
8702
  stack_size_sprites?: Sprite4Way;
8703
+ time_symbol_sprites?: Sprite4Way;
8105
8704
  }
8106
8705
  /**
8107
8706
  * This prototype is used for receiving an achievement when the player shoots certain ammo.
@@ -8237,6 +8836,10 @@ interface SimpleEntityPrototype extends EntityWithHealthPrototype {
8237
8836
  * Used to determine render order for entities with the same `render_layer` in the same position. Entities with a higher `secondary_draw_order` are drawn on top.
8238
8837
  */
8239
8838
  secondary_draw_order?: int8;
8839
+ /**
8840
+ * If true, map generator will shuffle graphics variations for each chunk and pick the next one in sequence instead of making it purely position-based. This prevents identical entity variations from being too close to each other. This property overrides random_variation_on_create.
8841
+ */
8842
+ shuffled_variation_on_chunk_generated?: boolean;
8240
8843
  /**
8241
8844
  * Loaded and drawn with all `pictures`, `picture` and `animations`. If graphics variation is larger than number of `lower_pictures` variations this layer is not drawn.
8242
8845
  */
@@ -8328,6 +8931,12 @@ interface SmokePrototype extends EntityPrototype {
8328
8931
  */
8329
8932
  movement_slow_down_factor?: double;
8330
8933
  render_layer?: RenderLayer;
8934
+ /**
8935
+ * The entity with the higher number is selectable before the entity with the lower number.
8936
+ *
8937
+ * The value `0` will be treated the same as `nil`.
8938
+ */
8939
+ selection_priority?: uint8;
8331
8940
  show_when_smoke_off?: boolean;
8332
8941
  spread_duration?: uint32;
8333
8942
  start_scale?: double;
@@ -8593,6 +9202,10 @@ interface SpaceLocationPrototype extends Prototype {
8593
9202
  * These transitions are used for any platform stopped at this location.
8594
9203
  */
8595
9204
  platform_procession_set?: ProcessionSet;
9205
+ /**
9206
+ * Render parameters that influence platforms orbiting this space location.
9207
+ */
9208
+ platform_surface_render_parameters?: SurfaceRenderParameters;
8596
9209
  procession_audio_catalogue?: ProcessionAudioCatalogue;
8597
9210
  procession_graphic_catalogue?: ProcessionGraphicCatalogue;
8598
9211
  solar_power_in_space?: double;
@@ -8632,15 +9245,16 @@ interface SpacePlatformHubPrototype extends EntityWithOwnerPrototype {
8632
9245
  default_speed_signal?: SignalIDConnector;
8633
9246
  draw_circuit_wires?: boolean;
8634
9247
  draw_copper_wires?: boolean;
8635
- /**
8636
- * Name of a {@link ContainerPrototype | prototype:ContainerPrototype}.
8637
- */
8638
- dump_container: EntityID;
8639
9248
  graphics_set?: CargoBayConnectableGraphicsSet;
8640
9249
  inventory_size: ItemStackIndex;
8641
9250
  persistent_ambient_sounds?: PersistentWorldAmbientSoundsDefinition;
9251
+ /**
9252
+ * Repair speed of entities is multiplied by this value when they are on a space platform with this hub prototype.
9253
+ */
8642
9254
  platform_repair_speed_modifier?: float;
8643
- surface_render_parameters?: SurfaceRenderParameters;
9255
+ /**
9256
+ * Weight which this entity adds to total space platform weight when placed.
9257
+ */
8644
9258
  weight?: Weight;
8645
9259
  }
8646
9260
  interface SpacePlatformStarterPackPrototype extends ItemPrototype {
@@ -8672,6 +9286,12 @@ interface SpectatorControllerPrototype {
8672
9286
  */
8673
9287
  interface SpeechBubblePrototype extends EntityPrototype {
8674
9288
  fade_in_out_ticks?: uint32;
9289
+ /**
9290
+ * The entity with the higher number is selectable before the entity with the lower number.
9291
+ *
9292
+ * The value `0` will be treated the same as `nil`.
9293
+ */
9294
+ selection_priority?: uint8;
8675
9295
  /**
8676
9296
  * Needs a style of the type "speech_bubble_style", defined inside the gui styles.
8677
9297
  */
@@ -8709,19 +9329,37 @@ interface SpiderLegPrototype extends EntityWithOwnerPrototype {
8709
9329
  minimal_step_size: double;
8710
9330
  movement_acceleration: double;
8711
9331
  movement_based_position_selection_distance: double;
9332
+ /**
9333
+ * The entity with the higher number is selectable before the entity with the lower number.
9334
+ *
9335
+ * The value `0` will be treated the same as `nil`.
9336
+ */
9337
+ selection_priority?: uint8;
8712
9338
  /**
8713
9339
  * A scalar that controls the amount of influence this leg has over the position of the torso. Must be greater than 0.
8714
9340
  */
8715
9341
  stretch_force_scalar?: double;
8716
9342
  target_position_randomisation_distance: double;
8717
9343
  upper_leg_dying_trigger_effects?: SpiderLegTriggerEffect[];
9344
+ /**
9345
+ * Must be larger than 0.
9346
+ */
8718
9347
  walking_sound_speed_modifier?: float;
9348
+ /**
9349
+ * Cannot be negative.
9350
+ */
8719
9351
  walking_sound_volume_modifier?: float;
8720
9352
  }
8721
9353
  interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
8722
9354
  absorptions_to_join_attack?: Record<AirbornePollutantID, float>;
8723
9355
  ai_settings?: UnitAISettings;
8724
9356
  attack_parameters: AttackParameters;
9357
+ /**
9358
+ * A list of entity prototypes that this spider unit can build when given the build base command.
9359
+ *
9360
+ * If empty or not specified, the spider unit cannot build anything.
9361
+ */
9362
+ buildable_entities?: EntityID[];
8725
9363
  distraction_cooldown: uint32;
8726
9364
  dying_sound?: Sound;
8727
9365
  graphics_set?: SpiderTorsoGraphicsSet;
@@ -8737,6 +9375,7 @@ interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
8737
9375
  radar_range?: uint32;
8738
9376
  spawning_time_modifier?: double;
8739
9377
  spider_engine: SpiderEngineSpecification;
9378
+ steering?: SteeringSettings;
8740
9379
  /**
8741
9380
  * Cannot be negative.
8742
9381
  */
@@ -9080,6 +9719,12 @@ interface StickerPrototype extends EntityPrototype {
9080
9719
  * Using this property marks the sticker as a "selection sticker", meaning that the selection box will be rendered around the entity when the sticker is on it.
9081
9720
  */
9082
9721
  selection_box_type?: CursorBoxType;
9722
+ /**
9723
+ * The entity with the higher number is selectable before the entity with the lower number.
9724
+ *
9725
+ * The value `0` will be treated the same as `nil`.
9726
+ */
9727
+ selection_priority?: uint8;
9083
9728
  single_particle?: boolean;
9084
9729
  /**
9085
9730
  * If this is given, this sticker is considered a "fire sticker" for some functions, such as {@link BaseAttackParameters::fire_penalty | prototype:BaseAttackParameters::fire_penalty} and {@link EntityPrototypeFlags::not-flammable | prototype:EntityPrototypeFlags::not_flammable}.
@@ -9172,6 +9817,7 @@ interface StorageTankPrototype extends EntityWithOwnerPrototype {
9172
9817
  CircuitConnectorDefinition
9173
9818
  ];
9174
9819
  circuit_wire_max_distance?: double;
9820
+ default_fluid_temperature_signal?: SignalIDConnector;
9175
9821
  draw_circuit_wires?: boolean;
9176
9822
  draw_copper_wires?: boolean;
9177
9823
  /**
@@ -9188,6 +9834,10 @@ interface StorageTankPrototype extends EntityWithOwnerPrototype {
9188
9834
  * Whether the "alt-mode icon" should be drawn at all.
9189
9835
  */
9190
9836
  show_fluid_icon?: boolean;
9837
+ /**
9838
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
9839
+ */
9840
+ show_fluid_visualization_when_in_cursor?: boolean;
9191
9841
  two_direction_only?: boolean;
9192
9842
  /**
9193
9843
  * The location of the window showing the contents. Note that for `window_background` the width and height are determined by the sprite and window_bounding_box only determines the drawing location. For `fluid_background` the width is determined by the sprite and the height and drawing location are determined by window_bounding_box.
@@ -9273,6 +9923,11 @@ interface TechnologyPrototype extends Prototype {
9273
9923
  ```
9274
9924
  */
9275
9925
  effects?: Modifier[];
9926
+ /**
9927
+ * This can be `false` to disable the technology at the start of the game, or `true` to leave it enabled.
9928
+ *
9929
+ * Changes to this property do not affect existing save files, as the enabled state is saved in the save file and not reloaded from the prototype.
9930
+ */
9276
9931
  enabled?: boolean;
9277
9932
  /**
9278
9933
  * Whether the technology should be shown in the technology tree GUI when "Show only essential technologies" is enabled.
@@ -9349,6 +10004,8 @@ interface TechnologyPrototype extends Prototype {
9349
10004
  upgrade?: boolean;
9350
10005
  /**
9351
10006
  * Controls whether the technology is shown in the tech GUI when it is not `enabled`.
10007
+ *
10008
+ * Changes to this property do not affect existing save files, as the visible_when_disabled state is saved in the save file and not reloaded from the prototype.
9352
10009
  */
9353
10010
  visible_when_disabled?: boolean;
9354
10011
  }
@@ -9461,7 +10118,7 @@ interface TilePrototype extends Prototype {
9461
10118
  * If set to true, the game will check for collisions with entities before building or mining the tile. If entities are in the way it is not possible to mine/build the tile.
9462
10119
  */
9463
10120
  check_collision_with_entities?: boolean;
9464
- collision_mask: CollisionMaskConnector;
10121
+ collision_mask: TileCollisionMaskConnector;
9465
10122
  decorative_removal_probability?: float;
9466
10123
  default_cover_tile?: TileID;
9467
10124
  /**
@@ -9635,7 +10292,7 @@ interface TipsAndTricksItemCategory {
9635
10292
  type: 'tips-and-tricks-item-category';
9636
10293
  }
9637
10294
  /**
9638
- * Items with a "durability". Used for {@link science packs | https://wiki.factorio.com/Science_pack}.
10295
+ * Items with a "durability".
9639
10296
  */
9640
10297
  interface ToolPrototype extends ItemPrototype {
9641
10298
  /**
@@ -9731,6 +10388,12 @@ interface TransportBeltConnectablePrototype extends EntityWithOwnerPrototype {
9731
10388
  * Transport belt connectable entities cannot have the `"building-direction-8-way"` flag.
9732
10389
  */
9733
10390
  flags?: EntityPrototypeFlags;
10391
+ /**
10392
+ * The entity with the higher number is selectable before the entity with the lower number.
10393
+ *
10394
+ * The value `0` will be treated the same as `nil`.
10395
+ */
10396
+ selection_priority?: uint8;
9734
10397
  /**
9735
10398
  * The speed of the belt: `speed × 480 = x Items/second`.
9736
10399
  *
@@ -9771,7 +10434,7 @@ interface TreePrototype extends EntityWithHealthPrototype {
9771
10434
  colors?: Color[];
9772
10435
  darkness_of_burnt_tree?: float;
9773
10436
  /**
9774
- * The amount of health automatically regenerated. Trees will regenerate every 60 ticks with `healing_per_tick × 60`.
10437
+ * The amount of health automatically regenerated.
9775
10438
  * @example ```
9776
10439
  healing_per_tick = 0.01
9777
10440
  ```
@@ -9916,6 +10579,7 @@ interface TurretPrototype extends EntityWithOwnerPrototype {
9916
10579
  * Whether this prototype should be a high priority target for enemy forces. See {@link Military units and structures | https://wiki.factorio.com/Military_units_and_structures}.
9917
10580
  */
9918
10581
  is_military_target?: boolean;
10582
+ leave_attacking_if_shoot_fails?: boolean;
9919
10583
  prepare_range?: double;
9920
10584
  prepared_alternative_animation?: RotatedAnimation8Way;
9921
10585
  /**
@@ -10007,7 +10671,7 @@ interface TutorialDefinition extends PrototypeBase {
10007
10671
  */
10008
10672
  order?: Order;
10009
10673
  /**
10010
- * Name of the folder for this tutorial scenario in the {@link `tutorials` folder | runtime:mod-structure}.
10674
+ * Name of the folder for this tutorial scenario in the {@link `tutorials` folder | auxiliary:mod-structure}.
10011
10675
  */
10012
10676
  scenario: string;
10013
10677
  }
@@ -10027,7 +10691,13 @@ interface UndergroundBeltPrototype extends TransportBeltConnectablePrototype {
10027
10691
  * Entity that moves around and attacks players, for example {@link biters and spitters | https://wiki.factorio.com/Enemies#Creatures}.
10028
10692
  */
10029
10693
  interface UnitPrototype extends EntityWithOwnerPrototype {
10694
+ /**
10695
+ * The pollution amount that has to be absorbed by the unit's {@link spawner | prototype:EnemySpawnerPrototype} before the unit will leave the spawner and attack the source of the pollution.
10696
+ */
10030
10697
  absorptions_to_join_attack?: Record<AirbornePollutantID, float>;
10698
+ /**
10699
+ * Whether this unit is affected by tile {@link walking speed modifiers | prototype:TilePrototype::walking_speed_modifier}.
10700
+ */
10031
10701
  affected_by_tiles?: boolean;
10032
10702
  ai_settings?: UnitAISettings;
10033
10703
  /**
@@ -10036,9 +10706,15 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10036
10706
  allow_run_time_change_of_is_military_target?: false;
10037
10707
  alternative_attacking_frame_sequence?: UnitAlternativeFrameSequence;
10038
10708
  /**
10039
- * Requires animation in attack_parameters. Requires ammo_type in attack_parameters.
10709
+ * Requires `animation` in attack_parameters. Requires `ammo_type` in attack_parameters.
10040
10710
  */
10041
10711
  attack_parameters: AttackParameters;
10712
+ /**
10713
+ * A list of entity prototypes that this unit can build when given the build base command.
10714
+ *
10715
+ * If empty or not specified, the unit cannot build anything.
10716
+ */
10717
+ buildable_entities?: EntityID[];
10042
10718
  can_open_gates?: boolean;
10043
10719
  /**
10044
10720
  * How fast the `run_animation` frames are advanced. The animations are advanced animation_speed frames per `distance_per_frame` that the unit moves.
@@ -10048,11 +10724,11 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10048
10724
  distance_per_frame: float;
10049
10725
  distraction_cooldown: uint32;
10050
10726
  /**
10051
- * The sound file to play when entity dies.
10727
+ * The sound file to play this unit dies.
10052
10728
  */
10053
10729
  dying_sound?: Sound;
10054
10730
  /**
10055
- * If the unit is immune to movement by belts.
10731
+ * If this unit is immune to movement by belts.
10056
10732
  */
10057
10733
  has_belt_immunity?: boolean;
10058
10734
  /**
@@ -10067,7 +10743,7 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10067
10743
  min_pursue_time?: uint32;
10068
10744
  move_while_shooting?: boolean;
10069
10745
  /**
10070
- * Movement speed of the unit in the world, in tiles per tick. Must be equal to or greater than 0.
10746
+ * Movement speed of this unit in the world, in tiles per tick. Must be equal to or greater than 0.
10071
10747
  */
10072
10748
  movement_speed: float;
10073
10749
  /**
@@ -10078,10 +10754,16 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10078
10754
  rotation_speed?: float;
10079
10755
  run_animation: RotatedAnimation;
10080
10756
  /**
10757
+ * List of positions in the `run_animation` when the `walking_sound` is played.
10758
+ *
10081
10759
  * Only loaded if `walking_sound` is defined.
10082
10760
  */
10083
10761
  running_sound_animation_positions?: float[];
10762
+ /**
10763
+ * Multiplier for the {@link EnemySpawnerPrototype::spawning_cooldown | prototype:EnemySpawnerPrototype::spawning_cooldown} after it spawns this unit.
10764
+ */
10084
10765
  spawning_time_modifier?: double;
10766
+ steering?: SteeringSettings;
10085
10767
  /**
10086
10768
  * Max is 100.
10087
10769
  *
@@ -10090,7 +10772,7 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10090
10772
  vision_distance: double;
10091
10773
  walking_sound?: Sound;
10092
10774
  /**
10093
- * A sound the unit makes when it sets out to attack.
10775
+ * A sound this unit makes when it sets out to attack.
10094
10776
  */
10095
10777
  warcry?: Sound;
10096
10778
  }
@@ -10209,9 +10891,9 @@ interface UtilityConstants extends PrototypeBase {
10209
10891
  */
10210
10892
  blueprint_small_slots_per_row: uint8;
10211
10893
  /**
10212
- * The base game uses more entries here that are applied via the ammo-category.lua file.
10894
+ * The base game uses more entries here that are applied via the `ammo-category.lua` file.
10213
10895
  */
10214
- bonus_gui_ordering: BonusGuiOrdering;
10896
+ bonus_gui_ordering: BonusUtilityConstants;
10215
10897
  building_buildable_tint: Color;
10216
10898
  building_buildable_too_far_tint: Color;
10217
10899
  building_collision_mask: CollisionMaskConnector;
@@ -10263,7 +10945,12 @@ interface UtilityConstants extends PrototypeBase {
10263
10945
  * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
10264
10946
  */
10265
10947
  default_platform_procession_set: ProcessionSet;
10948
+ default_platform_surface_render_parameters: SurfaceRenderParameters;
10266
10949
  default_player_force_color: Color;
10950
+ /**
10951
+ * Used for "Rocket capacity" item tooltip and for comparing rocket silo lift weight in GUI to this value.
10952
+ */
10953
+ default_rocket_lift_weight: Weight;
10267
10954
  default_scorch_mark_color: Color;
10268
10955
  /**
10269
10956
  * The strings are entity types.
@@ -10271,7 +10958,7 @@ interface UtilityConstants extends PrototypeBase {
10271
10958
  default_trigger_target_mask_by_type?: Record<string, TriggerTargetMask>;
10272
10959
  disabled_recipe_slot_background_tint: Color;
10273
10960
  disabled_recipe_slot_tint: Color;
10274
- drop_item_radius: float;
10961
+ drop_item_radius: double;
10275
10962
  dynamic_recipe_overload_factor: double;
10276
10963
  /**
10277
10964
  * Silently clamped to be between 0 and 0.99.
@@ -10297,25 +10984,33 @@ interface UtilityConstants extends PrototypeBase {
10297
10984
  equipment_default_background_border_color: Color;
10298
10985
  equipment_default_background_color: Color;
10299
10986
  equipment_default_grabbed_background_color: Color;
10987
+ equipment_disabled_background_tint: Color;
10988
+ equipment_disabled_tint: Color;
10300
10989
  explosions_in_simulation_volume_modifier: float;
10301
10990
  factoriopedia_recycling_recipe_categories: RecipeCategoryID[];
10991
+ far_away_chunk_generation_radius: uint8;
10302
10992
  feedback_screenshot_file_name: string;
10303
10993
  feedback_screenshot_subfolder_name: string;
10304
10994
  filter_outline_color: Color;
10305
10995
  /**
10306
10996
  * Must be >= 1.
10307
10997
  */
10308
- flying_text_ttl: uint32;
10998
+ flying_text_ttl: int32;
10309
10999
  forced_enabled_recipe_slot_background_tint: Color;
11000
+ /**
11001
+ * Will be clamped to a positive number, starting at 0.
11002
+ */
10310
11003
  freezing_temperature: double;
10311
11004
  frozen_color_lookup: ColorLookupTable;
10312
11005
  ghost_layer: CollisionLayerID;
11006
+ ghost_product_count_tint: Color;
10313
11007
  ghost_shader_tint: GhostTintSet;
10314
11008
  ghost_shaderless_tint: GhostTintSet;
10315
11009
  ghost_shimmer_settings: GhostShimmerConfig;
10316
11010
  gui_remark_color: Color;
10317
11011
  gui_search_match_background_color: Color;
10318
11012
  gui_search_match_foreground_color: Color;
11013
+ huge_area_size: float;
10319
11014
  huge_platform_animation_sound_area: float;
10320
11015
  icon_shadow_color: Color;
10321
11016
  icon_shadow_inset: float;
@@ -10377,12 +11072,11 @@ interface UtilityConstants extends PrototypeBase {
10377
11072
  */
10378
11073
  main_menu_simulations?: Record<string, SimulationDefinition>;
10379
11074
  manual_rail_building_reach_modifier: double;
10380
- map_editor: MapEditorConstants;
11075
+ map_editor: EditorUtilityConstants;
10381
11076
  /**
10382
11077
  * Must be >= 1.
10383
11078
  */
10384
11079
  max_belt_stack_size: uint8;
10385
- max_fluid_flow: FluidAmount;
10386
11080
  max_logistic_filter_count: LogisticFilterIndex;
10387
11081
  max_terrain_building_size: uint8;
10388
11082
  /**
@@ -10393,11 +11087,9 @@ interface UtilityConstants extends PrototypeBase {
10393
11087
  medium_area_size: float;
10394
11088
  medium_blueprint_area_size: float;
10395
11089
  /**
10396
- * If not set, defaults to 'true' when modded and 'false' when vanilla.
11090
+ * If not set, defaults to `true` when modded and `false` when vanilla.
10397
11091
  */
10398
11092
  merge_bonus_gui_production_bonuses?: boolean;
10399
- minimap_slot_clicked_tint: Color;
10400
- minimap_slot_hovered_tint: Color;
10401
11093
  minimum_recipe_overload_multiplier: uint32;
10402
11094
  missing_preview_sprite_location: FileName;
10403
11095
  /**
@@ -10419,7 +11111,6 @@ interface UtilityConstants extends PrototypeBase {
10419
11111
  recipe_step_limit: uint32;
10420
11112
  remote_view_LPF_max_cutoff_frequency: float;
10421
11113
  remote_view_LPF_min_cutoff_frequency: float;
10422
- rocket_lift_weight: Weight;
10423
11114
  script_command_console_chat_color: Color;
10424
11115
  /**
10425
11116
  * Will be clamped to the range [1, 100].
@@ -10434,10 +11125,11 @@ interface UtilityConstants extends PrototypeBase {
10434
11125
  show_chunk_components_collision_mask: CollisionMaskConnector;
10435
11126
  small_area_size: float;
10436
11127
  small_blueprint_area_size: float;
11128
+ sound_fade_ticks: uint32;
10437
11129
  space_LPF_max_cutoff_frequency: float;
10438
11130
  space_LPF_min_cutoff_frequency: float;
10439
11131
  /**
10440
- * Variables: speed, thrust, weight, width, height
11132
+ * Variables: `speed, thrust, weight, width, height`
10441
11133
  */
10442
11134
  space_platform_acceleration_expression: MathExpression;
10443
11135
  /**
@@ -10464,6 +11156,14 @@ interface UtilityConstants extends PrototypeBase {
10464
11156
  starmap_orbit_default_color: Color;
10465
11157
  starmap_orbit_disabled_color: Color;
10466
11158
  starmap_orbit_hovered_color: Color;
11159
+ /**
11160
+ * All trivial smoke will be tinted with this value when "Hide tall entities" mode is active.
11161
+ */
11162
+ tall_entity_smoke_tint: Color;
11163
+ /**
11164
+ * Tall entities will be tinted with this value when "Hide tall entities" mode is active.
11165
+ */
11166
+ tall_entity_tint: Color;
10467
11167
  /**
10468
11168
  * The number of ticks to show a segmented unit's health bar after fully regenerating.
10469
11169
  */
@@ -10502,7 +11202,7 @@ interface UtilityConstants extends PrototypeBase {
10502
11202
  * Silently clamped to be between 0 and 1.
10503
11203
  */
10504
11204
  walking_sound_count_reduction_rate: float;
10505
- water_collision_mask: CollisionMaskConnector;
11205
+ water_collision_mask: TileCollisionMaskConnector;
10506
11206
  weapons_in_simulation_volume_modifier: float;
10507
11207
  zero_count_value_tint: Color;
10508
11208
  zoom_to_world_can_use_nightvision: boolean;
@@ -10513,74 +11213,355 @@ interface UtilityConstants extends PrototypeBase {
10513
11213
  * Sounds used by the game that are not specific to certain prototypes.
10514
11214
  */
10515
11215
  interface UtilitySounds extends PrototypeBase {
11216
+ /**
11217
+ * Sound category `"gui-effect"`.
11218
+ */
10516
11219
  achievement_unlocked: Sound;
11220
+ /**
11221
+ * Sound category `"gui-effect"`.
11222
+ */
11223
+ adjust_blueprint_snapping: Sound;
11224
+ /**
11225
+ * Sound category `"alert"`.
11226
+ */
10517
11227
  alert_destroyed: Sound;
11228
+ /**
11229
+ * Sound category `"gui-effect"`.
11230
+ */
10518
11231
  armor_insert: Sound;
11232
+ /**
11233
+ * Sound category `"gui-effect"`.
11234
+ */
10519
11235
  armor_remove: Sound;
11236
+ /**
11237
+ * Sound category `"game-effect"`.
11238
+ */
10520
11239
  axe_fighting: Sound;
11240
+ /**
11241
+ * Sound category `"game-effect"`.
11242
+ */
10521
11243
  axe_mining_ore: Sound;
11244
+ /**
11245
+ * Sound category `"game-effect"`.
11246
+ */
10522
11247
  axe_mining_stone: Sound;
11248
+ /**
11249
+ * Sound category `"gui-effect"`.
11250
+ */
11251
+ blueprint_preview_build: Sound;
11252
+ /**
11253
+ * Sound category `"gui-effect"`.
11254
+ */
11255
+ blueprint_preview_mine: Sound;
11256
+ /**
11257
+ * Sound category `"game-effect"`.
11258
+ */
10523
11259
  build_animated_huge: Sound;
11260
+ /**
11261
+ * Sound category `"game-effect"`.
11262
+ */
10524
11263
  build_animated_large: Sound;
11264
+ /**
11265
+ * Sound category `"game-effect"`.
11266
+ */
10525
11267
  build_animated_medium: Sound;
11268
+ /**
11269
+ * Sound category `"game-effect"`.
11270
+ */
10526
11271
  build_animated_small: Sound;
11272
+ /**
11273
+ * Sound category `"game-effect"`.
11274
+ */
11275
+ build_behemoth: Sound;
11276
+ /**
11277
+ * Sound category `"game-effect"`.
11278
+ */
10527
11279
  build_blueprint_huge: Sound;
11280
+ /**
11281
+ * Sound category `"game-effect"`.
11282
+ */
10528
11283
  build_blueprint_large: Sound;
11284
+ /**
11285
+ * Sound category `"game-effect"`.
11286
+ */
10529
11287
  build_blueprint_medium: Sound;
11288
+ /**
11289
+ * Sound category `"game-effect"`.
11290
+ */
10530
11291
  build_blueprint_small: Sound;
11292
+ /**
11293
+ * Sound category `"game-effect"`.
11294
+ */
10531
11295
  build_ghost_upgrade: Sound;
11296
+ /**
11297
+ * Sound category `"game-effect"`.
11298
+ */
10532
11299
  build_ghost_upgrade_cancel: Sound;
11300
+ /**
11301
+ * Sound category `"game-effect"`.
11302
+ */
10533
11303
  build_huge: Sound;
11304
+ /**
11305
+ * Sound category `"game-effect"`.
11306
+ */
10534
11307
  build_large: Sound;
11308
+ /**
11309
+ * Sound category `"game-effect"`.
11310
+ */
10535
11311
  build_medium: Sound;
11312
+ /**
11313
+ * Sound category `"game-effect"`.
11314
+ */
10536
11315
  build_small: Sound;
11316
+ /**
11317
+ * Sound category `"gui-effect"`.
11318
+ */
10537
11319
  cannot_build: Sound;
11320
+ /**
11321
+ * Sound category `"gui-effect"`.
11322
+ */
11323
+ change_quality: Sound;
11324
+ /**
11325
+ * Sound category `"gui-effect"`.
11326
+ */
10538
11327
  clear_cursor: Sound;
11328
+ /**
11329
+ * Sound category `"gui-effect"`.
11330
+ */
10539
11331
  confirm: Sound;
11332
+ /**
11333
+ * Sound category `"gui-effect"`.
11334
+ */
10540
11335
  console_message: Sound;
11336
+ /**
11337
+ * Sound category `"gui-effect"`.
11338
+ */
11339
+ console_platform_created: Sound;
11340
+ /**
11341
+ * Sound category `"gui-effect"`.
11342
+ */
11343
+ console_platform_destroyed: Sound;
11344
+ /**
11345
+ * Sound category `"gui-effect"`.
11346
+ */
11347
+ console_player_changed_logistic_group: Sound;
11348
+ /**
11349
+ * Sound category `"gui-effect"`.
11350
+ */
11351
+ console_player_died: Sound;
11352
+ /**
11353
+ * Sound category `"gui-effect"`.
11354
+ */
11355
+ console_player_joined: Sound;
11356
+ /**
11357
+ * Sound category `"gui-effect"`.
11358
+ */
11359
+ console_player_left: Sound;
11360
+ /**
11361
+ * Sound category `"gui-effect"`.
11362
+ */
11363
+ console_player_paused_game: Sound;
11364
+ /**
11365
+ * Sound category `"gui-effect"`.
11366
+ */
11367
+ console_player_research: Sound;
11368
+ /**
11369
+ * Sound category `"gui-effect"`.
11370
+ */
11371
+ console_player_respawned: Sound;
11372
+ /**
11373
+ * Sound category `"gui-effect"`.
11374
+ */
11375
+ console_player_resumed_game: Sound;
11376
+ /**
11377
+ * Sound category `"gui-effect"`.
11378
+ */
10541
11379
  crafting_finished: Sound;
11380
+ /**
11381
+ * Sound category `"gui-effect"`.
11382
+ */
11383
+ cycle_blueprint_book: Sound;
11384
+ /**
11385
+ * Sound category `"game-effect"`.
11386
+ */
11387
+ deconstruct_behemoth: Sound;
11388
+ /**
11389
+ * Sound category `"game-effect"`.
11390
+ */
10542
11391
  deconstruct_huge: Sound;
11392
+ /**
11393
+ * Sound category `"game-effect"`.
11394
+ */
10543
11395
  deconstruct_large: Sound;
11396
+ /**
11397
+ * Sound category `"game-effect"`.
11398
+ */
10544
11399
  deconstruct_medium: Sound;
11400
+ /**
11401
+ * Sound category `"game-effect"`.
11402
+ */
10545
11403
  deconstruct_robot: Sound;
11404
+ /**
11405
+ * Sound category `"game-effect"`.
11406
+ */
10546
11407
  deconstruct_small: Sound;
11408
+ /**
11409
+ * Sound category `"walking"`.
11410
+ */
10547
11411
  default_driving_sound: InterruptibleSound;
11412
+ /**
11413
+ * Sound category `"walking"`.
11414
+ */
10548
11415
  default_landing_steps: Sound;
11416
+ /**
11417
+ * Sound category `"game-effect"`.
11418
+ */
10549
11419
  default_manual_repair: Sound;
11420
+ /**
11421
+ * Sound category `"game-effect"`.
11422
+ */
10550
11423
  drop_item: Sound;
11424
+ /**
11425
+ * Sound category `"gui-effect"`.
11426
+ */
10551
11427
  entity_settings_copied: Sound;
11428
+ /**
11429
+ * Sound category `"gui-effect"`.
11430
+ */
10552
11431
  entity_settings_pasted: Sound;
11432
+ /**
11433
+ * Sound category `"gui-effect"`.
11434
+ */
10553
11435
  game_lost: Sound;
11436
+ /**
11437
+ * Sound category `"gui-effect"`.
11438
+ */
10554
11439
  game_won: Sound;
11440
+ /**
11441
+ * Sound category `"gui-effect"`.
11442
+ */
10555
11443
  gui_click: Sound;
11444
+ /**
11445
+ * Sound category `"gui-effect"`.
11446
+ */
10556
11447
  gui_switch: Sound;
11448
+ /**
11449
+ * Sound category `"gui-effect"`.
11450
+ */
11451
+ gui_tab: Sound;
11452
+ /**
11453
+ * Sound category `"gui-effect"`.
11454
+ */
11455
+ gui_toggle: Sound;
11456
+ /**
11457
+ * Sound category `"walking"`.
11458
+ */
11459
+ heat_pipe_walking_sound: Sound;
11460
+ /**
11461
+ * Sound category `"gui-effect"`.
11462
+ */
10557
11463
  inventory_click: Sound;
11464
+ /**
11465
+ * Sound category `"gui-effect"`.
11466
+ */
10558
11467
  inventory_move: Sound;
11468
+ /**
11469
+ * Sound category `"gui-effect"`.
11470
+ */
10559
11471
  item_deleted: Sound;
11472
+ /**
11473
+ * Sound category `"gui-effect"`.
11474
+ */
10560
11475
  item_spawned: Sound;
11476
+ /**
11477
+ * Sound category `"gui-effect"`.
11478
+ */
10561
11479
  list_box_click: Sound;
11480
+ /**
11481
+ * Sound category `"walking"`.
11482
+ */
10562
11483
  metal_walking_sound: Sound;
11484
+ /**
11485
+ * Sound category `"game-effect"`.
11486
+ */
10563
11487
  mining_wood: Sound;
11488
+ /**
11489
+ * Sound category `"gui-effect"`.
11490
+ */
10564
11491
  new_objective: Sound;
11492
+ /**
11493
+ * Sound category `"gui-effect"`.
11494
+ */
10565
11495
  paste_activated: Sound;
11496
+ /**
11497
+ * Sound category `"game-effect"`.
11498
+ */
10566
11499
  picked_up_item: Sound;
11500
+ /**
11501
+ * Sound category `"gui-effect"`.
11502
+ */
10567
11503
  rail_plan_start: Sound;
11504
+ /**
11505
+ * Sound category `"gui-effect"`.
11506
+ */
10568
11507
  research_completed: Sound;
11508
+ /**
11509
+ * Sound category `"game-effect"`.
11510
+ */
10569
11511
  rotated_huge: Sound;
11512
+ /**
11513
+ * Sound category `"game-effect"`.
11514
+ */
10570
11515
  rotated_large: Sound;
11516
+ /**
11517
+ * Sound category `"game-effect"`.
11518
+ */
10571
11519
  rotated_medium: Sound;
11520
+ /**
11521
+ * Sound category `"game-effect"`.
11522
+ */
10572
11523
  rotated_small: Sound;
11524
+ /**
11525
+ * Sound category `"gui-effect"`.
11526
+ */
10573
11527
  scenario_message: Sound;
10574
11528
  /**
11529
+ * Sound category `"enemy"`.
11530
+ *
10575
11531
  * Only present when the Space Age mod is loaded.
10576
11532
  */
10577
11533
  segment_dying_sound?: Sound;
11534
+ /**
11535
+ * Sound category `"gui-effect"`.
11536
+ */
10578
11537
  smart_pipette: Sound;
11538
+ /**
11539
+ * Sound category `"gui-effect"`.
11540
+ */
10579
11541
  switch_gun: Sound;
11542
+ /**
11543
+ * Sound category `"gui-effect"`.
11544
+ */
11545
+ toggle_show_entity_info: Sound;
11546
+ /**
11547
+ * Sound category `"gui-effect"`.
11548
+ */
10580
11549
  tutorial_notice: Sound;
11550
+ /**
11551
+ * Sound category `"gui-effect"`.
11552
+ */
10581
11553
  undo: Sound;
11554
+ /**
11555
+ * Sound category `"game-effect"`.
11556
+ */
10582
11557
  wire_connect_pole: Sound;
11558
+ /**
11559
+ * Sound category `"game-effect"`.
11560
+ */
10583
11561
  wire_disconnect: Sound;
11562
+ /**
11563
+ * Sound category `"game-effect"`.
11564
+ */
10584
11565
  wire_pickup: Sound;
10585
11566
  }
10586
11567
  /**
@@ -10626,6 +11607,7 @@ interface UtilitySprites extends PrototypeBase {
10626
11607
  bulk_inserter_capacity_bonus_modifier_icon: Sprite;
10627
11608
  cable_editor_icon: Sprite;
10628
11609
  cargo_bay_not_connected_icon: Sprite;
11610
+ cargo_bay_too_far_from_source_icon: Sprite;
10629
11611
  cargo_landing_pad_count_modifier_constant?: Sprite;
10630
11612
  cargo_landing_pad_count_modifier_icon: Sprite;
10631
11613
  center: Sprite;
@@ -10906,10 +11888,10 @@ interface UtilitySprites extends PrototypeBase {
10906
11888
  fluid_icon: Sprite;
10907
11889
  fluid_indication_arrow: Sprite;
10908
11890
  fluid_indication_arrow_both_ways: Sprite;
11891
+ fluid_mixing_icon: Sprite;
10909
11892
  fluid_visualization_connection: Sprite;
10910
11893
  fluid_visualization_connection_both_ways: Sprite;
10911
11894
  fluid_visualization_connection_underground: Sprite;
10912
- fluid_visualization_extent_arrow: Sprite;
10913
11895
  follower_robot_lifetime_modifier_constant?: Sprite;
10914
11896
  follower_robot_lifetime_modifier_icon: Sprite;
10915
11897
  force_editor_icon: Sprite;
@@ -10971,6 +11953,8 @@ interface UtilitySprites extends PrototypeBase {
10971
11953
  lua_snippet_tool_icon: Sprite;
10972
11954
  map: Sprite;
10973
11955
  map_exchange_string: Sprite;
11956
+ max_cargo_bay_unloading_distance_modifier_constant?: Sprite;
11957
+ max_cargo_bay_unloading_distance_modifier_icon: Sprite;
10974
11958
  max_distance_underground_remove_belts: Sprite;
10975
11959
  max_failed_attempts_per_tick_per_construction_queue_modifier_constant?: Sprite;
10976
11960
  max_failed_attempts_per_tick_per_construction_queue_modifier_icon: Sprite;
@@ -11045,6 +12029,8 @@ interface UtilitySprites extends PrototypeBase {
11045
12029
  rebuild_mark: Sprite;
11046
12030
  recharge_icon: Sprite;
11047
12031
  recipe_arrow: Sprite;
12032
+ recipe_ghost_arrow: Sprite;
12033
+ recipe_potential_arrow: Sprite;
11048
12034
  red_wire: Sprite;
11049
12035
  red_wire_highlight: Sprite;
11050
12036
  reference_point: Sprite;
@@ -11111,7 +12097,10 @@ interface UtilitySprites extends PrototypeBase {
11111
12097
  starmap_platform_stopped: Sprite;
11112
12098
  starmap_platform_stopped_clicked: Sprite;
11113
12099
  starmap_platform_stopped_hovered: Sprite;
11114
- starmap_star: Sprite;
12100
+ /**
12101
+ * Only present when the space travel flag is enabled.
12102
+ */
12103
+ starmap_star?: Sprite;
11115
12104
  station_name: Sprite;
11116
12105
  status_blue: Sprite;
11117
12106
  status_inactive: Sprite;
@@ -11150,6 +12139,8 @@ interface UtilitySprites extends PrototypeBase {
11150
12139
  underground_remove_pipes: Sprite;
11151
12140
  unlock_circuit_network_modifier_constant?: Sprite;
11152
12141
  unlock_circuit_network_modifier_icon: Sprite;
12142
+ unlock_logistic_network_modifier_constant?: Sprite;
12143
+ unlock_logistic_network_modifier_icon: Sprite;
11153
12144
  unlock_quality_modifier_constant?: Sprite;
11154
12145
  unlock_quality_modifier_icon: Sprite;
11155
12146
  unlock_recipe_modifier_constant?: Sprite;
@@ -11158,6 +12149,8 @@ interface UtilitySprites extends PrototypeBase {
11158
12149
  unlock_space_location_modifier_icon: Sprite;
11159
12150
  unlock_space_platforms_modifier_constant?: Sprite;
11160
12151
  unlock_space_platforms_modifier_icon: Sprite;
12152
+ unlock_travel_to_space_platforms_modifier_constant?: Sprite;
12153
+ unlock_travel_to_space_platforms_modifier_icon: Sprite;
11161
12154
  upgrade_blueprint: Sprite;
11162
12155
  upgrade_mark: Sprite;
11163
12156
  variations_tool_icon: Sprite;
@@ -11207,9 +12200,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
11207
12200
  allow_passengers?: boolean;
11208
12201
  allow_remote_driving?: boolean;
11209
12202
  /**
11210
- * Must be positive. There is no functional difference between the two ways to set braking power/force.
12203
+ * Must be positive.
11211
12204
  */
11212
- braking_power: Energy | double;
12205
+ braking_force: double;
11213
12206
  /**
11214
12207
  * In chunks. The radius of the radar range of the vehicle, so how many chunks it charts around itself.
11215
12208
  */
@@ -11228,9 +12221,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
11228
12221
  */
11229
12222
  equipment_grid?: EquipmentGridID;
11230
12223
  /**
11231
- * Must be positive. There is no functional difference between the two ways to set friction force.
12224
+ * Must be positive.
11232
12225
  */
11233
- friction: double;
12226
+ friction_force: double;
11234
12227
  impact_speed_to_volume_ratio?: double;
11235
12228
  /**
11236
12229
  * The sprite that represents this vehicle on the map/minimap.
@@ -11458,6 +12451,8 @@ type dataExtendType = ({
11458
12451
  } & DontUseEntityInEnergyProductionAchievementPrototype) | ({
11459
12452
  type: 'editor-controller';
11460
12453
  } & EditorControllerPrototype) | ({
12454
+ type: 'electric-energy-interface-equipment';
12455
+ } & ElectricEnergyInterfaceEquipmentPrototype) | ({
11461
12456
  type: 'electric-energy-interface';
11462
12457
  } & ElectricEnergyInterfacePrototype) | ({
11463
12458
  type: 'electric-pole';