digicontrol/README.md

64 lines
3.2 KiB
Markdown
Raw Normal View History

2021-01-23 11:52:22 +01:00
# Digilines Control [digicontrol]
2021-01-29 07:42:48 +01:00
[![luacheck](https://github.com/OgelGames/digicontrol/workflows/luacheck/badge.svg)](https://github.com/OgelGames/digicontrol/actions)
2021-01-23 11:52:22 +01:00
[![License](https://img.shields.io/badge/License-MIT%20and%20CC%20BY--SA%204.0-green.svg)](LICENSE.md)
[![Minetest](https://img.shields.io/badge/Minetest-5.0+-blue.svg)](https://www.minetest.net)
2021-08-20 11:01:30 +02:00
[![ContentDB](https://content.minetest.net/packages/OgelGames/digicontrol/shields/downloads/)](https://content.minetest.net/packages/OgelGames/digicontrol/)
2021-01-23 11:52:22 +01:00
2021-01-29 07:42:48 +01:00
## Table of Contents
- [Overview](#overview)
- [Nodes](#nodes)
- [Usage](#usage)
2021-01-29 07:42:48 +01:00
- [Dependencies](#dependencies)
- [Installation](#installation)
- [License](#license)
## Overview
This mod adds nodes to control the flow of digiline messages in various ways, and is designed to be a more streamlined replacement for [`digiline_routing`](https://github.com/numberZero/digiline_routing).
2021-02-14 06:25:36 +01:00
![Overview Screenshot](images/overview.png?raw=true "Overview Screenshot")
2021-01-29 07:42:48 +01:00
## Nodes
- **Filter** - only lets messages with the correct channel pass through.
- **Limiter** - limits the rate at which messages can pass through.
- **Diode** - only lets messages pass through in one direction.
- **Splitter** - splits messages into two branches, and stops messages going between the branches.
- **Tri-Splitter** - same as Splitter, but splits into three branches.
## Usage
Digicontrol nodes are designed to be as simple to use as possible. The Diode, Splitter, and Tri-Splitter are similar to mesecons logic gates; they work without any setup.
The Filter can be right-clicked to set the channel it will filter. If left blank it will allow all messages to pass through, if a channel is specified, it will only let messages on that channel through, blocking all others.
![Filter Formspec](images/filter_formspec.png?raw=true "Filter Formspec")
The Limiter can also be right-clicked to set the rate at which messages can pass through. A value of 1 or higher will allow that number of messages to pass through per second, blocking further messages. A value of 0 blocks all messages, and a value of -1 allows an infinite number of messages.
![Limiter Formspec](images/limiter_formspec.png?raw=true "Limiter Formspec")
2021-01-29 07:42:48 +01:00
## Dependencies
**Required**
- `default` (included in [Minetest Game](https://github.com/minetest/minetest_game))
- [`digilines`](https://github.com/minetest-mods/digilines)
**Optional**
- [`basic_materials`](https://gitlab.com/VanessaE/basic_materials)
- `mesecons_materials` (included in [`mesecons`](https://github.com/minetest-mods/mesecons))
## Installation
2021-12-11 04:14:22 +01:00
Download the [master branch](https://github.com/OgelGames/digicontrol/archive/master.zip) or the [latest release](https://github.com/OgelGames/digicontrol/releases), and follow [the usual installation steps](https://dev.minetest.net/Installing_Mods).
Alternatively, you can download and install the mod from [ContentDB](https://content.minetest.net/packages/OgelGames/digicontrol) or the online content tab in Minetest.
2021-01-23 11:52:22 +01:00
## License
Except for any exceptions stated in [LICENSE.md](LICENSE.md#exceptions), all code is licensed under the [MIT License](LICENSE.md#mit-license), with all textures, models, sounds, and other media licensed under the [CC BY-SA 4.0 License](LICENSE.md#cc-by-sa-40-license).