Структура мода — различия между версиями
Admin (обсуждение | вклад) |
|||
| Строка 1: | Строка 1: | ||
Моды в Core Engine представляют собой папку с кодом, изображениями и текстурами, подхватываемых движком. | Моды в Core Engine представляют собой папку с кодом, изображениями и текстурами, подхватываемых движком. | ||
| + | |||
== Общее == | == Общее == | ||
| Строка 9: | Строка 10: | ||
*launcher.js - выполняется при загрузке мода, позволяет подключить сторонние моды, управлять ресурсами. | *launcher.js - выполняется при загрузке мода, позволяет подключить сторонние моды, управлять ресурсами. | ||
*config.json - файл конфигурации мода, по умолчанию содержит только две опции: | *config.json - файл конфигурации мода, по умолчанию содержит только две опции: | ||
| − | *enabled - по умолчанию true, определяет возможность загрузки мода. | + | **enabled - по умолчанию true, определяет возможность загрузки мода. |
| − | *advanced_api - не используется самим движком, но может быть использована модом для расширения API. | + | **advanced_api - не используется самим движком, но может быть использована модом для расширения API. |
*mod.info - не используется самим движком, но позволяет моду самоиндифицироваться. | *mod.info - не используется самим движком, но позволяет моду самоиндифицироваться. | ||
*resources.zip - текстурпак, содержит текстуры блоков, предметов, мобов. Разработчикам настоятельно рекомендуется собирать данный архив из содержимого папки resources. | *resources.zip - текстурпак, содержит текстуры блоков, предметов, мобов. Разработчикам настоятельно рекомендуется собирать данный архив из содержимого папки resources. | ||
| Строка 17: | Строка 18: | ||
*gui - папка, содержит текстуры для интерфейса, загружаются автоматически. | *gui - папка, содержит текстуры для интерфейса, загружаются автоматически. | ||
*lib - см. Подключение библиотек. | *lib - см. Подключение библиотек. | ||
| − | *resources - необязательна, разработчик может собирать из нее текстурпак для мода. | + | *resources - необязательна, разработчик может собирать из нее текстурпак для мода. |
== Структура скриптов == | == Структура скриптов == | ||
Версия 14:01, 10 июля 2017
Моды в Core Engine представляют собой папку с кодом, изображениями и текстурами, подхватываемых движком.
Общее
В папке с модом находятся следующие объекты:
- main.js - содержит весь код мода целиком.
- launcher.js - выполняется при загрузке мода, позволяет подключить сторонние моды, управлять ресурсами.
- config.json - файл конфигурации мода, по умолчанию содержит только две опции:
- enabled - по умолчанию true, определяет возможность загрузки мода.
- advanced_api - не используется самим движком, но может быть использована модом для расширения API.
- mod.info - не используется самим движком, но позволяет моду самоиндифицироваться.
- resources.zip - текстурпак, содержит текстуры блоков, предметов, мобов. Разработчикам настоятельно рекомендуется собирать данный архив из содержимого папки resources.
- resources.json - содержит список загружаемых движком текстурпаком. По умолчанию содержит только resources.zip со значением true.
- dev - см. Структура скриптов
- gui - папка, содержит текстуры для интерфейса, загружаются автоматически.
- lib - см. Подключение библиотек.
- resources - необязательна, разработчик может собирать из нее текстурпак для мода.
Структура скриптов
Весь код, конечно, можно писать и в main.js. Но это неудобно, к тому же при малейшем расширении кодовой базы большинство текстовых редакторов начинают тупить.
Для удобной работы с кодом можно распределить его по нескольким файлам, а потом склеивать содержимое и сохранять все в main.js.
Core Engine делает это автоматически. Все нужные файлы кода должны лежать в папке dev. В отличие от аддонов Factorization, можно распределять части скрипта по подпапкам.
Во время загрузки мода, если имеется dev, движок читает специальный файл-"манифест" .includes внутри dev, содержащий список файлов, подлежащих сборке. Добавлять скрипты в этот манифест очень легко. Для этого введите его путь и сохраните файл.
lol.js //движок будет искать файл %папка мода%/dev/lol.js syka/blyad.js //а тут путь %папка мода%/dev/syka/blyad.js //кстати, эти комментарии будут находиться прямо в main.js(!), так что используйте это, если не хотите заблудиться там ;)
Подключение библиотек
В Core Engine существует система особых скриптов — библиотек. Они загружаются вместе с первым модом, который использует данную библиотеку, и доступны в коде других модов с этим же скриптом.
Все библиотеки хранятся в папке lib.
Чтобы создать свою библиотеку, напишите обычный скрипт и засуньте его в папку lib. В конце файла добавьте:
registerAPIUnit(псевдоним, значение)
Псевдоним - имя, под которым значение будет доступно в модах, использующих библиотеку.
Значение - тут все, что угодно - метод библиотеки, объект, просто число или строка.
Повторите этот метод для всех нужных значений.
Для подключения библиотеки к вашему моду закиньте ее в папку lib. Пропишите в нужном месте мода метод:
importLib(название библиотеки, псевдоним);
Название библиотеки - название файла скрипта с ней без js в кавычках.
Псевдоним - нужный вам псевдоним из указанной библиотеки в кавычках. Если вам нужно все ее содержимое, пропишите универсальный псевдоним "*".