README.md

YALP v1.1

YALP, short for Yet Another Lua Plugin, aims to be a simple yet extendable SA-MP plugin allowing to use Lua for SA-MP server programming.

Compared to older Lua plugins, YALP doesn't export any of the SA-MP natives or callbacks directly. Instead, it exposes a set of functions to interact with the server via a virtual filterscript, mimicking calls to AMX functions. The actual server API can be ported entirely with Lua, which removes the need to update the plugin for new versions of SA-MP and maintain all functions, and also allows the use of other plugins.

Installation

Download the latest release for your platform to the "plugins" directory and add "YALP" (or "YALP.so" on Linux) to the plugins line in server.cfg.

Include YALP.inc to create and control Lua machines on-the-fly.

Building

Use Visual Studio to build the project on Windows, or make on Linux.

Example

local interop = require "interop"
local native = interop.native

local commands = {}

function commands.lua(playerid, params)
  -- no need to import native functions, simply call them! 
  native.SendClientMessage(playerid, -1, "Hello from Lua!")
  return true
end

function commands.setpos(playerid, params)
  -- even a function from any plugin can be used
  local fail, x, y, z = interop.vacall(native.sscanf, interop.asboolean, params, "fff")(0.0, 0.0, 0.0)
  -- return values can be easily specified
  if fail then
    return native.SendClientMessage(playerid, -1, "Wrong arguments!")
  end
  native.SetPlayerPos(playerid, x, y, z)
  return true
end

function interop.public.OnPlayerCommandText(playerid, cmdtext)
  -- properly convert values to Lua (YALP cannot determine their types)
  playerid = interop.asinteger(playerid)
  cmdtext = interop.asstring(cmdtext)
  
  -- take advantage of everything Lua has to offer
  local ret
  cmdtext:gsub("^/([^ ]+) ?(.*)$", function(cmd, params)
    local handler = commands[string.lower(cmd)]
    if handler then
      ret = handler(playerid, params)
    end
  end)
  return ret
end

Credits

• Zeex for creating subhook, the backbone of this plugin.
• The creators of Lua.