Body Import/Export Addon for Blender 3.6.4

[xxpy02]

Tested only under the 3.64 version of blender.
It only supports importing and exporting bodies (body_subdiv_cageShape) from BS files (eg: only *.bs files).
This addon started as a fork of the io_tkm17_body 2.79b addon, but changed so much that I can't consider it the same addon anymore.

Latest release: 1.6.1

Features supported:

• Importing and exporting meshes from any body files (original or custom)
  
• Advanced mesh editing (add and remove topology anywhere you want)
  
• Importing vertex groups
  
• Importing vertex weights
  
• Importing UV coordinates
  
• Importing shape keys (blend controls/morphs)
  
• Importing materials (texture shaders)
  
• Exporting vertex groups
  
• Exporting vertex weights
  
• Exporting UV coordinates
  
• Exporting shape keys
  

Planned features:

• Full scene import/export (all entities in a BS file)
  
• Exporting materials and shaders
  
• Importing armatures
  

Installation Instructions

• Unzip this file and place the io_tkm17_body folder under the 3.6\scripts\addons folder, relative to your Blender 3.6.4 installation path.
  
• Activate it under Edit > Preferences > Addons > io_tkm_body.
  

General usage

• To import either a custom or one of the original bodies go to: File -> Import -> TK17 Body File (.bs)
  
  Materials are imported automatically if they can be found at the images path relative to your addon file:
  1. If your file path is C:/TK17/Addons/Nice Body/Scenes/Shared/Body/body01.bs it will try loading the textures from C:/TK17/Addons/Nice Body/Images/Q=Tex032M/Shared/Body
  2. If your file path is C:/Archive/Nice Body/body01.bs it will try loading the textures from C:/Archive/Nice Body/Images/Q=Tex032M/Shared/Body
  3. If the files are not found then it will use the DefaultColor configured in the ShaderTexture.Texture
  
  
• To export your custom body go to: File -> Export -> TK17 Body File (.bs)
  

Tutorials

• [To see links please log-in or register here]

Download mirror (and release history):

[To see links please log-in or register here]

Changelog

Release 1.6.1

• Import missing vertex groups for unparented joints
  

Release 1.6.0

• Export of modified mesh topology
  
• Enhanced error/warning reporting
  
• Simplify mesh orientation by rotating parent object by 90 degrees
  
• Standardize mesh write/read with the Mesh API (deprecates BMesh)
  

Release 1.5.1

• Auto sort of shape keys vertex data
  

Release 1.5.0

• Export of modified shape keys
  
• Export of new uv coordinates
  
• Export of new vertex groups
  
• Export of new vertex weights
  
• Export of new shape keys
  
• Fix the shape keys import order
  
• Source code refactoring and improvements
  

Release 1.4.0

• Export of modified UV coordinates
  
• Share images between shaders to prevent loading duplicated textures
  

Release 1.3.0

• Export of modified vertex weights
  

Release 1.2.2

• Properly parse body number from internal BS path
  

Release 1.2.1

• Ignore Morph vertices that are out of the range of the Mesh VertexArray
  

Release 1.2.0

• Import of materials/texture shaders
  
• Import of UV maps
  
• Import of blend controls/morphs/shape keys
  
• Support for STransform.ScalingPivotTranslation
  
• Correctly handles negative zeroes for SPolygonGeometry.NormalArray
  
• Inline empty locals during compilation/export
  
• Minor fixes and improvements in source code
  
• Remove body files from the build process
  

Release 1.1.0

• Import of vertex groups
  
• Import of vertex weights
  
• Major refactor of the source code
  

Release 1.0.1

• Support for RenderShader.BlendMode, TGeometry.SortCenter, TGeometry.SortIndex, Texture2D.WrapU and Texture2D.WrapV
  
• Handling of unexpected leading/trailing commas on list definitions
  
• Swap vertex coordinates order (-z/y) for correct orientation in Blender
  
• Extensive code refactoring
  

Release 1.0.0

• Support for editing any type of imported body and not only the original ones packed with this addon
  
• Store original BS file contents in the .blend file for reference during export
  
