Skip to content

Modules

Jump to bottom
desht edited this page Oct 26, 2017 · 30 revisions

Contents

Overview

Modules specify what an Item Router does. A router can have up to nine modules installed, and every router tick (which is every 20 server ticks or 1 second by default, but see Speed Upgrades), it executes every installed module once, from the leftmost module to the rightmost.

There are many module types, each of which operate on the router's buffer in a specific way. All modules have a common configuration interface, which can be accessed by right-clicking with the module in hand, or by pressing the 'C' key (configurable) or middle-clicking while the mouse is over an installed module in the item router's GUI.

By default, a module operates on a single item at a time, but this can be increased with one or more Stack Upgrades.

  1. The filter: all modules have a 9-slot filter interface where you can add ghost items.

  2. Whitelist/Blacklist toggle: when whitelisting, the module will only operate on items which match an item in the filter; when blacklisting, the module will only operate on items which don't match any item in the filter.

  3. Match/Ignore Metadata: allows matching or ignoring of items' metadata values; either the damage on a item with durability, or the metadata on items such as wool. E.g. if you select Ignore Metadata and put wool in the filter, the module will work on wool of any colour.

  4. Match/Ignore NBT: allows matching or ignoring of items' extended NBT data, e.g. enchantment data, or mod-specific data, like the charge in a battery item.

  5. Use/Ignore Oredict: allows for oredict-based matching. Vanilla example: all music discs have an Oredict equivalence; if you enable oredict matching and put any music disc in the filter, all music discs will be matched by this module.

  6. Termination: if Termination is ON, and this module succeeds in processing an item, no further modules will be executed on this router tick. Example: say the first module in the router is set to match Stone, and the second module is set to match anything - if there's a stack of Stone in the router, and you want it all to be processed by the first module (e.g. send it all in a certain direction), you would enable Termination on the first module, so as soon as the router finds a match, it stops there.

  7. Direction: most modules need a direction to operate in; e.g. to know where to send an item, which block to break, where to place a block... The default direction is None, and in most (but not all) cases a module with a direction of None will do nothing, so you will need to explicitly configure a direction here. Directions are always relative to the router's facing (except Up and Down, which are always absolute). This section will be blank for modules which don't need a direction, e.g. Sender Mk2/Mk3, Player, Void...

  8. Extras: some modules have some extra controls for configuring module-specific settings. E.g. in the above example, the Detector Module has controls for setting the redstone signal level and whether to emit a strong or weak signal. This section is blank for modules which don't have any module-specific settings.

Breaker Module

This module tries to break a block, adjacent to the router in the module's configured direction. Most blocks are breakable, although anything with an unbreakable hardness (e.g. vanilla Bedrock or End Portal) can not be broken, nor can any fluid blocks. If the block is broken, its primary drop(s) will be pulled into the item router's buffer.

  • If there's already something else in the buffer, or the buffer is full, the block will not be broken.
  • If breaking the block yields more than one type of drop (e.g. mature wheat drops both wheat and seeds), only the first drop will be pulled into the buffer and other items will be left as items on the ground. In this case, you might also want a Vacuum Module to pull in the extra drops. If there are multiple drops of the same type (e.g. redstone ore dropping several redstone dust), all stackable drops will be pulled into the buffer where possible.
  • The Breaker Module may be crafted with either a Fortune or Silk Touch enchanted book to gain those enchantments' abilities.

Detector Module

This module doesn't actually manipulate items, but instead detects specific items in the router's buffer. If the buffer contents are matched by the module's filter, it will make the router emit a redstone signal in the configured direction, or all directions if the configured direction is None. The signal level (default: 15) and signal type (default: weak) can be adjust via the module GUI.

Dropper Module

This module tries to drop an item from the router's buffer as an item entity in the world. The drop will be adjacent to the router in the module's configured direction. The item entity will be placed with a zero velocity, unlike the vanilla Dropper which adds an irritating random velocity to the item.

  • This is one of the few ways I'm aware of in modded Minecraft to drop a stack of items at a time (think bulk in-world crafting for AE2 crystal seeds...) Most dropper devices drop only a single item at a time, but the Item Router can drop up to a stack of items at a time if you use Stack Upgrades.

