Skip to content

jushar/MTATD

Repository files navigation

MTA:TD: MTA:SA Lua Debugger and Test Framework Build Status

This extension implements a debug adapter for MTA:SA's (Multi Theft Auto: San Andreas) Lua. Note that it doesn't work with plain Lua though.

Features

  • Breakpoints
  • Step into, Step over
  • Variable lists (locals, upvalues, globals)
  • Resource restarts
  • Integrated runcode via VSCode's "Debug Console" feature

Screenshots

Debugger Screenshot

Planned Features

  • Step into functions (+ return from function)
  • Stack traces
  • Variable editing
  • Unit Tests

Usage

  1. When you start debugging, Visual Studio Code asks you to create a new launch configuration based upon a default configuration.
    Make then sure you insert a valid serverpath (the path to the server folder without MTA Server.exe).
  2. Add the debug bundle to your project by executing the command MTA:TD: Add bundle to current project (press F1, enter the command and submit). This only works if you opened the root folder of your resource (meta.xml lies there).
  3. Add the bundle file to your meta.xml:
    <script src="MTATD.bundle.lua" type="shared"/>
  4. Launch the debug test server by pressing F1 in Visual Studio Code and entering MTA:TD: Start MTA Debug Server (the auto-completion will help you). You could also create a key mapping for this command.
  5. You're ready to start debugging now!

Changelog

See CHANGELOG.md