diff --git a/Overview.html b/Overview.html new file mode 100644 index 0000000..c0ada80 --- /dev/null +++ b/Overview.html @@ -0,0 +1,160 @@ + + + + Pipeworks + + + +

Pipeworks

+

Links

+ + +

Description

+

Pipeworks is a mod for Minetest allowing the crafting and usage of pipes and tubes. In addition to providing pipes for transporting liquids and tubes for transporting items, it also contains a number of devices for working with them. Here's what it looks like:

+ +

Pipeworks requires a recent version of Minetest. Mesecons is recommended as well for the best possible experience.

+

To install Pipeworks, simply rename the folder to "pipeworks", and drop it into one of the Minetest mod folders. For more information, see the Minetest website for a mod installation guide.

+

All parts of Pipeworks are licenced under the WTFPL.

+

Crafting recipes noted here apply only for plain Pipeworks. If Technic is installed, Pipeworks items use alternate recipes. See the Technic documentation for more details.

+ +

Fluid transport

+ +

Pipes

+

Pipes are rounded, flanged devices that can transport liquids around - by default, only water. They can automatically connect to other pipes and devices that are pipe-compatible, such as pumps and spigots.

+

Pipes transport liquids at a speed of one meter (node) per second - a run of 30 pipes will take 30 seconds to transport liquid from one end to another.

+

Digging a pipe carrying liquid drops the empty pipe - the liquid inside is lost.

+

Pipes "light up" when they contain liquid.

+

Here's how you craft it:

+ +

Spigots

+

Spigots output the liquid input via pipe into the world.

+

Spigots only connect from one side.

+

Connecting a spigot to a pipe carrying water makes water flow out of the bottom of the spigot.

+ +

Pumps

+

Pumps can be placed inside or over a water source. They are toggled on and off by being punched.

+

Pumps can be connected to pipes from above. Pipes do not connect to pumps from the side or bottom.

+

Here's how you craft it:

+ +

Valves

+ Note: currently not working (behaves as if always closed). +

Valves control fluid flow. When active, valves allow liquids to flow through them. Otherwise, liquids cannot flow through them.

+

Here's how you craft it:

+ +

Storage Tanks

+ Note: currently not working (does not store any liquid). +

Storage tanks store liquid in a compact way. Placing multiple storage tanks on top of each other forms one large tank with the same capacity as all the single tanks added together.

+

Storage tanks can be connected to pipes from above or below. Pipes do not connect to storage tanks from the side.

+

Here's how you craft it:

+ +

Gratings

+

Gratings are decorative items that appear similar to fine metal grids used as barriers.

+

Here's how you craft it:

+ +

Sealed/Airtight Pipe Entries

+

Sealed/airtight pipe entries are .

+

Here's how you craft it:

+ + +

Item Transport

+ +

Unprocessed Plastic Base

+

Unprocessed plastic base is used primarily to make plastic sheeting, which is done through the process of smelting in a furnace.

+

Here's how you craft it:

+ +

Plastic Sheeting

+

Plastic sheeting is an essential part of crafting many tube-related recipes. It is the result of smelting unprocessed plastic base in a furnace.

+

Here's how you smelt it:

+ +

Tubes

+

Tubes are boxy, transparent devices that can transport items around. They can automatically connect to other tubes and devices that are tube-compatible, such as chests and injectors.

+

Breaking a tube carrying items simply drops the items onto the ground.

+

Here's how you craft it:

+ +

Chests

+

Ordinary chests found in the default game connect to tubes from all sides.

+

Items can be added to chests using tube-related devices, or removed from them using filters/injectors.

+

Attempting to add items to a full chest results in the item being dropped onto the ground.

+

Furnaces

+

Ordinary furnaces found in the default game connect to tubes from all sides.

+ +

Fuel items can be added to furnaces from the bottom, and items to be smelted can be added from the back. Smelted items can be removed from them using filters/injectors.

+

Attempting to add items to a full furnace results in the item being dropped onto the ground.

+

Filters/Injectors

+

Filters/injectors take items from the node behind them and sends them out in front.

+

Filters/injectors act only when punched, or when activated via a Mesecons signal.

+

Right clicking a filter/injector brings up an inventory. If items are added to the inventory, only those items will be taken from the node behind it when activated. Items that match the first slot on the filter/injector's inventory are always chosen before items in the second slot, which are always chosen before the third slot, etc.

+

Filters/injectors cannot be dug if they contain any items in their inventory.

+

Here's how you craft it:

+ +

Mese Sorting Tubes

+

Mese sorting tubes are special tubes that can be used to sort items or force them to move in a certain direction.

+ +

When placed, each direction the tube has a connection to has a distinct color.

+

Right clicking the tube brings up a form similar to the following:

+ +

Each row is associated with the color on the left side.

+

The far right contains an on/off button.

+

When on, only items that match those in the row associated with the color are allowed to move in that direction. If there are no items in the row, all items are allowed.