Extruder Module Mk1

This module extends and withdraws a row of blocks (from the router's buffer) in the module's configured direction. By default, the module extends blocks when the router has a redstone signal, and withdraws them when the router has no signal, but a Redstone Enhancement can be added to the module to customise this behaviour.

Using this module, it's possible to build large extending bridges and doorways. (If you've used the Tinker's Drawbridge from the Tinker's Mechworks mod in 1.7.10, the functionality will be familiar).

  • See also the Camouflage Upgrade, which may be useful to hide the router.
  • The default range (i.e. number of blocks which can be placed) is 12, but this can be increased up to 24 with Range Upgrades.
  • If you change the module's direction while it has blocks extended, you may get the router a little confused. In this case, breaking and replacing the router will help.
  • If you break the router while blocks are extended, it won't remember that, and you'll need to manually remove those blocks.
  • If you have multiple routers together with Extruder Modules installed (e.g. for a wide door or bridge), you may find the Sync Upgrade useful to ensure they all run on the same tick.
  • The Extruder (like the Placer) can also plant crop seeds on farmland, and cocoa beans on an adjacent jungle log.

Extruder Module Mk2

This module behaves rather like the Extruder Module Mk1, but with some important differences:

  • The Mk2 module doesn't place items from the router's buffer, but rather from a template defined within the module itself.
  • This template appears on the right-hand side of the module's GUI, has 9 slots, and can have multiple items per slot. Items placed in the template are "ghost" items.
  • Blocks extruded are "virtual" - effectively created out of nowhere, but drop nothing when broken and can't be crafted normally.
  • Therefore, this module isn't suitable for farming like the Extruder Mk1, but can be used to place doors/bridges etc. with more complex patterns than the Mk1 could.
  • The default range for the Extruder Mk2 is 24 blocks, which can be increased to 48 with Range Upgrades.

Flinger Module

This module behaves like the dropper module, except that it also imparts a configurable velocity to the dropped item, potentially throwing the item a considerable distance. You can adjust the item's speed, pitch and yaw via the module's GUI.

  • Pitch and Yaw are in degrees, relative to a base pitch or yaw.
  • If the module ejects Up or Down, the base pitch is +90° or -90°, respectively. Otherwise, the base pitch is 0°.
  • If the module ejects Up or Down, the base yaw is the router's facing direction. Otherwise the base yaw is taken from the module's direction.
  • Example: a speed of 1.0, pitch/yaw of 0°, and a horizontal module direction, will throw an item along the ground for a distance of about 7 blocks.

Fluid Module

Added in Modular Routers v1.2.0

While Item Routers can't handle fluids directly (they don't have an internal tank), they can manipulate fluids if there is a (single) fluid container item in the buffer. This includes buckets and any fluid containers added by other mods.

The Fluid Module's GUI allows the transfer direction to be set:

  • Transfer To Router means the router will try to pull fluids from an adjacent block (either a fluid in the world or a fluid-holding block) into a fluid-holding item in the buffer.
  • Transfer From Router means the router will try to push fluids from a fluid-holding item in the buffer to the world; either pouring fluid out, or putting fluid into an adjacent tank.

The GUI also allows the maximum transfer rate to be set. Note this is the maximum that will be attempted, and is still limited by the router's overall transfer rate, which is 1 bucket per second, and the transfer rate of the external fluid or fluid container.

  • The Fluid Module's filter slots will only accept fluid-containing items, and will filter by the contained fluid, not by the container item.
  • Adding Speed Upgrades will not transfer fluids any faster, only more often. A router with 9 speed upgrades will still only transfer 1 bucket per second, just more often and in smaller quantities. To increase the overall transfer rate, add Fluid Transfer Upgrades.
  • Be very careful tinkering with Fluid Module settings if the router holds any dangerous fluids, such as a lava bucket. The router will not hesitate to pour lava over you if you get it wrong...
  • Note that you can also connect fluid pipes from other mods to a router, if the buffer has a fluid container in it, and pump fluids in and out of the router. You don't need a Fluid Module installed to do this; Fluid Modules are only required if you want to actively push or pull fluids.

Placer Module

