An input block can receive redstone signal from the block above it or from any block on its sides. An output block sends its signal to any compatible device that’s attached to its sides or to its top. Possible output devices are levers, redstone torches, powered rails, doors, trap doors, and note blocks. When the output block doesn’t have any attached devices it will directly send signal to any input pin whose block is touching the output block.
The order of the input and output blocks is very important as different pin numbers have different functions. In simple circuit structures the pin numbering starts at the chip sign onwards. The pin to the right of the sign will always come before the pin to the left. See Chip detection scanning rules below, for information on finding the order of pins in more complex structures.
A clock, counter and two synth chips connected directly to each other forming a more complex structure.
When all you need is a chip with one i/o block, a sign can be directly attached to the single i/o block without needing any extra chip blocks.
There are several commands for investigating problems.
You can destroy a chip by breaking any of its structure blocks, or by running the /rcbreak command while pointing at a circuit block. Use
/rcdestroy to destroy the chip and remove all of its blocks. Creepers, TNT explosions and fire (in case you’re using flammable blocks) will also cause the chip to stop functioning. Destroying a chip block with Power tools or worldedit commands, however, will not cause the chip to decativate until the server shutdowns, and can result in “phantom” circuits still taking place in memory. Whenever the plugin saves data invalid chips should be deactivated. Running /rcsave to force saving.
To be able to guess the pin numbering of more complex structures you need to understand how the plugin scans the chip structure once you activate one. The chip is scanned block by block starting with the sign block. The pins are numbered as the chip structure is scanned, when the structure is a straight line the numbers start at the sign onwards. When the structure is more complex it will be scanned according to the following rules:
The sign block is added to the structure and then the plugin moves to the chip block the sign is attached to.
It will try to find input, output or interface blocks at any of the other sides of the chip block and above or below. The important part is the order in which different sides are scanned. First, it will look to the right (relative to the current scan direction), next it will look to the left. After that it will look at the next block in the original direction and finally it will look back, opposite to the scan direction. Finally it checks the block above and below. If going backwards seem like a waste of time see the next point.
Now the plugin will go to the next chip block. The scan order is
One very important thing to note is that the recursive scanning process work by branches. It will continue going from block to block in one direction even when chip blocks are found in other directions. Only when it reaches a dead end it will go back to try the other branches.
For more details see the CircuitManager class.
To change any of the preferences while playing, you can use the
/rcprefs command. All values are stored in
inputBlockType- Sets the input indicator block material (
outputBlockType- Sets the output indicator block material (
interfaceBlockType- Sets the interface indicator block material (
To add specific data values use
<material name/id>:<data value> such as
wood:2 for example for birch wood. Using specific wool colors is also possible,
wool:yellow for example.
infoColor- Color of info messages (
errorColor- Color of error messages (
debugColor- Color of debug messages (
enableDestroyCommand- Enable or disable /rcdestroy command. Possible values are
signColor- Sets the text color used for the circuit name when the circuit is activated. A hex code between 0-f. 4 (red) by default.
maxInputChangesPerTick- Sets the maximum number of input pin state changes per game tick. When this limit is reached the infinite loop detector is switched on and the chip is disabled. Set to 20000 changes per tick by default.
usePermissions- When set to true the plugin will use the permission system if a permissions plugin is installed.
checkForUpdates- Determines whether the plugin will check for new versions on server startup.
To use RedstoneChips permissions you must have a permissions plugin on your server. To activate permissions support enter:
/rcprefs usePermissions true. Protected channels can be used also when usePermissions is set to false.
/rchelp <command name> displays all permission node that are associated with a command.
All commands have an “allow” and “deny” permission. The “deny” permission overrides the “allow” permission. This can be used if a user belongs to a group which allows a command that you need to explicitly deny the user.
All chips have create and destroy permissions. These also have an “allow” and “deny”, which function identically as above. Destruction protection prevents a chip from being destroyed via RC commands or by breaking the blocks that make up the circuit. The following node types can be used:
redstonechips.circuit.destroy.\*- allows destroying any circuit type.
redstonechips.circuit.destroy.deny- denies destroying any circuit type.
redstonechips.circuit.<chip-name>;- allows destroying a specific circuit type.
redstonechips.circuit.<chip-name>.deny- denies destroying a specific circuit type.
Protecting channels allow users to control who can create and destroy wireless chips on particular channels. This system is independent of the other permissions and functions even when permissions are disabled. Users can define admins for the channel, who can change who has access to the channel, and users, who can create chips using the channel, but can not change access.
/rcchannels does not show a user any channels that they do not have access to, and protected channels the user does have access to are shown with a “P” to identify they are protected.
/rcchannels <channel name> will show all authorized users and admins of the channel. Use the command
/rcprotect to manage protected channels.
redstonechips.admin: Grants access to all of RedstoneChips including admin commands.
redstonechips.*: Grants access to all of RedstoneChips excluding admin commands.
redstonechips.deny: Denys access to all of RedstoneChips.
redstonechips.command.*: Grants access to all of RedstoneChips commands excluding admin commands.
redstonechips.command.admin: Grants access to all of RedstoneChips commands including admin commands.
redstonechips.command.deny: Deny all commands.
redstonechips.circuit.*: Grants access to create and destroy all RedstoneChips circuits.
redstonechips.circuit.deny: Deny all building or destroying circuits.
Chip libraries are essentially bukkit plugins that provide RedstoneChips with new chip types. If you have a solid understanding of Java, writing your own chips should be easy enough.
These should help you get started:
Don’t hesitate to ask any question by mail or on the forum.