+

When off, only items that do not match those in the row associated with the color are allowed to move in that direction. If there are no items in the row, no items are allowed.

+

Here's how you craft it:

+ +

Or alternatively:

+ +

Detector Tubes

+

Detector tubes are special tubes that output a Mesecons signal when an item passes through them.

+ +

The tubes turn off again when the item leaves.

+

Here's how you craft it:

+ +

Accelerator Tubes

+

Accelerator tubes are special tubes that transport items significantly faster than normal tubes. They appear similar to normal tubes, except with a greenish-blue tint.

+ +

Here's how you craft it:

+ +

Teleporter Tubes

+

Teleporter tubes are special tubes that move items to other teleporter tubes, regardless of the distance separating them.

+ +

Putting items into the tube via tube-related devices causes them to be teleported.

+

Right clicking a teleporter tube brings up a form allowing entry of a channel string, similar to the following:

+ +

Only teleporter tubes that have the same channel will be linked together and allow items to pass through.

+

If an item enters a teleporter tube, and there are multiple possible teleporter tubes that it can go to, a target is chosen at random from the possibilities.

+

Here's how you craft it:

+ +

Autocrafters

+

Autocrafters are devices that can automatically follow craft recipes to make new items.

+ +

Right clicking an autocrafter brings up a form similar to the following:

+ +

The slots in the top left of the form represent a crafting grid, where items can be arranged in the pattern of a craft recipe. These items are not consumed when the autocrafter operates.

+

The slots in the top right of the form are the craft results. Items that have been crafted can be found here. These can also be retrieved from the device using filters/injectors

+

The slots in the middle of the form are the autocrafter's inventory, storing the input materials. Items here are used to craft when the device operates. New items can be added here using tube-related devices.

+

The slots at the bottom of the form are the player's inventory.

+

When sufficient materials are present in the autocrafter's inventory to craft according to its recipe, the device automatically starts crafting them until it runs out of materials.

+

Here's how you craft it:

+ +

Sand Tubes

+

Sand tubes are special tubes that vacuum up free items around it. When an item drops near the sand tube, it is sucked up and sent along the tube.

+

Sand tubes have an effective radius of 2 meters (nodes). Outside of this sphere, items are unaffected.

+ +

Here's how you craft it:

