| 1 | = Custom Objects = |
| 2 | |
| 3 | !WorldPainter allows you to include arbitrary, custom made objects in the world. You can use this to, for instance, create forests with tree types or other vegetation that !WorldPainter (or Minecraft) doesn't support, or sprinkle buildings or artefacts around. Since these "objects" can also consist of water and/or empty space, and can be below ground, you can use them in various advanced techniques to create rivers and underground caverns or tunnels with more control than !WorldPainter allows. |
| 4 | |
| 5 | !WorldPainter currently supports three custom object formats: the bo2 and bo3 formats (as used by the [http://dev.bukkit.org/server-mods/terrain-control/ Terrain Control] mod) and the schematic format (as used by [http://www.mcedit.net/ MCEdit]). Note that the bo2 and bo3 support is limited; they can have various properties, but most of these are ignored by !WorldPainter. In particular, !WorldPainter does ''not'' support groups or branches! The only properties which are supported are {{{spawnWater}}}, {{{spawnLava}}}, {{{needsFoundation}}} and {{{randomRotation}}}. For bo3 objects random blocks and tile entities ''are'' supported. |
| 6 | |
| 7 | The way you use these objects is as follows: |
| 8 | |
| 9 | 1. Click on the + button on the Layers panel and choose "Add a custom object layer". |
| 10 | 1. Add one or more bo2 files, bo3 files or schematics to the list using the + button. |
| 11 | * Note that if you want some objects to be more prevalent than others you can adjust the relative frequency of each object, after adding it to the list, by clicking the button in the Options column or double clicking on the row. |
| 12 | 1. Type a name for the layer in the Name field. This name will be displayed on the button, so keep it short. |
| 13 | 1. Choose a colour. This is the colour with which the layer will be displayed in the editor. Choose different colours for different layers or you won't be able to keep them apart. |
| 14 | 1. Press OK and click on the new button on the Layers panel to begin painting with the layer. |
| 15 | * Note that you can paint with different intensities just like with any other layers. The higher the intensity, the more dense the objects will be. |
| 16 | * The objects will be randomly rotated and mirrored to add variety (although you can turn this off in the object options). |
| 17 | |
| 18 | == Custom Object Sites == |
| 19 | |
| 20 | There are a few web sites where you can download collections of custom objects which you can use in !WorldPainter: |
| 21 | |
| 22 | [http://www.planetminecraft.com/project/native-trees-of-europe-template-repository-1779952/ Custom Tree Repository] by Lentebriesje - a huge collection of ready to use tree objects |
| 23 | |
| 24 | [http://massivecraft.com/plugins/terraincontrol MassiveCraft] |
| 25 | |
| 26 | == Custom Objects == |
| 27 | |
| 28 | This section will contain custom objects created by !WorldPainter users. |
| 29 | |
| 30 | == Advanced Techniques == |
| 31 | |
| 32 | Custom bo2 objects don't have to be above ground and/or physical objects. They can be underground and be put to some creative uses: |
| 33 | |
| 34 | Rivers, tunnels and caves with [wiki:WyrmlordsObjects custom objects by Wyrmlord9]. |