This Blender addon was made possible by the following list of people. Anyone can contribute to the project by sending bug reports and feature requests here. Naturally the most welcome contribution is actual code via pull requests. If you are planning to implement something "big", it's a good practise to discuss it in the issue tracker first with other authors. So that there is no overlap with other developers or the overall roadmap.
Additionally the following companies have supportted/sponsored the development efforts.
This is a fork of the original version which is no longer actively maintained. This fork is to continue mainaining support for new Blender releases and to develop the code base further with bug fixes and new functionality.
- Supports Blender 2.66 and various older versions
- For Linux, Windows and OSX
- Download official releases
- Get latest sources
Updating to new versions
If you are upgrading from a previous version of blender2ogre, and having problems, you may want to delete your old .pickle config file from
~/.blender/2.6x/config/scripts/blender2ogre.pickle and restart blender.
Using Windows .msi installer
Note: The Windows MSI installer is not available for all releases!
The addon script
io_export_ogreDotScene.py has automatically been copied to the correct place by the installer.
If the installer fails to detect a valid Blender installation for the automatic copying, it will show a dialog for the user and instructions how/where to copy it manually. The uninstall step also tries to automatically clean the script file from Blender.
Mandatory dependencies are installed to the blender2ogre install directory. The script should automatically try to find them from there and set them correctly to the addon config.
Using an .zip archive release (or raw io_export_ogreDotScene.py file)
If you are using a .zip arhive release. Extract it to disk, you will find
io_export_ogreDotScene.py inside of it.
Use Blenders interface, under user-preferences, click addons, click
install-addon, and select
Or you can simply copy
io_export_ogreDotScene.py to your blender installation under
3rd party tutorials
- Meshmoon: Video and text instructions how to install and use blender2ogre addon. See http://doc.meshmoon.com/index.html?page=from-blender-to-meshmoon-part-1
Enabling the blender2ogre addon
- After installing the addon enable it in Blender from
User Preferences > Add-Ons > Import-Export. Search for
ogreand check the box on the right. Remember to save as default if you want the addon to be enabled after you exit your Blender.
- Integrated help docs will be shown in the upper right hand toolbar, replacing blender's normal
Helpmenu, read them for assistance.
This exporter writes Ogre mesh and skeleton files as XML
[.mesh.xml, .skeleton.xml]. In order for the tool to create binary assets from them
[.mesh, .skeleton], you need the
OgreXMLConverter command line tool that is provided by the Ogre project.
- Download the latest Ogre Command-line tools
- Install to the default location.
Setting tool pathssection to configure the tool, if binary assets
[.mesh, .skeleton]are not succesfully generated when exporting.
- Install the package
ogre-toolsif your distro provides it. For example on Ubuntu
apt-get install ogre-1.8-tools
- Or get Ogre sources, run CMake,
make && make install. This should build
- Download the latest pre-built SDK or build ogre from sources. If you build from sources the needed tools will be in
- Copy the OgreXMLConverter file to your
/usr/binfolder. It's a hidden folder, so, to do that, open Terminal and enter the following commands
open .Finder will open on the
- Drag the
OgreMeshConverterfile over to that folder
Ogre.framework. If you build from sources it will be in
<Ogre Folder>/build/lib/Release. The
Ogre.frameworkshows as a "folder". Copy
Setting tool paths section on how to configure the optional tools if default paths fail to find them.
- Install Image Magick to the default location.
- Windows Get the latest Ogre Meshy and install to the default location. See the "Setting tool paths" section. Prefer using the 64-bit OgreMeshy for 64-bit Windows.
- Linux / Mac OSX Get Ogre Meshy for Windows, install wine, extract OgreMeshy to
NVIDIA Texture Tools 2.0 with CUDA acceleration
- Note: NVIDIA DDS, if you can not install "NVIDIA Texture Tools 2.0" above, you can still use Legacy Utils
Tundra is a 3D virtual world platform that uses Ogre3D for rendering. This plugin can export the Tundra scene format
.txml directly along with the Ogre binary assets. Those scenes can be easily loaded and viewer by Tundra. Tundra also supports drag and drop imports for the Ogre scene file
- Windows and Mac OSX Download and install the latest Tundra
- Linux For Linux there are no binary installers, build from sources with these instructions.
Setting tool paths
You can change the required and optional tool paths in Blender when you see the need for it. This usually needs to be done if you failed to install the tools to the default paths, or they cannot be found from the default paths.
- In Blender go to
Properties > Scene > Ogre Configuration File
- Edit the required tool paths
update config fileto store the new config. You may need to restart Blender for the changes to take effect.