PKGImportExport

Blender PKG Add-On Version 1.02 March 11th 2022

Created by Dummiesman

1.Requirements The addon was created in Blender 2.83, and may not work in previous verions. The addon was tested and appears to work in 2.9+ as well

2.Installation

• Open the Blender preferences menu, found under Edit->Preferences.

• Go to the add-ons tab.

• Click the install button located on the top right corner.

• Select the downloaded addon ZIP

• Enable it, and enter your game data path

3.Importing Textures Textures with the format BMP,TGA,TEX will be imported.

MTX Files MTX files will automatically be imported if found

Geometry Flags Because geometry flags are done via geometry, and not via material. These are NOT imported.

4.Exporting Reflections To change the "Shininess" of a material, change the "Specular" property.

Geometry Flags Using the Emissive material type will export any geometry with that material as shadeless in game

Textures The exporter will try and find the texture by searching the node tree. If it can't find the texture, or it's otherwise not assigned, the material will export untextured.

XRefs To define an xref, simply name an empty object "xref:xrefname". Where xrefname is the name of the PKG file to xref e.g. "sp_parkmtr_f". It does not matter if Blender adds the .001 and so on.

Paintjobs (Variants) Press the N key to bring up the sidebar. You should see a tab called "Angel Tools"

Here you can create and edit paintjobs (variants). 

MTX Files MTX files will be created if the location of an object is not 0,0,0. Objects do not need the :m suffix. Adding the :m suffix will crash the game, because it will be exported with that name into the PKG file.

Export Type Export type (Dashboard, Trailer, Prop) will be automatically determined. And all types of objects such as city props, buildings, etc should work automatically

Transparency Transparency is done using Blenders native system. Make sure your "Blend Mode" property is set to something other than "Opaque" if you want that material to be transparent in-game.

Vertex Colors You can export vertex colors via the checkbox in the export dialog

5.FAQ Q:I imported my PKG file, I have my textures in the right format, but I don't see them in Blender!? A:You have to be in Material render mode, rather than Solid.

6.Special Thanks RacingFreak : Providing a Midnight Club sample file leading to some new discoveries Deebz__ : Testing (lots of it), ideas and suggestions Fireboyd78 : Suggestions for code improvement Diatosta : Testing, ideas and suggestions