Lua in Maguyva: Code-Graphen für Spiele, Plugins und OpenResty

Wo Lua oberflächliche KI-Tools ins Stolpern bringt

Lua hat kein Schlüsselwort für Klassen. Objekte sind Tabellen, Methoden sind darin gespeicherte Funktionen, und Vererbung ist ein setmetatable-Aufruf. Ein Modul ist, was auch immer require zurückgibt. Die Struktur ist real, aber sie steckt in Konventionen, die eine Textsuche nicht versteht.

Maguyva liest diese Konventionen als Struktur, damit ein Agent fragen kann, wer eine Methode aufruft oder welche Tabellen eine Basis erweitern, und eine direkte Antwort bekommt.

Was Maguyva in Lua extrahiert

Maguyva deckt .lua-Dateien ab. Funktionsdeklarationen, local function-Definitionen und Funktionsausdrücke werden extrahiert, und Doppelpunkt-Methoden wie function Account:deposit() werden ihrer besitzenden Tabelle Account zugeordnet. Methodenketten werden Aufruf für Aufruf verfolgt, und Aufrufe über self bleiben an das umgebende Objekt gebunden.

Die Konventionen von Lua werden so auf Beziehungen abgebildet:

• require, dofile und loadfile erfassen Importe.
• Ein setmetatable-Aufruf auf Modulebene erfasst Vererbung.
• ClassName:new(), ClassName.new() und setmetatable({...}, ClassName) zählen als Instanziierung.
• error() erfasst ein Throw, pcall und xpcall erfassen ein Catch.

Der Graph erfasst außerdem Lese- und Schreibzugriffe sowie den Kontrollfluss.

Beispiel-Prompts für Agenten

• „Wer ruft Inventory:addItem auf, und aus welchen Skripten?“ (find_symbol, dann dependency_search incoming)
• „Welche Module laden util.http per require?“ (dependency_search)
• „Verfolge, was passiert, wenn der Spieler Schaden nimmt.“ (get_task_context)

Bekannte Grenzen

• Etwa 150 Namen werden aus den Beziehungen gefiltert: die Lua-Standardbibliothek (string, table, math, io, os, coroutine, debug und utf8) sowie die Neovim-API vim.* und die OpenResty-API ngx.*. Aufrufe dieser APIs sind keine Graphkanten; verwende text_pattern_search, um sie zu finden.
• Weil Module und Klassen aus gewöhnlichen Aufrufen und Tabellen entstehen, wählen die Presets classes und imports in structural_search für Lua nichts aus. Verwende stattdessen find_symbol oder text_pattern_search.
• Lua hat weder Interfaces noch Typannotationen, daher sind Beziehungen für Interface-Implementierung und Typreferenzen als nicht anwendbar markiert.

Nächste Schritte

Verbinde ein Repository über den Schnellstart und prüfe dann die Unterstützungsmatrix auf der Kompatibilitätsseite. Für Engines, die Lua in nativen Code einbetten, lies auch den C-Leitfaden.