MAME Scripts

November 30, 2025 ยท View on GitHub

Lightweight collection of Lua helper scripts and plugins for MAME.

Repository layout

  • plugins/: MAME plugins you can load into MAME.
  • scripts/: Lua scripts you can load into MAME.

Plugins

dezog

Add support for DZRP - DeZog Remote Protocol

Using the CSpect debug configuration in Visual Studio Code the plugin will allow you to debug against MAME.

Notes

  • Current Windows builds of MAME has an issue, a pull request to fix the issue has been submitted (https://github.com/mamedev/mame/issues/14600)

  • All CSpect DZRP messages are implemented except the 4 SPRITE commands

    • CMD_GET_SPRITES_PALETTE
    • CMD_GET_SPRITES_CLIP_WINDOW_AND_CONTROL
    • CMD_GET_SPRITES
    • CMD_GET_SPRITE_PATTERNS

Scripts

faststart.lua

Temporarily speeds up the first few seconds of emulation to accelerate boot/startup.

profiler.lua

A simple on-screen profiler (overlay) designed for the ZX Spectrum Next that tracks up to 8 timers using writes to NEXTREG 127 (0x7F) to control the timers.

NextBASIC Example

  10 REG 127, 1: REM Start timer 1
  20 REM The code you want to time goes here
  20 REG 127, 256-1: REM Stop timer 1

Z80 Assembly Example

  nextreg \$7f, 1  ; Start timer 1

  ; ... The code you want to time goes here

  nextreg \$7f, -1 ; Stop timer 1

NEXTREG values

ValueDescription
0Reset all timers and remove overlay
1..8Start the specified timer, if the timer is already running there is no effect
-1..-8*Stop the specified timer. Stopping an already stopped timer will reset the timer to 0

*NextBASIC's REG command does not accept negative numbers. Use 256-n where n is the timer you want to stop.

Contributing

  • Contributions, bug reports, and improvements are welcome. Please open issues or pull requests on the repository.

License

  • This project is licensed under the MIT License. See LICENSE for details.