SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWeapons, items & crafting

Item Request Proxy Events

by thremtopod · for Factorio

Utility mod for item-request-proxy events.

15KDownloads
3 mo agoLast updated
GNU LGPLv3License
2.1Latest game version

About Item Request Proxy Events

From Factorio Mod Portal

Utility mod for item-request-proxy events.

foundrygg.com Discord Gitlab Pipeline Status

This mod was designed for detecting when modules are added/removed from crafting machines by construction robots or space platforms, or when modules spoil inside a crafting machine. However, the API works for any type of item and any type of entity.

It is already possible to detect when a player directly adds/removes items from an entity with only a few events:

There are, however, no built-in events for items being added/removed by construction robots or space platforms. In order to detect these cases, this mod adds lifecycle events for item-request-proxy entities. Using this mod's API, it is possible for a mod to receive events any time an item is added or removed from an entity by construction robots or space platforms. This mod also has an API that allows mods to receive events whenever items of any registered prototype spoil.

Cases this mod does not cover:

  • Items added/removed from entities by inserters.
  • Items added/removed from entities by logstic robots.
  • Items added/removed from entities by script.
  • Proxy containers.

Item Request Proxy Events

This API allows mods to receive events for items being added/removed from entities by construction robots and space platforms.

Subscribe to Creation Events

Covers creation of all item-request-proxy entities:

script.on_event("item-request-proxy-created", function(event)
    -- Logic to run upon item-request-proxy creation
end)

Subscribe to Destruction Events

Covers both fulfillment and cancellation of all item-request-proxy entities:

script.on_event("item-request-proxy-removed", function(event)
    -- Logic to run upon item-request-proxy removal
end)

Subscribe to Update Events

__Note: This does have a small on_tick cost.__ By default, the mod checks (up to) 4 item request proxies per tick. In my local testing, the worst-case update time was ~0.085ms.

Register specific item-request-proxy entities to fire events when updated:

script.on_event("item-request-proxy-created", function(event)
    if matches_some_criteria(event) then
        remote.call("item-request-proxy-events", "register_item_request_proxy_updated", event.unit_number)
    end
end)

Subscribe to the update events:

script.on_event("item-request-proxy-updated", function(event)
    -- Logic to run upon item-request-proxy update
end)

EventData

The event data for all three event types is the same:

  • tick: int The game tick when the item-request-proxy entity was created/removed/updated.
  • name: string The name of the event.
  • unit_number: int The LuaEntity.unit_number of the item-request-proxy entity; mostly useful for deduplication and calling register_item_request_proxy_updated.
  • proxy_target: LuaEntity The entity that the item-request-proxy is targeting; after being removed, when the item-request-proxy entity itself is no longer valid, the proxy_target will still be valid. If the proxy_target entity was also removed, this wil be nil.

Item Spoiled Events

This API allows mods to receive events for items spoiling inside entities.

Register a Prototype

In the data stage:

local spoilable_items = require("__item-request-proxy-events__.spoilable-items")
spoilable_items.register_item_spoiled_event(data.raw.module["my-module"])

Subscribe to Events

In the runtime stage:

script.on_event("item-spoiled", function(event)
    -- Logic to run upon item spoiling
end)

EventData

The event data for this event is:

  • tick: int The game tick when the item spoiled.
  • name: string The name of the event.
  • entity: LuaEntity The entity in which the item spoiled (if there is no such entity the event will not be fired).

More Information

Adding to an Existing Save

When a save is loaded after this mod has been added to it, the mod will fire "catch-up" events for all existing item-request-proxy entities.

Issues

This is a new mod, and should still be considered experimental. So far it has only been tested with Rigor Module. Use at your own risk.

Highlights

From source data

Game versions

Built for Factorio 2.1.

Footprint

Rated a light load on a server.

License

Published under GNU LGPLv3.

Item Request Proxy Events 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
0.4.1, released 2026-09-03

Run Item Request Proxy Events 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”

Weapons, items & crafting

New weapons, gear, items and the recipes to make them.

Runs on your server

From source side support

Factorio Mod Portal lists Item Request Proxy Events 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-08Open ↗
  • ✓Authorthremtopod, as published on Factorio Mod Portal
  • ✓LicenseGNU LGPLv3Free

Item Request Proxy Events, answered

Generated from the mod’s own source data.

Do my players need to install Item Request Proxy Events?

Factorio Mod Portal lists Item Request Proxy Events as required on the server. Check its Factorio Mod Portal page to see whether players need it too.

Is it free?

Yes. Item Request Proxy Events is free to download from Factorio Mod Portal. Its license is GNU LGPLv3.

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 Item Request Proxy Events on a Factorio server.

Deploy in about a minute from $2.99 a month, then add Item Request Proxy Events in one click.