Limits

​

The sandbox

• Its own globals. A global one plugin sets is invisible to every other plugin. Plugins share nothing but what they pass through reskate.expose, reskate.emit and messages, and those cross as JSON copies: tables, strings, numbers and booleans, never functions.
• Read-only libraries. The reskate table, its sub-tables and Luau’s libraries (string, table, math and the rest) cannot be changed or given a metatable.
• No files, programs or code loading. There is no io, package, dofile, loadfile, loadstring or load. os has no execute, remove, rename, getenv or exit.
• Source only. ReSkate compiles the plugin’s own .lua and .luau text. It never loads bytecode.
• Its own package. require and reskate.package read only inside the plugin’s folder. A path with .., a drive, \ or a link that leads outside is refused.
• Through the API only. Nothing reaches the game except the reskate functions, and each checks its arguments and permission first.

​

Stopped or refused

• Its unload handlers do not run. Its storage is saved.
• Its console commands go, and so does everything it held of the game: its clips and trick replacements, its sounds, the items it put on the outfit, its board changes, a drop it hosts, the camera, a freeze, a hidden HUD, its nametags and its binds. Only its own: on a lobby’s host, the server copy (<folder>@server) and the client copy hold their things apart, so one stopping leaves the other’s alone.
• The log says [<id>] stopped: <why>, and plugin list shows stopped (<why>). For a server copy on a lobby’s host, <id> is <folder>@server.
• It stays stopped until you change one of its files (which reloads it) or run plugin on <id>.

• raises a Lua error, which you can catch with pcall (uncaught, it counts towards the error limit), or
• returns false and a reason (or false alone, where the API page says so), with nothing raised.

​

Halts cannot be caught

-- This plugin is stopped all the same: the pcall cannot save it.
reskate.console.command("spin", "Loops forever", function()
    while true do
        pcall(function() while true do end end)
    end
end)

​

Limits that stop a plugin

​

Memory

​

Time for one call

​

Time a tick

speedo: running, 0.3 MB, 0.021 ms a tick, 1 command

​

Errors

[speedo] the draw handler: plugin/main.lua:13: attempt to perform arithmetic (mul) on nil and number

​

Logging

[speedo] more than 50 lines in a second: the rest of this second's are left out

​

Limits that refuse a call with an error

​

Limits that refuse a call with false

​

Limits on what a plugin draws and sends

• Shapes. A plugin draws at most 4000 shapes a frame, with at most 64 KB of text between them. The rest of that frame’s shapes are left out. The log warns at most once every 10 s, naming the limit it hit: more than 4000 shapes in a frame: the rest are left out, or more than 64 KB of text in a frame's shapes: the rest are left out.
• Emitted events. ReSkate holds at most 1024 emitted events a tick for all plugins together. reskate.emit returns false past that.
• Messages out. At most 64 messages wait to go out each tick on a player’s game (256 on a dedicated server). reskate.net.send returns false past that, and without a session.
• Messages in transit. The session passes at most 200 plugin messages a player every 5 s, from all that player’s plugins together; past that they are dropped. Messages reach only players on the same map, and a lobby’s host passes on none from a player whose mods change scoring or physics.
• Web requests at once. ReSkate runs at most 8 web requests at a time for all plugins together. reskate.http.request returns nil and web requests cannot be made now past that.
• Web answers. A request has 10 s, follows no redirects and sends no cookies. An answer over 1 MB comes back with no body and the error its answer is larger than 1 MB. A host on a private or local network is refused.

​

File sizes