unity-event

UnityEvent persistent-listener wiring at editor time — inspect, add, remove, batch-add, copy, clear, set call-state, list events on a component. Exact signatures via GET /skills/schema.

gabrielmoreira/agent-skills-mirror·0installs7stars

SKILL.md

Full skill instructions

Event Skills

Inspect and modify persistent listeners on UnityEvents (e.g. Button.onClick, Toggle.onValueChanged) — the same listeners you see in the Inspector's event drop slots.

Operating Mode

Approval：查询类 skill（event_get_listeners / event_list_events / event_get_listener_count，源码标 SkillMode.SemiAuto）直接执行；其余变更/调用类（event_add_listener / event_set_listener / event_set_listener_state / event_invoke / event_add_listener_batch / event_copy_listeners，标 SkillMode.FullAuto）需用户 grant，grant 后服务端一步执行返结果。
Auto / Bypass：未被禁列表拦截的 skill 直接执行。
本模块含 Delete 类 skill：event_remove_listener、event_clear_listeners 标记为 SkillOperation.Delete，被 IsForbiddenInSemi 静态拦截 —— 仅 Bypass 模式或加入 Allowlist 才能调用。
event_invoke 只在 Play mode / runtime 下有效；编辑器空跑时仅触发 EditorAndRuntime 监听。event_add_listener 等写入的是 persistent listener（序列化到 prefab/scene），即可在编辑器时配置。

DO NOT (common hallucinations):

event_create / event_trigger do not exist → UnityEvents are declared in component source code; this module only wires listeners
event_subscribe does not exist → use event_add_listener
event_remove does not exist → use event_remove_listener
event_add_listener requires exact component type and method name on the target

Routing:

For XR interaction events → use xr module's xr_add_interaction_event
For C# event code → write via script module

Skills

`event_get_listeners`

Get persistent listeners of a UnityEvent. Parameters:

name / instanceId / path: Target GameObject locator.
componentName (string): Component name.
eventName (string): Event field name (e.g. "onClick").

`event_add_listener`

Add a persistent listener to a UnityEvent (Editor time). Parameters:

name / instanceId / path, componentName, eventName: Target event.
targetObjectName, targetComponentName, methodName: Method to call.
mode (string, optional): "RuntimeOnly", "EditorAndRuntime", "Off".
argType (string, optional): "void", "int", "float", "string", "bool".
floatArg, intArg, stringArg, boolArg: Argument value if needed.

`event_remove_listener`

Remove a persistent listener by index. Parameters:

name / instanceId / path, componentName, eventName: Target event.
index (int): Listener index.

`event_invoke`

Invoke a UnityEvent explicitly (Runtime only). Parameters:

name / instanceId / path, componentName, eventName: Target event.

`event_clear_listeners`

Remove all persistent listeners from a UnityEvent.

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
componentName	string	No	null	Component name
eventName	string	No	null	Event field name (e.g. "onClick")

Returns: { success, removed }

`event_set_listener_state`

Set a listener's call state (Off, RuntimeOnly, EditorAndRuntime).

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
componentName	string	No	null	Component name
eventName	string	No	null	Event field name
index	int	No	0	Listener index
state	string	No	null	Call state: "Off", "RuntimeOnly", or "EditorAndRuntime"

Returns: { success, index, state }

`event_set_listener`

Replace a persistent listener at a specific index.

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
componentName	string	No	null	Source component name
eventName	string	No	null	Event field name
index	int	No	0	Listener index to replace
targetName	string	No	null	Target GameObject name
targetInstanceId	int	No	0	Target GameObject instance ID
targetPath	string	No	null	Target hierarchy path
targetComponentName	string	No	null	Target component name, or `GameObject`
methodName	string	No	null	Public method or `set_PropertyName`
mode	string	No	RuntimeOnly	Off, RuntimeOnly, or EditorAndRuntime
argType	string	No	void	void, int, float, string, bool, object
floatArg	float	No	0	Static float argument
intArg	int	No	0	Static int argument
stringArg	string	No	null	Static string argument
boolArg	bool	No	false	Static bool argument
objectReferenceName	string	No	null	Scene object argument name
objectReferenceInstanceId	int	No	0	Scene object argument instance ID
objectReferencePath	string	No	null	Scene object argument path
objectAssetPath	string	No	null	Project asset argument path
objectType	string	No	null	Object/component type for object argument

Returns: { success, index, target, targetType, method, state, argType }

`event_list_events`

List all UnityEvent fields on a component.

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
componentName	string	No	null	Component name

Returns: { success, component, count, events }

`event_add_listener_batch`

Add multiple listeners at once. items: JSON array of {targetObjectName, targetComponentName, methodName}.

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
componentName	string	No	null	Component name
eventName	string	No	null	Event field name
items	string	No	null	JSON array of {targetObjectName, targetComponentName, methodName}

Returns: { success, added, total }

`event_copy_listeners`

Copy listeners from one event to another.

Parameter	Type	Required	Default	Description
sourceObject	string	Yes	-	Source GameObject name
sourceComponent	string	Yes	-	Source component name
sourceEvent	string	Yes	-	Source event field name
targetObject	string	Yes	-	Target GameObject name
targetComponent	string	Yes	-	Target component name
targetEvent	string	Yes	-	Target event field name

Returns: { success, copied }

`event_get_listener_count`

Get the number of persistent listeners on a UnityEvent.

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
componentName	string	No	null	Component name
eventName	string	No	null	Event field name

Returns: { success, count }

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/gabrielmoreira/agent-skills-mirror --skill event

View on GitHub

mirrors/repos/Besty0728@Unity-Skills/SkillsForUnity/unity-skills~/skills/event/SKILL.md