set_event_dispatcher_signature
DestructiveIdempotent
Add or replace an event dispatcher's parameter list in a Blueprint you own, resolving all types before any change to prevent partial edits.
Instructions
Add to (mode="add", the idempotent default) or rewrite (mode="replace") the parameter list of a dispatcher this Blueprint OWNS -- inherited dispatchers have no local signature graph and are refused with the list of owned ones. Every requested type is resolved BEFORE anything is mutated, so a bad type aborts cleanly. The parameters become the OUTPUT pins of every bound handler and the INPUT pins of add_broadcast_node; existing nodes keep stale pins until compile_blueprint reconstructs them.
Returns: { blueprint_name, dispatcher_name, mode, added: [string], params: [ { name, type } ], param_count }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | Alias of `params` (same value, same meaning). Accepted because sibling tools spell this parameter differently; prefer `params`. | |
| mode | No | "add" (default, idempotent: skip a param whose name already exists) or "replace" (clear the existing signature first, then add the given params). | |
| force | No | Optional. This command is REFUSED while a Play-in-Editor session is running: it either compiles a Blueprint (the reinstancer can retain a world, and CheckForWorldGCLeaks is Fatal -- it KILLS the editor) or writes to disk (Editor.AllowSavingAssetsDuringPIE=0 makes the engine refuse the write, so it would report success without writing a byte). Stop PIE and retry instead; force=true runs it anyway, at your own risk. | |
| params | No | Array of parameter specs to add: [ { name: string, type: string } ]. Dispatcher params are input-only; 'type' accepts the same strings as add_function_parameter (bool, int, int64, float, string, name, text, byte, Vector, Array<T>, an object/class/struct/enum name or path). | |
| args_json | No | Alias of `params` (same value, same meaning). Accepted because sibling tools spell this parameter differently; prefer `params`. | |
| parameters | No | Alias of `params` (same value, same meaning). Accepted because sibling tools spell this parameter differently; prefer `params`. | |
| blueprint_name | No | Blueprint asset name or path that OWNS the dispatcher (inherited dispatchers cannot be edited here). | |
| blueprint_path | No | Alias of `blueprint_name` (same value, same meaning). Accepted because sibling tools spell this parameter differently; prefer `blueprint_name`. | |
| dispatcher_name | Yes | Name of an existing event dispatcher (created by add_event_dispatcher or the editor). |