Prototype/MiningDrill
The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/MiningDrillPrototype.html
This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.
Prototype definitions » PrototypeBase » Prototype/Entity » Prototype/EntityWithHealth » Prototype/EntityWithOwner » Prototype/MiningDrill
A mining drill for automatically extracting resources from resource entities. This prototype type is used by burner mining drill, electric mining drill and pumpjack in vanilla.
Mandatory properties
This prototype inherits the properties of Prototype/EntityWithOwner.
vector_to_place_result
Type: vector
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.
resource_searching_radius
Type: double
The distance from the centre of the mining drill to search for resources in.
This is 2.49 for electric mining drills (a 5x5 area) and 0.99 for burner mining drills (a 2x2 area). The drill searches resource outside its natural boundary box, which is 0.01 (the middle of the entity); making it 2.5 and 1.0 gives it another block radius.
energy_usage
Type: Energy
The amount of energy used by the drill while mining. Can't be less than or equal to 0.
mining_speed
Type: double
The speed of this drill.
energy_source
Type: EnergySource
The energy source of this mining drill.
resource_categories
Type: array of string
The names of the Prototype/ResourceCategory that can be mined by this drill. For a list on built-in categories, see Data.raw#resource-category.
Note: Categories containing resources which produce items, fluids, or items+fluids may be combined on the same entity, but may not work as expected.
Examples: Miner does not rotate fluid-resulting resources until depletion. Fluid isn't output (fluid resource change and fluidbox matches previous fluid). Miner with no vector_to_place_result can't output an item result and halts.
Optional properties
output_fluid_box
Type: FluidBox
input_fluid_box
Type: FluidBox
animations
Type: Animation4Way
Loaded only if graphics_set
does not exist.
graphics_set
Type: MiningDrillGraphicsSet
wet_mining_graphics_set
Type: MiningDrillGraphicsSet
base_picture
Type: Sprite4Way
Used by the pumpjack to have a static 4 way sprite.
allowed_effects
Type: EffectTypeLimitation
Default: All effects are allowed
radius_visualisation_picture
Type: Sprite
The sprite used to show the range of the mining drill.
circuit_wire_max_distance
Type: double
Default: 0
The maximum circuit wire distance for this entity.
draw_copper_wires
Type: bool
Default: true
draw_circuit_wires
Type: bool
Default: true
base_render_layer
Type: RenderLayer
Default: "lower-object"
base_productivity
Type: float
Default: 0
Productivity bonus that this machine always has. Values below 0 are allowed, however the sum of the resulting effect together with modules and research is limited to be at least 0%, see Types/Effect#productivity.
monitor_visualization_tint
Type: Color
When this mining drill is connected to the circuit network, the resource that it is reading (either the entire resource patch, or the resource in the mining area of the drill, depending on circuit network setting), is tinted in this color when mousing over the mining drill.
circuit_wire_connection_points
Type: table of WireConnectionPoint
Mandatory if circuit_wire_max_distance > 0.
circuit_connector_sprites
Type: table of CircuitConnectorSprites
Mandatory if circuit_wire_max_distance > 0.
module_specification
Type: ModuleSpecification