Page 1 of 1

Blender 2.79 Re-Volt Add-on

Posted: Mon Dec 04, 2017 11:41 pm
by Marv
This add-on is intended to be used with Blender 2.79b.

Download and Documentation

GitHub page


Import and Export Meshes (.prm/.m):
Mesh, UV, vertex colors, texture, face properties and lods (level of detail)

Import Cars from parameters.txt:
Import the car model and wheels from parameters.txt files.

Import and Export World (.w):
Import and export Re-Volt level mesh files including boundary boxes, environment colors and texture animations.

Import and Export Collision (.ncp):
Import and export Re-Volt collision files, properties and materials.

Import and Export Instances (.fin):
Import and export Re-Volt instance files and tweak their properties.

Mesh Editing Tools:
Edit face properties, vertex colors and texture animations.

Generate Shadows:
Generate shadow textures and coordinates for in-game use with just one click.

Generate Texture Animations (World):
Create A-to-B or grid animations easily.

Shade Meshes:
Shade meshes by baking light to vertex colors with just one click.

Re: Blender 2.79 Re-Volt Add-on

Posted: Sat Dec 09, 2017 2:16 pm
by Marv
Added an important note to the first post. Due to a Blender bug and a new feature, I had to update the add-on. Since the add-on now only works with a nightly build of Blender, there won't be a new version release in a while.

EDIT: No longer relevant. Blender 2.79a gets rid of the bug.

Re: Blender 2.79 Re-Volt Add-on

Posted: Sun Feb 25, 2018 2:51 pm
by Marv
I just released version 18.0225 of the add-on.

Download and documentation:

  • NCP: *Only export selected* option added (check the documentation for details)
  • Rewrote the parameters.txt parser, should now load all cars
  • The light panel now only shows up if at least one object is selected
  • New system for handling import and export errors

Have fun testing this one out. Please report any bugs or post feature requests in this forum thread. (Or even better, raise an issue on GitHub.)

Let me explain the two most important changes:


This is a feature that some track makers requested. Up until now, you only could export the entire scene as NCP.
This new option allows you to mark only one or many objects for export.


This is an example of a normal scenario of exporting collision objects for a track:
Let's say the cubes are some detail models and the ground plane is your track's mesh.


The exported NCP file would look exactly the same way. All objects are offset from the center.

However, if you want to export your detail objects as separate files (PRM instances), you will also have to export their collision to separate NCP files.
To export the collision of one single object, just enable the setting:


and then select the object in question and export as ncp.


After importing that file again, you will notice that the object is going to be at the very center again. This is exactly what happens when you export a single PRM mesh.


And that way you can easily export the collision for your PRM instances.


I rewrote the parameters.txt completely to work just like the one used in Re-Volt. That way you can import all cars that RVGL would load as well.
As an addition, it will warn you about any errors in the parameters.txt you loaded. Patriot, for example, is missing a final closing brace } in its parameters file:


The car will still be imported with the values that could be read. In this case nothing went horribly wrong but it will still prompt you a bout it so you can fix it.

Keep in mind that parameters.txt files will also be loaded to find out a car model's texture, even when you're only importing the body or wheels.

Re: Blender 2.79 Re-Volt Add-on

Posted: Mon Apr 30, 2018 11:10 am
by Marv
New version:

+ Download
+ Installation
+ Documentation

This Version requires Blender 2.79b.

Topics: Instance (.fin), UI, Bugfixes

- Instances (.fin): Export (full support)
- Select by name button in the Instances panel that allows users to select all objects with a similar name
- Mark as Instance button in the Instances panel that sets the instance properties on all selected objects
- Batch baking feature for instance RGB in the Instances panel
- Initial hull support: Import (unfinished)

- Textures are now loaded when importing a mesh from the custom folder (reported by Gotolei)
- Ensure that NCP layers exist when exporting: All Material layers and Type layers are now kept. This fixes missing materials when exporting NCP. (reported by LoScassatore, Gorgonzola)
- Export of textures with suffixes like .bmp.001 (reported by Boy80)

- Moved the instances helper section to a dedicated Instances panel.
- Objects marked as instance (*Is Instance*) will no longer be exported when exporting to .w, use .fin instead
- Fixed all Re-Volt panels to the top (object and scene properties) so they're easier to find. This makes the add-on a lot more intrusive but most people using this add-on use Blender exclusively for Re-Volt.
- Message boxes for confirming actions in the helpers panel
- Texture number face property only shows when Use Number for Textures option is enabled
- Prefer Solid Textured Mode is now disabled by default

Re: Blender 2.79 Re-Volt Add-on

Posted: Tue Jun 19, 2018 7:30 am
by Marv
Hey guys,

some people experienced problems with CTRL+Z: Blender would crash whenever you undo changes.
To me, it also happened when switching from edit mode to object mode using tab. Using the dropdown menu always works fine.

Did someone else experience something similar? What did you do right before it crashed? Can you reproduce it? I'm trying to find out what exactly makes Blender crash. It seems to do so with and without my add-on enabled so I'm not sure if it's that.

Re: Blender 2.79 Re-Volt Add-on

Posted: Tue Jun 19, 2018 10:40 am
by Kiwi
Marv, I didn't experienced this issue at all, while working with Blender and your addon (since end of last year). I very often use the functions you described. (CTRL + Z, Switching between Edit- and Object Mode with TAB).

I am using Windows 10, the newest Blender version, and the newest version of your addon.

Re: Blender 2.79 Re-Volt Add-on

Posted: Tue Jun 19, 2018 11:09 am
by Marv
It might just have been a bug in a specific Blender version. Thanks for the info :)

Re: Blender 2.79 Re-Volt Add-on

Posted: Mon Jul 30, 2018 2:03 pm
by Marv
I'm planning to release a new version on the 1st or 2nd of August. There are some new features which need to be tested:

Topics: Mirror Planes, Hull, Bugfixes, Tools

- Additions:
- Mirror Planes: .rim support
- Hulls: .hul support
- Import and Export
- _Hulls_ tool panel with convex hull generation
- Vertex color layer list in the tools panel
- Batch Bake section in the Light and Shadow tool panel
- RVGL Launcher in the Helpers panel. The RVGL path (folder) has to be set in the add-on settings.

- Fixes:
- Crash when importing levels with texture animation (reported by Gotolei)
- Batch bake should not crash anymore
- Import and export of .fin properties (mainly colors)
- Set default model rgb to (0.5, 0.5, 0.5)
- Too many dummy textures when importing prm
- Catch error when parameters.txt files don't end with a '}' (reported by Shara)
- NCPs consisting of multiple objects are now exported with correct materials

- Modifications:
- New documentation, yet again
- Code restructuring
- UI restructuring

You can get the current dev version here: ... ve/

I also worked on a new documentation which you can find in docs/index.html which covers some information about the new features.

On Linux you'll have to install qhull (package name should be qhull). The windows version is bundled with the add-on but I don't know if it works.

Re: Blender 2.79 Re-Volt Add-on

Posted: Tue Jul 31, 2018 10:43 am
by Marv
The new version is out: ... va_18.0801
Follow the link to read the changelog, it's similar to the one in my previous post.

Definitely check out the documentation as well:

You can now import and export complete hulls (convex and interior), as well as generate new ones (convex hull only at the moment):


Mirror Planes can also be imported and exported now. Which track is this?