specs

MTD

_{(non-animated 3D models)}

version 00 ( S3D )

supports POLY_F3 and POLY_F4 only
store up to 65536 polygons
(x, y, z) range for vertices is -32768 to 32767

blender 2.78 script:

## s3d v0 ##

import bpy
import os
import random

# get object context
obj = bpy.context.active_object
mesh = obj.to_mesh(bpy.context.scene, False, 'PREVIEW')

# FIXME: use relative file path name
with open('C:\\Dev\\tests\\blender\\s3d_test\\a.s3d', 'wb') as f:

    # header section
    ID = b'\x00\x00\x00\x00'
    nvert = (len(mesh.vertices)).to_bytes(2, byteorder='little', signed=False)
    npoly = (len(mesh.polygons)).to_bytes(2, byteorder='little', signed=False)

    # write the ID block
    f.write(ID)
    
    # write the unused block
    f.write(b'\x00\x00\x00\x00')

    # write the nvert and npoly block
    f.write(nvert + npoly)
    
    # write the VERTEX section
    for v in mesh.vertices:
        for dim in range(3):
            f.write( (int(v.co[dim])).to_bytes(2, byteorder="little", signed=True) )
    
    # finally, write the POLYGON section
    for face in mesh.tessfaces:
        vert = len(face.vertices)
        
        if vert == 3:
            p_type = b'\x00'
        elif vert == 4:
            p_type = b'\x01'
        else:
            p_type = b'\255'
        
        f.write(p_type + b'\x00\x00\x00')
        
        for i in range(vert):
            f.write( (face.vertices[i]).to_bytes(2, byteorder="little", signed=False) )
        
        # write unused 4th index
        if vert == 3:
            f.write(b'\x00\x00')
        
        # FIXME: write the color values from the mesh itself
        f.write((random.randint(0, 255)).to_bytes(1, byteorder="little", signed=False))
        f.write((random.randint(0, 255)).to_bytes(1, byteorder="little", signed=False))
        f.write((random.randint(0, 255)).to_bytes(1, byteorder="little", signed=False))
        
        f.write(b'\x00') # unused byte

version 01

supports POLY_F3 and POLY_F4 only
store up to 65536 polygons

NEW:
(x, y, z) range for vertices is -2147483648 to 2147483647

blender 2.78 script:

## MTD v1 ##

import bpy
import os
import random

VERSION = b'\x01\x00'

# get object context
obj = bpy.context.active_object
mesh = obj.to_mesh(bpy.context.scene, False, 'PREVIEW')

# FIXME: use relative file path name
with open('C:\\Users\\sveeion\\Desktop\\a.mtd', 'wb') as f:

    # header section
    ID = b'\x00\x00\x00\x00'
    nvert = (len(mesh.vertices)).to_bytes(2, byteorder='little', signed=False)
    npoly = (len(mesh.polygons)).to_bytes(2, byteorder='little', signed=False)

    # write the ID block
    f.write(ID)
    
    # write the version
    f.write(VERSION + b'\x00\x00')

    # write the nvert and npoly block
    f.write(nvert + npoly)
    
    # write the VERTEX section
    for v in mesh.vertices:
        for axis in range(3):
            num = int( round(v.co[axis] * 4096, 0) )
            f.write( num.to_bytes(4, byteorder='little', signed=True) )
    
    # finally, write the POLYGON section
    for face in mesh.tessfaces:
        vert = len(face.vertices)
        
        if vert == 3:
            p_type = b'\x00'
        elif vert == 4:
            p_type = b'\x01'
        else:
            p_type = b'\255'
        
        f.write(p_type + b'\x00\x00\x00')
        
        for i in range(vert):
            f.write( (face.vertices[i]).to_bytes(2, byteorder='little', signed=False) )
        
        # write unused 4th index
        if vert == 3:
            f.write(b'\x00\x00')
        
        r = bpy.data.materials[face.material_index].diffuse_color[0] * 255
        g = bpy.data.materials[face.material_index].diffuse_color[1] * 255
        b = bpy.data.materials[face.material_index].diffuse_color[2] * 255
        
        r = int(round(r, 0))
        g = int(round(g, 0))
        b = int(round(b, 0))
        
        # write actual color values
        f.write(r.to_bytes(1, byteorder='little', signed=False))
        f.write(g.to_bytes(1, byteorder='little', signed=False))
        f.write(b.to_bytes(1, byteorder='little', signed=False))
        
        # write random color values
        #f.write((random.randint(0, 255)).to_bytes(1, byteorder='little', signed=False))
        #f.write((random.randint(0, 255)).to_bytes(1, byteorder='little', signed=False))
        #f.write((random.randint(0, 255)).to_bytes(1, byteorder='little', signed=False))
        
        f.write(b'\x00') # unused byte

