This guide goes over some of the ways you can use the Editor Helpers plugin to build parts of your map's scenery while leveraging multiple plugin features simultaneously.

A "custom palette" is a collection of blocks, items, or macroblocks. In this step we will create a palette that contains the items we want to use randomly in our scenery.

Follow the instructions here to open the Editor Inventory window from the Openplanet toolbar.

Alternatively, if you already have another other Editor Helpers window showing, you can open it by selecting Windows | Editor Inventory in the window menubar.

In the Editor Inventory navigate to the Custom tab and expand the Edit section. Click the New Palette button to create a new empty palette below.

It will be created with default name of "Palette" so it should be renamed to something more meaningful. In the textbox next to the Set Name button enter the name Scenery Tutorial then click the Set Name button to apply it.

Now with the newly created but very empty palette, it is time to add some items.

This is done by selecting the item normally in the editor, and then pressing the "Add" button.

For this tutorial add the following items to the "Scenery Tutorial" palette:

• 1-1-2-4-1
• 1-1-2-4-2
• 1-1-1-4-4
• 1-1-1-4-5

The numbers above correspond to the numbers on editor folders.

Now that we have created the palette of items to use in the scenery, we can minimize the "Edit" controls of the Custom tab and expand the "Build" controls. This will reveal the randomizer modes: "None", "Random", and "Cycle".

Mode	Description
None	The randomizer is disabled
Random	A random element in the palette is picked whenever a block or item is placed
Cycle	The next element in the palette is picked whenever a block or item is placed. Will wrap back to the start from the end of the list

Select the "Random" randomizer mode, then begin placing items. You will notice that each time you place an item it will automatically switch your cursor to contain a new random item from your palette.

Press TAB to hide the inventory if it is blocking your view when it switches between items. You can show the inventory by pressing it again.

In the previous step using the "Random" mode you may have noticed that we didn't end up with an equal distribution of each item in the palette and there are clearly more of certain items than others. If getting an equal distribution really matters for what you are building then you need to use the "Cycle" randomizer mode.

The Cycle mode simply cycles through the items listed in your palette one by one until you reach the end, then it loops back to the start.

Select the "Cycle" randomizer mode, then begin placing items. Just like before, you will notice the item in your cursor changes each time you place an item. Although, instead of switching to a random item in the list, this time it simply cycles through the list from start to finish.

When you are finished using the randomizer, turn it off by switching the randomizer mode back to "None".

For even more randomness added into the mix, you can use the Rotation Randomizer in tandem with the random items from the palette. Since the rotation randomizer is picking a new random rotation each time you place a block or item, and the palette randomizer is picking a random item each time you place a block, you will end up with a random item that has a random rotation!

As you can see from the example, this can be used to achieve some truly wild results. I would recommend playing with the activated rotation axes of the Rotation Randomizer and the rotation angle limits to suit your scenery goals.

In this tutorial we used a custom palette which was entirely made up from Items. However, it would be entirely possible to create a custom palette that included Blocks, Macroblocks, Items, or a mixture of all three.

If you have a mixture of different kinds of objects in a palette, when the randomizer switches from one kind to another you will end up in the default placement mode for that kind of object.

If, for example, you want all your blocks to be placed in ghost mode or all your items to be placed in free ground mode, you should use the Default Block Mode function.

See the Editor Inventory reference for more information on custom palettes and the other tabs. Also, check out the reference for Rotation Randomizer to read more about how that randomizer works and what the options are. Lastly, check out the reference for Default Block Mode for more information on how to use that particular function.