LuaBoost v1.9.4

Lua runtime optimizer + GC manager + loading helpers for WoW 3.3.5a
Author: Suprematist

LuaBoost is a WoW addon that improves addon-side runtime behavior with:

• smarter garbage collection
• shared utility APIs
• loading-screen event suppression
• lightweight diagnostics
• optional integration with wow_optimize.dll

Designed for WoW 3.3.5a (build 12340).

---

Reviews

See what other players say: Reviews and Testimonials

---

Main Features

Smart GC Manager

• incremental per-frame GC
• different GC step sizes for normal, combat, idle, and loading
• emergency full GC when memory gets too high
• optional forced GC burst on certain heavy events

Runtime Utilities

• GetTimeCached()
• GetFrameNumber()
• LuaBoost_Throttle(id, interval)
• reusable table pool
• cached date helper
• OnUpdate dispatcher API

Loading-Screen Helpers

• SpeedyLoad event suppression during loading screens
• safe and aggressive modes
• restore events after loading completes

Diagnostics

• /lb gc
• /lb pool
• /lb fps
• /lb events
• /lb memleak
• /lb updates

DLL Integration

When wow_optimize.dll is loaded, LuaBoost can:

• detect DLL presence
• sync GC step settings to the DLL
• display DLL GC, fast path, and runtime state

---

What's New in v1.9.4

• delegated all GC control to wow_optimize.dll — addon-side emergency GC and per-frame stepping now fully skipped when DLL is present
• prevents duplicate GC work and conflicts between addon and DLL
• DLL uses incremental 16MB GC steps with 300MB threshold — eliminates full collect stalls
• addon-side GC remains as standalone fallback when DLL is absent
• syncs with wow_optimize.dll v3.5.6

---

What's New in v1.9.3

• proper public release for the addon-side compatibility update required by wow_optimize.dll 3.0.0+
• users should reinstall or update the addon, not only the DLL
• helps avoid freezes caused by running newer DLL builds with an older LuaBoost install
• keeps the current standalone mode and DLL integration behavior

---

Current Public Integration Model

The current public wow_optimize.dll builds are intentionally conservative.

Public DLL features still relevant to LuaBoost

• adaptive GC
• Lua allocator replacement
• string table pre-sizing
• string.format fast path
• GetItemInfo cache
• loading and runtime optimizations

Public DLL features intentionally disabled

• UI widget cache
• GetSpellInfo cache

Because of that, LuaBoost no longer shows old DLL API cache lines in slash commands.

---

Commands

Command	Description
/lb	Status overview
/lb gc	GC stats + DLL GC info
/lb pool	Table pool stats
/lb toggle	Enable/disable GC manager
/lb force	Force full GC
/lb sl	Toggle SpeedyLoad
/lb sl safe	SpeedyLoad safe mode
/lb sl agg	SpeedyLoad aggressive mode
/lb tg	ThrashGuard stats
/lb tg toggle	Toggle Lua-side ThrashGuard
/lb tg reset	Reset ThrashGuard counters
/lb fps	10-second FPS/frametime report
/lb events	10-second event frequency report
/lb memleak	30-second addon memory growth scan
/lb updates	Show registered update callbacks
/lb settings	Open Interface Options
/lb help	Show command list

---

Runtime APIs Exposed For Addons

Cached Time

local now = GetTimeCached()
local frame = GetFrameNumber()

Shared Throttle

if LuaBoost_Throttle("MyAddon_Update", 0.2) then
    -- runs at most every 0.2 sec
end

Table Pool

local t = LuaBoost_AcquireTable()
-- use table
LuaBoost_ReleaseTable(t)

OnUpdate Dispatcher

LuaBoost_RegisterUpdate("MyAddon_Update", 0.1, function(now, elapsed)
    -- update logic
end)

LuaBoost_UnregisterUpdate("MyAddon_Update")

---

Settings

Open: ESC → Interface → AddOns → LuaBoost

Panels:

• Main
• GC Settings
• Tools

Configurable options include:

• GC enable/disable
• preset selection
• per-mode GC step sizes
• emergency GC threshold
• idle timeout
• SpeedyLoad enable/mode
• debug output

---

Presets

Preset	Normal	Combat	Idle	Loading	Emergency GC
Light	20 KB	5 KB	80 KB	150 KB	150 MB
Standard	50 KB	15 KB	150 KB	300 KB	300 MB
Heavy	100 KB	30 KB	300 KB	500 KB	500 MB

---

wow_optimize Integration

LuaBoost works with or without the DLL.

Without DLL

LuaBoost still provides:

• addon-side GC management
• table pool
• throttling
• loading helpers
• diagnostics

With DLL

LuaBoost additionally becomes a control and visibility layer for:

• DLL GC mode and state
• DLL memory info
• Lua allocator status
• fast path stats

---

Notes About ThrashGuard

LuaBoost contains a Lua-side StatusBar-only ThrashGuard. When using current public DLL builds:

• the DLL UI widget cache is disabled
• LuaBoost ThrashGuard can still be used as a Lua-side option
• if you experience addon-specific frame issues, keep it off

---

Installation

Interface/AddOns/!LuaBoost/
├── !LuaBoost.toc
├── LuaBoost.lua
├── enUS.lua
├── koKR.lua
└── deDE.lua

---

Localization

Included locales:

• enUS
• koKR
• deDE

English is used as fallback for unsupported locales.

---

Project Structure

LuaBoost/
├── !LuaBoost/
│   ├── !LuaBoost.toc
│   ├── LuaBoost.lua
│   ├── enUS.lua
│   ├── koKR.lua
│   └── deDE.lua
└── README.md

---

Troubleshooting

Does LuaBoost do anything without the DLL?
Yes. GC management, loading optimization, table pool, throttling, and diagnostics all work standalone.

Why don't I see API cache info anymore?
The current public DLL no longer exposes a meaningful public spell cache path. Slash command output was simplified.

Are there taint risks?
Most of LuaBoost is safe. Potentially risky options remain optional and disabled by default.

---

License

MIT License — use, modify, and distribute freely.