Change a MiSTer.ini setting
mister_set_iniModify or clear a configuration key in MiSTer.ini or an alternate .ini file, with dry-run diffs and a timestamped backup before writing to SD storage.
Instructions
<use_case> Modify or clear a configuration key in MiSTer.ini (or alternate ini). </use_case> <important_notes>
Creates a timestamped .bak backup on SD storage before writing.
Rate-limited to guard against rapid SD card wear.
Dangerous system keys (main, bootcore, shared_folder) are disallowed. </important_notes>
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": {
"key": "<key>",
"value": "<value>"
},
"name": "mister_set_ini"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | A MiSTer.ini key, e.g. vscale_mode (misterfpga://ini-keys lists them). | |
| file | No | MiSTer.ini, or an alternate such as MiSTer_crt.ini (mister_get_ini lists them). | MiSTer.ini |
| host | No | MiSTer name from mister_get_status. Omit when the call already says which (a ref does). | |
| value | Yes | The new value, checked against the key's type and range. null removes the key. | |
| dry_run | No | Show the change (diff) without writing it. | |
| section | No | MiSTer (global), arcade, arcade_vertical, video=<WxH@Hz>, or a core name like SNES. | MiSTer |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | ||
| new | Yes | ||
| old | Yes | ||
| diff | Yes | ||
| file | Yes | ||
| host | Yes | ||
| backup | Yes | ||
| detail | Yes | ||
| outcome | Yes | ||
| section | Yes | ||
| warnings | Yes |