Difference between revisions of "Circuits"

From AAGRINDER wiki
Jump to navigationJump to search
m (fixed mistake in signal length limit)
(update descriptions for some components)
Line 27: Line 27:
 
- By default, the outputs are on, emitting power with data :.
 
- By default, the outputs are on, emitting power with data :.
  
- If at least one of the inputs is on, the outputs turn off.
+
- If at least one of the inputs is on, the outputs turn off. This NOR-gate functionality allows building arbitrary logic, making AAGRINDER turing-complete.
  
- If both inputs are on, and carrying identical data, the outputs turn on and emit matching data.
+
- If both inputs are on, and carrying identical data, the outputs turn on and emit matching data. This allows comparing and filtering data.
  
 
=== trapdoor <span style="color:#91702a">_</span> ===
 
=== trapdoor <span style="color:#91702a">_</span> ===
Line 51: Line 51:
 
=== motor <span style="color:#9e2929">M</span> ===
 
=== motor <span style="color:#9e2929">M</span> ===
  
The motor accepts input data w, a, s or d, and moves in the corresponding direction, pushing other blocks in front of it. If any other input data is given, the motor moves in the opposite direction where it was powered from.
+
The motor accepts input data w, a, s or d, and moves in the corresponding direction, pushing other blocks in front of it.
 +
 
 +
Alternatively, if any other input data is given (other than w/a/s/d), the motor moves in the opposite direction where it was powered from.
  
 
The motor has a push limit of 32 blocks, but it is impossible to push certain materials, such as boulder and warp.
 
The motor has a push limit of 32 blocks, but it is impossible to push certain materials, such as boulder and warp.
Line 58: Line 60:
  
 
When pushed by a motor, magnetite sticks to surrounding blocks, including other magnetite, allowing more complicated shapes to be moved by a single motor.
 
When pushed by a motor, magnetite sticks to surrounding blocks, including other magnetite, allowing more complicated shapes to be moved by a single motor.
 +
 +
Magnetite functionality was inspired by slime block from Minecraft.
  
 
== Future additions ==
 
== Future additions ==
Line 67: Line 71:
 
The aaterminal will have inputs and outputs.
 
The aaterminal will have inputs and outputs.
  
Input data will be displayed on the player's screen, and buttons pressed by the player will be outputted as an output signal.
+
When interacted with, it will work as a basic terminal device. Keys pressed by the player will be outputted on the output wire, meanwhile input data will be displayed on the player's screen.
  
 
=== aafile ===
 
=== aafile ===
  
 
The aafile will contain a sequence of characters, which can be replayed on demand and outputted as a sequence of wire signals.
 
The aafile will contain a sequence of characters, which can be replayed on demand and outputted as a sequence of wire signals.

Revision as of 15:09, 15 May 2024

Many components can be used to build circuits in AAGRINDER.

cable

When placed, the cable physically connects to adjacent cables and other components. The cable can transmit power and data up to 16 blocks far. Every cable carrying power also carries data. This data is a single ASCII character, which originates from the power source.

wire crossing %

A wire crossing is used to cross two independent wires.

ruby R

Ruby can be used as a constant power source with data R.

switch S

The switch is a toggleable power source with data S, and can be toggled by right-clicking.

button O

The button is a source of momentary power with data O, and can be triggered by right-clicking.

gate ÷

The gate has two inputs (left and right) and two outputs (top and bottom). It can be used as a logical NOT gate, a logical NOR gate, as well as for data comparison.

- By default, the outputs are on, emitting power with data :.

- If at least one of the inputs is on, the outputs turn off. This NOR-gate functionality allows building arbitrary logic, making AAGRINDER turing-complete.

- If both inputs are on, and carrying identical data, the outputs turn on and emit matching data. This allows comparing and filtering data.

trapdoor _

The trapdoor opens when receiving any input, or when clicked

aascanner s

The aascanner has two inputs (left and right) and one output (top). When receiving an input signal, the aascanner will scan the block underneath it and output corresponding data.

aaprinter p

The aaprinter accepts input from any direction, and modifies a ? block in the opposite direction, to match the input data.

grinder G

When powered, the grinder will attempt to dig all blocks touching it, except in the direction it was powered from. Some blocks are undiggable, and some decrease durability.

Successfuly collected items are placed into an adjacent chest (diagonals included). If it is not possible to place items in a chest, they are lost.

motor M

The motor accepts input data w, a, s or d, and moves in the corresponding direction, pushing other blocks in front of it.

Alternatively, if any other input data is given (other than w/a/s/d), the motor moves in the opposite direction where it was powered from.

The motor has a push limit of 32 blocks, but it is impossible to push certain materials, such as boulder and warp.

magnetite m

When pushed by a motor, magnetite sticks to surrounding blocks, including other magnetite, allowing more complicated shapes to be moved by a single motor.

Magnetite functionality was inspired by slime block from Minecraft.

Future additions

The following blocks are planned to be added in the future:

aaterminal

The aaterminal will have inputs and outputs.

When interacted with, it will work as a basic terminal device. Keys pressed by the player will be outputted on the output wire, meanwhile input data will be displayed on the player's screen.

aafile

The aafile will contain a sequence of characters, which can be replayed on demand and outputted as a sequence of wire signals.