unity-primetween

name	unity-primetween
description	Inspect PrimeTween Free and generate runtime tween scripts

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Checking a PrimeTween installation
• Exploring supported animation APIs
• Generating Transform/Sequence animation code
• 检查 PrimeTween 安装状态、探索动画 API、生成 Transform/Sequence 动画代码

PrimeTween Skills

PrimeTween Free support is intentionally tailored to its API rather than mirroring DOTween: it discovers static factories, reads process-wide configuration, and generates runtime scripts that own and stop their Tween or Sequence handles. It does not configure a DOTween-style settings asset or create PrimeTween Pro components.

Guardrails

• PrimeTween must be installed as com.kyrylokuzyk.primetween.
• Query skills (primetween_get_status, primetween_get_config, primetween_list_factories) run directly in all operating modes.
• Auto-forbidden in this module: the two script generators primetween_generate_tween_script and primetween_generate_sequence_script (both MayTriggerReload = true, RiskLevel = "high" — writing a new .cs triggers compilation + Domain Reload). They return MODE_FORBIDDEN under Approval and Auto, and are reachable only under Bypass mode or via a user-managed Allowlist entry; the grant flow returns MODE_FORBIDDEN too, so do not attempt it.
• primetween_get_config is read-only. PrimeTweenConfig is runtime state, not a serialized project configuration asset.
• Generated scripts support Transform Position, LocalPosition, EulerAngles, LocalEulerAngles, and Scale. Use primetween_list_factories before requesting an API outside that supported generator set.
• PrimeTween handles are non-reusable. Generated scripts stop their owned live handle on disable instead of using a DOTween SetLink equivalent.

Free Skills

primetween_get_status

Report whether PrimeTween is installed, its package version, assembly, and visible core types.

Parameters: None.

primetween_get_config

Read the current global runtime values exposed by PrimeTweenConfig.

Parameters: None.

primetween_list_factories

List public static methods from one PrimeTween API type.

Parameters: typeName="Tween" (Tween, Sequence, Shake, or PrimeTweenConfig), methodPrefix?, limit=100.

primetween_generate_tween_script

Create a Transform-focused PrimeTween MonoBehaviour that owns its Tween and stops it on disable.

Parameters: className, folder="Assets/Scripts/PrimeTween", namespaceName?, tweenKind="LocalPosition", duration=1, ease="OutQuad", cycles=1, cycleMode="Restart", autoPlay=true.

primetween_generate_sequence_script

Create a PrimeTween MonoBehaviour that uses Sequence.Chain and Sequence.Group with supported Transform tween factories.

Parameters: className, folder="Assets/Scripts/PrimeTween", namespaceName?, tweenKind="Scale", duration=0.2, ease="OutBack", cycles=1, sequenceCycleMode="Restart", autoPlay=true, stepsJson?.

stepsJson is a JSON array of { "op": "Chain|Group", "tweenKind": "Scale", "duration": 0.2 }.

Exact Signatures

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