From BlenderWiki

Jump to: navigation, search
Blender3D FreeTip.gif
IMPORTANT! Do not update this page!
We have moved the Blender User Manual to a new location. Please do not update this page, as it will be locked soon.

Page status (reviewing guidelines)

Partial page Text need to be updated to last change
Proposed fixes: none


Add-On is the general term for any optional script that extends Blender's functionality. They are found in the Add-Ons tab of the User Preferences window. This tab allows to install, enable and disable Add-Ons. Blender comes with some useful Add-Ons already, but you can also add your own, or any interesting ones you find on the web. The Scripts Catalog provides an index of Add-Ons that are included with Blender as well as listing a number of external Add-Ons.

Userpref addons en oct20 2013.jpg

Installation of an Add-On

For a script to show up in the Add-Ons tab it will first have to be installed. For this you can use the Install Add-On button in the header of the Add-Ons window. Simply click the button and locate the script you wish to install. Once installed, the script will show up in the panel.
Alternatively you can manually install an Add-On. An Add-On is considered installed when it is located in the ../scripts/addons folder (where .. is the path to your Blender configuration folder). Simply moving the Add-On into that folder is enough.

Addons can be python scripts .py or .zip files (containing .py scripts).

File locations

  • Windows 7 - C:\Users\%username%\AppData\Roaming\Blender Foundation\Blender\2.6x\scripts\addons
  • Windows XP - C:\Documents and Settings\%username%\Application Data\Blender Foundation\Blender\2.6x\scripts\addons
  • Linux - /home/$user/.config/blender/$version/scripts/addons

Note that the AppData folder in Windows 7 and the .config folder in Linux is hidden. The location may also be different depending on your choices for setting up your operating system and Blender.

You can also create a personnal folder containing new addons and configure your files path in the File panel of the User Preferences. To create a personnal script folder:

  1. Create an empty folder (i.e. 'script_addon_2-6x')
  2. Add one folder named 'addons'. It has to named like this for Blender to recognize it.
  3. Put your new addons in this 'addons' folder.
  4. open the File panel of the User Preferences.
  5. Fill the Scripts entry with the path to your script folder (i.e. 'script_addon_2-6x').

For information on the location of blender directories
see: Configuration & Data Paths

Enabling and Disabling

Enabling an Add-On

Once an Add-On has been installed, it has to be enabled before it can be used. Simply place a check mark on the Enable Add-On box of the Add-On you wish to activate and you're done. The extra functionality of the Add-on is now integrated into Blender and can be used.

To disable the functionality again, uncheck the box. To get more information on a certain Add-on you can press the arrow at the left of the entry and any additional information that is available will be shown. If the Add-On does not activate when enabled, check the Console window for any errors that may have occurred when loading.

Blender3D FreeTip.gif
Saving Add-On Preferences
If you want an Add-On to be enabled everytime you start Blender, you will need to save your User Preferences.

Development guidelines

If you are a script developer, you may be interested in the Add-Ons development guidelines.

Blender3D FreeTip.gif
This is the old manual!
For the current 2.7x manual see

User Manual

World and Ambient Effects


World Background

Ambient Effects

Stars (2.69)

Game Engine


Introduction to the Game Engine
Game Logic Screen Layout


Logic Properties and States
The Logic Editor


Introduction to Sensors
Sensor Editing
Common Options
-Actuator Sensor
-Always Sensor
-Collision Sensor
-Delay Sensor
-Joystick Sensor
-Keyboard Sensor
-Message Sensor
-Mouse Sensor
-Near Sensor
-Property Sensor
-Radar Sensor
-Random Sensor
-Ray Sensor
-Touch Sensor


Controller Editing
-AND Controller
-OR Controller
-NAND Controller
-NOR Controller
-XOR Controller
-XNOR Controller
-Expression Controller
-Python Controller


Actuator Editing
Common Options
-2D Filters Actuator
-Action Actuator
-Camera Actuator
-Constraint Actuator
-Edit Object Actuator
-Game Actuator
-Message Actuator
-Motion Actuator
-Parent Actuator
-Property Actuator
-Random Actuator
-Scene Actuator
-Sound Actuator
-State Actuator
-Steering Actuator
-Visibility Actuator

Game Properties

Property Editing

Game States



Camera Editing
Stereo Camera
Dome Camera




Material Physics
No Collision Object
Static Object
Dynamic Object
Rigid Body Object
Soft Body Object
Vehicle Controller
Sensor Object
Occluder Object

Path Finding

Navigation Mesh Modifier

Game Performance

Framerate and Profile
Level of Detail

Python API

Bullet physics


Standalone Player
Licensing of Blender Game

Android Support

Android Game development