鹊桥
首页
介绍
部署
配置文件
命令
  • V2 事件
  • V1 事件
  • V2 API
  • V1 API
常见问题
  • 标准开发
  • 快速开发
对接
GitHub
首页
介绍
部署
配置文件
命令
  • V2 事件
  • V1 事件
  • V2 API
  • V1 API
常见问题
  • 标准开发
  • 快速开发
对接
GitHub
  • 总览
  • 接口列表

    • 广播消息
    • 私聊消息
    • 标题
    • Actionbar
  • 常用对象

PrivateMessage

API:send_private_msg

请求参数

uuid 和 nickname 至少填写一个,如果都传递,则优先使用 uuid

字段名数据类型是否必填默认值说明
uuidUUID/string否-玩家 UUID
nicknamestring否-玩家昵称
messagestring / message是-发送的消息

响应数据

字段名数据类型说明
playerBasePlayer目标玩家信息(玩家基类,具体类型因服务端而异)
messagestring消息内容(成功、失败、未找到玩家、玩家离线等)

请求示例

only-UUID

{
  "api": "send_private_msg",
  "data": {
    "uuid": "aa96407b-9d4d-44f8-8d79-51d0dcfdedff",
    "nickname": "",
    "message": [
      {
        "type": "text",
        "data": {
          "text": "This is a private message only for you."
        }
      }
    ]
  },
  "echo": "1"
}

only-Nickname

{
  "api": "send_private_msg",
  "data": {
    "uuid": "",
    "nickname": "TestUserName",
    "message": [
      {
        "type": "text",
        "data": {
          "text": "This is a private message only for you."
        }
      }
    ]
  },
  "echo": "1"
}

All

{
  "api": "send_private_msg",
  "data": {
    "uuid": "aa96407b-9d4d-44f8-8d79-51d0dcfdedff",
    "nickname": "",
    "message": [
      {
        "type": "text",
        "data": {
          "text": "test",
          "color": "aqua",
          "font": null,
          "bold": false,
          "italic": false,
          "underlined": false,
          "strikethrough": false,
          "obfuscated": false,
          "insertion": null,
          "click_event": {
            "action": "open_url",
            "value": "https://www.baidu.com"
          },
          "hover_event": {
            "action": "show_text",
            "text": [
              {
                "text": "test hover",
                "color": "aqua",
                "font": null,
                "bold": true,
                "italic": false,
                "underlined": true,
                "strikethrough": false,
                "obfuscated": false,
                "insertion": null
              }
            ]
          }
        }
      }
    ]
  },
  "echo": "1"
}
Edit this page
最近更新: 2025/12/2 15:22
Contributors: 17TheWord
Prev
广播消息
Next
标题