Документация Melonity

Устранение неполадок ​

На этой странице описаны наиболее распространенные проблемы при настройке и запуске локальных скриптов Melonity.

Скрипт компилируется, но не отображается в Melonity. ​

Наиболее распространенной причиной является неправильный путь вывода сборки.

Проверьте следующее:

  • webpack.config.js записывает выходной файл в Melonity scripts папка
  • сгенерированный .js файл действительно появляется в этой папке после перестройки
  • Settings -> Scripts -> Load local scripts включен
  • скрипт появится в списке локальных скриптов
  • скрипт включен в этом списке

Если проект все же встроится в dist, скрипт скомпилируется успешно, но Melonity не загрузит его автоматически.

Если вы добавили новый .js файл в папку и он еще не отображается в списке, нажмите F7 перезагрузить скрипты.

Скрипт загружается, но callbacks не работает ​

Обычно это означает, что скрипт был зарегистрирован неправильно.

Убедитесь, что:

  • вы создали ScriptDescription объект
  • вы назначили callbacks этому объекту
  • ты позвонил RegisterScript(...)

IMPORTANT

Без RegisterScript, некоторые части скрипта могут по-прежнему работать, например параметры menu. Однако callbacks не будет работать.

Появляется опция menu, но логика скрипта не работает ​

Обычно это означает одно из двух:

  • основной скрипт callbacks не зарегистрирован
  • ваша логика отключена переключателем или ранним return

Проверять:

  • ли RegisterScript(...) называется
  • включен ли ваш переключатель
  • будь то твой OnUpdate или OnDraw функция завершается слишком рано

npm install терпит неудачу ​

Обычно это локальная проблема Node.js или проблема с зависимостями.

Проверьте следующее:

  • Node.js установлен правильно
  • вы используете версию LTS
  • вы запускаете команду в корне проекта
  • package.json существует в текущем каталоге

При необходимости удалите node_modules и переустановите зависимости.

npm run watch терпит неудачу ​

Если наблюдатель не запускается, проверьте:

  • зависимости установлены
  • webpack.config.js не содержит недействительных изменений
  • путь вывода действителен
  • никакой другой процесс не блокирует целевой выходной файл

Если ошибка появилась после редактирования config, восстановите последнюю рабочую версию и повторите попытку.

Изменения не применяются после перестроения ​

Если проект перекомпилируется, но в Melonity ничего не изменится, проверьте:

  • сгенерированный файл записывается в правильный scripts папка
  • Melonity загружает локальные скрипты
  • наблюдатель перестраивает тот же файл записи, который вы редактируете
  • скрипт был перезагружен после изменения файла

Иногда сборка завершается успешно, но обновляется не тот файл или не тот каталог.

OnDraw или рендеринг работает плохо ​

OnDraw называется каждый кадр. Это означает, что он чаще запускается с более высоким FPS, поэтому внутри сложная логика. OnDraw может ухудшить производительность.

Постарайтесь сохранить OnDraw ограничивается только рендерингом кода и переносит сложные вычисления в OnUpdate или кэшированные значения.

menu сломан или появляются другие визуальные ошибки. ​

Если menu выглядит сломанным или вы видите другие визуальные проблемы, сначала проверьте консоль.

Использовать:

текст
F10

Консоль — это самое быстрое место для поиска ошибок времени выполнения, вызванных вашим скриптом.

Все еще не работает ​

Если настройка по-прежнему не работает, пройдите эти страницы еще раз по порядку:

  1. Preparing the environment
  2. Creating your first script

Затем сравните свой проект с репозиторий шаблонов и проверьте, соответствуют ли ему ваша структура, путь сборки и процесс регистрации.