SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedLibraries & compatibility

Diesel Engine

by Talandar99 · for Factorio

Internal library responsible for making liquid fuel powered machines work

27KDownloads
57d agoLast updated
CC BY-NC-ND 4.0 License
2.1Latest game version

About Diesel Engine

From Factorio Mod Portal

Internal library responsible for making liquid fuel powered machines work

Discord Ko-Fi

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 data

Game 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 catalog
Listed on Factorio Mod Portal as “Mods”

Libraries & compatibility

Foundations and fixes other mods build on. Usually installed because something else needs it.

Runs on your server

From source side support

Factorio 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

Diesel Engine, answered

Generated from the mod’s own source data.

Do my players need to install Diesel Engine?

Factorio Mod Portal lists Diesel Engine as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Is it free?

Yes. Diesel Engine is free to download from Factorio Mod Portal. Its license is CC BY-NC-ND 4.0 .

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Diesel Engine on a Factorio server.

Deploy in about a minute from $2.99 a month, then add Diesel Engine in one click.