前置插件：聊天栏菜单

介绍

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

例如：

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

获取方式

• 类式插件：

  class MyPlugin(Plugin):
      ...
      
      def __init__(self, frame):
          super().__init__(frame)
          self.ListenPreload(self.on_preload)
  
      def on_preload(self):
          chatbar = self.GetPluginAPI("聊天栏菜单")

接口

添加聊天栏菜单项

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	触发词参数提示，如 "[arg1] [arg2]"
  usage	str	命令说明，如 "显示帮助信息"
  func	(str, list[str]) -> bool	命令执行回调：(玩家名, 参数列表) -> bool，一般来说返回 True 即可
  args_pd	(int) -> bool	参数个数合法性判断回调，传入参数个数，返回表示参数个数是否合法