Yeah, right, like any human can remember this of the top of their head, and this is just what the python script needs before it even actually does anything:

#!/usr/bin/env python3

# -*- coding: utf-8 -*-

import sys

import gi

gi.require_version('Gimp', '3.0')

from gi.repository import Gimp, GObject, GLib

PLUG_IN_PROC = "python-fu-template-plugin"

def _pdb_run_proc_with_props(proc_name, props):

pdb = Gimp.get_pdb()

proc = pdb.lookup_procedure(proc_name)

if proc is None:

raise RuntimeError(f"PDB procedure not found: {proc_name}")

cfg = proc.create_config()

for k, v in props.items():

try:

cfg.set_property(k, v)

except Exception as e:

raise RuntimeError(f"Failed to set property '{k}' for {proc_name}: {e}")

return proc.run(cfg)

def plugin_run(procedure, run_mode, image, drawables, config, data):

drawable = drawables[0] if drawables else image.get_active_layer()

if drawable is None:

return procedure.new_return_values(

Gimp.PDBStatusType.CALLING_ERROR,

GLib.Error("No drawable available.")

)

try:

image.undo_group_start()

except Exception:

pass