Skip to content

Runtime limits

The limits below are part of the Plugin API 1.0 operating model. Plugins must remain useful below every ceiling.

ResourceLimit
Lua memory per plugin8 MiB
Instructions per callback/resume100,000
CPU timeout per Lua callback4 ms
Slow callback warning2 ms
CPU per plugin callback phase6 ms
Total plugin CPU per frame8 ms
Pending semantic events256
Subscriptions per plugin256
Timers per plugin256
Managed tasks per plugin256
Draw commands per plugin per frame512
Error fuse3 errors within 10 seconds

Budgets are defensive ceilings, not performance targets. A per-frame callback should normally complete far below the warning threshold.

The runtime also bounds strings, menu controls, image dimensions, decoded image memory, storage capacity, list page size, and numeric ranges. APIs reject invalid data instead of silently accepting an unsafe value.