Guild of Writers

Alcscript?

AlcScript is a way to set more complex properties on objects, than you can with simple blender logic proprties.

In the basics, alcscript is just a text file that is read and parsed by the plugin. It is locates inside blender - blender has its built-in text editor.

Adding your first alcscript file

To add a default AlcScript file to your blender file, use "Scripts->Add->PyPRP->Add Default AlcScript" in a script window.

Make one window into a text window. Now on the text-windows-menu bar click the leftmost button wiht the double arrows on it, and select the file named "AlcScript".

Now you can start adding code to it.

AlcScript structure

Alcscript has a hierarchical formatting structure that allows us to group settings together, and nest group of settings in other groups of settings. Check the example below:

Ladder1_Top:
    type: region
    region:
        type: ladder
        ladder:
            direction: down
            style: twofeet
            loops: 7

Ladder1_Bot:
    type: region
    region:
        type: ladder
        ladder:
            direction: up
            style: twofeet
            loops: 7

Now you may notice a couple of things from this example:

• There is a structure of keys and values much like this: <key>: <value>
• A value can also be a group of other keys and values
• You indicate a group of keys and values by indenting it - tis can be don with tab-key in your blender file.
• There can be groups in groups in groups
• The first key is always the name of the object, and object-specific settings are located below that.

In the example above, the two objects (ladder regions) - have two keys, "type" and "region". Now "type" is a simple setting - it corresponds to the "type" logic property (which was the "alctype" property) and just has a simpel string as input. (You can either use the logic property "type", or the alcscript property "type" at your leasure). The key "region" however, contains a

[will continue later]