效果系统

本文档已拆分为单独的文件，请查看以下文档：

目录

• 效果系统总览 - 效果系统整体介绍
• HOLOGRAM - 全息图效果
• REMOVE_HOLOGRAM - 移除全息图
• TITLE - 标题显示效果
• FIREWORK - 烟花效果
• TIME - 时间设置效果
• EFFECT - 药水效果
• CLEAR_EFFECT - 清除药水效果
• WEATHER - 天气效果
• ARENA - 地图切换效果
• TEXT_DISPLAY - 文本显示效果
• TEXT_DISPLAY_EFFECT - 文本显示效果变换
• TEXT_DISPLAY_SYNC_TRACK - 轨道同步文本显示
• TEXT_DISPLAY_DESYNC_TRACK - 停止轨道同步
• TEXT_DISPLAY_REMOVE - 移除文本显示
• HIDE_NOTES - 隐藏音符效果
• GLOW_COLOR - 发光颜色效果
• MESSAGE - 消息效果

请访问 效果系统总览 获取完整的技术细节和使用指南。

在指定位置显示全息文字。

{
  "eventType": "HOLOGRAM",
  "beat": 4.0,
  "properties": {
    "location": [0.0, 1.5, 0.0],
    "id": "RhyMCGameHologram_1234567890",
    "contents": ["Line 1", "Line 2"],
    "duration": 5000
  }
}

properties

字段	类型	说明
location	double[3]	[X, Y, Z] 坐标 (数组格式)
id	String	唯一标识符 (可选，自动生成)
contents	List	文本行列表
duration	long	持续时间（毫秒，可选，默认为一年）

---

TEXT_DISPLAY

在指定位置显示文本。

{
  "eventType": "TEXT_DISPLAY",
  "beat": 4.0,
  "properties": {
    "id": "display_id",
    "text": "Text",
    "position": [0.0, 1.5, 0.0],
    "rotation": [0.0, 0.0, 0.0],
    "scale": [1.0, 1.0, 1.0]
  }
}

properties

字段	类型	说明
id	String	文本显示ID
text	String	显示文本
position	float[3]	[X, Y, Z] 坐标 (数组格式)
rotation	float[3]	[X, Y, Z] 旋转角度 (数组格式)
scale	float[3]	[X, Y, Z] 缩放 (数组格式)

---

TEXT_DISPLAY_REMOVE

移除文本显示。

{
  "eventType": "TEXT_DISPLAY_REMOVE",
  "beat": 20.0,
  "properties": {
    "id": "text_display_id"
  }
}

properties

字段	类型	说明
id	String	文本显示ID

---

TITLE

显示屏幕标题。

{
  "eventType": "TITLE",
  "beat": 4.0,
  "properties": {
    "title": "Title",
    "subtitle": "Subtitle",
    "fadeIn": 20,
    "stay": 60,
    "fadeOut": 20
  }
}

properties

字段	类型	说明
title	String	主标题
subtitle	String	副标题
fadeIn	int	淡入时间（tick）
stay	int	停留时间（tick）
fadeOut	int	淡出时间（tick）

---

MESSAGE

发送聊天消息。

{
  "eventType": "MESSAGE",
  "beat": 4.0,
  "properties": {
    "message": "Hello",
    "type": "CHAT"
  }
}

properties

字段	类型	说明
message	String	消息内容
type	String	消息类型 (CHAT, ACTIONBAR)

---

GLOW_COLOR

改变音符发光颜色。

{
  "eventType": "GLOW_COLOR",
  "beat": 4.0,
  "properties": {
    "color": "RED"
  }
}

properties

字段	类型	说明
color	String	颜色名称 (RED, BLUE, GREEN...)

---

HIDE_NOTES

隐藏或显示所有音符。

{
  "eventType": "HIDE_NOTES",
  "beat": 4.0,
  "properties": {
    "hidden": true
  }
}

properties

字段	类型	说明
hidden	boolean	是否隐藏

---

TEXT_DISPLAY_SYNC_TRACK

文本跟随轨道移动。

{
  "eventType": "TEXT_DISPLAY_SYNC_TRACK",
  "beat": 4.0,
  "properties": {
    "id": "text_display_id",
    "track": 0,
    "duration": 5000
  }
}

properties

字段	类型	说明
id	String	文本显示ID
track	int	轨道ID
duration	long	持续时间（毫秒，可选，默认为一年）

TEXT_DISPLAY_DESYNC_TRACK

停止文本跟随轨道移动。

{
  "eventType": "TEXT_DISPLAY_DESYNC_TRACK",
  "beat": 20.0,
  "properties": {
    "id": "text_display_id"
  }
}

properties

字段	类型	说明
id	String	文本显示ID