import{_ as i,o as a,c as n,a7 as t}from"./chunks/framework._avq4Ty7.js";const c=JSON.parse('{"title":"轻雪函数","description":"","frontmatter":{"title":"轻雪函数","order":2},"headers":[],"relativePath":"dev/lyfunc.md","filePath":"zh/dev/lyfunc.md","lastUpdated":1725101868000}'),l={name:"dev/lyfunc.md"};function e(h,s,p,k,d,r){return a(),n("div",null,s[0]||(s[0]=[t(`

轻雪函数 ​

轻雪函数 Liteyuki Function 是轻雪的一个功能，它允许你在轻雪中运行一些自定义的由数据驱动的命令，类似于Minecraft的mcfunction，属于资源包的一部分，但需单独起篇幅.

函数文件 ​

函数文件放在资源包的functions目录下，文件名以.mcfunction .lyfunction .lyf结尾，例如test.mcfunction，文件内容为一系列的命令，每行一个命令，支持单行注释#(编辑时的语法高亮可采取shell格式)，例如：

shell
# 在发信器输出"hello world"
cmd echo hello world

# 如果你想同时输出多行内容可以尝试换行符(Python格式)
cmd echo hello world\\nLiteyuki bot

也支持句末注释，例如：

shell
cmd echo hello world # 输出"hello world"

命令文档 ​

shell
var <var1=value1> [var2=value2] ...  # 定义变量
cmd <command>  # 在设备上执行命令
api <api_name> [var=value...]  # 调用Bot API
function <func_name> # 调用函数，可递归
sleep <time>  # 异步等待，单位s
nohup <command>  # 使用新的task执行命令，即不等待
end # 结束函数关键字，包括子task
await # 等待所有异步任务结束，若函数中启动了其他task，需要在最后调用，否则task对象会被销毁

示例 ​

shell
# 疯狂戳好友
# 使用 /function poke user_id=123456 执行
# 每隔0.2s戳两次，无限戳，会触发最大递归深度限制
# 若要戳20s后停止，则需要删除await，添加sleep 20和end
api friend_poke user_id=user_id
api friend_poke user_id=user_id
sleep 0.2
nohup function poke
await

API ​

理论上所有基于onebotv11的api都可调用，不同Adapter api也有差别.

Onebot v11 API文档

结束关键字 ​

由于LiteyukiBot基于异步运行, 所以在编写lyfunction时也要注意异步的调用，避免出现"单线程走到底"的情况是效率提升的关键.

await 异步任务结束关键字，用于结束当前已完成function的执行

WARNING

但若出现非单function的情况，有一个task任务没有完成而await被执行了，那么当前所有函数包的task都会被截停销毁

TIP

编写轻雪函数推荐你使用VS Code插件Liteyuki Function实现语法高亮

`,19)]))}const g=i(l,[["render",e]]);export{c as __pageData,g as default};