Enfusion Blender Tools – Arma Reforger

From Bohemia Interactive Community
Jump to navigation Jump to search
(→‎Import: Added mention of new features)
No edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{TOC|side}}'''Enfusion Blender Tools''' (shortened to '''EBT''') is a Blender addon allowing for a good workflow between Blender and Workbench, and Enfusion in general. Primarily developed and tested with 3.3.1 LTS.
{{TOC|side}}
'''Enfusion Blender Tools''' (shortened to '''EBT''') is a Blender addon allowing for a good workflow between Blender and Workbench, and Enfusion in general. Primarily developed and tested with latest LTS (Long Term Support) version of Blender.


{{Feature|informative|Enfusion Blender Tools '''Tutorials''' can be found at {{GameCategory|armaR|Modding|Tutorials|Official Tools|Enfusion Blender Tools|link= y|text= Enfusion Blender Tools Tutorials}}}}.
{{Feature|warning|Warning, '''Enfusion Blender Tools are not working correctly with Blender 4.x+''' versions! Use [https://www.blender.org/download/lts/ '''Blender 3.6 LTS'''] instead.}}{{Feature|informative|Enfusion Blender Tools '''Tutorials''' can be found at {{GameCategory|armaR|Modding|Tutorials|Official Tools|Enfusion Blender Tools|text= Enfusion Blender Tools Tutorials}}.}}




Line 8: Line 9:
=== Import ===
=== Import ===


* [[Enfusion_Blender_Tools:_Import/Export_ASC_Elevation|ASC elevation (.asc file)]] - import an ASC elevation file (Esri grid) as terrain mesh
* {{Link|Arma Reforger:Enfusion Blender Tools: Import/Export ASC Elevation|ASC elevation (.asc file)}} - import an ASC elevation file (Esri grid) as terrain mesh
* [[Arma_Reforger:Enfusion_Blender_Tools:_P3D_Conversion|Arma 3 P3D (.p3d file)]] - import P3D
* {{Link|Arma Reforger:Enfusion Blender Tools: P3D Conversion|{{arma3}} P3D (.p3d file)}} - import P3D
* [[Arma_Reforger:Enfusion_Blender_Tools:_Materials_Preview|FBX (.fbx file)]] - import FBX with Enfusion Shaders
* {{Link|Arma_Reforger:Enfusion Blender Tools: Materials Preview|FBX (.fbx file)}} - import FBX with Enfusion Shaders
* Prefab (.et file) - importing models located in prefabs (including prefabs located in hierarchy).  
* Prefab (.et file) - importing models located in prefabs (including prefabs located in hierarchy). '''It is only working on prefabs where source FBX are available - that means, you cannot use this function to edit read-only assets like Arma Reforger or downloaded mods.''' Function is meant mainly for structures and baking MLODs.


=== Export ===
=== Export ===


* [[Enfusion_Blender_Tools:_Import/Export_ASC_Elevation|ASC elevation (.asc file)]]
* {{Link|Enfusion Blender Tools: Import/Export ASC Elevation|ASC elevation (.asc file)}}
* [[Arma_Reforger:Enfusion_Blender_Tools:_Import/Export_Animation|Enfusion animation (.txa file)]]
* {{Link|Arma Reforger:Enfusion Blender Tools: Import/Export Animation|Enfusion animation (.txa file)}}
* FBX (.fbx file) - exporting single FBX file with automatic registration of model in Workbench
* FBX (.fbx file) - exporting single FBX file with automatic registration of model in Workbench
*[[Arma_Reforger:Enfusion_Blender_Tools:_Batch_FBX_Export|Batch FBX export (.fbx file)]] - batch exporting of FBX files  
* {{Link|Arma Reforger:Enfusion Blender Tools: Batch FBX Export|Batch FBX export (.fbx file)}} - batch exporting of FBX files  


=== Misc ===
=== Misc ===


* [[Arma_Reforger:Enfusion_Blender_Tools:_Objects_Tools|Object Tools]] - Various small tools helping with preparation of model for Workbench import
* {{Link|Arma Reforger:Enfusion Blender Tools: Objects Tools|Object Tools}} - Various small tools helping with preparation of model for Workbench import
* Model Quality Assurance<!-- - see BT: Model Quality Assurance - Verifies if -->
* {{Link|Arma_Reforger:Enfusion_Blender_Tools:_Model_Quality_Assurance|Model Quality Assurance}}
* {{Link|Arma_Reforger:Enfusion_Blender_Tools:_NLA_Strips_Baking_Tool|NLA Strips Baking Tool}}
* {{Link|Arma_Reforger:Enfusion_Blender_Tools:_Rig_Updater|Rig Updater}}
* {{Link|Arma_Reforger:Enfusion_Blender_Tools:_Skeleton_Updater|Skeleton Updater}}
* {{Link|Arma_Reforger:Enfusion_Blender_Tools:_Portal_Tools|Portal Tools}}




{{Clear}}
{{Clear}}
== Installation ==
== Installation ==


[[File:armareforger-enfusionblendertools-net-api.png|alt=Location of Enable net API in Workbench Options|thumb|600x600px|Location of Enable net API option in Workbench Options window]]
[[File:armareforger-enfusionblendertools-net-api.png|alt=Location of Enable net API in Workbench Options|thumb|600x600px|Location of Enable net API option in Workbench Options window]]
* Download [https://www.blender.org/download/lts/3-3/ Blender LTS 3.3]
* Download {{Link|https://www.blender.org/download/lts/3-6/|Blender LTS 3.6}}
* Download '''Arma Reforger Tools''' from Steam{{Feature|informative|Arma Reforger Tools only appear if Arma Reforger is in your Steam Library.}}
* Download '''Arma Reforger Tools''' from Steam{{Feature|informative|Arma Reforger Tools only appear if Arma Reforger is in your Steam Library.}}
* Install EBT addon from {{hl|Arma Reforger Tools\Blender\EnfusionBlenderTools-Plugin.zip}} (do not unzip it!)
* Install EBT addon from {{hl|Arma Reforger Tools\Blender\EnfusionBlenderTools-Plugin.zip}} (do not unzip it!)
** See [https://www.youtube.com/watch?v=LzdoUTvAgXk&t=64s How to Install Add-Ons in Blender]
** See {{Link|https://www.youtube.com/watch?v{{=}}LzdoUTvAgXk&t{{=}}64s|How to Install Add-Ons in Blender}}
* Open '''Workbench''' and in '''Workbench → Options → Workbench''' settings turn on '''Enable net API (for communication with external applications)''' option
* Open '''Workbench''' and in '''Workbench → Options → Workbench''' settings turn on '''Enable net API (for communication with external applications)''' option


{{Clear}}
{{Clear}}
[[File:armareforger-enfusionblendertools_options_setup2.png|thumb|Enfusion Blender Tools addon preferences|alt=|600x600px]]
[[File:armareforger-enfusionblendertools_options_setup2.png|thumb|Enfusion Blender Tools addon preferences|alt=|600x600px]]
If you intend to use TXA exporter and want to use Reforger library of [[Arma Reforger:Animation Export Profiles|animation export profiles]], it is also necessary to set up '''Export Profile Folder'''
If you intend to use TXA exporter and want to use Reforger library of {{Link|Arma Reforger:Animation Export Profiles|animation export profiles}}, it is also necessary to set up '''Export Profile Folder'''
* Unzip {{hl|Arma Reforger Tools\Blender\EnfusionBlenderTools-Data.zip}} to any empty folder
* Unzip {{hl|Arma Reforger Tools\Blender\EnfusionBlenderTools-Data.zip}} to any empty folder
* In '''Export Profile Folder''', press the ''''+'''<nowiki/>' button and set path to the directory where {{hl|EnfusionBlenderTools-Data.zip}} file was extracted (see image)
* In '''Export Profile Folder''', press the '<nowiki/>'''+'''<nowiki/>' button and set path to the directory where {{hl|EnfusionBlenderTools-Data.zip}} file was extracted (see image)
Similar steps can also be performed to define the custom animation export profiles directory
Similar steps can also be performed to define the custom animation export profiles directory


Line 54: Line 60:
=== Top Menu ===
=== Top Menu ===


In the top section of the viewport, '''Enfusion Tools (1)''' tab contains '''Import''' & '''Export''' sub menus where it is possible to [[#Import P3D|import P3D]], [[#Import ASC|ASC file]] or [[#Import FBX|FBX models]] and export [[#Export ASC|ASC]] or [[#Export TXA|TXA]] animations.
In the top section of the viewport, '''Enfusion Tools (1)''' tab contains '''Import''' & '''Export''' sub menus where it is possible to {{Link|#Import P3D}}, {{Link|#Import ASC|ASC file}} or {{Link|#Import FBX|FBX models}} and {{Link|#Export ASC}} or {{Link|#Export TXA}} animations.


==== Import ASC ====
==== Import ASC ====
Line 75: Line 81:


==== Import FBX ====
==== Import FBX ====
This option activates import of [[Arma_Reforger:Enfusion_Blender_Tools:_Materials_Preview|FBX with Enfusion Shaders]].
This option activates import of {{Link|Arma Reforger:Enfusion Blender Tools: Materials Preview|FBX with Enfusion Shaders}}.


===== Remove All Objects =====
===== Remove All Objects =====
Line 84: Line 90:


==== Export TXA ====
==== Export TXA ====
Export the [[Arma_Reforger:Enfusion_Blender_Tools:_Import/Export_Animation|animation to the TXA format]].
Export the {{Link|Arma Reforger:Enfusion Blender Tools: Import/Export Animation|animation to the TXA format}}.


=== Side section ===
=== Side section ===
Line 96: Line 102:


==== Object Tools ====
==== Object Tools ====
Object Tools '''(5)''' panel contains controls for [[Arma_Reforger:Enfusion_Blender_Tools:_Objects_Tools#Automatic_sorting_of_objects|automatic object sorting into collections]]
Object Tools '''(5)''' panel contains controls for {{Link|Arma Reforger:Enfusion Blender Tools: Objects Tools#Automatic sorting of objects|automatic object sorting into collections}}


==== Material Tools ====
==== Material Tools ====
This section '''(6)''' contains options [[Arma_Reforger:Enfusion_Blender_Tools:_Objects_Tools#Colliders_.26_Layer_Presets_setup|colliders setup]], light setup & [[Arma_Reforger:Enfusion_Blender_Tools:_Materials_Preview#Materials_Synchronisation|(re)import of Enfusion Materials into Blender]]
This section '''(6)''' contains options {{Link|Arma Reforger:Enfusion Blender Tools: Objects Tools#Colliders .26 Layer Presets setup|colliders setup}}, light setup and {{Link|Arma Reforger:Enfusion Blender Tools: Materials Preview#Materials Synchronisation|(re)import of Enfusion Materials into Blender}}




{{GameCategory|armaR|Modding|Official Tools}}
{{GameCategory|armaR|Modding|Official Tools|Enfusion Blender Tools}}

Latest revision as of 09:14, 13 November 2024

Enfusion Blender Tools (shortened to EBT) is a Blender addon allowing for a good workflow between Blender and Workbench, and Enfusion in general. Primarily developed and tested with latest LTS (Long Term Support) version of Blender.

⚠
Warning, Enfusion Blender Tools are not working correctly with Blender 4.x+ versions! Use Blender 3.6 LTS instead.
ⓘ
Enfusion Blender Tools Tutorials can be found at Enfusion Blender Tools Tutorials.


Features

Import

  • ASC elevation (.asc file) - import an ASC elevation file (Esri grid) as terrain mesh
  • Arma 3 P3D (.p3d file) - import P3D
  • FBX (.fbx file) - import FBX with Enfusion Shaders
  • Prefab (.et file) - importing models located in prefabs (including prefabs located in hierarchy). It is only working on prefabs where source FBX are available - that means, you cannot use this function to edit read-only assets like Arma Reforger or downloaded mods. Function is meant mainly for structures and baking MLODs.

Export

Misc


Installation

Location of Enable net API in Workbench Options
Location of Enable net API option in Workbench Options window
  • Download Blender LTS 3.6
  • Download Arma Reforger Tools from Steam
    ⓘ
    Arma Reforger Tools only appear if Arma Reforger is in your Steam Library.
  • Install EBT addon from Arma Reforger Tools\Blender\EnfusionBlenderTools-Plugin.zip (do not unzip it!)
  • Open Workbench and in Workbench → Options → Workbench settings turn on Enable net API (for communication with external applications) option
Enfusion Blender Tools addon preferences

If you intend to use TXA exporter and want to use Reforger library of animation export profiles, it is also necessary to set up Export Profile Folder

  • Unzip Arma Reforger Tools\Blender\EnfusionBlenderTools-Data.zip to any empty folder
  • In Export Profile Folder, press the '+' button and set path to the directory where EnfusionBlenderTools-Data.zip file was extracted (see image)

Similar steps can also be performed to define the custom animation export profiles directory


Interface

Once addon is properly installed and activated, two new elements - (1) & (2) should be visible in main interface of Blender. Depending on used layout, right section of the menu might need to be expanded by clicking on small arrow on the right side of the viewport.

armareforger-enfusionblendertools interface.jpg

Top Menu

In the top section of the viewport, Enfusion Tools (1) tab contains Import & Export sub menus where it is possible to Import P3D, ASC file or FBX models and Export ASC or Export TXA animations.

Import ASC

Import a .asc terrain file.

Import P3D

Discard unsupported LODs

LODs like View Cargo/Gunner/Pilot, Roadway, Hitpoints, Paths and similar will be discarded from the import.

Layer Presets

Assign detected layers (geometry, physics)

Game Materials
Rename materials

Rename RVMATs to Enfusion equivalents.

Memory Points
Convert axis to single point

Convert two points with default rotation to single point with orientation axis.

Import FBX

This option activates import of FBX with Enfusion Shaders.

Remove All Objects

Remove any object present in the fbx file.

Export ASC

Export the terrain to .asc format.

Export TXA

Export the animation to the TXA format.

Side section

On the right side of the viewport, Enfusion Tools tab (2) you have following options:

Model Quality Assurance

In this panel (3) it is possible to adjust and execute Model Quality Assurance script which checks for common configuration & topology errors in the mesh.

Settings

Settings panel (4) contains options for Batch FBX export

Object Tools

Object Tools (5) panel contains controls for automatic object sorting into collections

Material Tools

This section (6) contains options colliders setup, light setup and (re)import of Enfusion Materials into Blender

Retrieved from "https://community.bistudio.com/wiki?title=Arma_Reforger:Enfusion_Blender_Tools&oldid=370232"