# Energy

{% hint style="warning" %}
This page is a work in progress. Information may not be accurate.
{% endhint %}

## Energy System

### Overview

![energy-net-example](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

Some STB items and blocks require energy to operate; units of this energy are called _SCU_ - Sensible Charge Units. There are a couple of ways of charging an item or block:

* Chargeable blocks usually have a slot for an [energy cell](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/energy#energy-cells) in their GUI; you can install a cell into the block to charge it. Note that blocks usually also have a Charge Direction button next to the cell slot; make sure this is configured to send charge in the right direction.
* Chargeable blocks can also be connected via _cables_ to other blocks; some blocks supply charge (e.g. Heat Generator, Basic Solar Cell), some blocks demand charge (Smelter, Masher...), and some blocks can both supply _and_ demand charge (Battery Box).
* An energy cell can be used to charge certain items: with the item you want to charge in your hotbar, and the energy cell in your hand, press and hold the right mouse button, and charge will transfer from the cell to the item.

As an idea of how much 1 SCU is worth, 1 lump of coal will produce 1800 SCU when burnt in a Heat Generator (see below). It takes 120 SCU for a Smelter to smelt a block of iron ore into an ingot; so one lump of coal will smelt 15 ingots; nearly twice as efficient as a vanilla furnace. However, you also want to run ores through a Masher to double the ingot output, which also requires 120 SCU per ore. So to turn one iron ore into two iron ingots via the Masher -> Smelter ore doubling process requires 240 SCU; slightly more energy per ore than vanilla smelting, but double the output. (Gold, being softer than iron, requires a little less energy in the Masher).

### Energy Nets

An _energy net_ is basically any collection of charge suppliers and charge consumers linked together by cabling.

* Use the vanilla Iron Fence block for cabling.
* Charge is not transferred through machines, only through cabling.
* All chargeable blocks can be on zero or more energy nets. It is possible for a block to receive or supply charge to multiple nets (and this is a common case for battery boxes).
* Linking two separate energy nets with cabling will create a single new unified energy net.
* Breaking an energy net by cutting cabling will create two (or maybe more) new separate energy nets.

Energy nets "tick" periodically, and attempt to balance out the charge demanded against the available charge supply. During the tick, charge is moved from blocks which can supply it to blocks which need it; the available charge is distributed as equally as possible. The default tick period is every 10 server ticks, or twice per second.

### Energy Cells

#### 10K Energy Cell

![recipe-10k-cell](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

This basic energy cell can store up to 10,000 SCU, and can transfer its charge at a maximum of 100 SCU/tick.

#### 50K Energy Cell

![recipe-50k-cell](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

This second-tier energy cell can store up to 50,000 SCU, and can transfer its charge at a maximum of 500 SCU/tick. Note that (as of v0.0.4) it requires [Energized Iron Ingots](components) to craft.

### Battery Boxes

#### 10K Battery Box

![recipe-10k-batbox](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

This basic battery box can store up to 10,000 SCU and transfer energy at maximum of 100 SCU/tick. _Added in v0.0.4_

#### 50K Battery Box

![recipe-50k-batbox](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

This second-tier battery box can store up to 50,000 SCU and transfer energy at maximum of 500 SCU/tick. To configure a battery box's operation, right-click to open its GUI:

![batbox-gui](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

1. You can place an energy cell here to charge or discharge
2. These six buttons (around the central batbox icon) allow configuration of charge direction: each face of the block can supply charge, receive charge, or do neither.
3. These are the Redstone, Public/Private, and Charge Indicator buttons common to many STB blocks.

### Generators

#### Heat Engine

![recipe-heat-engine](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

This generator can turn a variety of burnable items into energy. Different items provide varying quantities of energy, and have varying burn times:

| Item         | SCU   | Burn Time (server ticks) |
| ------------ | ----- | ------------------------ |
| Coal         | 1800  | 120                      |
| Charcoal     | 1200  | 80                       |
| Coal Block   | 16800 | 960                      |
| Blaze Rod    | 2700  | 180                      |
| Blaze Powder | 675   | 30                       |
| Logs         | 400   | 40                       |
| Planks       | 100   | 20                       |
| Sticks       | 50    | 20                       |
| Fire Charges | 1000  | 20                       |

Notes:

* Fire charges produce a lot of SCU very quickly (1000 SCU per second)
* Coal blocks are slightly (3.7%) more efficient than the 9 lumps of coal used to create them (the SCU/tick is the same, but they burn a little longer).
* The Heat Engine has an internal storage cell of 5000 SCU, and can transfer its charge at a maximum of 50 SCU/tick.
* If the Heat Engine's internal cell is more than 75% full, the engine's burn rate is progressively reduced to conserve fuel.
* If you install a [Regulator Upgrade](machines) in a Heat Engine, it will only start burning a fuel item if there is definitely enough room in its internal SCU buffer to store the SCU that would be generated; this can save a lot of fuel in the long run.

#### Bio Engine

![recipe-bio-engine](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

This engine can convert various organic Materials into energy.

| Item          | SCU  | Burn Time (server ticks) |
| ------------- | ---- | ------------------------ |
| Rotten Flesh  | 180  | 60                       |
| Spider Eye    | 210  | 60                       |
| Bone          | 180  | 60                       |
| Ink Sack      | 240  | 60                       |
| Slime Ball    | 480  | 80                       |
| Sapling       | 360  | 60                       |
| Leaves        | 240  | 40                       |
| Tall Grass    | 320  | 80                       |
| Apple         | 1000 | 100                      |
| Melon Slice   | 1000 | 100                      |
| Melon Seeds   | 1000 | 100                      |
| Melon         | 9000 | 900                      |
| Pumpkin       | 1000 | 100                      |
| Pumpkin Seeds | 1000 | 100                      |
| Wheat         | 1000 | 100                      |
| Seeds         | 1000 | 100                      |
| Carrot        | 1000 | 100                      |
| Potato        | 1000 | 100                      |
| Sugar Cane    | 800  | 100                      |
| Nether Wart   | 1680 | 140                      |
| Dirt          | 10   | 20                       |
| Grass         | 10   | 20                       |
| Flower        | 880  | 80                       |
| Mushroom      | 880  | 80                       |
| Vine          | 640  | 80                       |
| Cactus        | 800  | 100                      |
| Lilypad       | 640  | 80                       |

#### Magmatic Engine

![recipe-magmatic-engine](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

This Engine produces 16000 SCU in total (16 SCU/t for 1000 Ticks) and runs on Lava Buckets

#### Basic Solar

![recipe-basic-solar](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

This generator produces a steady trickle of up to only 0.5 SCU/tick. It has an internal storage cell of a measly 100 SCU, and can only transfer energy at a maximum of 5 SCU/tick.

#### Dense Solar

![recipe-dense-solar](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

Eight Basic Solars and an [Integrated Circuit](components) are required to craft.

This tier 2 generator produces a steady trickle of up to 4.0 SCU/tick. It has an internal storage cell of 240 SCU, and can transfer energy at a maximum of 12 SCU/tick. _Added in v0.0.4_

Solars require sunlight to run on. There needs to be clear view of the sky (glass above is OK), and it must be day time. It will produce energy as long as the light level is 12 or greater, but requires light level of 15 for optimum efficiency:

| Light Level | SCU/tick (Basic) | SCU/tick (Dense) |
| ----------- | ---------------- | ---------------- |
| 15          | 0.5              | 4.0              |
| 14          | 0.375            | 3.0              |
| 13          | 0.25             | 2.0              |
| 12          | 0.125            | 1.0              |
| 11 or under | 0                | 0                |

**PV Cells**

As of v0.0.4, Solars require a PV cell to be installed, which must be crafted separately:

![recipe-pv-cell](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

Note that a [Silicon Wafer](components) is required to craft.

A PV cell is fairly long-lived: it provides 180 (real) minutes of power generation (note that PV cell lifetime is only consumed when power is actively being generated). Once its lifetime is over, a new PV cell must be crafted.

It should be noted that [Item Routers](routing) can be used to insert and extract PV cells to/from the Solar, adding automation possibilities...

### Consumers

There are several different types of charge consumer, and they are documented on their own pages:

* See [Machines](machines) for a list of the different processing machines
* See [Items/Storage](storage) for a description of the HSU (HyperStorage Unit), which needs a small amount of energy to operate

### Utilities

#### Power Monitor

![recipe-power-monitor](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

The Power Monitor will show you the Net Gain/Loss of your Energy Net on an attached Sign. It needs to be directly adjacent to a part of your Energy Net (preferably a Cable). Above or Below a Cable will not work. It has to be on a Side. Examples: -263 SCU/t + 32.1K SCU/t

#### Holographic Monitor

![holographicmonitor](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

Since version 1.1 a new type of power monitor has been added.

The Holograpic Monitor utilizes [HolographicDisplays](http://dev.bukkit.org/bukkit-plugins/holographic-displays/) to display the Net Gain/Loss, otherwise it will not display anything. An example of it can be found here:

![holograpicmonitor-example](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

#### Multimeter

![recipe-multimeter](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-f1101353487f91dead813c7c7de1a3381554426a%2FWIP2.png?alt=media)

This little device is useful for basic energy net analysis:

* Right-clicking any cable will display:
  * The number of cables in this energy net
  * The number of charge suppliers (sources) and charge consumers (sinks) on this energy net
  * The charge available (instantaneous measurement at the last energy net tick)
  * The charge demanded (instantaneous measurement at the last energy net tick)
* Right-clicking any chargeable block will display:
  * The number of energy nets to which the block is connected
  * The block's current charge level and max charge transfer rate

![multimeter-display](https://2230937003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds7aHdIFHflqDb6wMwxU%2Fuploads%2Fgit-blob-b77ce1a7bc5a8d1bf302b613427029d710020419%2FWIP.png?alt=media)

As a bonus, the multimeter comes with a free clock!
