OpenSim OAR Convert to Unity Scene with Windows Interface

News 19-Nov-2016: The licence for OAR Converter was clarified on 19th November 2016 to ensure users and other developers realised this was intended to be openly and freely usable but to leave the copyright notice, author credits and liability statement intact (using a BSD style licence) via

News 11-May-2016: OARConvWin was updated to version 1.0.6 to correct an issue of the handling of the orientation of foliage on Cypress trees. It, or a later version, is available via the TUIS OARConWin Wiki Page.

News 30-Apr-2016: OARConvWin was updated to version 1.0.5 and it, or a later version, is available via the TUIS OARConWin Wiki Page. This version corrects an issue with handling greyscale images and blank textures (which are interpreted as a sphere) to describe the shape of Sculpt objects.


News 26-Oct-2015: OARConvWin was publicly released as version 1.0.4. This first version addresses all the issues discovered during testing that are reported on below.

Fumikazu -IsekiAs described in an earlier post Fumikazu Iseki at the Network Systems Laboratory of Tokyo University of Information Sciences (TUIS) (@Fumi.Hax – @fumi_hax) in Japan has created an “OAR Converter” to convert an OpenSim Archive (OAR) file into textures, meshes and terrain suitable to import into a Unity scene.

The original ran on Linux/Unix. Fumi has now also made a Windows version. A pre-release beta version (1.0.0b 24th October 2015) was tested to provide feedback.

Edinburgh/F4K in OpenSimEdinburgh/F4K in Unity

2015-10-24-OpenSim-F4K-2 2015-10-24-OpenSim-F4K-1

I converted the OpenSim Edinburgh/Fish4Knowledge project region via an OAR to Collada DAE and imported it into a “Sintel” avatar base Unity project…


When run in the Unity Web Player after conversion, this is what the region looks like…

2015-10-24-Unity-F4K-2 2015-10-24-Unity-F4K-1

Feedback on using the Windows UI version of the OAR Converter

I noted that there were a few errors on import of the DAE textures/materials from the conversion related to “Material doesn’t have a color property ‘_Emission’“.

Fumi notes:

This is a problem of selection of shader. I think that this is a bug in Unity 5.2.2. This error occurs when “Legacy Shaders/Self-Illumin/VertexLit” shader is selected in SelectOARShader.cs (in the Editor Folder). Example, if you use “Legacy Shaders/Self-Illumin/Specular” instead of “Legacy Shaders/Self-Illumin/VertexLit” the error does not occur.

So, this can be fixed by changing a line in the Unity Assets/Editor/SelectOARShader.cs file provided with the OAR Converter and that must be in place before you bring the OAR converted DAE folder alng with the associated materials and textures into the Unity project.

// Use “Legacy Shaders/Self-Illumin/Specular” instead
// of “Legacy Shaders/Self-Illumin/VertexLit” to avoid
// Material doesn’t have a color property ‘_Emission’
private const string BrightShader =
“Legacy Shaders/Self-Illumin/Specular”;

In addition, it was noted that the built in “plant” object of type “Plumeria” was not imported at all. Various other plants and trees are correctly converted though. Fumi later confirmed there were some missing assets in build 1.0.0b which were fixed in a revised version 1.0.1b which on test converted the Plumeria plants properly, as shows in this image…


Multiple Similar Textures and Materials

In the DAE conversion Textures and Materials folders you may see a number of similar looking entities, starting with the same UUIDs. This is because these materials differ in some features such as colour, glossiness, etc.


This entry was posted in OpenSim, Virtual World and tagged , , , , , , . Bookmark the permalink.

2 Responses to OpenSim OAR Convert to Unity Scene with Windows Interface

  1. bat says:

    On 12-Oct-2016 Fumikazu Iseki added some notes in response to an enquiry about using OARConv to create files suitable for import to Blender rather than Unity…

    OARconv has been designed to support the Unity for now.

    Outputed Collada files are customized for the Unity, and SelectOARShader (as Editor Extension) is required to import the Unity.

    SelectOARShader handles texture import for meshes in the Phantom folder.

    If you want to use outputted Collada files with Blender it is necessary to modify the OARConv output function.

    For countries and locales where the system uses conventions other than dot for decimal places, such as countries which use comma and dot notations, I think that should to be done in the setlocale() function for Locale.

Comments are closed.