Skip to content

Blender import-export for Angel Studios ModPackage (*.PKG)

Notifications You must be signed in to change notification settings

Dummiesman/PKGImportExport

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 

Repository files navigation

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