RGP Lua is an environment to run scripts written in the Lua programming language as plugins in Finale. It is free and compatible with all 64-bit versions of Finale. It is intended as a successor to the very successful JW Lua plugin, which unfortunately has not been updated since 2017.

Tested thru Finale 27.4 (version history)	Windows	macOS
RGP Lua Version 0.73	Finale 25+	Finale 25+
RGP Lua is licensed under a Creative Commons Attribution 4.0 International License
RGP Lua Utilities (zip archive) RGP Lua Class Browser RGP Lua Console
RGP Lua Version 0.63 (final version for macOS 10.10-10.12)		Finale25+

RGP Lua includes the following features.

• Lua 5.4, with backwards Lua 5.2 compatibility (matching the version of Lua embedded in JW Lua).
• Fully compatible with Jari Williamsson's PDK Framework. (RGP Lua uses the same source code for the PDK Framework as JW Lua.)
• Allows require of c/c++ libraries that are compatible with Lua 5.4. On Mac these are dylib or bundle and on Windows dll.
• Adds the current script path to both PATH and CPATH before executing the script.
• Native Apple Silicon support is already built into the Mac binary.
• Optionally embeds luasocket for use with compatible Lua debuggers or other peer-to-peer networking needs.
• Can be run in parallel with JW Lua. (Place them in separate sub-directories of Finale's Plug-in folder.)
• Mac binary is codesigned and notarized by Apple.
• Pure Lua class browser and console, which are optional.

RGP Lua has the following limitations with respect to JW Lua.

• No support for finenv.UserValueInput. Use FCCustomWindow or FCCustomLuaWindow instead. (More information here.)
• Built-in development environment is a Console script you can add on. See above.

With the exception noted above (UserValueInput), scripts that run in JW Lua are compatible with RGP Lua. Most of the existing documentation for JW Lua is still relevant. The following links access that documentation and then offer some pages of revised documentation relevant to RGP Lua.

• Main Documentation Page for RGP Lua
• JW Lua Start Page
• Revised PDK Framework Documentation

There are lively discussion groups for Finale-embedded Lua at the JW Lua email list and the JW Lua Facebook page.

If you have questions, comments, or suggestions about the operation of RGP Lua, please feel free to contact me.