> For the complete documentation index, see [llms.txt](https://chaoss-organization.gitbook.io/chaosdungeon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoss-organization.gitbook.io/chaosdungeon/zhu-yao-mo-kuai-jie-shao/fu-ben-jiao-ben-zu-jian/shi-jian-event.md).

# 事件 event

| 条件名与构造                                                                                  | 说明                                                                                                                                                                                  |                                                    |
| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| addDunMeta:metastring                                                                   | 添加副本元数据,分号分隔,可添加多条                                                                                                                                                                  |                                                    |
| delDunMeta:metastring                                                                   | 删除副本元数据,分号分隔,可删除多条                                                                                                                                                                  |                                                    |
| delMob                                                                                  | 删除副本当前存在的全部怪物                                                                                                                                                                       |                                                    |
| playSound:声音名;x;y;z;v;p                                                                 | 播放声音,v指音量,p指音高, vp可省略不写,会用默认值                                                                                                                                                       |                                                    |
| playParticle:粒子名[^1];x;y;z;c                                                            | 播放粒子,c指数量. 可省略不写                                                                                                                                                                    |                                                    |
| playGroupParticle:粒子名;x1;y1;z1;x2;y2;z2;per                                             | <p>播放范围粒子. 选取两个点. 在这两个点的所有坐标中播放指定的粒子. 最后的参数是选取点的百分比. 如果是0.5,那么就是选取两个点中随机的50%坐标进行播放.</p><p>写法示例: playGroupParticle:effect;x1;y1;z1;x2;y2;z2;0.5</p><p>(如果要全部位置都播放. 那么最后的参数留空就行.)</p> |                                                    |
| <p>*玩家触发器可用事件*<br>vectorPush:0;0;0</p>                                                  | 给触发者一个向量推力                                                                                                                                                                          |                                                    |
| spawnMob:mmid;x;y;z\|                                                                   | 在指定位置生成mm怪物 可用\|分隔表示多个                                                                                                                                                              |                                                    |
| spawnMobGroup:怪物组名                                                                      | 生成预设的怪物组                                                                                                                                                                            |                                                    |
| TeamMessage:消息                                                                          | 给副本队伍全员发送消息                                                                                                                                                                         |                                                    |
| TeamTitle:title;subtitle;0;0;0                                                          | 给副本队伍全员发送title消息(不带延迟参数则使用默认参数:20;60;20)                                                                                                                                            |                                                    |
| dunSuccessPass                                                                          | 成功通关当前副本                                                                                                                                                                            |                                                    |
| <p>*玩家触发器可用事件*<br>playerTp:\~x;\~y;\~z;\~pitch;\~yaw</p><p>playerTp:x;y;z;patch;yaw</p> | <p>tp玩家至指定坐标.</p><p>写法1: tp玩家至相对玩家自身的坐标点.</p><p>写法2: tp玩家至副本的固定坐标处.</p><p>两种写法不可混用.</p>                                                                                             |                                                    |
| TeamTp:x;y;z;patch;yaw                                                                  | <p>tp副本内全部队员至某处</p><p>(会随机传送至目标点的附近2格内的位置.</p><p>随机原因: 让多人副本传送时,不至于传送后全部堆到一块)</p>                                                                                                   |                                                    |
| setDunProgress:id;目标字符1\|id;目标字符2                                                       | <p>设置副本目标说明. 可设置多条.                                                                                                                                                                 | 分隔多条.</p><p>每一条说明需要一个 说明id\[数字]+说明字符,用分号分隔.</p>    |
| delDunProgress:id                                                                       | 删除一条目标id. \| 分隔多条.                                                                                                                                                                  |                                                    |
| addDunPoint:id;数量\|id2;数量                                                               | 设置副本点数. 数量为负数时是减少. 可设置多条. \| 分隔多条                                                                                                                                                   |                                                    |
| delDunPoint:id                                                                          | <p>删除一条点数id.                                                                                                                                                                        | 分隔多条. </p><p>注:点数删除是全局的.及时副本状态回滚也无法恢复已经删除的点数id</p> |

[^1]: 同mm粒子名. 若不使用mm前置,则自动读取原版粒子名. 对应版本请查阅自身服务端的粒子\
    以1.12为例:\
    粒子名为

    ```
    EXPLOSION_NORMAL
    EXPLOSION_LARGE
    EXPLOSION_HUGE
    ...略
    ```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chaoss-organization.gitbook.io/chaosdungeon/zhu-yao-mo-kuai-jie-shao/fu-ben-jiao-ben-zu-jian/shi-jian-event.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.