View source for Howto:Working with FlightGear models in Blender

{{Stub}}{{WIP|In progress as of Sept 4th, 2024}}
FlightGear uses the [[AC3D file format]] for its models. AC3D files are denoted by the  <code>.ac</code> file extension. It is a niche legacy format native to the [[AC3D]] modelling software, and its adoption is not widespread in computer graphics (being used mainly by X-Plane<ref>[https://en.wikipedia.org/wiki/AC3D]</ref> and FlightGear). This lead to support for the format eventually being removed from Blender. In order to work with models in the AC3D format in Blender, and thus do any modelling work for the FlightGear project, the use of an add-on is required. 

== Installing the Blender add-on for AC3D models ==
{{Warning|While Blender offers an "Install From File" option to simplify the installation of add-ons, it is not supported by Blender-AC3D and should not be used.}}
The [https://github.com/NikolaiVChr/Blender-AC3D Blender-AC3D] add-on is one such add-on that allows AC3D models to be used in Blender. It is an open-source project licensed under the [[GNU GPL]]. It is hosted on [[Github|GitHub]], and it can be accessed here: [https://github.com/NikolaiVChr/Blender-AC3D Blender-AC3D].
To install the Blender-AC3D add-on, you must complete the following steps:

# Identify the version of Blender you are using. This can be done by simply opening Blender, and checking the version number in the top-right corner of the startup / splash screen:[[File:Blender_Startup_Screen.png|alt=Determining Blender version from the splash screen|none|frame|Determining Blender version from the splash screen]]
# Close Blender.
# Download the correct version of the Blender add-on for your version of Blender. You can download the add-on at: https://github.com/NikolaiVChr/Blender-AC3D
# Once you have downloaded the Blender add-on, extract the <code>.zip</code> file so that you have a folder called <code>io_scene_ac3d</code>.
# Next, you will need to place the add-on (the <code>io_scene_ac3d</code> folder) in the correct directory in order for Blender to be able to load it. It will vary based on platform, where <code>x.x</code> is the version of Blender you are using.
#* For Linux users, the location may be in one of two places. If you installed it through your package manager, it will be the first path. If you installed Blender as a Flatpak, it will be the second path.  <code>~/.blender/x.x/scripts/addons</code> <code>~/.var/app/org.blender.Blender/config/blender/x.x/scripts/addons</code>.
#* For Windows users, the location is: <code>C:\Users\yourusername\AppData\Roaming\Blender Foundation\Blender\x.x\scripts\addons</code>
#* For macOS users, the location is: <code>Macintosh HD/Users/yourusername/Library/Application Support/Blender/x.x/scripts/addons</code>
# Re-open Blender.
# Navigate to '''Edit > Preferences''', and select '''Add-ons''' from the side-bar. If you downloaded the correct version of the add-on, and place it in the right location, you should see it in the list of available add-ons.
# Select the checkbox next to '''AC3D (.ac) format''' to enable the plugin. This step is critical, otherwise the add-on won't actually become active.{{Note|The add-on will not be active after installing, you must manually enable it.}}[[File:Enable Blender-AC3D.png|thumb|Selecting Blender-AC3D from the add-ons menu|alt=Selecting Blender-AC3D from the add-ons menu|none|680x680px]]
# Once you have enabled the Blender add-on, restart Blender.


If you have completed the above steps and encountered no error messages, the Blender-AC3D add-on should be correctly installed and enabled, and is ready for use.

== Importing models ==

# Once the add-on is installed, AC3D models can be imported in the same fashion as any model format supported by Blender. To import a model, navigate to '''File > Import > AC3D (.ac)'''{{Note|If you do not see the option to import AC3D models, the add-on either has not been correctly installed, or enabled.}} [[File:Blender AC3D import dialog.png|frameless|546x546px]]
# A file chooser dialog will appear. Select your AC3D (<code>.ac</code> ) file and select '''Import AC3D'''.
 
 {{WIP}}  

==Editing models==
Once the model has been successfully imported into Blender using the add-on, the

{{WIP}}

== Configuring accurate model previews ==
{{WIP}}

==Viewing liveries==

Blender can be used as a 'livery viewer' for your FlightGear models.  

{{WIP}}

== Exporting models ==
{{Warning|To ensure that models exported from Blender are displayed and function correctly in FlightGear, special steps must be followed.}}[[File:Cessna 172P Model in Blender.png|thumb|Example screenshot demonstrating a Cessna model taken from FlightGear and opened in Blender]]{{WIP}}{{Appendix}}
{{3d}}
[[Category:Modeling]]