Как читать и исправлять Lua-ошибки

Файл, строка, стек вызовов и быстрый способ найти настоящий источник сбоя.

Читайте ошибку сверху вниз

Пример:

addons/example/lua/example/sv_main.lua:42: attempt to index a nil value
  1. DoSomething - sv_main.lua:42
  2. unknown - sv_main.lua:80

Первый путь и строка обычно указывают место сбоя. Нижние строки показывают, кто вызвал функцию. Откройте именно указанную версию файла: дубликат старого аддона может загружаться раньше исправленного.

Частые причины

переменная ещё не создана;
сущность удалена — нужна проверка IsValid;
функция существует в другом realm;
файл не подключён через include;
опечатка в регистре имени;
ранняя ошибка остановила выполнение файла.

Добавляйте временные сообщения с префиксом аддона и значениями ключевых переменных. Не оставляйте печать в частом хуке. После исправления перезапустите сервер или выполните контролируемую перезагрузку Lua и убедитесь, что ошибка исчезла, а не просто перестала попадать в видимую часть консоли.