Not Motion Graphics.

// Bracelet Generator
import c4d
import copy

# Helper function to get the correct object index from the character
def get_object_index_from_char(char):
    # For standard characters 'A'-'Z', 'a'-'z', and '0'-'9'
    if 'A' <= char <= 'Z':  # A to Z
        return ord(char) - ord('A')  # Index 0-25 for A-Z
    elif 'a' <= char <= 'z':  # a to z
        return ord(char.upper()) - ord('A')  # Also map lowercase to A-Z range
    elif '0' <= char <= '9':  # 0 to 9
        return ord(char) - ord('0') + 26  # Index 26-35 for 0-9
    # Handle special characters '+', '?', '<', '>', '$', '*', '_'
    special_chars = {'+': 36, '?': 37, '<': 38, '>': 39, '$': 40, '*': 41, '_': 42, '=': 43}
    return special_chars.get(char)

def check_conditions(cloner, linked_object):
    # Conditions that need to be met for the script to set the clone count correctly
    warnings = []

    # Check if the cloner is in Object Mode (ID_MG_MOTIONGENERATOR_MODE == 0)
    if cloner[c4d.ID_MG_MOTIONGENERATOR_MODE] != 0:
        warnings.append("Cloner is not in Object Mode.")

    # Check if the linked object is a spline
    if linked_object and linked_object.GetType() not in [c4d.Ospline, c4d.Osplinecircle, c4d.Osplinerectangle]:  # Add more spline types as needed
        warnings.append("The linked object is not a spline.")

    # Check if the spline mode is set to 0 (MG_SPLINE_MODE == 0)
    if cloner[c4d.MG_SPLINE_MODE] != 0:
        warnings.append("Cloner distribution is not set to 'count' (MG_SPLINE_MODE is not 0).")

    return warnings

def populate_cloner(cloner):
    try:
        doc = c4d.documents.GetActiveDocument()  # Get the active document

        cloner_name = cloner.GetName()  # Get the name of the cloner object

        # Validate the cloner name
        if not cloner_name:
            c4d.gui.MessageDialog("Error: Cloner name is empty.")
            return

        # Check for linked object (MG_OBJECT_LINK)
        linked_object = cloner.GetParameter(c4d.MG_OBJECT_LINK, c4d.DESCFLAGS_GET_0)
        if linked_object:
            print(f"Cloner is cloning over object: {linked_object.GetName()}")
        else:
            c4d.gui.MessageDialog("Cloner does not have a linked object.")
            return

        # Search for the selection object by name
        selection_obj = doc.SearchObject("character_refs")  # Replace with the actual name of the selection object
        if not selection_obj:
            c4d.gui.MessageDialog("Error: Selection object not found.")
            return

        # Access the In-/Exclusion list (InExcludeData) from the selection object
        in_exclude_list = selection_obj.GetParameter(c4d.SELECTIONOBJECT_LIST, c4d.DESCFLAGS_GET_0)
        
        if not in_exclude_list or in_exclude_list.GetObjectCount() == 0:
            c4d.gui.MessageDialog("Error: The selection object list is empty.")
            return

        # Clear existing children in the cloner
        children = cloner.GetChildren()
        for child in children:
            doc.AddUndo(c4d.UNDOTYPE_DELETE, child)
            child.Remove()

        # Track the last inserted instance for InsertAfter
        last_instance = None

        # Count the number of clones
        clone_count = 0

        # Collect warnings for unassigned characters
        unassigned_warnings = []

        # Iterate through each character in the cloner's name
        for i, char in enumerate(cloner_name):
            # Create a new instance object for each character, including underscores
            instance = c4d.BaseObject(c4d.Oinstance)

            # Special naming for $, *, and _
            if char == "$":
                instance.SetName("heart_instance")
            elif char == "*":
                instance.SetName("star_instance")
            elif char == "_":
                instance.SetName("Filler_bead_instance")  # Renaming for underscore instances
            else:
                instance.SetName(f"{char}_instance")  # Default naming with character followed by _instance

            # Get the corresponding object index from the character
            object_index = get_object_index_from_char(char)

            if object_index is not None and object_index < in_exclude_list.GetObjectCount():
                ref_object = in_exclude_list.ObjectFromIndex(doc, object_index)
                if ref_object:
                    print(f"Assigning reference object {ref_object.GetName()} to instance '{char}'.")
                    instance[c4d.INSTANCEOBJECT_LINK] = ref_object  # Link the instance to the reference object
                else:
                    unassigned_warnings.append(f"Warning: No reference object found for character '{char}'. Instance left empty.")
                    instance[c4d.INSTANCEOBJECT_LINK] = None  # Leave the instance unassigned
            else:
                # Character does not have a corresponding object in the list, leave the instance empty and warn
                unassigned_warnings.append(f"Warning: Character '{char}' is unassigned, instance object left empty.")
                instance[c4d.INSTANCEOBJECT_LINK] = None  # Leave the instance unassigned

            # Add the instance object as a child of the cloner
            if last_instance is None:
                instance.InsertUnder(cloner)
            else:
                instance.InsertAfter(last_instance)

            # Track the current instance as the last inserted one
            last_instance = instance

            # Increase clone count
            clone_count += 1

        # Update the clone count using the correct parameter
        cloner.SetParameter(c4d.MG_SPLINE_COUNT, len(cloner_name), c4d.DESCFLAGS_SET_0)

        # Print the length of the name and the clone count
        print(f"Cloner name length: {len(cloner_name)}")
        print(f"Number of clones created: {clone_count}")

        # After the script finishes running, check if any warnings need to be issued
        warnings = check_conditions(cloner, linked_object)
        if warnings:
            warning_message = "\n".join(warnings)
            c4d.gui.MessageDialog(f"Warning: Cloner count couldn't be set due to the following reasons:\n{warning_message}")

        # Display all collected unassigned warnings at once
        if unassigned_warnings:
            warning_message = "\n".join(unassigned_warnings)
            c4d.gui.MessageDialog(f"Unassigned Character Warnings:\n{warning_message}")

        # Update Cinema 4D document
        c4d.EventAdd()

    except Exception as e:
        c4d.gui.MessageDialog(f"Error: {e}")

# Main function to run the script on the selected object
def main():
    doc = c4d.documents.GetActiveDocument()  # Get the active document
    selected_object = doc.GetActiveObject()  # Get the currently selected object

    # Check if the selected object is a cloner
    if selected_object and selected_object.GetType() == c4d.Omgcloner:
        populate_cloner(selected_object)
    else:
        c4d.gui.MessageDialog("Error: No cloner object selected. Please select a cloner object and run the script.")

# Run the main function
if __name__ == "__main__":
    main()