build_play_audio
Create a Play BGM/BGS/ME/SE event command for RPG Maker MZ, validating audio asset names and returning the command with any warnings for insertion via insert_event_commands.
Instructions
Build a Play BGM/BGS/ME/SE (241/245/249/250) event command for insertion via insert_event_commands. Warns (never blocks) when name is not a known audio asset for that channel (checked against list_assets). Returns { command, warnings? }.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"kind": "<kind>",
"name": "<name>"
},
"name": "build_play_audio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pan | No | Pan -100–100 (default 0) | |
| kind | Yes | Which audio channel to play on | |
| name | Yes | Audio basename (from list_assets, extension stripped) | |
| pitch | No | Pitch 50–150 (default 100) | |
| indent | No | Indentation level (default 0) | |
| volume | No | Volume 0–100 (default 90) |