+ + + \ No newline at end of file diff --git a/README b/README index fb18d4f..c16754e 100644 --- a/README +++ b/README @@ -1,5 +1,7 @@ -This simple mod uses nodeboxes to supply a complete set of 3D flanged pipes, -along with "valve" and "pump" devices. +This mod uses nodeboxes to supply a complete set of 3D pipes and tubes, +along devices that work with them. + +See "Overview.html" for detailed information about usage of this mod. Unlike the previous version of this mod, these pipes are rounded, and when placed, they'll automatically join together as needed. Pipes can go vertically @@ -14,21 +16,9 @@ windows, as if full (the two colors should also be easy to select if you want to change them in a paint program). These windows only appear on straight lengths and on certain junctions. -There are no crafting recipes, yet, but you can use /giveme as usual, namely -"/giveme pipeworks:pipe 999" or so, and then place them as needed. See -init.lua for more details. - -This mod is intended to be used as a basis or at least as sort of a model for -something else to build on (perhaps a nicer-looking oil mod?), and does not -provide any of the code necessary to cause anything to flow through them. Like -the pipes, the valve and pump don't do anything useful yet, but you can punch -them to turn them "on" and "off". Note that the valve and pump textures and -shapes are not yet complete (hence their boxy appearance). - This mod is a work in progress. Please note that owing to the nature of this mod, I have opted to use 64px textures. Anything less just looks terrible. -If you don't need the old node names from the previous version of this mod, -edit init.lua and comment-out the 'dofile' line at the top. +All parts of this mod are licensed under the WTFPL. \ No newline at end of file diff --git a/img/AcceleratorTube.png b/img/AcceleratorTube.png new file mode 100644 index 0000000..2f5e87c Binary files /dev/null and b/img/AcceleratorTube.png differ diff --git a/img/Autocrafter.png b/img/Autocrafter.png new file mode 100644 index 0000000..6f7d1bd Binary files /dev/null and b/img/Autocrafter.png differ diff --git a/img/AutocrafterForm.png b/img/AutocrafterForm.png new file mode 100644 index 0000000..9c71c2d Binary files /dev/null and b/img/AutocrafterForm.png differ diff --git a/img/CraftAcceleratorTube.png b/img/CraftAcceleratorTube.png new file mode 100644 index 0000000..6f59db0 Binary files /dev/null and b/img/CraftAcceleratorTube.png differ diff --git a/img/CraftAutocrafter.png b/img/CraftAutocrafter.png new file mode 100644 index 0000000..dfa429b Binary files /dev/null and b/img/CraftAutocrafter.png differ diff --git a/img/CraftDetectorTube.png b/img/CraftDetectorTube.png new file mode 100644 index 0000000..1331bba Binary files /dev/null and b/img/CraftDetectorTube.png differ diff --git a/img/CraftFilter.png b/img/CraftFilter.png new file mode 100644 index 0000000..430cc4e Binary files /dev/null and b/img/CraftFilter.png differ diff --git a/img/CraftGrating.png b/img/CraftGrating.png new file mode 100644 index 0000000..31e3f03 Binary files /dev/null and b/img/CraftGrating.png differ diff --git a/img/CraftMeseTube1.png b/img/CraftMeseTube1.png new file mode 100644 index 0000000..43009a9 Binary files /dev/null and b/img/CraftMeseTube1.png differ diff --git a/img/CraftMeseTube2.png b/img/CraftMeseTube2.png new file mode 100644 index 0000000..8a96be7 Binary files /dev/null and b/img/CraftMeseTube2.png differ diff --git a/img/CraftPipe.png b/img/CraftPipe.png new file mode 100644 index 0000000..855c12a Binary files /dev/null and b/img/CraftPipe.png differ diff --git a/img/CraftPipeEntry.png b/img/CraftPipeEntry.png new file mode 100644 index 0000000..2ac03b0 Binary files /dev/null and b/img/CraftPipeEntry.png differ diff --git a/img/CraftPlasticBase.png b/img/CraftPlasticBase.png new file mode 100644 index 0000000..319dfb7 Binary files /dev/null and b/img/CraftPlasticBase.png differ diff --git a/img/CraftPlasticSheeting.png b/img/CraftPlasticSheeting.png new file mode 100644 index 0000000..5d69555 Binary files /dev/null and b/img/CraftPlasticSheeting.png differ diff --git a/img/CraftPump.png b/img/CraftPump.png new file mode 100644 index 0000000..e59f483 Binary files /dev/null and b/img/CraftPump.png differ diff --git a/img/CraftSandTube.png b/img/CraftSandTube.png new file mode 100644 index 0000000..80c4d5f Binary files /dev/null and b/img/CraftSandTube.png differ diff --git a/img/CraftSpigot.png b/img/CraftSpigot.png new file mode 100644 index 0000000..69e5603 Binary files /dev/null and b/img/CraftSpigot.png differ diff --git a/img/CraftStorageTank.png b/img/CraftStorageTank.png new file mode 100644 index 0000000..7928774 Binary files /dev/null and b/img/CraftStorageTank.png differ diff --git a/img/CraftTeleporterTube.png b/img/CraftTeleporterTube.png new file mode 100644 index 0000000..34457cb Binary files /dev/null and b/img/CraftTeleporterTube.png differ diff --git a/img/CraftTube.png b/img/CraftTube.png new file mode 100644 index 0000000..198ec33 Binary files /dev/null and b/img/CraftTube.png differ diff --git a/img/CraftValve.png b/img/CraftValve.png new file mode 100644 index 0000000..169b00a Binary files /dev/null and b/img/CraftValve.png differ diff --git a/img/DetectorTube.png b/img/DetectorTube.png new file mode 100644 index 0000000..5ce1950 Binary files /dev/null and b/img/DetectorTube.png differ diff --git a/img/FluidTransport.png b/img/FluidTransport.png new file mode 100644 index 0000000..b1c0565 Binary files /dev/null and b/img/FluidTransport.png differ diff --git a/img/Furnaces.png b/img/Furnaces.png new file mode 100644 index 0000000..6742e57 Binary files /dev/null and b/img/Furnaces.png differ diff --git a/img/ItemTransport.png b/img/ItemTransport.png new file mode 100644 index 0000000..ea08d01 Binary files /dev/null and b/img/ItemTransport.png differ diff --git a/img/MeseSortingTubeForm.png b/img/MeseSortingTubeForm.png new file mode 100644 index 0000000..e3badf3 Binary files /dev/null and b/img/MeseSortingTubeForm.png differ diff --git a/img/Pipeworks.png b/img/Pipeworks.png new file mode 100644 index 0000000..59be66d Binary files /dev/null and b/img/Pipeworks.png differ diff --git a/img/SandTube.png b/img/SandTube.png new file mode 100644 index 0000000..24c455b Binary files /dev/null and b/img/SandTube.png differ diff --git a/img/SortingTube.png b/img/SortingTube.png new file mode 100644 index 0000000..9357d6a Binary files /dev/null and b/img/SortingTube.png differ diff --git a/img/TeleporterTube.png b/img/TeleporterTube.png new file mode 100644 index 0000000..bdb6ba4 Binary files /dev/null and b/img/TeleporterTube.png differ diff --git a/img/TeleporterTubeForm.png b/img/TeleporterTubeForm.png new file mode 100644 index 0000000..58e7f40 Binary files /dev/null and b/img/TeleporterTubeForm.png differ