View source for Documentation for “Open World Bakery” - Unreal 4 plugin

[[File:ValleyPreview.jpg|400px|thumb|right|Example Landscape - Valley]] 
== Bakery overview ==
{{#ev:youtube|Om1IW00uBKc|225|right}}
=== Functionality ===
“Open World Bakery” is an Unreal 4 plugin to generate geologically accurate heightmaps/landscapes in real time. You can use it both in the editor and at the runtime in your project. Plugin is perfectly integrated with UE4 native Landscapes and also with some 3-d party plugins (see [[#Integration with other UE4 plugins|below]]).

=== Performance ===
“Open World Bakery” utilizes multithreading and works quite fast on any modern desktop CPU with maps up to ~1024*1024. You can produce maps of any resolution (as long as your computer possesses enough memory), but it can take significant time, for example final baking of 8192*8192 map may take up to an hour even on a hi-end PC, which is acceptable during development but not of much use in the real time game.


Currently GPU isn't used for baking. After core functionality stabilizes many terrain processing steps are planned to move to GPU, so this will speed up baking up to ten times or even more (depends on GPU too). But not yet, only CPU is currently used.

=== Usage ===
[[File:BuildProgress.png|200px|thumb|right|Baking feedback]] 
You can use Bakery in the “Directive” manner, deploying manually shaped mountains and rivers at the exact positions and then (optionally) eroding the terrain. Or you can set up some (more or less - it's up to you) wide terrain generation framework to get an infinite number of realistically looking random landscapes.

Plugin provides full control of the generation process for both [https://primitive.game/OWB_cpp_Docs/ C++] and [[Bakery Blueprint reference|Blueprints]]. There is also a [https://www.youtube.com/watch?v=7e3yfHQ6GdM graphical interface] to setup and quickly preview map generation.

== Supported engine versions ==
* 4.25 - fully supported
** Tested on Win/Mac, all is fine
** Tested on Linux, runtime is fine, but I could not test Editor module due to editor instant crashing (with or without the plugin) after I create any Landscape. Should work, thou, no reasons not to.
* 4.24 - no Landscape Brush blueprints, manual build required. I'm to lazy to copy-paste blueprints back to 4.24, but generally it should all work just fine there too.
* 4.23 and older - core functionality must work if you build plugin yourself, but I do not plan to support thouse

== Examples ==
Picture's worth a thousand words, so you can find several executable and several open-source [[Open World Bakery Examples| example projects]].

You should also take a look at videos, they show plugin capabilities and some usage scenarios.

== Integration with other UE4 plugins ==
=== Native UE4 Landscape Blueprint Brush ===
Plugin relies on native UE4 Landscape [https://docs.unrealengine.com/en-US/Engine/Landscape/Editing/SculptMode/Blueprint/index.html “Blueprint brush”], so you can use Bakery out of the box inside the editor. See the video instruction on how to integrate native landscaping tools with the bakery.

{{#ev:youtube|ykXJ6cODuco|225}}

=== Voxel Plugin ===
You can use Bakery with both [https://www.unrealengine.com/marketplace/en-US/product/voxel-plugin-pro “Voxel Plugin PRO”] and [https://www.unrealengine.com/marketplace/en-US/product/voxel-plugin-free “Voxel Plugin FREE”], you only need to install a free [https://github.com/gribuser/OWB_VoxelPlugin interconnection plugin from GitHub]. See the video step-by-step video instruction on how to make theese plugins work together.

{{#ev:youtube|XyFRl53ChA4|225}}

=== Easy Voxels: Marching Cubes ===
[https://www.unrealengine.com/marketplace/en-US/product/easy-voxels-marching-cubes Easy Voxels: Marching Cubes] - you can use Bakery with “Easy Voxels”, you only need to install a [https://github.com/gribuser/OWBEasyVoxelsMC free interconnection plugin from GitHub]. See the step-by-step video instruction on how to make theese plugins work together.

{{#ev:youtube|T8eFOiF1rK0|225}}

== What's this “Geologically accurate” means, really? ==
You can watch a video, explaning the principles used by Bakery to visually approximate real geological processes.

{{#ev:youtube|sIgcW0y1e_E}}

== Water: lakes, springs, rivers ==
[[File:RiversScreen.jpg|200px|thumb|right|Stream layaut demo]] 
Plugin not only creates realistically looking terrain, but it also produces correct water heightmsp as well as flow map. So you can automatically place lakes and rivers exactly where they must be and the water flows top-down, as you would expect it in real life.