factorio-types 1.2.58 → 1.2.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,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.77
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
  }
@@ -884,9 +945,8 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
884
945
  disabled_when_recipe_not_researched?: boolean;
885
946
  draw_circuit_wires?: boolean;
886
947
  draw_copper_wires?: boolean;
887
- enable_logistic_control_behavior?: boolean;
888
948
  /**
889
- * Only loaded when fixed_recipe is provided.
949
+ * Only loaded if `fixed_recipe` is defined.
890
950
  */
891
951
  fixed_quality?: QualityID;
892
952
  /**
@@ -981,12 +1041,15 @@ interface AsteroidCollectorPrototype extends EntityWithOwnerPrototype {
981
1041
  unpowered_arm_speed_scale?: float;
982
1042
  }
983
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;
984
1048
  /**
985
1049
  * Emissions cannot be larger than zero, asteroids cannot produce pollution.
986
1050
  */
987
1051
  emissions_per_second?: Record<AirbornePollutantID, double>;
988
1052
  graphics_set?: AsteroidGraphicsSet;
989
- mass?: double;
990
1053
  }
991
1054
  /**
992
1055
  * A setting in the map creation GUI. Used by the {@link autoplace system | prototype:AutoplaceSpecification::control}.
@@ -1196,6 +1259,18 @@ interface BoilerPrototype extends EntityWithOwnerPrototype {
1196
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.
1197
1260
  */
1198
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;
1199
1274
  energy_consumption: Energy;
1200
1275
  energy_source: EnergySource;
1201
1276
  /**
@@ -1340,6 +1415,10 @@ interface CarPrototype extends VehiclePrototype {
1340
1415
  auto_sort_inventory?: boolean;
1341
1416
  consumption: Energy;
1342
1417
  darkness_to_render_light_animation?: float;
1418
+ /**
1419
+ * Cannot be negative.
1420
+ */
1421
+ driving_sound_volume_modifier?: float;
1343
1422
  /**
1344
1423
  * Modifies the efficiency of energy transfer from burner output to wheels.
1345
1424
  */
@@ -1353,6 +1432,10 @@ interface CarPrototype extends VehiclePrototype {
1353
1432
  * If this car is immune to movement by belts.
1354
1433
  */
1355
1434
  has_belt_immunity?: boolean;
1435
+ /**
1436
+ * If this car gets damaged by driving into anything.
1437
+ */
1438
+ immune_to_all_impacts?: boolean;
1356
1439
  /**
1357
1440
  * If this car gets damaged by driving against {@link cliffs | prototype:CliffPrototype}.
1358
1441
  */
@@ -1401,11 +1484,16 @@ interface CarPrototype extends VehiclePrototype {
1401
1484
  turret_rotation_speed?: float;
1402
1485
  }
1403
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;
1404
1491
  /**
1405
1492
  * Has to be 2 for 2x2 grid.
1406
1493
  */
1407
1494
  build_grid_size?: 2;
1408
1495
  graphics_set?: CargoBayConnectableGraphicsSet;
1496
+ has_direction?: boolean;
1409
1497
  hatch_definitions?: CargoHatchDefinition[];
1410
1498
  /**
1411
1499
  * Cannot be 0.
@@ -1415,6 +1503,14 @@ interface CargoBayPrototype extends EntityWithOwnerPrototype {
1415
1503
  * A special variant which renders on space platforms. If not specified, the game will fall back to the regular graphics set.
1416
1504
  */
1417
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;
1418
1514
  }
1419
1515
  interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
1420
1516
  cargo_station_parameters: CargoStationParameters;
@@ -1431,20 +1527,12 @@ interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
1431
1527
  * In chunks. The radius of how many chunks this cargo landing pad charts around itself.
1432
1528
  */
1433
1529
  radar_range?: uint32;
1434
- radar_visualisation_color?: Color;
1435
- /**
1436
- * Drawn when a robot brings/takes items from this landing pad.
1437
- */
1438
- robot_animation?: Animation;
1439
- /**
1440
- * Played when a robot brings/takes items from this landing pad. Only loaded if `robot_animation` is defined.
1441
- */
1442
- robot_animation_sound?: Sound;
1443
1530
  /**
1444
- * 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.
1445
1532
  */
1446
- robot_landing_location_offset?: Vector;
1447
- robot_opened_duration?: uint8;
1533
+ radar_visualisation_color?: Color;
1534
+ radius_visualisation_picture?: Sprite;
1535
+ robot_door?: RobotDoorSpecification;
1448
1536
  trash_inventory_size?: ItemStackIndex;
1449
1537
  }
1450
1538
  interface CargoPodPrototype extends EntityWithOwnerPrototype {
@@ -1728,7 +1816,21 @@ interface CombatRobotPrototype extends FlyingRobotPrototype {
1728
1816
  idle?: RotatedAnimation;
1729
1817
  in_motion?: RotatedAnimation;
1730
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;
1731
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;
1732
1834
  shadow_idle?: RotatedAnimation;
1733
1835
  shadow_in_motion?: RotatedAnimation;
1734
1836
  time_to_live: uint32;
@@ -1867,15 +1969,22 @@ interface ConstructionRobotPrototype extends RobotWithLogisticInterfacePrototype
1867
1969
  working_light?: LightDefinition;
1868
1970
  }
1869
1971
  /**
1870
- * A generic container, such as a chest. Cannot be rotated.
1972
+ * A generic container, such as a chest.
1871
1973
  */
1872
1974
  interface ContainerPrototype extends EntityWithOwnerPrototype {
1873
- circuit_connector?: CircuitConnectorDefinition;
1975
+ /**
1976
+ * If given, there must be exactly `direction_count` elements in the table.
1977
+ */
1978
+ circuit_connector?: CircuitConnectorDefinition[];
1874
1979
  /**
1875
1980
  * The maximum circuit wire distance for this container.
1876
1981
  */
1877
1982
  circuit_wire_max_distance?: double;
1878
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;
1879
1988
  draw_circuit_wires?: boolean;
1880
1989
  draw_copper_wires?: boolean;
1881
1990
  /**
@@ -1897,7 +2006,7 @@ interface ContainerPrototype extends EntityWithOwnerPrototype {
1897
2006
  /**
1898
2007
  * The picture displayed for this entity.
1899
2008
  */
1900
- picture?: Sprite;
2009
+ picture?: Sprite4Way;
1901
2010
  quality_affects_inventory_size?: boolean;
1902
2011
  }
1903
2012
  /**
@@ -2089,7 +2198,6 @@ interface CraftingMachinePrototype extends EntityWithOwnerPrototype {
2089
2198
  ```
2090
2199
  */
2091
2200
  fluid_boxes?: FluidBox[];
2092
- forced_symmetry?: Mirroring;
2093
2201
  graphics_set?: CraftingMachineGraphicsSet;
2094
2202
  graphics_set_flipped?: CraftingMachineGraphicsSet;
2095
2203
  ignore_output_full?: boolean;
@@ -2133,6 +2241,10 @@ interface CraftingMachinePrototype extends EntityWithOwnerPrototype {
2133
2241
  */
2134
2242
  show_recipe_icon_on_map?: boolean;
2135
2243
  trash_inventory_size?: ItemStackIndex;
2244
+ /**
2245
+ * Defaults to true if `vector_to_place_result` is given.
2246
+ */
2247
+ use_mirroring?: boolean;
2136
2248
  vector_to_place_result?: Vector;
2137
2249
  }
2138
2250
  /**
@@ -2482,16 +2594,13 @@ interface CustomInputPrototype extends Prototype {
2482
2594
  * - RALT
2483
2595
  * - RGUI
2484
2596
  * - MODE
2485
- * - AUDIONEXT
2486
- * - AUDIOPREV
2487
- * - AUDIOSTOP
2488
- * - AUDIOPLAY
2489
- * - AUDIOMUTE
2490
- * - MEDIASELECT
2491
- * - WWW
2492
- * - MAIL
2493
- * - CALCULATOR
2494
- * - COMPUTER
2597
+ * - MEDIA_NEXT_TRACK
2598
+ * - MEDIA_PREVIOUS_TRACK
2599
+ * - MEDIA_STOP
2600
+ * - MEDIA_PLAY
2601
+ * - MEDIA_PLAY_PAUSE
2602
+ * - MUTE
2603
+ * - MEDIA_SELECT
2495
2604
  * - AC_SEARCH
2496
2605
  * - AC_HOME
2497
2606
  * - AC_BACK
@@ -2499,18 +2608,10 @@ interface CustomInputPrototype extends Prototype {
2499
2608
  * - AC_STOP
2500
2609
  * - AC_REFRESH
2501
2610
  * - AC_BOOKMARKS
2502
- * - BRIGHTNESSDOWN
2503
- * - BRIGHTNESSUP
2504
- * - DISPLAYSWITCH
2505
- * - KBDILLUMTOGGLE
2506
- * - KBDILLUMDOWN
2507
- * - KBDILLUMUP
2508
- * - EJECT
2611
+ * - MEDIA_EJECT
2509
2612
  * - SLEEP
2510
- * - APP1
2511
- * - APP2
2512
- * - AUDIOREWIND
2513
- * - AUDIOFASTFORWARD
2613
+ * - MEDIA_REWIND
2614
+ * - MEDIA_FAST_FORWARD
2514
2615
  */
2515
2616
  key_sequence: string;
2516
2617
  /**
@@ -2577,10 +2678,6 @@ interface DeconstructionItemPrototype extends SelectionToolPrototype {
2577
2678
  * This property is hardcoded to `false`.
2578
2679
  */
2579
2680
  always_include_tiles?: boolean;
2580
- /**
2581
- * Can't be > 255.
2582
- */
2583
- entity_filter_count?: ItemStackIndex;
2584
2681
  /**
2585
2682
  * The {@link SelectionModeData::mode | prototype:SelectionModeData::mode} is hardcoded to `"deconstruct"`.
2586
2683
  *
@@ -2594,10 +2691,6 @@ interface DeconstructionItemPrototype extends SelectionToolPrototype {
2594
2691
  ```
2595
2692
  */
2596
2693
  stack_size: 1;
2597
- /**
2598
- * Can't be > 255.
2599
- */
2600
- tile_filter_count?: ItemStackIndex;
2601
2694
  }