This module tries to place an item from the router's buffer as a block, adjacent to the router in the module's configured direction.

  • If the item isn't a block or the destination block is obstructed, nothing will be done.
  • Normal Minecraft placement rules are followed; e.g. sugar cane can only be placed next to water on sand/dirt.
  • Fluid blocks will be replaced, as will replaceable blocks such as tall grass.
  • The Placer module can plant seeds on farmland, and cocoa beans on an adjacent jungle log.

Player Module

This module tries to transfer items between the router and a player's own inventory. The player can be anywhere in any dimension, making this a rather powerful module.

  • The module can transfer items either from or to the player; you can set this in the module's GUI.
  • The module can operate on either the player's main 36-slot inventory, their 4-slot armor inventory, their offhand slot, or their Ender inventory (as shown by vanilla Ender Chests). This can also be set in the module's GUI.
  • Extracted/inserted items can, of course, be filtered by the module.

A good use-case for this module would be to extract ores/cobblestone/dirt etc. from the player's inventory, and send it on to the player's main storage system in their base. With a little design, it should be possible to build a system to auto-swap your armor sets (maybe even in the field, with some wireless redstone from another mod...)

The Player Module is keyed to a specific player; the item tooltip shows the owner. This is set to the player who initially crafted the module, but can be overridden by holding the module and sneak-right-clicking it. You might also need to do this if you obtained the module by other means (creative, JEI cheat mode...).

Using a Security Upgrade in conjunction with this module is probably wise on PvP servers; you don't want a hostile player stealing this module...

Puller Module Mk1

This module tries to pull the first eligible item from the adjacent inventory in its configured direction into the router's buffer. If the buffer is full or contains something that stacks with nothing in the inventory, nothing will be pulled.

Puller Module Mk2

This behaves like the Puller Mk1, but can pull items from non-adjacent inventories:

  • The inventory can be up to 12 blocks away (up to 24 with Range Upgrades).
  • Clear line of sight is not required.
  • To select the target inventory, Sneak-Right-click the target with the Puller Mk2 module in hand. You will get a confirmation message.
  • If you need to check where a Puller Mk2 is configured to, Left-click with the module in hand, and a particle effect will stream toward the target inventory (the co-ordinates of the target are also shown in the module item's tooltip).

Sender Module Mk1

This module tries to send an item from the router's buffer to an inventory in the module's configured direction:

  • The target inventory can be up to 8 blocks away (up to 16 with Range Upgrades )
  • The target inventory must be directly along the X, Y, or Z axis
  • The router must have clear line of sight to the target inventory; no opaque blocks, but blocks such as glass, fences, iron bars etc. are OK

Sender Module Mk2

This more powerful sender module tries to send an item from the router's buffer to a nearby inventory:

  • The target inventory can be up to 24 blocks away (up to 48 with Range Upgrades )
  • Clear line of sight is not required
  • To select the target inventory, Sneak-Right-click the target with the Sender Mk2 module in hand. You will get a confirmation message.
  • If you need to check where a Sender Mk2 is configured to, Left-click with the module in hand, and a particle effect will stream toward the target inventory (the co-ordinates of the target are also shown in the module item's tooltip).

Sender Module Mk3

This top-end sender module operates very much like the Mk2 Sender, but can send to any inventory (in any dimension) with no restrictions! Note: the target inventory must be chunk-loaded; Modular Routers will not do this for you.

Vacuum Module

This module scans for dropped items in a 13x13x13 cubic area around the router (i.e. up to 6 blocks in each direction), and absorbs them into the router's buffer, if possible.

  • The range can be increased up to 25x25x25 (12 blocks in each direction) with Range Upgrades. Each Range Upgrade increases the distance by 1 block, so up to 6 Range Upgrades can be usefully installed.
  • The scanned area is centered on the router if the module's direction is None. If the module has an actual direction configured, the area is offset in that direction by 6 blocks (plus one for each Range Upgrade installed). E.g. with a direction of UP, the module will only scan an area directly above the router.

Void Module

This dangerous module permanently destroys items in the router's buffer! It is strongly recommended to configure this module with a Whitelist to prevent accidental deletion of valuable items...

Clone this wiki locally