Skip to content

Getting Started

Lilly Tempest edited this page Nov 18, 2021 · 2 revisions

Open the editor

Creating templates is quite easy. Make sure that you stand on a memorable spot. You will need to stand on this spot when you export in the end. So take a spot at the corner or the center or your structure.
/schemtemp create <name>
Will open a template editor to create your template.

Everything which looks like [text] are buttons and will run commands or suggest them for completion.
Press on the [Show] button to verify that your origin is correct. Changing it later will be a bit tricky.
If you wanna change it go on the correct position and press [Update]

Template structure

Templates are holding multiple types which are holding multiple variants of the type.

For example if we have a room like this:

We can decompose this into 5 types.

  • Four corners
  • Two doors where one is closed and one is open
  • One center
  • One roof
  • One floor

In the end we have a structure like this:

  • corner
    • flat
    • low
    • medium
    • high
  • door
    • open
    • closed
  • center
    • normal
  • roof
    • normal
  • floor
    • normal

Adding types and variants

Lets start with adding the corners
We press on the add button and complete the comand by typing corner as our type.
Next we mark our first corner, press the add button again and type the name of our variant.

You can change the rotation and flip with the [Edit] button. The rotation is counter clockwise.
Now repeat the same with the other four corners by pressing [Back], changing the selection and pressing [Add] again all the time.
When you are done you should have four variants.\

Use the [Show Selections] button to verify that all your selections are as you wish.

Now repeat these steps with the other types and variants.

Saving and editing

To save your template use the [Save] button on the template overview.

You can edit the template with the schemtemp edit <name> command.

Creating a namespace

To decompose and export your structure we need to create a namespace and link it with our template.

Once a template is assigned to a namespace it is recommended to not change it again, so make sure that everything is like you want.

Use schemexp namespace add <name> <template> to add a new namespace and associate it with your template.

Now we can use the namespace to export our structure.

Make sure that you stand on the origin. you can check this with schemexp namespace show <name>. My reference point was the green block on the floor.

Now stand on your origin point and use schemexp export <namespace>

Your structure is now saved with your namespace and a unique id.

You can check your exported schematics with schemexp paste <namepsace> <id>. Schematics will be pasted in your view direction and are expanding to the right.

Advanced Usage

Overriding schematics

schemexp export <namespace> <id> -f overrides an already exported id.

Modify pasting

You can modify the gaps between the pasted schematics. The values can be changed in the config and with flags on the paste command.
-r [num] changes the row offset
-c [num] changes the column offset
-m [num] changes the offset between id pastes when using batch pasting

Batch pasting

schemexp paste <namespace> pastes all schematics of a namespace.

Use -g types to group types and variants together or -g id to post every id together.

Clone this wiki locally