Home - GhislainGir/BlenderGameToolsDoc GitHub Wiki

Welcome to the Blender Game Tools wiki!

[!IMPORTANT] This repository contains only documentation, images and content example files, not the actual addon itself, which is for now, not yet publicly available. Access to the beta is however available right now on my Patreon. @Ghislain GIRARDOT @TODO remove when no longer relevant

This addon packs several professional-grade techniques commonly used in the video game industry:

  • Vertex Animation Textures: a tool that allows you to bake animation data, per vertex, into texture(s).
  • Object Animation Textures: a tool that allows you to bake animation data, per object, into texture(s).
  • Bone Animation Textures: a tool that allows you to bake animation data, per bone, into texture(s).
  • Object Attributes Textures: a tool that allows you to bake data, per object, into texture(s). Previously known as 'Pivot Painter 2.0', it has been rebranded due to improvements that offer greater flexibility and potentially open the door to new workflows.
  • Signed Distance Fields: a tool that allows you to bake signed distance fields.
  • Data Baker: a tool that allows you to bake various types of data into UVs, Vertex Colors, or Normals, offering great flexibility and advanced bit-packing techniques.
  • FFT Ocean Baker: a tool that streamlines the process of baking Blender's FFT-based ocean modifier into a set of tiling, looping textures containing displacement offsets, normals & peaks. It is considered experimental due to the bake's performance issues.

This wiki includes an extensive Technical Art Compendium that provides additional information relevant to all the tools and techniques listed above.

RELEASE NOTES

0.2 - Object Attributes Baker

  • New: Object Attributes Baker is live. Documentation & content examples were added
  • New: Data Baker can now bake quaternions
  • New: Data Baker can make use of a custom property for each object to target another object
  • Fix: Data Baker data layer feature couldn't target a layer that was above the selected layer when initially below it, and vice versa.
  • Fix: Reduced precision of the bit-packed quaternion algorithm by 1 bit to prevent generating NaNs, which is troublesome even when exporting to .exr files. This isn't ideal but the change in precision shouldn't be noticeable.
  • Fix: Object Attributes not reporting quaternion custom order in XML file
  • Fix: Object Attributes had an erroneous property description mentioning VAT
  • Fix: BAT has an extra safety check for generating UVs
  • Fix: BAT not properly checking for uniquely named textures
  • Fix: BAT not accounting for ref_frame_padding when reporting number of padded frames
  • Various code clean up & property descriptions

0.1 - Early access

  • Ocean Baker and Object Attributes Baker are on standby
  • All other tools are mostly feature-complete and have passed an initial round of QA.

TODO

  • Ocean Baker

    • Complete implementation
    • Write doc
  • Tech Art Compendium

    • Lumen: Do more research
    • Nanite: Do more research
    • Raytracing: Do more research
  • Features

    • Corrective shapekey: provide shapekey A & B and generate shapekey C so that A+B result in the provided pose
    • Adjacency map (nearest uv boundary)
    • Tangent map (spline interpolation for VAT/BAT/OAT)
    • Curve SDF
    • Bake 2D Pose in UVs and output lerp curves