LÖVE.

Scripts in 2D games made with LÖVE.

This page is generated from the SDK's platform registry (sdk/environments.json) and the adapter's SETUP.md. The LÖVE page on the site is the short version.

How it runs

A Lua module the game loads, scriptgo_love.lua. It runs the core in LÖVE's LuaJIT, ticks it from love.update through sg:update(dt) and draws notifications with sg:draw(). Server and local client share the game process.

The adapter's code and README: sdk/adapters/love2d.

Set up

1. Copy scriptgo_love.lua, adapter.lua and verify.lua from sdk/adapters/love2d/ into the game (for example lib/), and the core sdk/lua/scriptgo/ next to them as lib/scriptgo/.

2. Put resources in a folder of the game, for example resources/sg_inventory/.

3. Create the host in love.load and drive it from the game's callbacks:

   luaCopy

   local scriptgoLove = require("lib.scriptgo_love")
   local sg
   function love.load()
       sg = scriptgoLove.new({
           resources = { "sg_inventory" },          -- dependencies are added too
           search = { "resources" },
           player = { id = 1, name = "Ada" },
           config = { permissions = { ["1"] = { "inventory.give" } } },
       })
   end
   function love.update(dt) sg:update(dt) end
   function love.draw() --[[ the game ]] sg:draw() end
   function love.quit() sg:shutdown() end

The server side and the local client (player 1) both run in the game process. Storage goes to the save directory; HTTP and licensing use curl in a love.thread worker, so frames keep running. The layout works from a folder and from a .love archive.

Capabilities

What the adapter provides. See SDK and capabilities for what each one is.

Protection

Licence check and signed releases. The host runs plain script, so its operator can read what it loads: no code-secrecy claim.

See Protect your work for what protection does and does not do.

Assets

Maps, models, textures, sounds and other files players download. See Selling assets.

No game client downloads anything: assets are files of the resource.

Asset escrow: The host can read containers itself, but its operator holds the key: at-rest encryption only.

Limits

• Single-player only: no real network between server and client.
• HTTP needs io.popen and a curl executable (on the PATH, or opts.curl).
• Measured with LÖVE 11.5 (LuaJIT 2.1) on Windows, as a folder and as a .love archive, through lovec.exe; macOS, Linux, mobile and fused builds are not measured yet.

Real runs

Each row is a scriptgo verify run on LÖVE itself, not on a mock or an emulator: the package started there and its own tests reported back. Rows marked probe are SCRIPT//GO's conformance probes, which exercise the runtime and are never published as packages. See how a status is earned.