# Dustwright

> Describe, check, view and export Minecraft Bedrock redstone designs. A design is one JSON file (format rsd/1):
> layers of character grids, a legend of block specs, ports and truth-table tests. Validate it, view it in 3D,
> and export it as a function, a structure or a behavior pack.

## Docs

- [AUTHORING.md](/dustwright/AUTHORING.md): how to write a design, block by block, and the authoring loop
- [Diagnostics](/dustwright/docs/diagnostics.html): every diagnostic code and its fix
- [Bedrock mapping](/dustwright/docs/bedrock-mapping.html): every block type and state, with its Bedrock ID

## Schemas

- [rsd/1 design format](/dustwright/schema/rsd-1.json): JSON Schema for .rsd.json files
- [Diagnostics output](/dustwright/schema/diagnostics.json): JSON Schema for `rsd validate --json`

## Patterns (known-good, tested in game)

- [and-gate](/dustwright/patterns/and-gate.rsd.json)
- [hopper-sorter](/dustwright/patterns/hopper-sorter.rsd.json)
- [not-gate](/dustwright/patterns/not-gate.rsd.json)
- [observer-clock](/dustwright/patterns/observer-clock.rsd.json)
- [or-gate](/dustwright/patterns/or-gate.rsd.json)
- [piston-door-2x2](/dustwright/patterns/piston-door-2x2.rsd.json)
- [pulse-extender](/dustwright/patterns/pulse-extender.rsd.json)
- [pulse-limiter](/dustwright/patterns/pulse-limiter.rsd.json)
- [repeater-clock](/dustwright/patterns/repeater-clock.rsd.json)
- [repeater-line](/dustwright/patterns/repeater-line.rsd.json)
- [rs-latch](/dustwright/patterns/rs-latch.rsd.json)
- [t-flip-flop](/dustwright/patterns/t-flip-flop.rsd.json)
- [xor-gate](/dustwright/patterns/xor-gate.rsd.json)

## Examples

- [jeb-door](/dustwright/examples/jeb-door.rsd.json)
- [not-gate](/dustwright/examples/not-gate.rsd.json)
- [observer-clock](/dustwright/examples/observer-clock.rsd.json)
- [orientation-test](/dustwright/examples/orientation-test.rsd.json)
- [piston-door-2x2](/dustwright/examples/piston-door-2x2.rsd.json)
- [repeater-line](/dustwright/examples/repeater-line.rsd.json)
- [t-flip-flop](/dustwright/examples/t-flip-flop.rsd.json)

## Tools

- [Playground](/dustwright/play/): edit a design and see diagnostics and the 3D view live
- [Viewer](/dustwright/view/): open a design from a share link (#d= or #json=), a URL (?src=) or a file