name	copilot-control
internal	true
description	Paracraft 3D场景中的Copilot子角色控制技能。当LLM需要控制NPC角色（宠物、助手等）执行动作（说话、移动、播放动画）时使用此技能。涵盖角色发现、代码执行、消息发送和多角色协作。

Skill: Copilot角色控制

Skill Config

tools: run_paracraft_copilot_code, list_copilots, send_message_to_copilot
observation_keywords: copilot, 宠物, pet, NPC, 角色, character, 走路, 说话, 动画
structured_keywords: 控制角色, control character, copilot command
scene_focus: copilot characters visible, NPC actors in scene
internal: true

使用说明

可用工具

list_copilots: 列出所有可用的copilot角色及其能力
send_message_to_copilot: 向指定copilot发送消息或命令
run_paracraft_copilot_code: 执行Lua代码控制copilot角色

run_paracraft_copilot_code 用法

在代码中可使用以下函数：

函数	说明
`Say(text, duration)`	让角色说话，duration为秒数
`WalkTo(x, y, z)`	走到指定方块坐标
`WalkForward(distance)`	向前走指定距离
`Wait(seconds)`	等待指定秒数
`PlayAnimation(name)`	播放指定动画
`GetPlayerBlockPos()`	获取玩家方块坐标，返回 [x,y,z]
`GetPosition()`	获取copilot自身坐标，返回 [x,y,z]

代码示例

-- 让角色走到玩家身边并打招呼
local pos = GetPlayerBlockPos()
if pos[1] then
    WalkTo(pos[1] + 1, pos[2], pos[3])
    Wait(1)
    Say("你好！我来帮你啦！", 3)
end

-- 让角色播放动画并说话
PlayAnimation("dance")
Wait(2)
Say("跳舞真开心！", 2)

注意事项

使用 GetPlayerBlockPos() 获取玩家位置前要检查返回值是否有效
位置函数返回数组 [x,y,z]，用 pos[1], pos[2], pos[3] 访问
代码在协程环境中运行，可使用 Wait() 进行延时
copilotName 参数使用角色的 id（如 __my_pet_copilot__）

Más de este repositorio

mismo repositorio

coding-teaching

NPLPackages/paracraft

Paracraft 场景中的编程学习 skill。当用户要学编程、代码方块、NPL、Lua 或基础命令时使用。目标是稳定驱动编程学习流程。

2026-07-1727

english-teaching

NPLPackages/paracraft

Paracraft 场景中的英语学习 skill。当用户要学英语、单词、拼写、口语或翻译时使用。目标是稳定驱动英语学习流程。

2026-07-1727

user-profile

NPLPackages/paracraft

结构化收集或确认学员档案信息。当需要补充姓名、年龄、年级、兴趣、英语水平或编程水平时使用。

2026-07-1727

block-operations

NPLPackages/paracraft

Paracraft 3D世界中方块操作技能。当用户需要放置、删除、填充、替换、克隆、旋转、平移、镜像方块，或者修改方块属性（颜色、光照、可见性等），加载/保存模板，导出模型，或者需要查询场景中的方块信息时使用此技能。通过 run_npl_codeblock_code 工具执行斜杠命令和 BlockEngine API 来操作3D世界。涵盖所有方块相关操作和常用方块ID查询。关键词：方块、block、放置、删除、填充、替换、克隆、旋转、镜像、模板、颜色、建造、build、setblock、场景、scene。

2026-07-1727

dialog-summary

NPLPackages/paracraft

对话历史摘要压缩技能（内部）。当对话上下文过长时，DialogHistoryManager 自动调用此技能将旧对话压缩为摘要，保留学习相关关键信息，过滤无关闲聊。

2026-07-1727

name	copilot-control
internal	true
description	Paracraft 3D场景中的Copilot子角色控制技能。当LLM需要控制NPC角色（宠物、助手等）执行动作（说话、移动、播放动画）时使用此技能。涵盖角色发现、代码执行、消息发送和多角色协作。

Skill: Copilot角色控制

Skill Config

tools: run_paracraft_copilot_code, list_copilots, send_message_to_copilot
observation_keywords: copilot, 宠物, pet, NPC, 角色, character, 走路, 说话, 动画
structured_keywords: 控制角色, control character, copilot command
scene_focus: copilot characters visible, NPC actors in scene
internal: true

使用说明

可用工具

list_copilots: 列出所有可用的copilot角色及其能力
send_message_to_copilot: 向指定copilot发送消息或命令
run_paracraft_copilot_code: 执行Lua代码控制copilot角色

run_paracraft_copilot_code 用法

在代码中可使用以下函数：

函数	说明
`Say(text, duration)`	让角色说话，duration为秒数
`WalkTo(x, y, z)`	走到指定方块坐标
`WalkForward(distance)`	向前走指定距离
`Wait(seconds)`	等待指定秒数
`PlayAnimation(name)`	播放指定动画
`GetPlayerBlockPos()`	获取玩家方块坐标，返回 [x,y,z]
`GetPosition()`	获取copilot自身坐标，返回 [x,y,z]

代码示例

-- 让角色走到玩家身边并打招呼
local pos = GetPlayerBlockPos()
if pos[1] then
    WalkTo(pos[1] + 1, pos[2], pos[3])
    Wait(1)
    Say("你好！我来帮你啦！", 3)
end

-- 让角色播放动画并说话
PlayAnimation("dance")
Wait(2)
Say("跳舞真开心！", 2)

注意事项

使用 GetPlayerBlockPos() 获取玩家位置前要检查返回值是否有效
位置函数返回数组 [x,y,z]，用 pos[1], pos[2], pos[3] 访问
代码在协程环境中运行，可使用 Wait() 进行延时
copilotName 参数使用角色的 id（如 __my_pet_copilot__）