mcpField
U
unity-primetween

unity-primetween

github.com/besty0728开发1.9k50 次安装今天更新
代码仓库

关于 unity-primetween

unity-primetween 提供 Unity Editor 技能，用于检查 PrimeTween，并生成面向 Transform 的补间或序列脚本。它面向使用 PrimeTween 的 Unity 开发者，依据库的工厂方法和运行时配置，而非 DOTween 式设置资源。

主要功能

  1. 01检查 PrimeTween 安装状态和版本
  2. 02读取进程级运行时配置
  3. 03列出公开静态 API 方法
  4. 04生成 Transform 补间脚本
  5. 05生成链式或分组序列脚本

适用场景

  1. 01确认项目已安装 PrimeTween
  2. 02查看可用的补间工厂方法
  3. 03创建 Transform 动画组件
  4. 04通过链式和分组步骤构建序列

MCP 相关

它向 MCP 客户端提供 Unity Editor 技能，用于检查 PrimeTween 和生成脚本。脚本生成器仅可在 Bypass 模式或用户管理的 Allowlist 条目下使用。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/besty0728/unity-skills --skill unity-primetween

安装后在 Claude Code 中输入/unity-primetween确认已加载。

详细介绍

**调用本模块中的任何技能前：**如果你准备根据技能名称或描述猜测参数后调用技能，请停止——先阅读此文件（或通过 GET /skills/recommend?includeSchema=true 获取其架构）。如果你已从 recommend/schema 获取参数定义，则可直接进行 dryRun。

触发条件

  • 检查 PrimeTween 安装状态
  • 探索受支持的动画 API
  • 生成 Transform/Sequence 动画代码
  • 检查 PrimeTween 安装状态、探索动画 API、生成 Transform/Sequence 动画代码

PrimeTween 技能

PrimeTween Free 的支持有意针对其自身 API 设计，而非照搬 DOTween：它会发现静态工厂、读取进程级配置，并生成由自身持有和停止 Tween 或 Sequence 句柄的运行时脚本。它不会配置 DOTween 风格的设置资源，也不会创建 PrimeTween Pro 组件。

防护措施

  • 必须将 PrimeTween 安装为 com.kyrylokuzyk.primetween。
  • 查询技能（primetween_get_status、primetween_get_config、primetween_list_factories）在所有运行模式下均可直接运行。
  • 本模块中自动禁止：两个脚本生成器 primetween_generate_tween_script 和 primetween_generate_sequence_script（二者均为 MayTriggerReload = true、RiskLevel = "high"——写入新的 .cs 文件会触发编译和 Domain Reload）。在 Approval 和 Auto 模式下，它们都会返回 MODE_FORBIDDEN；只有在 Bypass 模式或通过用户管理的 Allowlist 条目才能调用；授权流程也会返回 MODE_FORBIDDEN，因此不要尝试。
  • primetween_get_config 是只读的。PrimeTweenConfig 是运行时状态，并非序列化的项目配置资源。
  • 生成的脚本支持 Transform 的 Position、LocalPosition、EulerAngles、LocalEulerAngles 和 Scale。请求此生成器支持范围之外的 API 前，请先使用 primetween_list_factories。
  • PrimeTween 句柄不可重复使用。生成的脚本会在禁用时停止其持有的活动句柄，而不是使用 DOTween 的 SetLink 等效功能。

Free 技能

primetween_get_status

报告 PrimeTween 是否已安装、其软件包版本、程序集和可见核心类型。

**参数：**无。

primetween_get_config

读取 PrimeTweenConfig 当前公开的全局运行时值。

**参数：**无。

primetween_list_factories

列出一个 PrimeTween API 类型中的公共静态方法。

参数：typeName="Tween"（Tween、Sequence、Shake 或 PrimeTweenConfig）、methodPrefix?、limit=100。

primetween_generate_tween_script

创建一个专注于 Transform 的 PrimeTween MonoBehaviour，用于持有其 Tween 并在禁用时停止它。

参数：className、folder="Assets/Scripts/PrimeTween"、namespaceName?、tweenKind="LocalPosition"、duration=1、ease="OutQuad"、cycles=1、cycleMode="Restart"、autoPlay=true。

primetween_generate_sequence_script

创建一个 PrimeTween MonoBehaviour，使用 Sequence.Chain 和 Sequence.Group 搭配受支持的 Transform Tween 工厂。

参数：className、folder="Assets/Scripts/PrimeTween"、namespaceName?、tweenKind="Scale"、duration=0.2、ease="OutBack"、cycles=1、sequenceCycleMode="Restart"、autoPlay=true、stepsJson?。

stepsJson 是一个 JSON 数组，包含 { "op": "Chain|Group", "tweenKind": "Scale", "duration": 0.2 }。

精确签名

确切名称、参数、默认值和返回值由 GET /skills/schema 或 unity_skills.get_skill_schema() 定义，而非此文件。

评论

支持 Markdown