imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li

2026-08-24T08:08:27Z

Imported from legacy OpenComputers documentation at ocdoc.cil.li

New page

= Component: Generator =

This component is provided by the [[Item/generator upgrade|generator upgrade]] for robots. Generators have an internal inventory that can store one item stack of fuel items. This API allows interaction with that inventory.

Component name: `generator`. Callbacks:

* `count(): number`

<pre>The current number of fuel items still in the generator.
</pre>
* `insert([count: number]): boolean[, string]`

<pre>Inserts up to the specified number of fuel items from the currently selected inventory slot into the generator's inventory. Returns `true` if at least one item was moved to the generator's inventory. Returns `false` and an error message otherwise.
</pre>
Possible error messages are: _"selected slot does not contain fuel"_ if the selected slot has no item which can be burnt _"different fuel type already queued"_ if there is already another type of item in the generator _"queue is full"_ if there already are 64 items of that type in the generator - `remove([count: number]): boolean`

<pre>Removes up to the specified number of fuel items from the generator and places them into the currently selected slot or the first free slot after it. Returns `true` if at least one item was removed from the generator's inventory, `false` otherwise.
</pre>
== Example use: ```lua local component = require("component") -- Assuming the generator was just added to a robot and -- the selected slot contains one stack of coal: local g = component.generator -- get primary generator component print(g.count()) -- 0 g.insert(1) -- true print(g.count()) -- 0 because the item was immediately consumed, generator is running now g.insert(5) print(g.count()) -- 5 g.remove() -- remove everything from the generator print(g.count()) -- 0 g.insert() -- insert everything into the generator print(g.count()) -- 63 (minus the one consumed in the beginning) ``` ==

{{:Component/contents}}

Component/generator - Revision history

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li