Set of tool to efficiently help artists to design their game level inside Blender
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Ropy Builder Documentation


  • Write the docs
  • Unified Interface for all tools

What is Ropy Builder ?

Ropy Builder is a Blender addon designed to help artists create complex environment set and export them to their favorite game engine.

Ropy Builder is composed og two main parts : -A very basic asset manager that stores blender groups and puts them in categories. -Some scattering tools to easily populate blender scenes.


Ropy Builder needs Blender 2.79 to fully work.


Installation is quite straightforward. Download this repo as a zip file by clicking on the big green button Clone or Download. In Blender, open the User Preferences and in the addon tab, click on the install from file button. Select the zip you've just downloaded and validate.

Setting up the Database

Ropy Builder is a production tool designed for a small team that work remotely. As each member of the team can store the project's assets in a different location, we strongly recommend that the database should be stored at the root of your asset folder as illustrated in the following schema :


If it's your first use of ropy builder, you have to first initialize a database. You can do so using an operator directly in Blender. Using the spacebar search menu, type "Initialize database". A pop up menu will appear, where you can choose the location of your database and its name. It's recommended to check the option to set the database as default so it will be automatically set up in the user preferences.

When the database is set up, you can see the absolute path to the database in the addon preferences

If a database already exists, you have to set it up in the user preferences. Please note that the database only stores relative path to blend files. There is no binary data stored in the database.

When the database is set up, you can see the absolute path to the database in the addon preferences

Adding groups to the database

Once the database is set up, you can now create categories to sort your props. For each prop that you have modelled, you will have to create a Blender Group to encapsulate the props. Let's take an example : you have modelled five rocks models. For each rock, you have to create a new group in Blender. In your blend file, you'll have five groups, rock_1,rock_2, rock_3, rock_4 and rock_5.

list of groups in the current file

Next, you have to create a new category in the database to store these groups. To do so, go in the Object Menu in the Property Windows, you will find a new DataBase Management menu, where you can create categories and assign groups to it. Simply click on the Create New Category button and enter the category name.

Adding a new category

Once the category is added, you can now add each group to the category. Select the category and a group, and click on the Add to database button. Please note that, you have to save the blend file first, so that Ropy Builder can append the group into your future blend files.

Adding the group to database

Ropy builder will only store the path to the blend file, the name of the group, and its dimension. This allows a team to work collaboratively, you can create a placeholder group and add it to the database. The environment artist can then append this group and place it using the ropy builder tools in its level file.

Using Ropy Builder

When building your level, you can now use the ropy builder scattering tools to fastly add props. There are currently four operators available.

Filled Line brush

Paint brush

Fill area

Precise brush

Export your scene to Game engine

As Ropy Builder only allows you to paint Group Instances, it is very convenient to export your scenes and replace each group instance by an empty. By doing so, size of the exported file is reasonably low and each props can be exported separately. This allows a flexible workflow, as artists can populate their level in blender, export level to their game engine and replace each empty by their corresponding GameEngine props.