Init-Script erstellen¶

Damit ein Plugin eingebunden werden kann, muss ein gültiges Python-Modul vorliegen. Beim Laden eines Plugins wird das Hauptskript namens __init__.py aufgerufen. Dieses muss alle anderen Module nachladen. Außerdem muss es über die Funktionen register() und unregister() verfügen, die beim Laden bzw. Entladen des Plugins aufgerufen werden. Obwohl sie beliebigen Code enthalten dürfen, werden sie in der Regel dazu verwendet, plugineigene Datenstrukturen und Klassen zu registrieren.

Ein minimales Beispiel für eine __init__.py am Ende dieses Abschnittes könnte so aussehen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

import bpy
class Testklasse(bpy.types.Operator):
    """Tooltip"""
    bl_idname = "object.nutzlos"
    bl_label = "Tut nichts"

    @classmethod
    def poll(cls, context):
        return true

    def execute(self, context):
        return {'FINISHED'}


def register():
    bpy.utils.register_class(Testklasse)


def unregister():
    bpy.utils.unregister_class(Testklasse)

Header hinzufügen¶

Ein Plugin in Python benötigt einige Informationen am Beginn der __init__.py. Diese werden in der folgenden Form angegeben:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

bl_info = {
    "author": "Max Mustermann",
    "name": "Plugin von Max",
    "description": "Beschreibungstext",
    "warning": "",
    "version": (0, 0),
    "blender": (2, 72, 0), 
    "support": 'TESTING',
    "category": 'Kategoriename'
}

Die Bedeutung der einzelnen Einträge ist dieser Tabelle zu entnehmen:

Bei den Kategorien hat man die Wahl zwischen den folgenden dreiundzwanzig Einträgen:

• '3D View'

• 'Add Mesh'

• 'Add Curve'

• 'Animation'

• 'Developement'

• 'Game Engine'

• 'Import-Export'

• 'Lighting'

• 'Material'

• 'Mesh'

• 'Node'

• 'Object'

• 'Physics'

• 'Pyconstraint'

• 'Pydriver'

• 'Pynode'

• 'Paint'

• 'Render'

• 'Rigging'

• 'System'

• 'Text Editor'

• 'UV'

• 'User Interface'

Einbinden¶

Das so erhaltene Plugin umfasst neben der Headerdatei alle geladenen Module, die nicht von Python oder Blender bereitgestellt werden. Es kann entweder über die graphische Oberfläche installiert oder händisch in einen beliebig benannten Unterordner des Pluginordners ~/.config/blender/<Versionsnummer>/scripts/addons kopiert werden.