MacroLua tutorial

This is a supplementary tutorial for a preset FBA-RR emulator with MacroLua, which you can download here: https://mega.nz/file/XcgyBaRT#5krysPuTgLNh5wUSN4IJghiS78NS5yBk1XUpDKAK8Os

FBA-RR and MacroLua normally require configuration when downloaded from their official pages.
https://code.google.com/archive/p/fbarr/downloads
https://code.google.com/archive/p/macrolua/downloads

————————————
Introduction
————————————

MacroLua is a tool for scripting player inputs with perfect frame accuracy. It's used for creating hard playthroughs, elaborate combos in fighting games, and researching games.

———————————————————
How to run MacroLua
———————————————————

Open FBA-RR emulator.
Go to Game>Lua Scripting>New Lua Script Window.
Click Browse.
Open macro.lua file (located in the MacroLua folder).
Click Run.

————————————————
MacroLua hotkeys
————————————————

Q - Play script.
W - Record inputs. A .mis script will be created in the MacroLua folder when you stop recording (by pressing the W key again).
T - Toggle input display on/off.

—————————————————
MacroLua commands
—————————————————

The commands below represent player inputs. Type them in the Inputs.mis file to execute them in the game.

L = Left
R = Right
U = Up
D = Down
1 = Light Punch
2 = Medium Punch
3 = Heavy Punch
4 = Light Kick
5 = Medium Kick
6 = Heavy Kick

Example: 14 = Press Light Punch (1) and Light Kick (4) at the same time.

. = Wait 1 frame.
Example: ... = Wait 3 frames.

Wx = Wait x number of frames.
Example: W10 = Wait 10 frames.

_x = Hold x input.
Example: _1 = Hold Light Punch (1).

^x = Release the held x input.
Example: _1_4..^4 = Hold Light Punch (1) and Light Kick (4), wait 2 frames, then stop holding Light Kick (4) only.

* = Release all held inputs.
Example: _1_4..* = Hold Light Punch (1) and Light Kick (4), wait 2 frames, then stop holding both inputs.

()x = Repeat commands written inside parentheses x number of times.
Example: (U.D.)3 = Press Up, Down 3 times.

# = Text after # on the same line is ignored. Use this to type notes without executing any commands as a consequence or to disable a part of the script instead of deleting commands.

! = All text after ! is ignored. Use this to add notes at the end of the script or to store commands that you might use later.

For an input to be recognized, there must be at least 1 frame of waiting after it. For example, for Heavy Punch to come out, you must type "3." or "3W1", not just "3" without any wait command.

Comma, space, and new line don't do anything, so you can use them for script readability.

————————————————————
Macro script example
————————————————————

R.D.DR1,W48,R.D5.DR1.

This is Ken's Light Punch Shoryuken, Light Punch Shoryuken mid-screen combo in Street Fighter III: 3rd Strike. Crouching Medium Kick is canceled into Shoryuken on its second frame so that Ken gains forward momentum for his second Shoryuken.

Copy the above text into Inputs.mis file, save the file, place Ken next to Ryu, and press the Q key to play the script.

———————————————
Inputs.mis file
———————————————

Inputs.mis file is pre-edited for simultaneous two-player control. It looks like this:

&1
< # Player 1


/ # Player 2


>

Player 1 inputs go under the Player 1 line, Player 2 inputs go under the Player 2 line.

For elaborate scripts to produce a desired result in the game, you often need to repeatedly play them from the same save state, and then re-edit them.

The script is played from save state slot 1 by default. If there's no save state in slot 1, the script will be played from the current frame. To play a script from a different save state, change the number after & accordingly. For example, &7 plays the script from save state slot 7.

—————————————————————————
Useful emulator shortcuts
—————————————————————————

Tab = Fast forward.
Pause = Pause the game.
\ = Advance 1 frame.
Shift+F1–F10 = Save state to slot 1–10.
F1–F10 = Load state from slot 1–10.
F2 = Service mode.
F3 = Restart game.
Ctrl+L = Open Lua Script window.
Ctrl+C = Open cheats menu.

F2 and F3 are configured twice by default, so you should re-configure them via Inputs>Map game inputs.