Lua Emulation of Roblox APIs
Lemur reimplements a large portion of Roblox's API in Lua in order to enable Roblox projects to have continuous integration using services like Travis CI or Jenkins.
Lemur aims to be a fairly complete and up-to-date implementation of Roblox's API, however:
- Lemur will always be incomplete by nature
- Lemur will not implement deprecated APIs for the sake of simplicity
- Lemur is naturally restricted by the environment it runs in
Current feature coverage is detailed in FEATURES.md
Lemur requires:
- Lua 5.1
- LuaFileSystem (
luarocks install luafilesystem)
Lemur needs certain extra dependencies for some optional features:
- dkjson (Roblox JSON API) (
luarocks install dkjson) - LuaSocket (high performance timer) (
luarocks install luasocket)
Clone the Git repository wherever, then call require on it.
To use Lemur, create a Habitat and load pieces of the filesystem into the tree:
local lemur = require("lemur")
-- Create a Habitat
local habitat = lemur.Habitat.new()
local ReplicatedStorage = habitat.game:GetService("ReplicatedStorage")
-- Load `src/roblox` as a Folder containing some ModuleScripts:
local root = habitat:loadFromFs("src/roblox", ReplicatedStorage)
root.Parent = ReplicatedStorage
-- Locate src/roblox/CoolModule.lua from inside the habitat and load it!
local CoolModule = habitat:require(root.CoolModule)
-- Invoke a method on our Roblox module!
CoolModule.doSomething()If there are any APIs you'd like that are missing, feel free to open an issue on GitHub!
Lemur is available under the MIT license. See LICENSE.md for details.