前置插件：聊天栏菜单

介绍

聊天栏菜单主要提供了将触发词命令注册到聊天栏菜单中的功能，让你可以在聊天栏中唤出插件功能。

例如：

• .help - 显示聊天栏菜单帮助
• .music play - 播放音乐 （音乐播放器插件）
• .spawnpoint - 记录重生点 （自定义聊天栏菜单插件）

获取方式

from tooldelta import plugins

chatbar = plugins.get_plugin_api("聊天栏菜单")

接口

添加聊天栏菜单项

def add_trigger(
    triggers: list[str],
    argument_hint: str | None,
    usage: str,
    func: Callable | None,
    args_pd: Callable[[int], bool] = lambda _: True,
    op_only=False,
)

• 添加一个菜单触发词项。
• 参数：
  • triggers (list[str]): 触发词列表，如 ["help"]
  • argument_hint (str | None): 触发词参数提示，如 "[arg1] [arg2]"
  • usage (str): 命令说明，如 "显示帮助信息"
  • func ((str, list[str]) -> bool): 命令执行回调：(玩家名, 参数列表) -> bool，一般来说返回 True 即可
  • args_pd (int) -> bool: 参数个数合法性判断回调，传入参数个数，返回表示参数个数是否合法