🌟 特殊函数#

某些函数遵循特定约定以精简功能并确保跨模块一致性。


👉 ata 函数#

这是“从执行者到执行位置(as to at)”的简写。某些函数需要两个位置才能工作(例如:获取两点间距离)或一个实体和一个位置。为简化使用,无需为每个位置传递3个分数值。你可将实体放置在点1(如有需要),然后以点1的实体为执行者,在点2位置执行函数。


🔗 runner 函数#

这些函数使用 run 回调指定通常立即执行的动作。它像子命令一样工作,定义函数调用后应执行的操作。

例如:

function #bs.view:at_aimed_block {run: "<command>", with: {}}

📡 listener 函数#

这些函数设计用于响应特定事件。命名约定 on_<事件> 用于输入,指示特定事件发生时将触发的命令。

例如:

function #bs.health:time_to_live {with: {on_death: "<command>", time: 10}}

⚒️ callback 函数#

这些函数专门作为回调的一部分执行,其函数标签必须放在 callback 目录内。

例如:

  • #bs.move:callback/bounce

  • #bs.move:callback/slide

  • #bs.interaction:callback/glow


🔒 保留函数#

保留函数是每个模块中具有预定用途的特殊函数,位于模块根目录。

__help__

该函数提供指向模块文档的路径(自动生成)

__load__

该函数在模块加载时执行(必须存在于每个模块中)

__unload__

该函数在模块卸载时执行(必须存在于每个模块中)