MCRedstoneSim

MCRedstoneSim copied to clipboard

Redstone Simulator v2.2

This program simulates the behavior of redstone in Minecraft.

----- Controls -----

Left click to erase tiles or activate switches. Right click to place the active material on the map. Middle click on torches or switches to change the wall they are attached to. Use the scroll wheel to select a material from the palette. Hold the control key and hover the mouse over any tile in the field for more information on it.

----- Menus -----

-- File --

New: reset field to empty 30x20x7 map.

Save/Open: save and load .rdat files to keep designs between runs of the program. You can also open .schematic files (exported by MCEdit) and .dat chunk files from the game.

Export as GIF: creates a GIF file containing the entire design, animated to show the layers (bottom to top). Each frame stays for 2 seconds.

Exit: Take a wild guess.

-- Edit --

Clone: copy parts of a map. Click once to set one corner, again to set the diagonally opposite corner (use the layer buttons to make a tall selection box), and once more to set the bottom corner of the paste region. Press Escape to stop cloning before finished. WARNING: separate torches from their blocks, chop doors in half, etc. at your own risk.

Tick - step forward in time by one "tick" - that is, the time for a torch to turn on or off from its previous state. Play - tick continually (at 10 ticks per second) Pause - stop simulation

Options...: Opens the Options dialog. (See below.)

Look and Feel: Choose another interface style from the menu if you prefer.

-- View --

Level up/down: Press these buttons (or up and down arrow keys, or W and S) to go through horizontal slices. Level 1 is ground level.

-- Adjust Size --

Adjust Size: Click this button to open a separate panel.

These 12 buttons move each face of the cuboid region in or out, creating more or less space to work in. The circled dot is an arrow pointing at you, and the circled plus is an arrow pointing away from you. If you shrink the area where you have placed components, the program will warn you, unless you hold Shift while doing so.

The two menus do the same thing, but are accessible directly through the menu, or through the numpad key combinations.

----- Options ----- There are several options in this dialog for fine-tuning the interface. In order:

Cyclic (in X and Z only) - torches, wires, power, and everything else "bleeds" over the edges and wraps around. You can even connect a torch to a block on the other side of the field!

"Natural" wire connections - A modification of Minecraft's wire connection algorithm, intended to help visualize the connections without extraneous connections. Wires only point in a direction if they are receiving power from or are powering the tile. To avoid confusion, unconnected wires form "squares" instead of crosses and singly-connected wires don't extend all the way across the tile. That way, screenshots in this mode should be distinctive enough that the different pointing direction doesn't confuse anyone who may be expecting something else.

Ground switches power blocks below - In Minecraft, there are two kinds of ground switches -- E/W, and N/S. One of them powers the block below them, and the other doesn't. This option toggles the behavior of ground switches to behave in on mode or the other.

Show only one layer / Show three layers - deselect both checkboxes for 2 layer mode. In 1 layer mode, no 2-layer palette options are available, and only 1 layer is visible. In 2 layer mode, bridges and wire-block-blocks are not visible. In 3 layer mode, all available tiles are visible.

Show bridges - Enable this option to have a wire on a gray background mean "wire over block over wire" or disable it to show "wire over block over air" instead. They cannot both be viewed simultaneously, as that would cause ambiguity.

Block type - This will be used when exporting to .schematic files. Choose which block you would like the "generic block" to actually become. (Grass/Dirt grows grass everywhere it can, and uses dirt everywhere else.)

----- Main view -----

This is where you make your design. Use the controls described earlier to draw.

Note that you actually view 2 layers at once: the level stated in the toolbar, and the one above that. this is so that you can see most 2D designs. See Palette.

----- Palette -----

Click on the buttons to select the active material, or use the mouse wheel. From left to right, the materials are:

Air: air over air Block: air over block Wire: air over wire (note that this will also place a block below, if necessary) Torch: air over torch (middle click to change orientation) Switch: air over switch Button: air over button (button lasts 10 ticks) Wire over Block Torch over Block Switch over Block Bridge: wire over block over wire (this is the only palette option that will change anything 2 levels above, but is provided for convenience in viewing and editing) Block over Wire Block over Torch Block over Switch Door: 2-high (unlike Minecraft, this door actually makes the right sounds for open and close, rather than random) Shadow: special block (see below)

Note that not all combinations of two materials stacked are represented here. In these cases (like torch over torch, switch over plate) only the bottom object will be visible (although you can always use the level up button to get a complete picture).

The shadow block appears the same color as the grid, but is functionally equivalent to air. It is good for drawing the bounds of an irregularly shaped circuit. When exported as GIF, it appears transparent.

----- Status Bar -----

Layer number: This shows what layer you are on. The numbering starts at 1 at the lowest level and goes up from there. If it is blue, you are above or at ground level. If you are underground (by using the "Back (ground) face down" menu item or button), it will be brown.

Size: Number of blocks long, wide, and high. Order is X,Z,Y (for backwards compatibility).

Location: Only visible if the cursor is over the field. Shows the X.Y.Z position of the mouse (with 0-based indices).

Redstone counts (right): Keep track of your materials budget. The red cross is the number of redstone wires placed, the torch is the number of torches, and the ore is torches + wires = the total amount necessary to mine.

This is still very much a work in progress; please PM or post to Baezon on the Minecraft Forum:

http://www.minecraftforum.net/

to report any behavior which does not match Minecraft redstone, or any bugs, feature requests, or interface ideas that might help me improve this work.