A Blender toolset for working with the Refractor 2 engine assets (primarily for Battlefield 2).
This is still a work in progress. Features may be added, removed or changed without maintaining backwards compatibility with assets created using older versions of this add-on!
Import & export support of:
- Skeleton (
.ske) - Animation (
.baf) - StaticMesh (
.staticMesh) including lightmap samples - SkinnedMesh (
.skinnedMesh) - BundledMesh (
.bundledMesh) - CollisionMesh (
.collisionMesh) - Occlusion Mesh (
.occ)
As well as many other utilities for creating new assets, including:
- Level import & lightmap baking tools
- Skeleton rigging tools
- StaticMesh & Overgrowth LOD generation
- SkinnedMesh/BundledMesh skinning
| Minimum required | Blender 4.2 |
|---|---|
| Recommended 1 | Blender 5.2 |
1 For the best experience, always use the recommended Blender version. Newer versions of Blender might still work but have not been verified!
- Download the latest
io_scene_bf2package from Releases compatible with your system. - Drag-and-drop the add-on's
.zipfile into Blender or install it from preferences. - Before doing anything, follow the initial add-on setup steps.
Head over to the documentation for details on how to use this add-on.
This repository includes the source code of the following third-party projects:
- rectpack licensed under Apache License Version 2.0
- Texconv Custom DLL including Python bindings from Blender-DDS-Addon licensed under MIT License
The distributed Texconv Custom DLL binaries include third-party libraries (libjpeg-turbo, libpng, zlib, libdeflate, OpenEXR, and others). This software is based in part on the work of the Independent JPEG Group. See THIRD_PARTY_LICENSES.txt for full third-party license details.
Unless stated otherwise, all of the remaining source files in this repository are licensed under MIT License.
- secnot and matyalatte as the respective maintainers of the repositories listed above
- rpoxo for bf2mesh (used for the initial version of the mesh importer)
- Harmonikater for BF2-3dsMax-Tools (served as "inspiration" for some of the tools)
- Remdul for guidance and bfmeshview (a lot of the stuff is ported over from there)
- Ason and DeWolfe for testing and feedback