How ethangreen-dev/lovely-injector works
Lovely injects into a running LÖVE game, intercepts Lua buffer loading, loads a mod’s patch definitions and assets, and applies the matching injections before Lua executes the buffer. The patch system supports module, copy, pattern, regex, and variable-substitution patches; the README also documents priority ordering and reloadable mods. Platform entry points and core patching are excerpted, but several implementation details and native bindings are not, so uncertain connections are omitted.
Main entry points: table.rs Patch table · src/lib.rs Lovely runtime · src/lib.rs Unix injector · dump.rs Patch dumps
Components 19
Platform injectors
- Unix injector
crates/lovely-unix/src/lib.rs - Unix Lua loader
crates/lovely-unix/src/lualib.rs - Windows injector
crates/lovely-win/src/lib.rs - Windows Lua loader
crates/lovely-win/src/lualib.rs - Dobby FFI
crates/dobby-sys/src/ffi.rs - C interface
crates/liblovely/src/lib.rs
Runtime core
- Lovely runtime
crates/lovely-core/src/lib.rs
Patch system
- Patch table
crates/lovely-core/src/patch/table.rs - Mod patch loader
crates/lovely-core/src/patch/loader.rs - Module patches
crates/lovely-core/src/patch/module.rs - Copy patches
crates/lovely-core/src/patch/copy.rs - Pattern patches
crates/lovely-core/src/patch/pattern.rs - Regex patches
crates/lovely-core/src/patch/regex.rs - Variable substitution
crates/lovely-core/src/patch/vars.rs
Lua and diagnostics
- Lua API access
crates/lovely-core/src/sys.rs - Rope regex cursor
crates/lovely-core/src/chunk_vec_cursor.rs - Patch dumps
crates/lovely-core/src/dump.rs - Logging
crates/lovely-core/src/log.rs
Other components
- LÖVE game
Connections 23
- LÖVE game → Unix injector: loads injector
crates/lovely-unix/src/lib.rs - LÖVE game → Windows injector: loads injector
crates/lovely-win/src/lib.rs - Unix injector → Lovely runtime: initializes runtime
crates/lovely-unix/src/lib.rs - Windows injector → Lovely runtime: initializes runtime
crates/lovely-win/src/lib.rs - Unix injector → Lovely runtime: detours Lua loads
crates/lovely-unix/src/lib.rs - Windows injector → Lovely runtime: detours Lua loads
crates/lovely-win/src/lib.rs - Unix injector → Unix Lua loader: loads Lua library
crates/lovely-unix/src/lib.rs - Unix Lua loader → Lua API access: provides Lua bindings
crates/lovely-unix/src/lualib.rs - Lovely runtime → Patch table: loads and applies
crates/lovely-core/src/lib.rs - Lovely runtime → Patch dumps: writes source dumps
crates/lovely-core/src/lib.rs - Lovely runtime → Lua API access: uses Lua state
crates/lovely-core/src/lib.rs - Patch table → Mod patch loader: loads patch definitions
crates/lovely-core/src/patch/table.rs - Patch table → Module patches: applies module patches
crates/lovely-core/src/patch/table.rs - Patch table → Copy patches: applies copy patches
crates/lovely-core/src/patch/table.rs - Patch table → Pattern patches: applies pattern patches
crates/lovely-core/src/patch/table.rs - Patch table → Regex patches: applies regex patches
crates/lovely-core/src/patch/table.rs - Patch table → Variable substitution: interpolates variables
crates/lovely-core/src/patch/table.rs - Patch table → Lua API access: preloads modules
crates/lovely-core/src/patch/table.rs - Regex patches → Rope regex cursor: scans rope chunks
crates/lovely-core/src/patch/regex.rs - Pattern patches → Patch dumps: records patch regions
crates/lovely-core/src/patch/pattern.rs - Regex patches → Patch dumps: records patch regions
crates/lovely-core/src/patch/regex.rs - Copy patches → Patch dumps: records patch details
crates/lovely-core/src/patch/copy.rs - Lovely runtime → LÖVE game: returns patched buffer
crates/lovely-core/src/lib.rs