ScottishCyclops / cub-to-obj

Cube World .cub file to .obj file converter
6 stars 0 forks source link

CUB to OBJ exporter

Example in Blender 2.8

This is a small script that takes in a .cub file from the game Cube World and turns it into a .obj and .mtl file

The goal is to be able to import Cube World data into any 3D Program, such as Blender.

It creates an OBJ object per material (color). But every cube is exported. That means you can remove/add cubes easily, or merge the overlapping vertices to keep only the minimum amount of data.

Usage

You will need Node.JS to run the script. You can get it at https://nodejs.org/en/ for any platform.

No other dependancy is required. You can then download the .js file from Github, and run it with:

node cub-to-obj.js /your/cub-file.cub

You can also run:

node cub-to-obj.js --help

for a bit more info about the two available parameters.

Orientation

To get the correct orientation, in Blender, I had to import using the following settings:

I hope you like it. If you see any other necessary features, please get in touch.

Big thanks to Chrismiuchiz on the Cube World Discord for helping me understand the .cub file format.