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

Подготовка окружения ​

Эта страница объясняет, как подготовить локальное окружение для разработки скриптов Melonity с помощью репозитория шаблона.

Требования ​

  • Node.js LTS
  • Любой редактор кода, например VS Code или WebStorm

Совет

В репозитории шаблона уже есть готовая структура проекта и пример точки входа в src/example.ts.

Создайте проект из шаблона ​

Клонируйте репозиторий шаблонов:

bash
git clone https://github.com/melonity-public/template-custom-scripts
cd template-custom-scripts

Вы также можете воспользоваться кнопкой Use this template на GitHub, если хотите сразу создать собственный репозиторий.

Установить зависимости ​

Установите необходимые пакеты:

bash
npm install

После этого проект будет готов к компиляции.

Настройте вывод сборки ​

По умолчанию шаблонный проект собирается в локальную папку dist рядом с webpack.config.js:

js
output: {
	filename: '[name].js',
	path: path.resolve(__dirname, 'dist')
}

Это полезно для чистой локальной сборки, но Melonity не будет загружать файлы из dist автоматически.

Если вы хотите, чтобы программа запуска загружала вашу сборку напрямую, измените output.path в каталог, из которого Melonity загружает локальные скрипты.

Текущее расположение пользовательских скриптов обычно выглядит следующим образом:

txt
...\launcher_files\melonity_dota2\scripts

Важно

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

Включить локальные скрипты в лаунчере ​

В Melonity включите следующую опцию:

txt
Settings -> Scripts -> Load local scripts

Без этой опции локальные скрипты не будут загружаться, даже если компиляция прошла успешно.

После включения Melonity отобразит список всех .js файлов из локальной папки scripts.

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

Начать компиляцию ​

Запустите наблюдатель:

bash
npm run watch

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

Убедитесь, что среда готова ​

Ваша среда настроена правильно, если:

  • npm run watch запускается без ошибок
  • сгенерированный .js файл появляется в ожидаемом каталоге
  • Load local scripts включен в Melonity

Как только все это заработает, вы можете перейти к созданию своего первого сценария.