From BlenderWiki

[edit] Scripts

[edit] note

	PLEASE NOTE:
	' Feel free to help in this section. Script are being slowly updated & written for blender 2.5, Please check the api for recent changes & include revision numbers for Blender in your scripts or docs. That is say "Works with Rev:24633" so tracking becomes easier. '

[edit] Introduction

A script is a program that is written in the Python language which runs within Blender, and calls on Blender routines to create new functionality. Because Python is a popular interpreted programming language, it can be used to extend the functionality of Blender in a wide array of ways. Users all over the world have written hundreds of scripts, and this section of the Blender wiki attempts to catalog and document those scripts, and provide you the user with information on how to use & write Scripts more effectively & a little easier.

[edit] Blender 2.5

• Blender has gone through some big changes:

Python 3 series is now in use, this meant writing an Python API basically from scratch again. Campbell Barton aka ideasman42, has made an huge effort towards getting an API for Blender/Python that integrates Python more effectively & consistently than ever before. Be prepared for some more changes in the api, but already it's quite usable. I would recommend taking a look at the api learning the new functions, exploring the new api, have a go at writing some scripts. Soon, bmesh & the new render/materials system are being added. This may/will mean some more changes to the Python api. Don't let this stop you from exploring & learning the new api. There's plenty of great Python scripting Fun to be had! enjoy.

[edit] API

• Dev:2.5/Py/API/Intro
  • current api intro by ideasman42
  • contains examples

• http://www.blender.org/documentation/250PythonDoc/
  • current API

[edit] Manual

yet to be written.

• Doc:2.5/Manual/Extensions/Python

[edit] Script Development

devs, feel free to add things here.

• Dev:2.5/Py/Scripts

[edit] Links

• http://en.wikibooks.org/wiki/Blender_3D:_Blending_Into_Python/2.5_quickstart
  • Blending Into Python is also a great resource.

Remember if something does not work, check the current api for changes.

• http://blenderartists.org/forum/forumdisplay.php?f=11
  • Python & Plugin forum on Blender Artists.

There's a fair amount of blender 2.5 scripting going on in the forum, it can be a valuable resource.

[edit] Catalog

• • • Extensions:Py/Scripts/2.5x (2.5x catalog, but not called "catalog")

yes, there will be one. yet to be written.

[edit] Plugins

yet to be written.

[edit] Blender 2.49b

Blender 2.49b uses Python 2.6 series. There are many great scripts & examples of scripting in this section. You cannot open these scripts in Blender 2.5. However the vast array of algorithms, is still very useful.

[edit] API

• http://www.blender.org/documentation/249PythonDoc/

Blender 2.49 API

[edit] Manual

• Doc:Manual/Extensions/Python 2.49 manual page.

• Doc:Manual/Extensions/Python/References includes api references from 2.42 - 2.49.

• Doc:Manual/Extensions/Python/Scripts_guidelines a useful intro to using 2.49 scripts.

[edit] Catalog

• Extensions:Py/Scripts/2.4x (2.4x catalog, was Extensions:Py/Scripts/Catalog)

The 2.49b Scripts Catalog is here, along with links to other 2.4x resources.

[edit] Plugins

• http://www-users.cs.umn.edu/~mein/blender/plugins/

• Doc:Manual/Extensions/Plugins

• Extensions:Plugins, contains:
  • no documentation about plugins usage, but link to Doc:Manual/Extensions/Plugins
  • link to Development part of plugins (Dev:Plugins)
  • link to catalogs (which are subpages of this index):
    • 2.5x catalog Extensions:Plugins/2.5x (2.5x catalog, but not called "catalog")
    • 2.4x catalog Extensions:Plugins/2.4x (2.4x catalog, was Extensions:Plugins)

• Dev:Plugins (index of development pages)
  • Dev:Plugins/Concepts: api docs and concepts
  • Dev:Plugins/Examples: howto do things
    • general howto (cookbook/snipetts)
  • Dev:Plugins/Sharing: how to share your plugin on bf-extensions
    • plugins trackers howto
    • contrib-svn howto

[edit] To Do List

older links to clean up:

• Dev:Py/Scripts (index of development pages)
• Manual/Python Scripting: A detailed description of Python & Blender from the Blender Manual pages.
• Doc:Manual/Extensions/Python merge with above.
• Extensions:Py/Scripts/Image & associated pages.
• Extensions:Contents full list of extensions namespace
• Dev:Py get this started properly!
• Dev:Extensions/Sharing links on how to use bf:extensions & sharing.