2602
2695
  /**
2603
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.
@@ -2772,6 +2865,14 @@ interface DisplayPanelPrototype extends EntityWithOwnerPrototype {
2772
2865
  circuit_wire_max_distance?: double;
2773
2866
  draw_circuit_wires?: boolean;
2774
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;
2775
2876
  /**
2776
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.
2777
2878
  */
@@ -2917,6 +3018,27 @@ interface EditorControllerPrototype {
2917
3018
  show_status_icons: boolean;
2918
3019
  type: 'editor-controller';
2919
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
+ }
2920
3042
  /**
2921
3043
  * Entity with electric energy source with that can have some of its values changed runtime. Useful for modding in energy consumers/producers.
2922
3044
  */
@@ -3017,6 +3139,10 @@ interface ElevatedCurvedRailAPrototype extends CurvedRailAPrototype {
3017
3139
  * The value `0` will be treated the same as `nil`.
3018
3140
  */
3019
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;
3020
3146
  }
3021
3147
  /**
3022
3148
  * An elevated curved-B rail.
@@ -3034,6 +3160,10 @@ interface ElevatedCurvedRailBPrototype extends CurvedRailBPrototype {
3034
3160
  * The value `0` will be treated the same as `nil`.
3035
3161
  */
3036
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;
3037
3167
  }
3038
3168
  /**
3039
3169
  * An elevated half diagonal rail.
@@ -3051,6 +3181,10 @@ interface ElevatedHalfDiagonalRailPrototype extends HalfDiagonalRailPrototype {
3051
3181
  * The value `0` will be treated the same as `nil`.
3052
3182
  */
3053
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;
3054
3188
  }
3055
3189
  /**
3056
3190
  * An elevated straight rail.
@@ -3068,6 +3202,10 @@ interface ElevatedStraightRailPrototype extends StraightRailPrototype {
3068
3202
  * The value `0` will be treated the same as `nil`.
3069
3203
  */
3070
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;
3071
3209
  }
3072
3210
  /**
3073
3211
  * Can spawn entities. Used for biter/spitter nests.
@@ -3116,6 +3254,10 @@ interface EnemySpawnerPrototype extends EntityWithOwnerPrototype {
3116
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.
3117
3255
  */
3118
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;
3119
3261
  /**
3120
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.
3121
3263
  */