• Refactor Bionic Script Binary file parsing algorithm
  

[Richter Belmont]

Tested only under the 3.64 version of blender.
It only supports importing and exporting bodies (body_subdiv_cageShape) from BS files (eg: only *.bs files).
This addon started as a fork of the io_tkm17_body 2.79b addon, but changed so much that I can't consider it the same addon anymore.

Features supported:

• Importing and exporting meshes from any body files (original or custom)
  
• Simple mesh editing (moving around faces/vertices)
  
• Importing Vertex groups
  
• Importing Vertex weights
  
• Importing Materials (texture shaders)
  
• Importing UV maps
  
• Importing Shape keys (morphs/blend controls)
  

Planned features:

• Advanced mesh editing (adding or removing faces/vertices)
  
• Exporting Vertex weights
  
• Exporting Materials
  
• Exporting UV maps
  
• Exporting Shape keys (morphs/blend controls)
  
• Importing/Exporting armatures/bones
  

WOW!! Incredible! Finaly a newer Coded Tool version for Blender, i was using 2.69 and 2.79, Congratulations!! we apreciate this so much!! ^^

[xxpy02]

The idea is exactly that, to update/refresh our toolset. TK17 has a lot of potential with hook5, but our modding community gets hindered by the very ancient and often convoluted toolset we have available. Most tutorials you find nowadays are for Blender 2.8+ (new interface), there are very few tutorials left for the old interface versions - not to mention the lack of many useful features/plugins.

My short term plan is to make this a body editing addon anyone can use to create heavily customized and high resolution/poly count meshes from existing bodies. This includes adding support in Blender to customize even the shader parameters (specular, textures, etc).

The long term plan is to make this a general editing addon to customize anything, but since there's CTK (which already works fine with newer Blender versions albeit not begginers friendly) I am not sure what the next goal (after bodies) will be. I am open to suggestions.

[Richter Belmont]

The idea is exactly that, to update/refresh our toolset. TK17 has a lot of potential with hook5, but our modding community gets hindered by the very ancient and often convoluted toolset we have available. Most tutorials you find nowadays are for Blender 2.8+ (new interface), there are very few tutorials left for the old interface versions - not to mention the lack of many useful features/plugins.

My short term plan is to make this a body editing addon anyone can use to create heavily customized and high resolution/poly count meshes from existing bodies. This includes adding support in Blender to customize even the shader parameters (specular, textures, etc).

The long term plan is to make this a general editing addon to customize anything, but since there's CTK (which already works fine with newer Blender versions albeit not begginers friendly) I am not sure what the next goal (after bodies) will be. I am open to suggestions.

Amazing, SIMPLE amazing and wonderful!!!!, no comments ^^

[xxpy02]

Just uploaded a new 1.2.1 version with a fix to support bodies using custom morphs containing unusual/unexpected vertex data.
I am just not sure if I should always update the original post (thread) or if I should upload the file to a new post in this same thread.

[daspex]

Thank you for this amazing work,finaly someone is taking care of this tool.
I think it would be best to update your post each time you release a new version.
You could leave all versions in there so the user has a good overview about
all versions available.But if you want to post them separately feel free to do so.

[xxpy02]

Thank you for this amazing work,finaly someone is taking care of this tool.
I think it would be best to update your post each time you release a new version.
You could leave all versions in there so the user has a good overview about
all versions available.But if you want to post them separately feel free to do so.

Thanks for the feedback. I'll just leave the older versions next time as well, that's a good idea indeed.

[xxpy02]

Thank you for this amazing work,finaly someone is taking care of this tool.
I think it would be best to update your post each time you release a new version.
You could leave all versions in there so the user has a good overview about
all versions available.But if you want to post them separately feel free to do so.

I just released a new version, but before uploading I had to remove one of the files as there's a limit of 3 files per post.
I'll keep the last 3 in this case following your recommendation albeit limited by this restriction.

[JORATH]

Hello great job but if you have a tutorial for install and using the tools please !

[xxpy02]

Hello great job but if you have a tutorial for install and using the tools please !

I have added instructions to the thread, give them a try.