diff --git a/README.md b/README.md index 8f4966a..7284ab1 100644 --- a/README.md +++ b/README.md @@ -144,7 +144,7 @@ All meshes will be finally stored in the mod's folder - this means that _all_ wo # Dealing with matrices -Matrix files record only the colors of your build and as such will only use wool blocks to rebuild your creations when imported. +Matrix files record only the colors of your build and as such will only use wool blocks to rebuild your creations when imported in normal mode. Other modes are explained here below. When importing a matrix file it must match the size of the canvas you're currently interacting with. If the size doesn't match, the mod will display a message in the chat saying that and will do nothing. I plan on improving this by storing the size of the matrix itself in the filename. @@ -156,11 +156,17 @@ You can select three different modes to import the matrices: - `Invert`: the negative version of the matrix will be filled with whatever node you enter in the textarea - `Mononode`: uses the entered nodename to import the matrix instead of the original colors -`Mononode` can be checked or unchecked in `Invert` mode, it makes no difference. +`Mononode` can be checked or unchecked in `Invert` mode, it makes no difference. + +![Import matrix](/screenshots/import-matrix.png) You can also completely fill the canvas space using the `Fill/Empty Canvas` button with whatever node, including air. -Finally, matrices can be accessed and rebuilt immediately, without the need for restarting the world. This means that you can use this feature to blueprint something and rebuild it with wool blocks right away as many times as you want, then go to "Manage meshes" and delete such temporary capture to avoid adding any new meshes to your library. +![Fill canvas](/screenshots/fill-canvas.png) + +Finally, matrices can be accessed and rebuilt immediately, without the need for restarting the world. This means that you can use this feature to blueprint something and rebuild it with wool blocks right away as many times as you want, then go to `Manage meshes` and delete such temporary capture to avoid adding any new meshes to your library. + +[Here are some examples](/examples.md) explaining how to use some of the above features. # Specifying custom properties In the `.obj.dat` file of each mesh you'll find something like this: diff --git a/examples.md b/examples.md new file mode 100644 index 0000000..e69de29 diff --git a/screenshots/auto-collision-box-2.png b/screenshots/auto-collision-box-2.png index 69593bb..13d2ae5 100644 Binary files a/screenshots/auto-collision-box-2.png and b/screenshots/auto-collision-box-2.png differ diff --git a/screenshots/auto-collision-box.png b/screenshots/auto-collision-box.png index 65b5d37..1f1115f 100644 Binary files a/screenshots/auto-collision-box.png and b/screenshots/auto-collision-box.png differ diff --git a/screenshots/examples/carved-wool-cube.png b/screenshots/examples/carved-wool-cube.png new file mode 100644 index 0000000..466a912 Binary files /dev/null and b/screenshots/examples/carved-wool-cube.png differ diff --git a/screenshots/examples/delete-temporary-capture.png b/screenshots/examples/delete-temporary-capture.png new file mode 100644 index 0000000..afe848c Binary files /dev/null and b/screenshots/examples/delete-temporary-capture.png differ diff --git a/screenshots/examples/digging-tunnel.png b/screenshots/examples/digging-tunnel.png new file mode 100644 index 0000000..f8a5b0a Binary files /dev/null and b/screenshots/examples/digging-tunnel.png differ diff --git a/screenshots/examples/fill-with-air.png b/screenshots/examples/fill-with-air.png new file mode 100644 index 0000000..2f44dec Binary files /dev/null and b/screenshots/examples/fill-with-air.png differ diff --git a/screenshots/examples/filled-with-air.png b/screenshots/examples/filled-with-air.png new file mode 100644 index 0000000..dc922ed Binary files /dev/null and b/screenshots/examples/filled-with-air.png differ diff --git a/screenshots/examples/filled-with-water.png b/screenshots/examples/filled-with-water.png new file mode 100644 index 0000000..59e93df Binary files /dev/null and b/screenshots/examples/filled-with-water.png differ diff --git a/screenshots/examples/first-tunnel-section.png b/screenshots/examples/first-tunnel-section.png new file mode 100644 index 0000000..480f181 Binary files /dev/null and b/screenshots/examples/first-tunnel-section.png differ diff --git a/screenshots/examples/frozen-acacias.png b/screenshots/examples/frozen-acacias.png new file mode 100644 index 0000000..a0d6720 Binary files /dev/null and b/screenshots/examples/frozen-acacias.png differ diff --git a/screenshots/examples/halfway-staircase-one.png b/screenshots/examples/halfway-staircase-one.png new file mode 100644 index 0000000..761c942 Binary files /dev/null and b/screenshots/examples/halfway-staircase-one.png differ diff --git a/screenshots/examples/halfway-staircase-two.png b/screenshots/examples/halfway-staircase-two.png new file mode 100644 index 0000000..d4fe2b2 Binary files /dev/null and b/screenshots/examples/halfway-staircase-two.png differ diff --git a/screenshots/examples/head-down.png b/screenshots/examples/head-down.png new file mode 100644 index 0000000..c391a31 Binary files /dev/null and b/screenshots/examples/head-down.png differ diff --git a/screenshots/examples/hollow-matrix-with-air.png b/screenshots/examples/hollow-matrix-with-air.png new file mode 100644 index 0000000..a0e4853 Binary files /dev/null and b/screenshots/examples/hollow-matrix-with-air.png differ diff --git a/screenshots/examples/lonely-acacias.png b/screenshots/examples/lonely-acacias.png new file mode 100644 index 0000000..ba0a563 Binary files /dev/null and b/screenshots/examples/lonely-acacias.png differ diff --git a/screenshots/examples/multiple-tunnel-sections.png b/screenshots/examples/multiple-tunnel-sections.png new file mode 100644 index 0000000..cffe534 Binary files /dev/null and b/screenshots/examples/multiple-tunnel-sections.png differ diff --git a/screenshots/examples/staircase-down.png b/screenshots/examples/staircase-down.png new file mode 100644 index 0000000..8ef06df Binary files /dev/null and b/screenshots/examples/staircase-down.png differ diff --git a/screenshots/examples/wool-cube.png b/screenshots/examples/wool-cube.png new file mode 100644 index 0000000..3dff933 Binary files /dev/null and b/screenshots/examples/wool-cube.png differ diff --git a/screenshots/fill-canvas.png b/screenshots/fill-canvas.png new file mode 100644 index 0000000..7a23ee9 Binary files /dev/null and b/screenshots/fill-canvas.png differ diff --git a/screenshots/import-matrix.png b/screenshots/import-matrix.png new file mode 100644 index 0000000..d0fec70 Binary files /dev/null and b/screenshots/import-matrix.png differ diff --git a/screenshots/non-wool-capture.png b/screenshots/non-wool-capture.png index 3fa1e3a..fe0eb50 100644 Binary files a/screenshots/non-wool-capture.png and b/screenshots/non-wool-capture.png differ diff --git a/screenshots/prompt-name.png b/screenshots/prompt-name.png index bc2f764..95aa590 100644 Binary files a/screenshots/prompt-name.png and b/screenshots/prompt-name.png differ diff --git a/screenshots/save-confirm.png b/screenshots/save-confirm.png index 9d8778f..59a49f2 100644 Binary files a/screenshots/save-confirm.png and b/screenshots/save-confirm.png differ