About Diesel Engine
From Factorio Mod PortalInternal library responsible for making liquid fuel powered machines work
Diesel Engine
This is library for managing fluid with fuel value for my mods Here is what it does:
Central Fluid Configuration
- Everything relies on a single configuration file (
fluid-properties.lua). - This is where fuel values (e.g.,
1.2MJ) and emission multipliers for various fluids (both vanilla and from mods like Pelagos or
Krastorio 2) are placed.
Global Stat Updates
- The script takes table and automatically overwrites the fluid properties
in the game.
- It also ensures that every listed fluid can be packaged into
barrels (auto_barrel = true).
More Flamethrower Ammo
- Script automatically checks which fluids have a fuel value and adds them as
valid ammo.
- It scales the damage modifier of the flamethrower
proportionally to the energy value of the fluid used.
Barrel Fuel Generation
- Script converts standard (and titanium) barrels into burnable fuel items
(barrel-fuel.lua) based on the underlying fluid's fuel value.
- This allows machines and vehicles that do not support
direct fluid fuel inputs to be powered by barreled fluids instead.
- The system also calculates acceleration and top-speed bonuses dynamically, based on the
fluid's power and standard rocket fuel stats.
Space Diesel
- Generates chemical recipes to process any fuel from your list into
space-diesel-fuel, maintaining the correct energy conversion ratios.
- Overrides specific icons (like oxygen) to better fit the mod's aesthetic. (this can be changed in settings)
- Automatically generates "space" filters for diesel-powered machines (with
proper fluid filters applied) as long as the mod creator adds the diesel_fuel_fluid_filter = true flag to their entity.
For modders:
Adding your machine as diesel machine
This library includes a script that creates fluid filters for machines marked as "diesel machine" The script automatically scans the entire game database (data.raw) and generates new filters for the entities.
To make the script pick up your machine (or a machine from another mod), you just need to add a single, simple flag to its definition: diesel_fuel_fluid_filter = true.
Simply inject this parameter into your chosen entity during the data.lua or data-updates.lua phase.
Example for a custom machine:
data:extend({
{
type = "assembling-machine",
name = "my-custom-awesome-diesel-assembling-machine",
-- ... rest of the standard machine parameters
diesel_fuel_fluid_filter = true, -- <<< ADD THIS LINE <<<
energy_source = {
type = "fluid",
fluid_box = {
-- fluid box definition
}
}
}
})
Example for an existing machine:
if data.raw["assembling-machine"]["calciner"] then
data.raw["assembling-machine"]["calciner"].diesel_fuel_fluid_filter = true
end
Using Barreled Diesel Fuel
This mod introduces a custom fuel category named "diesel-fuel". All the burnable barrels generated by the barrel-fuel.lua script belong to this specific category.
If you want your custom vehicles, generators, or burner machines to accept these fluid barrels as fuel, you simply need to add "diesel-fuel" to the fuel_categories of your entity's burner energy source.
IMPORTANT NOTE: Burnt Inventory Because burning a barreled fluid leaves behind an empty barrel (defined via burnt_result), your entity must have a burnt_inventory_size defined in its energy_source.
Example for a custom machine:
data:extend({
{
type = "car",
name = "my-custom-diesel-car",
-- [...] other entity properties
energy_source = {
type = "burner",
fuel_categories = {"diesel-fuel"}, -- Add "diesel-fuel" to allow it to burn the generated fluid barrels
effectivity = 1,
fuel_inventory_size = 2,
burnt_inventory_size = 2 -- <--- Must be greater than 0
}
}
})Highlights
From source dataGame versions
Built for Factorio 2.1.
Footprint
Rated a light load on a server.
License
Published under CC BY-NC-ND 4.0 .
Diesel Engine on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Factorio servers. We download it from Factorio Mod Portal, place it, and restart the server.
- Server side
- Required on the server
- Server load
- light
- Smallest plan we suggest
- Factorio — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.2.0, released 2026-09-25
Run Diesel Engine on a Factorio server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogLibraries & compatibility
Foundations and fixes other mods build on. Usually installed because something else needs it.
Runs on your server
From source side supportFactorio Mod Portal lists Diesel Engine as required on the server. Check its Factorio Mod Portal page to see whether players need it too.
Compatibility
- Game
- Factorio
- Runs on
- Serverrequired on the server
- Game versions
- 2.1
Verified at the source
- ✓Factorio Mod PortalOfficial listing, checked 2026-10-09Open ↗
- ✓AuthorTalandar99, as published on Factorio Mod Portal
- ✓LicenseCC BY-NC-ND 4.0 Free
