完整插件示例

← 插件与自动化 · 所有分区

此示例为 VexBot 声明式 JSON 规则插件，接口版本 1，无需 Python、Java 或额外依赖。保存为 UTF-8 的 community_helper.json 后，从“扩展 → 导入插件”导入。同 ID 已安装时应走版本更新，新插件请同时更换 ID 和文件名。

社群小助手

{
  "api_version": 1,
  "id": "community_helper",
  "name": "社群小助手",
  "version": "1.0.0",
  "author": "VexBot",
  "description": "提供服讯、问候和可选的入服欢迎通知。所有内容可在面板调整。",
  "settings": {
    "greeting": {
      "type": "string",
      "label": "问候内容",
      "default": "欢迎来到我们的 Minecraft 社区！",
      "description": "群内发送「问候」或「问候 名字」时显示。",
      "max_length": 500
    },
    "join_notice": {
      "type": "boolean",
      "label": "开启插件入服欢迎",
      "default": false,
      "description": "可与内置进退服通知同时发送；只需要一种时，请在消息与事件中关闭内置通知。"
    },
    "welcome": {
      "type": "string",
      "label": "入服欢迎内容",
      "default": "欢迎加入，一起愉快地玩耍吧！",
      "max_length": 500
    },
    "community": {
      "type": "select",
      "label": "社区类型",
      "default": "生存",
      "options": [
        "生存",
        "创造",
        "综合"
      ]
    },
    "recommended_players": {
      "type": "integer",
      "label": "建议组队人数",
      "default": 4,
      "min": 1,
      "max": 20
    },
    "activity_hours": {
      "type": "number",
      "label": "建议活动时长（小时）",
      "default": 1.5,
      "min": 0.5,
      "max": 12
    }
  },
  "rules": [
    {
      "event": "group_command",
      "command": "服讯",
      "match": "exact",
      "reply": "{server_name} · {online}\n在线人数：{online_count}\n玩家：{players}\n社区：{settings.community}\n建议 {settings.recommended_players} 人组队，活动 {settings.activity_hours} 小时。",
      "cooldown": 3
    },
    {
      "event": "group_command",
      "command": "问候",
      "match": "prefix",
      "reply": "{settings.greeting}\n来自：{server_name}\n你的留言：{arg}",
      "cooldown": 3
    },
    {
      "event": "player_join",
      "reply": "[{server_name}] 欢迎 {player}！{settings.welcome}",
      "when": "join_notice",
      "cooldown": 30
    }
  ]
}

验证步骤

1. 导入后插件默认停用，不会立即发送群消息。
2. 打开“设置”修改问候内容，单独保存；在“权限”中限制到测试服务器、关联群和允许的使用者。
3. 启用插件，在关联群发送 服讯，查看桥接连接状态及最近心跳的在线快照。
4. 发送 问候 Steve，确认参数替换；等待至少 3 秒后再次发送以避开冷却。
5. 入服欢迎默认关闭。需要测试时开启该设置，并连接游戏端桥接；若内置进退服通知也开启，可能收到两条通知。
6. 停用后确认不再回复。离线时人数可能保留旧心跳数据，应同时阅读“在线/离线”。

插件仅响应已关联群，不处理陌生群和私聊。基础内置命令及已启用关键词回复优先；同名指令可能被先处理。 模板中的绑定姓名与服务器状态分别受 read_bindings、read_server 权限限制。

下载原始示例 · 全部字段与变量 · 权限范围。