version 02

store up to 65536 polygons
(x, y, z) range for vertices is -2147483648 to 2147483647

NEW:
supports POLY_F3, POLY_F4, POLY_FT3, POLY_FT4, and LINE_F2 primitives

blender 2.76 script:

MTDv2.txt

version 03

store up to 65536 polygons
(x, y, z) range for vertices is -2147483648 to 2147483647
supports POLY_F3, POLY_F4, POLY_FT3, POLY_FT4, and LINE_F2 primitives

NEW:
supports normals

blender 2.76 script:

MTDv3.txt

version 04

store up to 65536 polygons
(x, y, z) range for vertices is -2147483648 to 2147483647
supports POLY_F3, POLY_F4, POLY_FT3, POLY_FT4, and LINE_F2 primitives
supports normals

NEW:
allow same amount of UVs as vertices ( was quite the oversight I've realized :p )

blender 2.76 script:

MTDv4.txt

version 05

store up to 65536 polygons
(x, y, z) range for vertices is -2147483648 to 2147483647
supports POLY_F3, POLY_F4, POLY_FT3, POLY_FT4, and LINE_F2 primitives
supports normals
allow same amount of UVs as vertices

NEW:
added option for point lights
culling flags are now embedded within the file (as opposed to setting it manually via XADD_CONVEX_CLIP or XADD_CONVEX_CLIP_B)
added optional RGB section (must have USE_GOURAUD flag on)
lighting is now available for flat-shaded polygons, not just gouraud-shaded ones

blender 2.76 script:

MTDv5.txt

ATD

_{(animated 3D models)}

version 00

instant and linear interpolation support

blender 2.76 script:

ATDv0.txt

CXC

_{(3D collision data)}

version 00

x / z linear slope collision support
box collision support

blender 2.78 script:

## CXC v0 ##

import bpy
import sys

VERSION = b'\x00\x00'

## GUIDE:
# layer 0: MTD/ATD data
# layer 1: CXC-COLMAP data
# layer 2: CXC-AREATRIG data

objects_all = bpy.context.scene.objects
nplanes = 0
ncuboids = 0

with open('C:\\Users\\sveeion\\Desktop\\a.cxc', 'wb') as f:
    
    # HEADER section
    ID = b'\x00\x00\x00\x00'
    f.write(ID + VERSION + b'\x00\x00')
    print('\n\n--------------------------------\n\n')
    
    # COLMAP section
    active_layer = 1
    layer_obj = [obj for obj in objects_all if obj.layers[active_layer]]
    
    bnum = 8
    plane_data = []
    cuboid_data = []
    
    # read data into lists
    for obj in layer_obj:
        mesh = obj.to_mesh(bpy.context.scene, False, 'PREVIEW')
        
        # PLANE
        if len(obj.data.vertices) == 4:
            nplanes += 1
            bnum += 24
            
            for v in range(4):
                plane_data.append(obj.data.vertices[mesh.tessfaces[0].vertices[v]])
        
        # CUBOID
        elif len(obj.data.vertices) == 8:
            ncuboids += 1
            bnum += 24*6
            
            if len(mesh.tessfaces) != 6:
                raise Exception('One or more cuboids are missing a face!')
            
            for plane in mesh.tessfaces:
                for v in range(4):
                    cuboid_data.append(obj.data.vertices[plane.vertices[v]])
        else:
            raise Exception('COLMAP data must be either a PLANE (4) or CUBOID (8). Found unknown (' + str(len(obj.data.vertices)) + ')')
    
    f.write(bnum.to_bytes(4, byteorder='little', signed=False))
    f.write(nplanes.to_bytes(2, byteorder='little', signed=False))
    f.write(ncuboids.to_bytes(2, byteorder='little', signed=False))
    
    for v in plane_data:
        x = (-int(round(v.co[0], 0))).to_bytes(2, byteorder='little', signed=True)
        z = (-int(round(v.co[1], 0))).to_bytes(2, byteorder='little', signed=True)
        y = (-int(round(v.co[2], 0))).to_bytes(2, byteorder='little', signed=True)
        
        f.write(x + y + z)
            
    for v in cuboid_data:
        x = (-int(round(v.co[0], 0))).to_bytes(2, byteorder='little', signed=True)
        z = (-int(round(v.co[1], 0))).to_bytes(2, byteorder='little', signed=True)
        y = (-int(round(v.co[2], 0))).to_bytes(2, byteorder='little', signed=True)
        
        f.write(x + y + z)
    
    # AREATRIG section
    active_layer = 2
    layer_obj = [obj for obj in objects_all if obj.layers[active_layer]]

    bnum = 8
    ncuboids = 0
    cuboid_data = []

    for obj in layer_obj:
        mesh = obj.to_mesh(bpy.context.scene, False, 'PREVIEW')
        
        # CUBOID
        if len(obj.data.vertices) == 8:
            ncuboids += 1
            bnum += 24*6
            
            if len(mesh.tessfaces) != 6:
                raise Exception('One or more cuboids are missing a face!')
            
            for plane in mesh.tessfaces:
                for v in range(4):
                    cuboid_data.append(obj.data.vertices[plane.vertices[v]])
        else:
            raise Exception('AREATRIG data must be cuboids! Found unknown (' + str(len(obj.data.vertices)) + ')')
    
    f.write(bnum.to_bytes(4, byteorder='little', signed=False))
    f.write(b'\x00\x00')
    f.write(ncuboids.to_bytes(2, byteorder='little', signed=False))
    
    for v in cuboid_data:            
        x = (-int(round(v.co[0], 0))).to_bytes(2, byteorder='little', signed=True)
        z = (-int(round(v.co[1], 0))).to_bytes(2, byteorder='little', signed=True)
        y = (-int(round(v.co[2], 0))).to_bytes(2, byteorder='little', signed=True)
        
        f.write(x + y + z)

BEZ

_{(3D bezier data)}

version 00

supports up to 6 key points

blender 2.76 script:

bezv0.txt

TEX

_{(TIM packaging)}

version 00

python 3.4.3 script:

TEXv0.txt

guide:

TEXv0_guide.txt

LVL

_{(LOD data, sky color, etc..)}

version 00

python 3.4.3 script:

LVLv0.txt

guide:

LVLv0_guide.txt

NRM

_{(polygon face normals)}

Does not truncate repeating entries
No option to include vertex normals

python 3.4.3 script:

NRM.txt

MTD

blender 2.78 script:

NEW:

blender 2.78 script:

NEW:

blender 2.76 script:

NEW:

blender 2.76 script:

NEW:

blender 2.76 script:

NEW:

blender 2.76 script:

ATD

blender 2.76 script:

CXC

blender 2.78 script:

BEZ

blender 2.76 script:

TEX

python 3.4.3 script:

guide:

LVL

python 3.4.3 script:

guide:

NRM

python 3.4.3 script:

guide: