跳到主要内容

MESSAGE - 消息效果

概述​

发送聊天消息或动作栏消息。

技术规格​

属性值
效果类型MESSAGE
Java 枚举EffectType.MESSAGE
实现类MessageEffect

JSON 格式​

{
  "eventType": "MESSAGE",
  "beat": 4.0,
  "properties": {
    "contents": ["Hello", "World"],
    "type": "CHAT"
  }
}

字段说明​

字段类型必需默认值说明
eventTypestring是-固定为 "MESSAGE"
beatdouble是-效果触发的拍数
contentsstring[]是-消息内容列表
typestring否"CHAT"消息类型

消息类型​

类型说明
CHAT聊天消息
ACTIONBAR动作栏消息

使用示例​

聊天消息​

{
  "eventType": "MESSAGE",
  "beat": 4.0,
  "properties": {
    "contents": ["欢迎来到 RhythMC！", "祝你游戏愉快！"],
    "type": "CHAT"
  }
}

动作栏消息​

{
  "eventType": "MESSAGE",
  "beat": 8.0,
  "properties": {
    "contents": ["连击 x50!", "完美！"],
    "type": "ACTIONBAR"
  }
}

多行消息​

{
  "eventType": "MESSAGE",
  "beat": 12.0,
  "properties": {
    "contents": [
      "第一行消息",
      "第二行消息",
      "第三行消息"
    ],
    "type": "CHAT"
  }
}

注意事项​

  1. 消息类型: ACTIONBAR 消息会显示在快捷栏上方，CHAT 消息发送到聊天栏
  2. 多行消息: contents 数组中的每个元素会作为单独的消息发送
  3. 玩家影响: 只影响当前玩家
  4. 性能: 频繁发送消息可能影响性能

相关效果​

相关文档​