@@ -3224,7 +3366,6 @@ interface EntityPrototype extends Prototype {
3224
3366
  * Used to specify the rules for placing this entity during map generation.
3225
3367
  */
3226
3368
  autoplace?: AutoplaceSpecification;
3227
- build_base_evolution_requirement?: double;
3228
3369
  /**
3229
3370
  * Supported values are 1 (for 1x1 grid) and 2 (for 2x2 grid, like rails).
3230
3371
  *
@@ -3427,6 +3568,10 @@ interface EntityPrototype extends Prototype {
3427
3568
  * The cursor size used when shooting at this entity.
3428
3569
  */
3429
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;
3430
3575
  stateless_visualisation?: StatelessVisualisation | StatelessVisualisation[];
3431
3576
  /**
3432
3577
  * Used to specify the area where the {@link sticker | prototype:StickerPrototype} animation can appear for entities that can have stickers on them.
@@ -3436,6 +3581,10 @@ interface EntityPrototype extends Prototype {
3436
3581
  */
3437
3582
  sticker_box?: BoundingBox;
3438
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;
3439
3588
  tile_buildability_rules?: TileBuildabilityRule[];
3440
3589
  tile_height?: int32;
3441
3590
  /**
@@ -3502,7 +3651,7 @@ interface EntityWithHealthPrototype extends EntityPrototype {
3502
3651
  dying_explosion?: ExplosionDefinition | ExplosionDefinition[];
3503
3652
  dying_trigger_effect?: TriggerEffect;
3504
3653
  /**
3505
- * 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.
3506
3655
  * @example ```
3507
3656
  healing_per_tick = 0.01
3508
3657
  ```
@@ -3528,15 +3677,16 @@ interface EntityWithHealthPrototype extends EntityPrototype {
3528
3677
  loot =
3529
3678
  {
3530
3679
  {
3531
- count_max = 10,
3532
- count_min = 2,
3533
- item = "stone",
3534
- probability = 1
3680
+ type = "item",
3681
+ name = "stone",
3682
+ amount_min = 2,
3683
+ amount_max = 10,
3684
+ independent_probability = 1
3535
3685
  }
3536
3686
  }
3537
3687
  ```
3538
3688
  */
3539
- loot?: LootItem[];
3689
+ loot?: ItemProductPrototype[];
3540
3690
  /**
3541
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.
3542
3692
  * @example ```
@@ -3922,6 +4072,10 @@ interface FluidPrototype extends Prototype {
3922
4072
  * Also the minimum temperature of the fluid. Has to be lower than `max_temperature`.
3923
4073
  */
3924
4074
  default_temperature: float;
4075
+ /**
4076
+ * Whether the fluid should glow in pipe and storage tank windows.
4077
+ */
4078
+ draw_as_glow?: boolean;
3925
4079
  /**
3926
4080
  * Scales pollution generated when the fluid is consumed.
3927
4081
  */
@@ -3968,6 +4122,10 @@ interface FluidPrototype extends Prototype {
3968
4122
  */
3969
4123
  icons?: IconData[];
3970
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;
3971
4129
  /**
3972
4130
  * Color to use for visualization. This color should be vibrant and easily distinguished.
3973
4131
  *
@@ -4064,7 +4222,7 @@ interface FluidTurretPrototype extends TurretPrototype {
4064
4222
  attacking_muzzle_animation_shift?: AnimatedVector;
4065
4223
  ending_attack_muzzle_animation_shift?: AnimatedVector;
4066
4224
  enough_fuel_indicator_light?: LightDefinition;
4067
- enough_fuel_indicator_picture?: Sprite4Way;
4225
+ enough_fuel_indicator_picture?: Sprite8Way;
4068
4226
  fluid_box: FluidBox;
4069
4227
  fluid_buffer_input_flow: FluidAmount;
4070
4228
  fluid_buffer_size: FluidAmount;
@@ -4073,7 +4231,7 @@ interface FluidTurretPrototype extends TurretPrototype {
4073
4231
  muzzle_animation?: Animation;
4074
4232
  muzzle_light?: LightDefinition;
4075
4233
  not_enough_fuel_indicator_light?: LightDefinition;
4076
- not_enough_fuel_indicator_picture?: Sprite4Way;
4234
+ not_enough_fuel_indicator_picture?: Sprite8Way;
4077
4235
  /**
4078
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.
4079
4237
  */
@@ -4090,6 +4248,22 @@ interface FluidTurretPrototype extends TurretPrototype {
4090
4248
  * A {@link fluid wagon | https://wiki.factorio.com/Fluid_wagon}.
4091
4249
  */
4092
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;
4093
4267
  capacity: FluidAmount;
4094
4268
  /**
4095
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.
@@ -4097,9 +4271,21 @@ interface FluidWagonPrototype extends RollingStockPrototype {
4097
4271
  connection_category?: string | string[];
4098
4272
  quality_affects_capacity?: boolean;
4099
4273
  /**
4100
- * Must be 1, 2 or 3.
4274
+ * Must be positive.
4101
4275
  */
4102
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;
4103
4289
  }
4104
4290
  /**
4105
4291
  * Abstract base for construction/logistics and combat robots.
@@ -4223,7 +4409,9 @@ interface FuelCategory extends Prototype {
4223
4409
  fuel_value_type?: LocalisedString;
4224
4410
  }
4225
4411
  /**
4226
- * 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.
4227
4415
  */
4228
4416
  interface FurnacePrototype extends CraftingMachinePrototype {
4229
4417
  /**
@@ -4431,8 +4619,6 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4431
4619
  * The number of fluid units the generator uses per tick.
4432
4620
  */
4433
4621
  fluid_usage_per_tick: FluidAmount;
4434
- horizontal_animation?: Animation;
4435
- horizontal_frozen_patch?: Sprite;
4436
4622
  /**
4437
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.
4438
4624
  *
@@ -4445,10 +4631,12 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4445
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`.
4446
4632
  */
4447
4633
  maximum_temperature: float;
4634
+ output_fluid_box?: FluidBox;
4448
4635
  /**
4449
4636
  * Affects animation speed and working sound.
4450
4637
  */
4451
4638
  perceived_performance?: PerceivedPerformance;
4639
+ pictures?: GeneratorPictureSet;
4452
4640
  /**
4453
4641
  * Scales the generator's fluid usage to its maximum power output.
4454
4642
  *
@@ -4458,8 +4646,11 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4458
4646
  */
4459
4647
  scale_fluid_usage?: boolean;
4460
4648
  smoke?: SmokeSource[];
4461
- vertical_animation?: Animation;
4462
- 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;
4463
4654
  }
4464
4655
  /**
4465
4656
  * Properties of the god controller.
@@ -4546,7 +4737,18 @@ interface HeatInterfacePrototype extends EntityWithOwnerPrototype {
4546
4737
  * A {@link heat pipe | https://wiki.factorio.com/Heat_pipe}.
4547
4738
  */
4548
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;
4549
4748
  connection_sprites?: ConnectableEntityGraphics;
4749
+ default_temperature_signal?: SignalIDConnector;
4750
+ draw_circuit_wires?: boolean;
4751
+ draw_copper_wires?: boolean;
4550
4752
  heat_buffer: HeatBuffer;
4551
4753
  heat_glow_sprites?: ConnectableEntityGraphics;
4552
4754
  /**
@@ -4618,7 +4820,7 @@ interface InfinityContainerPrototype extends LogisticContainerPrototype {
4618
4820
  /**
4619
4821
  * The way this chest interacts with the logistic network.
4620
4822
  */
4621
- logistic_mode?: 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
4823
+ logistic_mode?: LogisticMode;
4622
4824
  /**
4623
4825
  * When true, items created inside the infinity chest will not start to spoil until they have been removed from the chest.
4624
4826
  */
@@ -4660,6 +4862,12 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4660
4862
  CircuitConnectorDefinition,
4661
4863
  CircuitConnectorDefinition
4662
4864
  ];
4865
+ circuit_connector_flipped?: [
4866
+ CircuitConnectorDefinition,
4867
+ CircuitConnectorDefinition,
4868
+ CircuitConnectorDefinition,
4869
+ CircuitConnectorDefinition
4870
+ ];
4663
4871
  /**
4664
4872
  * The maximum circuit wire distance for this entity.
4665
4873
  */
@@ -4714,7 +4922,9 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4714
4922
  max_belt_stack_size?: uint8;
4715
4923
  pickup_position: Vector;
4716
4924
  platform_frozen?: Sprite4Way;
4925
+ platform_frozen_flipped?: Sprite4Way;
4717
4926
  platform_picture?: Sprite4Way;
4927
+ platform_picture_flipped?: Sprite4Way;
4718
4928
  rotation_speed: double;
4719
4929
  /**
4720
4930
  * Stack size bonus that is inherent to the prototype without having to be researched.
@@ -4725,6 +4935,7 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4725
4935
  * Whether the inserter should be able to fish {@link fish | https://wiki.factorio.com/Raw_fish}.
4726
4936
  */
4727
4937
  use_easter_egg?: boolean;
4938
+ use_mirroring?: boolean;
4728
4939
  /**
4729
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.
4730
4941
  */
@@ -4800,7 +5011,7 @@ interface ItemGroup extends Prototype {
4800
5011
  */
4801
5012
  icons?: IconData[];
4802
5013
  /**
4803
- * 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.
4804
5015
  */
4805
5016
  order_in_recipe?: Order;
4806
5017
  }
@@ -4917,6 +5128,7 @@ interface ItemPrototype extends Prototype {
4917
5128
  icons?: IconData[];
4918
5129
  ingredient_to_weight_coefficient?: double;
4919
5130
  inventory_move_sound?: Sound;
5131
+ lab_ignores_spoil_percent?: boolean;
4920
5132
  /**
4921
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"`.
4922
5134
  */
@@ -4954,10 +5166,17 @@ interface ItemPrototype extends Prototype {
4954
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.
4955
5167
  */
4956
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;
4957
5173
  /**
4958
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.
4959
5175
  */
4960
5176
  spoil_level?: uint8;
5177
+ spoil_quality_change?: int8;
5178
+ spoil_quality_max?: QualityID;
5179
+ spoil_quality_min?: QualityID;
4961
5180
  spoil_result?: ItemID;
4962
5181
  spoil_ticks?: uint32;
4963
5182
  spoil_to_trigger_result?: SpoilToTriggerResult;
@@ -4971,7 +5190,7 @@ interface ItemPrototype extends Prototype {
4971
5190
  /**
4972
5191
  * The default weight is calculated automatically from recipes and falls back to {@link UtilityConstants::default_item_weight | prototype:UtilityConstants::default_item_weight}.
4973
5192
  *
4974
- * 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}.
4975
5194
  */
4976
5195
  weight?: Weight;
4977
5196
  }
@@ -5081,6 +5300,7 @@ interface ItemWithInventoryPrototype extends ItemWithLabelPrototype {
5081
5300
  ```
5082
5301
  */
5083
5302
  item_subgroup_filters?: ItemSubGroupID[];
5303
+ quality_affects_inventory_size?: boolean;
5084
5304
  /**
5085
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.
5086
5306
  * @example ```
@@ -5162,7 +5382,7 @@ interface KillAchievementPrototype extends AchievementPrototype {
5162
5382
  type_to_kill?: string;
5163
5383
  }
5164
5384
  /**
5165
- * 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}.
5166
5386
  */
5167
5387
  interface LabPrototype extends EntityWithOwnerPrototype {
5168
5388
  /**
@@ -5173,6 +5393,14 @@ interface LabPrototype extends EntityWithOwnerPrototype {
5173
5393
  * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
5174
5394
  */
5175
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;
5176
5404
  effect_receiver?: EffectReceiver;
5177
5405
  /**
5178
5406
  * Defines how this lab gets energy.
@@ -5365,6 +5593,13 @@ interface LampPrototype extends EntityWithOwnerPrototype {
5365
5593
  interface LandMinePrototype extends EntityWithOwnerPrototype {
5366
5594
  action?: Trigger;
5367
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;
5368
5603
  /**
5369
5604
  * Force the landmine to kill itself when exploding.
5370
5605
  */
@@ -5464,7 +5699,7 @@ interface LightningPrototype extends EntityPrototype {
5464
5699
  /**
5465
5700
  * When lightning strikes something that is not a lightning attractor, this damage is applied to the target.
5466
5701
  */
5467
- damage?: double;
5702
+ damage?: DamageParameters;
5468
5703
  effect_duration: uint16;
5469
5704
  /**
5470
5705
  * When lightning hits a {@link lightning attractor | prototype:LightningAttractorPrototype}, this amount of energy is transferred to the lightning attractor.
@@ -5629,32 +5864,20 @@ interface LocomotivePrototype extends RollingStockPrototype {
5629
5864
  * A generic container, such as a chest, that interacts with the logistics network.
5630
5865
  */
5631
5866
  interface LogisticContainerPrototype extends ContainerPrototype {
5632
- /**
5633
- * Drawn when a robot brings/takes items from this container.
5634
- */
5635
- animation?: Animation;
5636
- /**
5637
- * Played when a robot brings/takes items from this container. Only loaded if `animation` is defined.
5638
- */
5639
- animation_sound?: Sound;
5640
- /**
5641
- * The offset from the center of this container where a robot visually brings/takes items.
5642
- */
5643
- landing_location_offset?: Vector;
5644
5867
  /**
5645
5868
  * The way this chest interacts with the logistic network.
5646
5869
  * This property is required, but marked as optional due to typescript inheritance limitations
5647
5870
  */
5648
- logistic_mode?: 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
5871
+ logistic_mode?: LogisticMode;
5649
5872
  /**
5650
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.
5651
5874
  */
5652
5875
  max_logistic_slots?: uint16;
5653
- opened_duration?: uint8;
5654
5876
  /**
5655
5877
  * Whether the "no network" icon should be rendered on this entity if the entity is not within a logistics network.
5656
5878
  */
5657
5879
  render_not_in_network_icon?: boolean;
5880
+ robot_door?: RobotDoorSpecification;
5658
5881
  trash_inventory_size?: ItemStackIndex;
5659
5882
  /**
5660
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).
@@ -5766,7 +5989,6 @@ interface MapSettings {
5766
5989
  name: string;
5767
5990
  path_finder: PathFinderSettings;
5768
5991
  pollution: PollutionSettings;
5769
- steering: SteeringSettings;
5770
5992
  type: 'map-settings';
5771
5993
  unit_group: UnitGroupSettings;
5772
5994
  }
@@ -5792,17 +6014,18 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5792
6014
  * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
5793
6015
  */
5794
6016
  allowed_module_categories?: ModuleCategoryID[];
5795
- /**
5796
- * Used by the {@link pumpjack | https://wiki.factorio.com/Pumpjack} to have a static 4 way sprite.
5797
- */
5798
- base_picture?: Sprite4Way;
5799
- base_render_layer?: RenderLayer;
5800
6017
  circuit_connector?: [
5801
6018
  CircuitConnectorDefinition,
5802
6019
  CircuitConnectorDefinition,
5803
6020
  CircuitConnectorDefinition,
5804
6021
  CircuitConnectorDefinition
5805
6022
  ];
6023
+ circuit_connector_flipped?: [
6024
+ CircuitConnectorDefinition,
6025
+ CircuitConnectorDefinition,
6026
+ CircuitConnectorDefinition,
6027
+ CircuitConnectorDefinition
6028
+ ];
5806
6029
  /**
5807
6030
  * The maximum circuit wire distance for this entity.
5808
6031
  */
@@ -5830,7 +6053,12 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5830
6053
  */
5831
6054
  filter_count?: uint8;
5832
6055
  graphics_set?: MiningDrillGraphicsSet;
6056
+ graphics_set_flipped?: MiningDrillGraphicsSet;
5833
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;
5834
6062
  /**
5835
6063
  * The speed of this drill.
5836
6064
  */
@@ -5861,6 +6089,7 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5861
6089
  * The sprite used to show the range of the mining drill.
5862
6090
  */
5863
6091
  radius_visualisation_picture?: Sprite;
6092
+ require_resources_to_place?: boolean;
5864
6093
  /**
5865
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}.
5866
6095
  *
@@ -5882,12 +6111,14 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5882
6111
  */
5883
6112
  resource_searching_radius: double;
5884
6113
  shuffle_resources_to_mine?: boolean;
6114
+ use_mirroring?: boolean;
5885
6115
  uses_force_mining_productivity_bonus?: boolean;
5886
6116
  /**
5887
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.
5888
6118
  */
5889
6119
  vector_to_place_result: Vector;
5890
6120
  wet_mining_graphics_set?: MiningDrillGraphicsSet;
6121
+ wet_mining_graphics_set_flipped?: MiningDrillGraphicsSet;
5891
6122
  }
5892
6123
  /**
5893
6124
  * Block of arbitrary data set by mods in prototype stage.
@@ -5936,11 +6167,41 @@ interface ModulePrototype extends ItemPrototype {
5936
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.
5937
6168
  */
5938
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;
5939
6176
  /**
5940
6177
  * The effect of the module on the machine it's inserted in, such as increased pollution.
5941
6178
  */
5942
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;
5943
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;
5944
6205
  /**
5945
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.
5946
6207
  */
@@ -6025,7 +6286,7 @@ interface MovementBonusEquipmentPrototype extends EquipmentPrototype {
6025
6286
  *
6026
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.
6027
6288
  *
6028
- * 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")`.
6029
6290
  * @example ```
6030
6291
  {
6031
6292
  type = "noise-expression",
@@ -6169,6 +6430,10 @@ interface OffshorePumpPrototype extends EntityWithOwnerPrototype {
6169
6430
  */
6170
6431
  pumping_speed: FluidAmount;
6171
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;
6172
6437
  }
6173
6438
  /**
6174
6439
  * An entity with a limited lifetime that can use trigger effects.
@@ -6241,6 +6506,16 @@ interface ParticleSourcePrototype extends EntityPrototype {
6241
6506
  * An entity to transport fluids over a distance and between machines.
6242
6507
  */
6243
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;
6244
6519
  /**
6245
6520
  * The area of the entity where fluid/gas inputs, and outputs.
6246
6521
  */
@@ -6250,13 +6525,27 @@ interface PipePrototype extends EntityWithOwnerPrototype {
6250
6525
  * All graphics for this pipe.
6251
6526
  */
6252
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;
6253
6532
  vertical_window_bounding_box: BoundingBox;
6254
6533
  }
6255
6534
  /**
6256
6535
  * A {@link pipe to ground | https://wiki.factorio.com/Pipe_to_ground}.
6257
6536
  */
6258
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;
6259
6546
  disabled_visualization?: Sprite4Way;
6547
+ draw_circuit_wires?: boolean;
6548
+ draw_copper_wires?: boolean;
6260
6549
  /**
6261
6550
  * Causes fluid icon to always be drawn, ignoring the usual pair requirement.
6262
6551
  */
@@ -6264,6 +6553,10 @@ interface PipeToGroundPrototype extends EntityWithOwnerPrototype {
6264
6553
  fluid_box: FluidBox;
6265
6554
  frozen_patch?: Sprite4Way;
6266
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;
6267
6560
  visualization?: Sprite4Way;
6268
6561
  }
6269
6562
  interface PlaceEquipmentAchievementPrototype extends AchievementPrototype {
@@ -6290,10 +6583,18 @@ interface PlanetPrototype extends SpaceLocationPrototype {
6290
6583
  }
6291
6584
  interface PlantPrototype extends TreePrototype {
6292
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[];
6293
6590
  /**
6294
6591
  * Must be positive.
6295
6592
  */
6296
6593
  growth_ticks: MapTick;
6594
+ /**
6595
+ * If defined, it can't be empty.
6596
+ */
6597
+ growth_variations?: TreeGrowth[];
6297
6598
  /**
6298
6599
  * The burst of pollution to emit when the plant is harvested.
6299
6600
  */
@@ -6612,6 +6913,8 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6612
6913
  * The animation for the pump.
6613
6914
  */
6614
6915
  animations?: Animation4Way;
6916
+ arm_orienting_sound?: InterruptibleSound;
6917
+ base_lifting_sound?: InterruptibleSound;
6615
6918
  circuit_connector?: [
6616
6919
  CircuitConnectorDefinition,
6617
6920
  CircuitConnectorDefinition,
@@ -6619,6 +6922,7 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6619
6922
  CircuitConnectorDefinition
6620
6923
  ];
6621
6924
  circuit_wire_max_distance?: double;
6925
+ clamp_sound?: Sound;
6622
6926
  draw_circuit_wires?: boolean;
6623
6927
  draw_copper_wires?: boolean;
6624
6928
  /**
@@ -6638,16 +6942,23 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6638
6942
  * The area of the entity where fluid travels.
6639
6943
  */
6640
6944
  fluid_box: FluidBox;
6641
- fluid_wagon_connector_alignment_tolerance?: double;
6642
6945
  fluid_wagon_connector_frame_count?: uint8;
6643
- fluid_wagon_connector_graphics?: FluidWagonConnectorGraphics;
6644
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;
6645
6951
  frozen_patch?: Sprite4Way;
6646
6952
  glass_pictures?: Sprite4Way;
6647
6953
  /**
6648
6954
  * The amount of fluid this pump transfers per tick.
6649
6955
  */
6650
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;
6651
6962
  }
6652
6963
  /**
6653
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.
@@ -6668,7 +6979,7 @@ interface QualityPrototype extends Prototype {
6668
6979
  */
6669
6980
  beacon_module_slots_bonus?: ItemStackIndex;
6670
6981
  /**
6671
- * Must be >= 0.
6982
+ * Must be >= 0.01.
6672
6983
  */
6673
6984
  beacon_power_usage_multiplier?: float;
6674
6985
  /**
@@ -6677,7 +6988,17 @@ interface QualityPrototype extends Prototype {
6677
6988
  * Must be >= 0 and <= 64.
6678
6989
  */
6679
6990
  beacon_supply_area_distance_bonus?: float;
6680
- color: Color;
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;
7001
+ color: Color;
6681
7002
  /**
6682
7003
  * Must be >= 0.01.
6683
7004
  *
@@ -6759,6 +7080,10 @@ interface QualityPrototype extends Prototype {
6759
7080
  * Requires Space Age to use level greater than `0`.
6760
7081
  */
6761
7082
  level: uint32;
7083
+ /**
7084
+ * Must be >= 0.01.
7085
+ */
7086
+ locomotive_power_multiplier?: double;
6762
7087
  /**
6763
7088
  * Must be >= 0.01.
6764
7089
  */
@@ -6783,6 +7108,26 @@ interface QualityPrototype extends Prototype {
6783
7108
  * Must be in range `[0, 1]`.
6784
7109
  */
6785
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;
6786
7131
  /**
6787
7132
  * Unique textual identification of the prototype. May only contain alphanumeric characters, dashes and underscores. May not exceed a length of 200 characters.
6788
7133
  *
@@ -6791,23 +7136,49 @@ interface QualityPrototype extends Prototype {
6791
7136
  name: string;
6792
7137
  next?: QualityID;
6793
7138
  /**
6794
- * 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.
7140
+ *
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.
6795
7142
  *
6796
- * Must be in range [0, 1.0].
7143
+ * Must be >= 0.
6797
7144
  */
6798
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;
6799
7162
  /**
6800
7163
  * Must be within `[1, 3]`.
6801
7164
  *
6802
7165
  * Affects the range of {@link attack parameters | prototype:AttackParameters}, e.g. those used by combat robots, units, guns and turrets.
6803
7166
  */
6804
7167
  range_multiplier?: double;
7168
+ /**
7169
+ * Must be >= 0.01.
7170
+ */
7171
+ rolling_stock_max_speed_multiplier?: double;
6805
7172
  /**
6806
7173
  * Must be in range `[0, 1]`.
6807
7174
  *
6808
7175
  * Only affects labs with {@link LabPrototype::uses_quality_drain_modifier | prototype:LabPrototype::uses_quality_drain_modifier} set.
6809
7176
  */
6810
7177
  science_pack_drain_multiplier?: float;
7178
+ /**
7179
+ * Must be >= 0.01.
7180
+ */
7181
+ spoil_ticks_multiplier?: float;
6811
7182
  /**
6812
7183
  * Must be >= 0.01.
6813
7184
  *
@@ -6828,6 +7199,10 @@ interface RadarPrototype extends EntityWithOwnerPrototype {
6828
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.
6829
7200
  */
6830
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;
6831
7206
  draw_circuit_wires?: boolean;
6832
7207
  draw_copper_wires?: boolean;
6833
7208
  /**
@@ -6919,7 +7294,7 @@ interface RailPrototype extends EntityWithOwnerPrototype {
6919
7294
  * Must be 0, 2 or 4. Can't be non-zero if `fence_pictures` is defined.
6920
7295
  */
6921
7296
  forced_fence_segment_count?: uint8;
6922
- pictures: RailPictureSet;
7297
+ pictures?: RailPictureSet;
6923
7298
  removes_soft_decoratives?: boolean;
6924
7299
  /**
6925
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.
@@ -6958,6 +7333,10 @@ interface RailRampPrototype extends RailPrototype {
6958
7333
  * Must be lower than 500 and at least 1.
6959
7334
  */
6960
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;
6961
7340
  }
6962
7341
  /**
6963
7342
  * Used for rail corpses.
@@ -6971,7 +7350,7 @@ interface RailRemnantsPrototype extends CorpsePrototype {
6971
7350
  * "Rail remnant entities must have a non-zero {@link collision_box | prototype:EntityPrototype::collision_box} defined.
6972
7351
  */
6973
7352
  collision_box?: BoundingBox;
6974
- pictures: RailPictureSet;
7353
+ pictures?: RailPictureSet;
6975
7354
  related_rail: EntityID;
6976
7355
  secondary_collision_box?: BoundingBox;
6977
7356
  }
@@ -7101,11 +7480,19 @@ interface ReactorPrototype extends EntityWithOwnerPrototype {
7101
7480
  */
7102
7481
  meltdown_action?: Trigger;
7103
7482
  neighbour_bonus?: double;
7483
+ /**
7484
+ * Defines connection points to neighbours used to compute neighbour bonus.
7485
+ */
7486
+ neighbour_connectable?: NeighbourConnectable;
7104
7487
  picture?: Sprite;
7105
7488
  /**
7106
7489
  * When this is true, the reactor will stop consuming fuel/energy when the temperature has reached the maximum.
7107
7490
  */
7108
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;
7109
7496
  /**
7110
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}
7111
7498
  */
@@ -7131,7 +7518,7 @@ interface RecipeCategory extends Prototype {
7131
7518
  {
7132
7519
  type = "recipe",
7133
7520
  name = "iron-plate",
7134
- category = "smelting",
7521
+ categories = {"smelting"},
7135
7522
  energy_required = 3.5,
7136
7523
  ingredients = {{type = "item", name = "iron-ore", amount = 1}},
7137
7524
  results = {{type = "item", name = "iron-plate", amount = 1}}
@@ -7141,7 +7528,7 @@ interface RecipeCategory extends Prototype {
7141
7528
  {
7142
7529
  type = "recipe",
7143
7530
  name = "coal-liquefaction",
7144
- category = "oil-processing",
7531
+ categories = {"oil-processing"},
7145
7532
  subgroup = "fluid-recipes",
7146
7533
  order = "a[oil-processing]-c[coal-liquefaction]",
7147
7534
  enabled = false,
@@ -7165,7 +7552,6 @@ interface RecipeCategory extends Prototype {
7165
7552
  ```
7166
7553
  */
7167
7554
  interface RecipePrototype extends Prototype {
7168
- additional_categories?: RecipeCategoryID[];
7169
7555
  /**
7170
7556
  * Whether the recipe can be used as an intermediate recipe in hand-crafting.
7171
7557
  */
@@ -7204,10 +7590,6 @@ interface RecipePrototype extends Prototype {
7204
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.
7205
7591
  */
7206
7592
  always_show_made_in?: boolean;
7207
- /**
7208
- * Whether the products are always shown in the recipe tooltip.
7209
- */
7210
- always_show_products?: boolean;
7211
7593
  /**
7212
7594
  * Whether the recipe should be included in the recycling recipes automatically generated by the quality mod.
7213
7595
  *
@@ -7215,14 +7597,24 @@ interface RecipePrototype extends Prototype {
7215
7597
  */
7216
7598
  auto_recycle?: boolean;
7217
7599
  /**
7218
- * 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.
7219
7609
  *
7220
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.
7221
7613
  * @example ```
7222
- category = "smelting"
7614
+ categories = {"smelting"}
7223
7615
  ```
7224
7616
  */
7225
- category?: RecipeCategoryID;
7617
+ categories?: RecipeCategoryID[];
7226
7618
  /**
7227
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.
7228
7620
  */
@@ -7281,7 +7673,7 @@ interface RecipePrototype extends Prototype {
7281
7673
  *
7282
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.
7283
7675
  *
7284
- * 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`.
7285
7677
  * @example ```
7286
7678
  -- Recipe with items
7287
7679
  ingredients =
@@ -7319,13 +7711,9 @@ interface RecipePrototype extends Prototype {
7319
7711
  preserve_products_in_machine_output?: boolean;
7320
7712
  requester_paste_multiplier?: uint32;
7321
7713
  /**
7322
- * When set to true, if the recipe successfully finishes crafting without spoiling, the result is produced fresh (non-spoiled).
7323
- */
7324
- reset_freshness_on_craft?: boolean;
7325
- /**
7326
- * When set to true, the recipe will always produce fresh (non-spoiled) item even when the ingredients are spoiled.
7714
+ * Whether enabling this recipe requires the ingredients be unlocked before the products are marked as unlocked.
7327
7715
  */
7328
- result_is_always_fresh?: boolean;
7716
+ requires_ingredients_to_unlock_results?: boolean;
7329
7717
  /**
7330
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.
7331
7719
  *
@@ -7353,9 +7741,9 @@ interface RecipePrototype extends Prototype {
7353
7741
  */
7354
7742
  results?: ProductPrototype[];
7355
7743
  /**
7356
- * 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}.
7357
7745
  */
7358
- show_amount_in_title?: boolean;
7746
+ sort_item_ingredients?: boolean;
7359
7747
  surface_conditions?: SurfaceCondition[];
7360
7748
  /**
7361
7749
  * Whether enabling this recipe unlocks its item products to show in selection lists (item filters, logistic requests, etc.).
@@ -7448,7 +7836,7 @@ interface ResourceCategory extends Prototype {
7448
7836
  name = "crude-oil",
7449
7837
  amount_min = 10,
7450
7838
  amount_max = 10,
7451
- probability = 1
7839
+ independent_probability = 1
7452
7840
  }
7453
7841
  }
7454
7842
  },
@@ -7830,6 +8218,10 @@ interface RobotWithLogisticInterfacePrototype extends FlyingRobotPrototype {
7830
8218
  * Must be >= max_payload_size.
7831
8219
  */
7832
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;
7833
8225
  /**
7834
8226
  * Only the first frame of the animation is drawn. This means that the graphics for the idle state cannot be animated.
7835
8227
  */
@@ -7858,6 +8250,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7858
8250
  arm_01_back_animation?: Animation;
7859
8251
  arm_02_right_animation?: Animation;
7860
8252
  arm_03_front_animation?: Animation;
8253
+ /**
8254
+ * Must be >= 0.
8255
+ */
8256
+ arms_speed_modifier_per_quality_level?: double;
7861
8257
  base_day_sprite?: Sprite;
7862
8258
  base_engine_light?: LightDefinition;
7863
8259
  base_front_frozen?: Sprite;
@@ -7928,6 +8324,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7928
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}.
7929
8325
  */
7930
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;
7931
8331
  /**
7932
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}.
7933
8333
  * @example ```
@@ -7960,6 +8360,11 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7960
8360
  * Whether the "no network" icon should be rendered on this entity if the entity is not within a logistics network.
7961
8361
  */
7962
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;
7963
8368
  /**
7964
8369
  * Name of a {@link RocketSiloRocketPrototype | prototype:RocketSiloRocketPrototype}.
7965
8370
  */
@@ -7978,6 +8383,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7978
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}.
7979
8384
  */
7980
8385
  rocket_rising_delay?: uint8;
8386
+ /**
8387
+ * Must be >= 0.
8388
+ */
8389
+ rocket_rising_speed_modifier_per_quality_level?: double;
7981
8390
  rocket_shadow_overlay_sprite?: Sprite;
7982
8391
  satellite_animation?: Animation;
7983
8392
  satellite_shadow_animation?: Animation;
@@ -7990,6 +8399,9 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7990
8399
  * Does not affect the duration of the launch sequence.
7991
8400
  */
7992
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
+ */
7993
8405
  to_be_inserted_to_rocket_inventory_size?: ItemStackIndex;
7994
8406
  }
7995
8407
  /**
@@ -8114,10 +8526,11 @@ interface RollingStockPrototype extends VehiclePrototype {
8114
8526
  /**
8115
8527
  * Maximum speed of the rolling stock in tiles/tick.
8116
8528
  *
8117
- * 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.
8118
8530
  */
8119
- max_speed: double;
8531
+ max_speed?: double;
8120
8532
  pictures?: RollingStockRotatedSlopedGraphics;
8533
+ quality_affects_max_speed?: boolean;
8121
8534
  stand_by_light?: LightDefinition;
8122
8535
  /**
8123
8536
  * In tiles. Used to determine how often `drive_over_tie_trigger` is triggered.
@@ -8278,12 +8691,16 @@ interface SelectionToolPrototype extends ItemWithLabelPrototype {
8278
8691
  }
8279
8692
  interface SelectorCombinatorPrototype extends CombinatorPrototype {
8280
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;
8281
8697
  max_symbol_sprites?: Sprite4Way;
8282
8698
  min_symbol_sprites?: Sprite4Way;
8283
8699
  quality_symbol_sprites?: Sprite4Way;
8284
8700
  random_symbol_sprites?: Sprite4Way;
8285
8701
  rocket_capacity_sprites?: Sprite4Way;
8286
8702
  stack_size_sprites?: Sprite4Way;
8703
+ time_symbol_sprites?: Sprite4Way;
8287
8704
  }
8288
8705
  /**
8289
8706
  * This prototype is used for receiving an achievement when the player shoots certain ammo.
@@ -8419,6 +8836,10 @@ interface SimpleEntityPrototype extends EntityWithHealthPrototype {
8419
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.
8420
8837
  */
8421
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;
8422
8843
  /**
8423
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.
8424
8845
  */
@@ -8781,6 +9202,10 @@ interface SpaceLocationPrototype extends Prototype {
8781
9202
  * These transitions are used for any platform stopped at this location.
8782
9203
  */
8783
9204
  platform_procession_set?: ProcessionSet;
9205
+ /**
9206
+ * Render parameters that influence platforms orbiting this space location.
9207
+ */
9208
+ platform_surface_render_parameters?: SurfaceRenderParameters;
8784
9209
  procession_audio_catalogue?: ProcessionAudioCatalogue;
8785
9210
  procession_graphic_catalogue?: ProcessionGraphicCatalogue;
8786
9211
  solar_power_in_space?: double;
@@ -8820,15 +9245,16 @@ interface SpacePlatformHubPrototype extends EntityWithOwnerPrototype {
8820
9245
  default_speed_signal?: SignalIDConnector;
8821
9246
  draw_circuit_wires?: boolean;
8822
9247
  draw_copper_wires?: boolean;
8823
- /**
8824
- * Name of a {@link ContainerPrototype | prototype:ContainerPrototype}.
8825
- */
8826
- dump_container: EntityID;
8827
9248
  graphics_set?: CargoBayConnectableGraphicsSet;
8828
9249
  inventory_size: ItemStackIndex;
8829
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
+ */
8830
9254
  platform_repair_speed_modifier?: float;
8831
- surface_render_parameters?: SurfaceRenderParameters;
9255
+ /**
9256
+ * Weight which this entity adds to total space platform weight when placed.
9257
+ */
8832
9258
  weight?: Weight;
8833
9259
  }
8834
9260
  interface SpacePlatformStarterPackPrototype extends ItemPrototype {
@@ -8915,13 +9341,25 @@ interface SpiderLegPrototype extends EntityWithOwnerPrototype {
8915
9341
  stretch_force_scalar?: double;
8916
9342
  target_position_randomisation_distance: double;
8917
9343
  upper_leg_dying_trigger_effects?: SpiderLegTriggerEffect[];
9344
+ /**
9345
+ * Must be larger than 0.
9346
+ */
8918
9347
  walking_sound_speed_modifier?: float;
9348
+ /**
9349
+ * Cannot be negative.
9350
+ */
8919
9351
  walking_sound_volume_modifier?: float;
8920
9352
  }
8921
9353
  interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
8922
9354
  absorptions_to_join_attack?: Record<AirbornePollutantID, float>;
8923
9355
  ai_settings?: UnitAISettings;
8924
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[];
8925
9363
  distraction_cooldown: uint32;
8926
9364
  dying_sound?: Sound;
8927
9365
  graphics_set?: SpiderTorsoGraphicsSet;
@@ -8937,6 +9375,7 @@ interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
8937
9375
  radar_range?: uint32;
8938
9376
  spawning_time_modifier?: double;
8939
9377
  spider_engine: SpiderEngineSpecification;
9378
+ steering?: SteeringSettings;
8940
9379
  /**
8941
9380
  * Cannot be negative.
8942
9381
  */
@@ -9378,6 +9817,7 @@ interface StorageTankPrototype extends EntityWithOwnerPrototype {
9378
9817
  CircuitConnectorDefinition
9379
9818
  ];
9380
9819
  circuit_wire_max_distance?: double;
9820
+ default_fluid_temperature_signal?: SignalIDConnector;
9381
9821
  draw_circuit_wires?: boolean;
9382
9822
  draw_copper_wires?: boolean;
9383
9823
  /**
@@ -9394,6 +9834,10 @@ interface StorageTankPrototype extends EntityWithOwnerPrototype {
9394
9834
  * Whether the "alt-mode icon" should be drawn at all.
9395
9835
  */
9396
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;
9397
9841
  two_direction_only?: boolean;
9398
9842
  /**
9399
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.
@@ -9674,7 +10118,7 @@ interface TilePrototype extends Prototype {
9674
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.
9675
10119
  */
9676
10120
  check_collision_with_entities?: boolean;
9677
- collision_mask: CollisionMaskConnector;
10121
+ collision_mask: TileCollisionMaskConnector;
9678
10122
  decorative_removal_probability?: float;
9679
10123
  default_cover_tile?: TileID;
9680
10124
  /**
@@ -9848,7 +10292,7 @@ interface TipsAndTricksItemCategory {
9848
10292
  type: 'tips-and-tricks-item-category';
9849
10293
  }
9850
10294
  /**
9851
- * Items with a "durability". Used for {@link science packs | https://wiki.factorio.com/Science_pack}.
10295
+ * Items with a "durability".
9852
10296
  */
9853
10297
  interface ToolPrototype extends ItemPrototype {
9854
10298
  /**
@@ -9990,7 +10434,7 @@ interface TreePrototype extends EntityWithHealthPrototype {
9990
10434
  colors?: Color[];
9991
10435
  darkness_of_burnt_tree?: float;
9992
10436
  /**
9993
- * The amount of health automatically regenerated. Trees will regenerate every 60 ticks with `healing_per_tick × 60`.
10437
+ * The amount of health automatically regenerated.
9994
10438
  * @example ```
9995
10439
  healing_per_tick = 0.01
9996
10440
  ```
@@ -10135,6 +10579,7 @@ interface TurretPrototype extends EntityWithOwnerPrototype {
10135
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}.
10136
10580
  */
10137
10581
  is_military_target?: boolean;
10582
+ leave_attacking_if_shoot_fails?: boolean;
10138
10583
  prepare_range?: double;
10139
10584
  prepared_alternative_animation?: RotatedAnimation8Way;
10140
10585
  /**
@@ -10226,7 +10671,7 @@ interface TutorialDefinition extends PrototypeBase {
10226
10671
  */
10227
10672
  order?: Order;
10228
10673
  /**
10229
- * 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}.
10230
10675
  */
10231
10676
  scenario: string;
10232
10677
  }
@@ -10264,6 +10709,12 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10264
10709
  * Requires `animation` in attack_parameters. Requires `ammo_type` in attack_parameters.
10265
10710
  */
10266
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[];
10267
10718
  can_open_gates?: boolean;
10268
10719
  /**
10269
10720
  * How fast the `run_animation` frames are advanced. The animations are advanced animation_speed frames per `distance_per_frame` that the unit moves.
@@ -10312,6 +10763,7 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10312
10763
  * Multiplier for the {@link EnemySpawnerPrototype::spawning_cooldown | prototype:EnemySpawnerPrototype::spawning_cooldown} after it spawns this unit.
10313
10764
  */
10314
10765
  spawning_time_modifier?: double;
10766
+ steering?: SteeringSettings;
10315
10767
  /**
10316
10768
  * Max is 100.
10317
10769
  *
@@ -10439,9 +10891,9 @@ interface UtilityConstants extends PrototypeBase {
10439
10891
  */
10440
10892
  blueprint_small_slots_per_row: uint8;
10441
10893
  /**
10442
- * 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.
10443
10895
  */
10444
- bonus_gui_ordering: BonusGuiOrdering;
10896
+ bonus_gui_ordering: BonusUtilityConstants;
10445
10897
  building_buildable_tint: Color;
10446
10898
  building_buildable_too_far_tint: Color;
10447
10899
  building_collision_mask: CollisionMaskConnector;
@@ -10493,7 +10945,12 @@ interface UtilityConstants extends PrototypeBase {
10493
10945
  * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
10494
10946
  */
10495
10947
  default_platform_procession_set: ProcessionSet;
10948
+ default_platform_surface_render_parameters: SurfaceRenderParameters;
10496
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;
10497
10954
  default_scorch_mark_color: Color;
10498
10955
  /**
10499
10956
  * The strings are entity types.
@@ -10501,7 +10958,7 @@ interface UtilityConstants extends PrototypeBase {
10501
10958
  default_trigger_target_mask_by_type?: Record<string, TriggerTargetMask>;
10502
10959
  disabled_recipe_slot_background_tint: Color;
10503
10960
  disabled_recipe_slot_tint: Color;
10504
- drop_item_radius: float;
10961
+ drop_item_radius: double;
10505
10962
  dynamic_recipe_overload_factor: double;
10506
10963
  /**
10507
10964
  * Silently clamped to be between 0 and 0.99.
@@ -10527,25 +10984,33 @@ interface UtilityConstants extends PrototypeBase {
10527
10984
  equipment_default_background_border_color: Color;
10528
10985
  equipment_default_background_color: Color;
10529
10986
  equipment_default_grabbed_background_color: Color;
10987
+ equipment_disabled_background_tint: Color;
10988
+ equipment_disabled_tint: Color;
10530
10989
  explosions_in_simulation_volume_modifier: float;
10531
10990
  factoriopedia_recycling_recipe_categories: RecipeCategoryID[];
10991
+ far_away_chunk_generation_radius: uint8;
10532
10992
  feedback_screenshot_file_name: string;
10533
10993
  feedback_screenshot_subfolder_name: string;
10534
10994
  filter_outline_color: Color;
10535
10995
  /**
10536
10996
  * Must be >= 1.
10537
10997
  */
10538
- flying_text_ttl: uint32;
10998
+ flying_text_ttl: int32;
10539
10999
  forced_enabled_recipe_slot_background_tint: Color;
11000
+ /**
11001
+ * Will be clamped to a positive number, starting at 0.
11002
+ */
10540
11003
  freezing_temperature: double;
10541
11004
  frozen_color_lookup: ColorLookupTable;
10542
11005
  ghost_layer: CollisionLayerID;
11006
+ ghost_product_count_tint: Color;
10543
11007
  ghost_shader_tint: GhostTintSet;
10544
11008
  ghost_shaderless_tint: GhostTintSet;
10545
11009
  ghost_shimmer_settings: GhostShimmerConfig;
10546
11010
  gui_remark_color: Color;
10547
11011
  gui_search_match_background_color: Color;
10548
11012
  gui_search_match_foreground_color: Color;
11013
+ huge_area_size: float;
10549
11014
  huge_platform_animation_sound_area: float;
10550
11015
  icon_shadow_color: Color;
10551
11016
  icon_shadow_inset: float;
@@ -10607,12 +11072,11 @@ interface UtilityConstants extends PrototypeBase {
10607
11072
  */
10608
11073
  main_menu_simulations?: Record<string, SimulationDefinition>;
10609
11074
  manual_rail_building_reach_modifier: double;
10610
- map_editor: MapEditorConstants;
11075
+ map_editor: EditorUtilityConstants;
10611
11076
  /**
10612
11077
  * Must be >= 1.
10613
11078
  */
10614
11079
  max_belt_stack_size: uint8;
10615
- max_fluid_flow: FluidAmount;
10616
11080
  max_logistic_filter_count: LogisticFilterIndex;
10617
11081
  max_terrain_building_size: uint8;
10618
11082
  /**
@@ -10623,11 +11087,9 @@ interface UtilityConstants extends PrototypeBase {
10623
11087
  medium_area_size: float;
10624
11088
  medium_blueprint_area_size: float;
10625
11089
  /**
10626
- * 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.
10627
11091
  */
10628
11092
  merge_bonus_gui_production_bonuses?: boolean;
10629
- minimap_slot_clicked_tint: Color;
10630
- minimap_slot_hovered_tint: Color;
10631
11093
  minimum_recipe_overload_multiplier: uint32;
10632
11094
  missing_preview_sprite_location: FileName;
10633
11095
  /**
@@ -10649,7 +11111,6 @@ interface UtilityConstants extends PrototypeBase {
10649
11111
  recipe_step_limit: uint32;
10650
11112
  remote_view_LPF_max_cutoff_frequency: float;
10651
11113
  remote_view_LPF_min_cutoff_frequency: float;
10652
- rocket_lift_weight: Weight;
10653
11114
  script_command_console_chat_color: Color;
10654
11115
  /**
10655
11116
  * Will be clamped to the range [1, 100].
@@ -10664,10 +11125,11 @@ interface UtilityConstants extends PrototypeBase {
10664
11125
  show_chunk_components_collision_mask: CollisionMaskConnector;
10665
11126
  small_area_size: float;
10666
11127
  small_blueprint_area_size: float;
11128
+ sound_fade_ticks: uint32;
10667
11129
  space_LPF_max_cutoff_frequency: float;
10668
11130
  space_LPF_min_cutoff_frequency: float;
10669
11131
  /**
10670
- * Variables: speed, thrust, weight, width, height
11132
+ * Variables: `speed, thrust, weight, width, height`
10671
11133
  */
10672
11134
  space_platform_acceleration_expression: MathExpression;
10673
11135
  /**
@@ -10694,6 +11156,14 @@ interface UtilityConstants extends PrototypeBase {
10694
11156
  starmap_orbit_default_color: Color;
10695
11157
  starmap_orbit_disabled_color: Color;
10696
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;
10697
11167
  /**
10698
11168
  * The number of ticks to show a segmented unit's health bar after fully regenerating.
10699
11169
  */
@@ -10732,7 +11202,7 @@ interface UtilityConstants extends PrototypeBase {
10732
11202
  * Silently clamped to be between 0 and 1.
10733
11203
  */
10734
11204
  walking_sound_count_reduction_rate: float;
10735
- water_collision_mask: CollisionMaskConnector;
11205
+ water_collision_mask: TileCollisionMaskConnector;
10736
11206
  weapons_in_simulation_volume_modifier: float;
10737
11207
  zero_count_value_tint: Color;
10738
11208
  zoom_to_world_can_use_nightvision: boolean;
@@ -10743,74 +11213,355 @@ interface UtilityConstants extends PrototypeBase {
10743
11213
  * Sounds used by the game that are not specific to certain prototypes.
10744
11214
  */
10745
11215
  interface UtilitySounds extends PrototypeBase {
11216
+ /**
11217
+ * Sound category `"gui-effect"`.
11218
+ */
10746
11219
  achievement_unlocked: Sound;
11220
+ /**
11221
+ * Sound category `"gui-effect"`.
11222
+ */
11223
+ adjust_blueprint_snapping: Sound;
11224
+ /**
11225
+ * Sound category `"alert"`.
11226
+ */
10747
11227
  alert_destroyed: Sound;
11228
+ /**
11229
+ * Sound category `"gui-effect"`.
11230
+ */
10748
11231
  armor_insert: Sound;
11232
+ /**
11233
+ * Sound category `"gui-effect"`.
11234
+ */
10749
11235
  armor_remove: Sound;
11236
+ /**
11237
+ * Sound category `"game-effect"`.
11238
+ */
10750
11239
  axe_fighting: Sound;
11240
+ /**
11241
+ * Sound category `"game-effect"`.
11242
+ */
10751
11243
  axe_mining_ore: Sound;
11244
+ /**
11245
+ * Sound category `"game-effect"`.
11246
+ */
10752
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
+ */
10753
11259
  build_animated_huge: Sound;
11260
+ /**
11261
+ * Sound category `"game-effect"`.
11262
+ */
10754
11263
  build_animated_large: Sound;
11264
+ /**
11265
+ * Sound category `"game-effect"`.
11266
+ */
10755
11267
  build_animated_medium: Sound;
11268
+ /**
11269
+ * Sound category `"game-effect"`.
11270
+ */
10756
11271
  build_animated_small: Sound;
11272
+ /**
11273
+ * Sound category `"game-effect"`.
11274
+ */
11275
+ build_behemoth: Sound;
11276
+ /**
11277
+ * Sound category `"game-effect"`.
11278
+ */
10757
11279
  build_blueprint_huge: Sound;
11280
+ /**
11281
+ * Sound category `"game-effect"`.
11282
+ */
10758
11283
  build_blueprint_large: Sound;
11284
+ /**
11285
+ * Sound category `"game-effect"`.
11286
+ */
10759
11287
  build_blueprint_medium: Sound;
11288
+ /**
11289
+ * Sound category `"game-effect"`.
11290
+ */
10760
11291
  build_blueprint_small: Sound;
11292
+ /**
11293
+ * Sound category `"game-effect"`.
11294
+ */
10761
11295
  build_ghost_upgrade: Sound;
11296
+ /**
11297
+ * Sound category `"game-effect"`.
11298
+ */
10762
11299
  build_ghost_upgrade_cancel: Sound;
11300
+ /**
11301
+ * Sound category `"game-effect"`.
11302
+ */
10763
11303
  build_huge: Sound;
11304
+ /**
11305
+ * Sound category `"game-effect"`.
11306
+ */
10764
11307
  build_large: Sound;
11308
+ /**
11309
+ * Sound category `"game-effect"`.
11310
+ */
10765
11311
  build_medium: Sound;
11312
+ /**
11313
+ * Sound category `"game-effect"`.
11314
+ */
10766
11315
  build_small: Sound;
11316
+ /**
11317
+ * Sound category `"gui-effect"`.
11318
+ */
10767
11319
  cannot_build: Sound;
11320
+ /**
11321
+ * Sound category `"gui-effect"`.
11322
+ */
11323
+ change_quality: Sound;
11324
+ /**
11325
+ * Sound category `"gui-effect"`.
11326
+ */
10768
11327
  clear_cursor: Sound;
11328
+ /**
11329
+ * Sound category `"gui-effect"`.
11330
+ */
10769
11331
  confirm: Sound;
11332
+ /**
11333
+ * Sound category `"gui-effect"`.
11334
+ */
10770
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
+ */
10771
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
+ */
10772
11391
  deconstruct_huge: Sound;
11392
+ /**
11393
+ * Sound category `"game-effect"`.
11394
+ */
10773
11395
  deconstruct_large: Sound;
11396
+ /**
11397
+ * Sound category `"game-effect"`.
11398
+ */
10774
11399
  deconstruct_medium: Sound;
11400
+ /**
11401
+ * Sound category `"game-effect"`.
11402
+ */
10775
11403
  deconstruct_robot: Sound;
11404
+ /**
11405
+ * Sound category `"game-effect"`.
11406
+ */
10776
11407
  deconstruct_small: Sound;
11408
+ /**
11409
+ * Sound category `"walking"`.
11410
+ */
10777
11411
  default_driving_sound: InterruptibleSound;
11412
+ /**
11413
+ * Sound category `"walking"`.
11414
+ */
10778
11415
  default_landing_steps: Sound;
11416
+ /**
11417
+ * Sound category `"game-effect"`.
11418
+ */
10779
11419
  default_manual_repair: Sound;
11420
+ /**
11421
+ * Sound category `"game-effect"`.
11422
+ */
10780
11423
  drop_item: Sound;
11424
+ /**
11425
+ * Sound category `"gui-effect"`.
11426
+ */
10781
11427
  entity_settings_copied: Sound;
11428
+ /**
11429
+ * Sound category `"gui-effect"`.
11430
+ */
10782
11431
  entity_settings_pasted: Sound;
11432
+ /**
11433
+ * Sound category `"gui-effect"`.
11434
+ */
10783
11435
  game_lost: Sound;
11436
+ /**
11437
+ * Sound category `"gui-effect"`.
11438
+ */
10784
11439
  game_won: Sound;
11440
+ /**
11441
+ * Sound category `"gui-effect"`.
11442
+ */
10785
11443
  gui_click: Sound;
11444
+ /**
11445
+ * Sound category `"gui-effect"`.
11446
+ */
10786
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
+ */
10787
11463
  inventory_click: Sound;
11464
+ /**
11465
+ * Sound category `"gui-effect"`.
11466
+ */
10788
11467
  inventory_move: Sound;
11468
+ /**
11469
+ * Sound category `"gui-effect"`.
11470
+ */
10789
11471
  item_deleted: Sound;
11472
+ /**
11473
+ * Sound category `"gui-effect"`.
11474
+ */
10790
11475
  item_spawned: Sound;
11476
+ /**
11477
+ * Sound category `"gui-effect"`.
11478
+ */
10791
11479
  list_box_click: Sound;
11480
+ /**
11481
+ * Sound category `"walking"`.
11482
+ */
10792
11483
  metal_walking_sound: Sound;
11484
+ /**
11485
+ * Sound category `"game-effect"`.
11486
+ */
10793
11487
  mining_wood: Sound;
11488
+ /**
11489
+ * Sound category `"gui-effect"`.
11490
+ */
10794
11491
  new_objective: Sound;
11492
+ /**
11493
+ * Sound category `"gui-effect"`.
11494
+ */
10795
11495
  paste_activated: Sound;
11496
+ /**
11497
+ * Sound category `"game-effect"`.
11498
+ */
10796
11499
  picked_up_item: Sound;
11500
+ /**
11501
+ * Sound category `"gui-effect"`.
11502
+ */
10797
11503
  rail_plan_start: Sound;
11504
+ /**
11505
+ * Sound category `"gui-effect"`.
11506
+ */
10798
11507
  research_completed: Sound;
11508
+ /**
11509
+ * Sound category `"game-effect"`.
11510
+ */
10799
11511
  rotated_huge: Sound;
11512
+ /**
11513
+ * Sound category `"game-effect"`.
11514
+ */
10800
11515
  rotated_large: Sound;
11516
+ /**
11517
+ * Sound category `"game-effect"`.
11518
+ */
10801
11519
  rotated_medium: Sound;
11520
+ /**
11521
+ * Sound category `"game-effect"`.
11522
+ */
10802
11523
  rotated_small: Sound;
11524
+ /**
11525
+ * Sound category `"gui-effect"`.
11526
+ */
10803
11527
  scenario_message: Sound;
10804
11528
  /**
11529
+ * Sound category `"enemy"`.
11530
+ *
10805
11531
  * Only present when the Space Age mod is loaded.
10806
11532
  */
10807
11533
  segment_dying_sound?: Sound;
11534
+ /**
11535
+ * Sound category `"gui-effect"`.
11536
+ */
10808
11537
  smart_pipette: Sound;
11538
+ /**
11539
+ * Sound category `"gui-effect"`.
11540
+ */
10809
11541
  switch_gun: Sound;
11542
+ /**
11543
+ * Sound category `"gui-effect"`.
11544
+ */
11545
+ toggle_show_entity_info: Sound;
11546
+ /**
11547
+ * Sound category `"gui-effect"`.
11548
+ */
10810
11549
  tutorial_notice: Sound;
11550
+ /**
11551
+ * Sound category `"gui-effect"`.
11552
+ */
10811
11553
  undo: Sound;
11554
+ /**
11555
+ * Sound category `"game-effect"`.
11556
+ */
10812
11557
  wire_connect_pole: Sound;
11558
+ /**
11559
+ * Sound category `"game-effect"`.
11560
+ */
10813
11561
  wire_disconnect: Sound;
11562
+ /**
11563
+ * Sound category `"game-effect"`.
11564
+ */
10814
11565
  wire_pickup: Sound;
10815
11566
  }
10816
11567
  /**
@@ -10856,6 +11607,7 @@ interface UtilitySprites extends PrototypeBase {
10856
11607
  bulk_inserter_capacity_bonus_modifier_icon: Sprite;
10857
11608
  cable_editor_icon: Sprite;
10858
11609
  cargo_bay_not_connected_icon: Sprite;
11610
+ cargo_bay_too_far_from_source_icon: Sprite;
10859
11611
  cargo_landing_pad_count_modifier_constant?: Sprite;
10860
11612
  cargo_landing_pad_count_modifier_icon: Sprite;
10861
11613
  center: Sprite;
@@ -11136,10 +11888,10 @@ interface UtilitySprites extends PrototypeBase {
11136
11888
  fluid_icon: Sprite;
11137
11889
  fluid_indication_arrow: Sprite;
11138
11890
  fluid_indication_arrow_both_ways: Sprite;
11891
+ fluid_mixing_icon: Sprite;
11139
11892
  fluid_visualization_connection: Sprite;
11140
11893
  fluid_visualization_connection_both_ways: Sprite;
11141
11894
  fluid_visualization_connection_underground: Sprite;
11142
- fluid_visualization_extent_arrow: Sprite;
11143
11895
  follower_robot_lifetime_modifier_constant?: Sprite;
11144
11896
  follower_robot_lifetime_modifier_icon: Sprite;
11145
11897
  force_editor_icon: Sprite;
@@ -11201,6 +11953,8 @@ interface UtilitySprites extends PrototypeBase {
11201
11953
  lua_snippet_tool_icon: Sprite;
11202
11954
  map: Sprite;
11203
11955
  map_exchange_string: Sprite;
11956
+ max_cargo_bay_unloading_distance_modifier_constant?: Sprite;
11957
+ max_cargo_bay_unloading_distance_modifier_icon: Sprite;
11204
11958
  max_distance_underground_remove_belts: Sprite;
11205
11959
  max_failed_attempts_per_tick_per_construction_queue_modifier_constant?: Sprite;
11206
11960
  max_failed_attempts_per_tick_per_construction_queue_modifier_icon: Sprite;
@@ -11275,6 +12029,8 @@ interface UtilitySprites extends PrototypeBase {
11275
12029
  rebuild_mark: Sprite;
11276
12030
  recharge_icon: Sprite;
11277
12031
  recipe_arrow: Sprite;
12032
+ recipe_ghost_arrow: Sprite;
12033
+ recipe_potential_arrow: Sprite;
11278
12034
  red_wire: Sprite;
11279
12035
  red_wire_highlight: Sprite;
11280
12036
  reference_point: Sprite;
@@ -11341,7 +12097,10 @@ interface UtilitySprites extends PrototypeBase {
11341
12097
  starmap_platform_stopped: Sprite;
11342
12098
  starmap_platform_stopped_clicked: Sprite;
11343
12099
  starmap_platform_stopped_hovered: Sprite;
11344
- starmap_star: Sprite;
12100
+ /**
12101
+ * Only present when the space travel flag is enabled.
12102
+ */
12103
+ starmap_star?: Sprite;
11345
12104
  station_name: Sprite;
11346
12105
  status_blue: Sprite;
11347
12106
  status_inactive: Sprite;
@@ -11380,6 +12139,8 @@ interface UtilitySprites extends PrototypeBase {
11380
12139
  underground_remove_pipes: Sprite;
11381
12140
  unlock_circuit_network_modifier_constant?: Sprite;
11382
12141
  unlock_circuit_network_modifier_icon: Sprite;
12142
+ unlock_logistic_network_modifier_constant?: Sprite;
12143
+ unlock_logistic_network_modifier_icon: Sprite;
11383
12144
  unlock_quality_modifier_constant?: Sprite;
11384
12145
  unlock_quality_modifier_icon: Sprite;
11385
12146
  unlock_recipe_modifier_constant?: Sprite;
@@ -11388,6 +12149,8 @@ interface UtilitySprites extends PrototypeBase {
11388
12149
  unlock_space_location_modifier_icon: Sprite;
11389
12150
  unlock_space_platforms_modifier_constant?: Sprite;
11390
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;
11391
12154
  upgrade_blueprint: Sprite;
11392
12155
  upgrade_mark: Sprite;
11393
12156
  variations_tool_icon: Sprite;
@@ -11437,9 +12200,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
11437
12200
  allow_passengers?: boolean;
11438
12201
  allow_remote_driving?: boolean;
11439
12202
  /**
11440
- * Must be positive. There is no functional difference between the two ways to set braking power/force.
12203
+ * Must be positive.
11441
12204
  */
11442
- braking_power: Energy | double;
12205
+ braking_force: double;
11443
12206
  /**
11444
12207
  * In chunks. The radius of the radar range of the vehicle, so how many chunks it charts around itself.
11445
12208
  */
@@ -11458,9 +12221,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
11458
12221
  */
11459
12222
  equipment_grid?: EquipmentGridID;
11460
12223
  /**
11461
- * Must be positive. There is no functional difference between the two ways to set friction force.
12224
+ * Must be positive.
11462
12225
  */
11463
- friction: double;
12226
+ friction_force: double;
11464
12227
  impact_speed_to_volume_ratio?: double;
11465
12228
  /**
11466
12229
  * The sprite that represents this vehicle on the map/minimap.
@@ -11688,6 +12451,8 @@ type dataExtendType = ({
11688
12451
  } & DontUseEntityInEnergyProductionAchievementPrototype) | ({
11689
12452
  type: 'editor-controller';
11690
12453
  } & EditorControllerPrototype) | ({
12454
+ type: 'electric-energy-interface-equipment';
12455
+ } & ElectricEnergyInterfaceEquipmentPrototype) | ({
11691
12456
  type: 'electric-energy-interface';
11692
12457
  } & ElectricEnergyInterfacePrototype) | ({
11693
12458
  type: 'electric-pole';