mineprogramming wiki - Вклад участника [ru]

Minecraft Script Engine

2018-11-06T14:09:35Z

193.105.201.12:

<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">'''Внимание! '''Данная документация предназначена исключительно для ознакомления, так как '''Minecraft Script Engine''' находится в разработке и конечный его вариант может существенно отличаться от текущего.</div>
== Система скриптинга ==

В '''Minecraft Script Engine''' использован язык программирования Javascript. Скрипты связываются с пакетами поведений, могут отлавливать внутриигровые события и выполнять определенные команды, в частности изменять данные различных компонентов игры.

Два примера уже доступны для скачивания и изучения:

{| border="1" cellpadding="1" cellspacing="1" style="width: 100%;"
|-
| style="text-align: center;" | '''Пример'''
| style="text-align: center;" | '''Ссылка'''
|-
| Mob Arena
| [https://aka.ms/minecraftscripting_mobarena https://aka.ms/minecraftscripting_mobarena]
|-
| Turn-Based RPG
| [https://aka.ms/minecraftscripting_turnbased https://aka.ms/minecraftscripting_turnbased]
|}

== Структура файлов и папок ==

В качестве основы предлагается использовать ванильный набор поведений, который можно скачать по [https://aka.ms/minecraftscripting_behaviorpack этой ссылке]. 

Все скрипты разделены на две основные группы - серверные и клиентские. Серверные скрипты управляют глобальными игровыми событиями, такими как спавн сущностей или изменение их компонентов. Клиентские скрипты обрабатывают лишь отдельные действия, связанные с игроком. Такая структура позволяет избавиться от необходимости разделять кодом серверную и клиентскую логику и создавать скрипты как для одиночной игры (где сервером будет выступать сам клиент), так и для многопользовательской. Следует также отметить, что количество скриптов в одном пакете поведений неограничено, и все скрипты будут запускаться независимо друг от друга. Все скрипты с расширением .js будут автоматически подгружены из папок client и server.

Пока '''Minecraft Script Engine''' находится в бета-версии, для его работы необходимо будет включение экспериментального геймплея в настройках мира. 

Структура файлов и папок для пакета поведения со скриптами приведена ниже:

[[File:Folder Structure.PNG|RTENOTITLE]]

<div class="mw-parser-output">
<div class="mw-parser-output">
== Структура скрипта ==

Каждый скрипт должен регистрировать систему (клиентский - клиентскую, серверный - серверную). Достигается это следующим кодом:
<syntaxhighlight lang="Javascript">var sampleClientSystem == client.registerSystem(0, 0); // Для клиентских скриптов
var sampleServerSystem == server.registerSystem(0, 0); // Для серверных скриптов</syntaxhighlight>

Аргументами функции registerSystem является версия Minecraft Script Engine, под которую заточен данный скрипт. В примере выше это версия 0.0. Версии API будут различаться набором функционала и, соответственно, совместимостью с версиями майнкрафта.

Далее необходимо задать нашим системам функции ''initialize'',''update ''и ''shutdown'':
<syntaxhighlight lang="Javascript">sampleSystem.initialize == function() {
//Код инициализации
};
sampleSystem.update == function() {
//Код обновления
};
sampleSystem.shutdown == function() {
//Код завершения работы
};</syntaxhighlight>

Для отладки кода (обнаружения ошибок и даже построчного выполнения) нам понадобится компьютер с установленной [https://www.microsoft.com/uk-ua/software-download/windows10 Windows 10], [https://visualstudio.microsoft.com/ru/ Visual Studio] и [https://www.microsoft.com/store/productId/9NBLGGH2JHXJ Minecraft Bedrock Edition]. 

Файлы логов могут быть расположены в различных местах на различных платформах. В Windows 10 это ''%APPDATA%\..\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\logs''.

Также возможна отладка на ходу, для этого необходимо установить JIT Debugger и модули разработки Javascript в Visual Studio, затем подключиться к процессу Minecraft (''Debug -> Attach to Process''). Теперь с помощью кнопки Pause можно остановить выполнение скрипта и увидеть значения переменных непосредственно в процессе его выполнения. При этом через некоторое время может произойти отключение клиентов от сервера (''time out''). 
</div>

== Команды ==

Все команды выполняются внутри функций с помощью контекста this. Это работает как в приведенных выше функциях, так и в определенных таким же образом собственных. 

=== Сущности ===

Для сущностей используются следующие команды:

*createEntity() - создает пустую сущность без <s>признаков жизни</s> компонентов и не добавляет её в мир. Возвращает объект ''EntityObject'', представляющий данную сущность, либо ''null'', если что-то пошло не так.
*createEntity(type, template) - создает сущность с типом ''type ''(собственный тип сущности, должен соответствовать правилам имен переменных) и компонентами, взятыми из сущности текущего пакета поведений (например, ''minecraft:cow'').
*destroyEntity(EntityObject)  - уничтожает объект ''EntityObject ''и делает его невалидным. При этом всесущности данного типа просто убираются из мира (без события смерти).
*isValidEntity(EntityObject) - возвращает ''true'', если ''EntityObject ''валден, в противном случае ''false''. Может также возвращать ''null ''при возникновении ошибки. 

=== Компоненты ===

Компоненты используются для задания параметров сущностям. По-сути, они являются тем и же компонентами, что используются в пакетах поведения, но могут быть динамически присвоены сущностям во время игры.

*registerComponent(name, data) - регистрирует новый компонент сущности с названием ''name ''и объектом данных ''data''. Рекомендуется называть свои компоненты в формате ''packName:customComponent'' во избежание конфликтов с другими наборами поведений. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
*createComponent(EntityObject, componentName) - создает экземпляр компонента с названием ''componentName ''и присваивает его сущности ''EntityObject''. Возвращает объект компонента, если вызов функции прошел успешно, в противном случае ''null''. 
*hasComponent(EntityObject, componentName) - возвращает ''true'', если ''EntityObject ''содержит компонент с названием ''componentName'', в противном случае ''false''. Может также возвращать ''null ''при возникновении ошибки. 
*getComponent(EntityObject, сomponentName) - ищет компонент с именем ''componentName'' в ''EntityObject.'' Возвращает объект компонента, если он есть, в противном случае ''null''.
*applyComponentChanges(componentObject) - применяет изменения в объекте компонента ''componentObject''. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
*destroyComponent(EntityObject, сomponentName) - убирает компонент с названием ''сomponentName ''из объекта ''EntityObject''. На данный моменнт работает только с компонентами, добавленными скриптом, и не работает с компонентами, определенными в JSON. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
<div class="mw-parser-output">
=== События ===

События - одна из самых важных частей любой системы. В '''Minecraft Script Engine '''для управления событиями используются следующие функции:

*broadcastEvent(EventIdentifier, EventData) - вызывает событие с идентификатором ''EventIdentifier ''и данными ''EventData''. Возвращает ''ture'', если вызов события прошел успешно, в противном случае ''null''. 
*listenForEvent(EventIdentifier, CallbackObject) - подписывает функцию ''CallbackObject'' на событие ''EventIdentifier''. Событие может быть как собственным (вызваным с помощью ''broadcastEvent''), так и внутриигровым. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 

=== Фильтры ===

Фильтры (''Англ. Script Views'') - способ отсортировать сущностей на основе их компонентов. Дополнительные возможности фильтрования предоставлют ''пространственные фильтры''. Все фильтры возвращают сущностей, на данный момент прогруженных в мире.

*registerView() - позволяет заригистрировать пустой фильтр, который будет возвращать все сущности в игре. Возвращает объект с ''ID ''фильтра либо ''null'', если во время выполнения команды произошла ошибка. 
*registerSpatialView(SpatialComponent, X_Attribute, Y_Attribute, Z_Attribute) - регистрирует фильтр, использующий пространственный компонент (задается с помощью minecraft:position либо кастомным компонентом). Принимает непосредственно пространственный компонент (координаты начала коробки) и размерности по осям X, Y, Z соответственно. Возвращает объект с ''ID ''фильтра либо ''null'', если во время выполнения команды произошла ошибка. 
*addFilter(ComponentName) - добавляет фильтрацию по компоненту ''ComponentName''. 
*getEntitiesFromView(View) - получает массив сущностей, подпадающий под фильтр ''View'', либо ''null ''в случае ошибки. 
*getEntitiesFromSpatialView(SpatialView, X_0, Y_0, Z_0, X_1, Y_1, Z_1) - возвращает массив сущностей, которые попадают в коробку с координатами X_0, Y_0, Z_0, X_1, Y_1, Z_1, где нулевые координаты - координаты начала коробки, а первые - конца (У направлен вверх), либо ''null ''в случае ошибки. 

<div class="mw-parser-output">
== Ссылки ==

*[https://minecraft.gamepedia.com/Bedrock_Beta_Script_Documentation Оригинальная документация] (на английском) - с описанием всех встроенных компонентов и событий.
*[https://minecraft.gamepedia.com/Bedrock_Beta_UI_Documentation Документация по пользовательским интерфейсам]
*[https://minecraft.gamepedia.com/Add-on Документация по аддонам]
</div>

Minecraft Script Engine

2018-11-06T14:07:19Z

193.105.201.12:

<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">'''Внимание! '''Данная документация предназначена исключительно для ознакомления, так как '''Minecraft Script Engine''' находится в разработке и конечный его вариант может существенно отличаться от текущего.</div>
== Система скриптинга ==

В '''Minecraft Script Engine''' использован язык программирования Javascript. Скрипты связываются с пакетами поведений, могут отлавливать внутриигровые события и выполнять определенные команды, в частности изменять данные различных компонентов игры.

Два примера уже доступны для скачивания и изучения:

{| border="1" cellpadding="1" cellspacing="1" style="width: 100%;"
|-
| style="text-align: center;" | '''Пример'''
| style="text-align: center;" | '''Ссылка'''
|-
| Mob Arena
| [https://aka.ms/minecraftscripting_mobarena https://aka.ms/minecraftscripting_mobarena]
|-
| Turn-Based RPG
| [https://aka.ms/minecraftscripting_turnbased https://aka.ms/minecraftscripting_turnbased]
|}

== Структура файлов и папок ==

В качестве основы предлагается использовать ванильный набор поведений, который можно скачать по [https://aka.ms/minecraftscripting_behaviorpack этой ссылке]. 

Все скрипты разделены на две основные группы - серверные и клиентские. Серверные скрипты управляют глобальными игровыми событиями, такими как спавн сущностей или изменение их компонентов. Клиентские скрипты обрабатывают лишь отдельные действия, связанные с игроком. Такая структура позволяет избавиться от необходимости разделять кодом серверную и клиентскую логику и создавать скрипты как для одиночной игры (где сервером будет выступать сам клиент), так и для многопользовательской. Следует также отметить, что количество скриптов в одном пакете поведений неограничено, и все скрипты будут запускаться независимо друг от друга. Все скрипты с расширением .js будут автоматически подгружены из папок client и server.

Пока '''Minecraft Script Engine''' находится в бета-версии, для его работы необходимо будет включение экспериментального геймплея в настройках мира. 

Структура файлов и папок для пакета поведения со скриптами приведена ниже:

[[File:Folder Structure.PNG|RTENOTITLE]]

<div class="mw-parser-output">
== Структура скрипта ==

Каждый скрипт должен регистрировать систему (клиентский - клиентскую, серверный - серверную). Достигается это следующим кодом:
<syntaxhighlight lang="Javascript">var sampleClientSystem == client.registerSystem(0, 0); // Для клиентских скриптов
var sampleServerSystem == server.registerSystem(0, 0); // Для серверных скриптов</syntaxhighlight>

Аргументами функции registerSystem является версия Minecraft Script Engine, под которую заточен данный скрипт. В примере выше это версия 0.0. Версии API будут различаться набором функционала и, соответственно, совместимостью с версиями майнкрафта.

Далее необходимо задать нашим системам функции ''initialize'',''update ''и ''shutdown'':
<syntaxhighlight lang="Javascript">sampleSystem.initialize == function() {
//Код инициализации
};
sampleSystem.update == function() {
//Код обновления
};
sampleSystem.shutdown == function() {
//Код завершения работы
};</syntaxhighlight>

Для отладки кода (обнаружения ошибок и даже построчного выполнения) нам понадобится компьютер с установленной [https://www.microsoft.com/uk-ua/software-download/windows10 Windows 10], [https://visualstudio.microsoft.com/ru/ Visual Studio] и [https://www.microsoft.com/store/productId/9NBLGGH2JHXJ Minecraft Bedrock Edition]. 

Файлы логов могут быть расположены в различных местах на различных платформах. В Windows 10 это ''%APPDATA%\..\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\logs''.

Также возможна отладка на ходу, для этого необходимо установить JIT Debugger и модули разработки Javascript в Visual Studio, затем подключиться к процессу Minecraft (''Debug -> Attach to Process''). Теперь с помощью кнопки Pause можно остановить выполнение скрипта и увидеть значения переменных непосредственно в процессе его выполнения. При этом через некоторое время может произойти отключение клиентов от сервера (''time out''). 
<div class="mw-parser-output"><div class="mw-parser-output"> </div> </div> </div>

== Команды ==

Все команды выполняются внутри функций с помощью контекста this. Это работает как в приведенных выше функциях, так и в определенных таким же образом собственных. 

=== Сущности ===

Для сущностей используются следующие команды:

*createEntity() - создает пустую сущность без <s>признаков жизни</s> компонентов и не добавляет её в мир. Возвращает объект ''EntityObject'', представляющий данную сущность, либо ''null'', если что-то пошло не так.
*createEntity(type, template) - создает сущность с типом ''type ''(собственный тип сущности, должен соответствовать правилам имен переменных) и компонентами, взятыми из сущности текущего пакета поведений (например, ''minecraft:cow'').
*destroyEntity(EntityObject)  - уничтожает объект ''EntityObject ''и делает его невалидным. При этом всесущности данного типа просто убираются из мира (без события смерти).
*isValidEntity(EntityObject) - возвращает ''true'', если ''EntityObject ''валден, в противном случае ''false''. Может также возвращать ''null ''при возникновении ошибки. 

=== Компоненты ===

Компоненты используются для задания параметров сущностям. По-сути, они являются тем и же компонентами, что используются в пакетах поведения, но могут быть динамически присвоены сущностям во время игры.

*registerComponent(name, data) - регистрирует новый компонент сущности с названием ''name ''и объектом данных ''data''. Рекомендуется называть свои компоненты в формате ''packName:customComponent'' во избежание конфликтов с другими наборами поведений. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
*createComponent(EntityObject, componentName) - создает экземпляр компонента с названием ''componentName ''и присваивает его сущности ''EntityObject''. Возвращает объект компонента, если вызов функции прошел успешно, в противном случае ''null''. 
*hasComponent(EntityObject, componentName) - возвращает ''true'', если ''EntityObject ''содержит компонент с названием ''componentName'', в противном случае ''false''. Может также возвращать ''null ''при возникновении ошибки. 
*getComponent(EntityObject, сomponentName) - ищет компонент с именем ''componentName'' в ''EntityObject.'' Возвращает объект компонента, если он есть, в противном случае ''null''.
*applyComponentChanges(componentObject) - применяет изменения в объекте компонента ''componentObject''. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
*destroyComponent(EntityObject, сomponentName) - убирает компонент с названием ''сomponentName ''из объекта ''EntityObject''. На данный моменнт работает только с компонентами, добавленными скриптом, и не работает с компонентами, определенными в JSON. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
<div class="mw-parser-output">
=== События ===

События - одна из самых важных частей любой системы. В '''Minecraft Script Engine '''для управления событиями используются следующие функции:

*broadcastEvent(EventIdentifier, EventData) - вызывает событие с идентификатором ''EventIdentifier ''и данными ''EventData''. Возвращает ''ture'', если вызов события прошел успешно, в противном случае ''null''. 
*listenForEvent(EventIdentifier, CallbackObject) - подписывает функцию ''CallbackObject'' на событие ''EventIdentifier''. Событие может быть как собственным (вызваным с помощью ''broadcastEvent''), так и внутриигровым. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 

=== Фильтры ===

Фильтры (''Англ. Script Views'') - способ отсортировать сущностей на основе их компонентов. Дополнительные возможности фильтрования предоставлют ''пространственные фильтры''. Все фильтры возвращают сущностей, на данный момент прогруженных в мире.

*registerView() - позволяет заригистрировать пустой фильтр, который будет возвращать все сущности в игре. Возвращает объект с ''ID ''фильтра либо ''null'', если во время выполнения команды произошла ошибка. 
*registerSpatialView(SpatialComponent, X_Attribute, Y_Attribute, Z_Attribute) - регистрирует фильтр, использующий пространственный компонент (задается с помощью minecraft:position либо кастомным компонентом). Принимает непосредственно пространственный компонент (координаты начала коробки) и размерности по осям X, Y, Z соответственно. Возвращает объект с ''ID ''фильтра либо ''null'', если во время выполнения команды произошла ошибка. 
*addFilter(ComponentName) - добавляет фильтрацию по компоненту ''ComponentName''. 
*getEntitiesFromView(View) - получает массив сущностей, подпадающий под фильтр ''View'', либо ''null ''в случае ошибки. 
*getEntitiesFromSpatialView(SpatialView, X_0, Y_0, Z_0, X_1, Y_1, Z_1) - возвращает массив сущностей, которые попадают в коробку с координатами X_0, Y_0, Z_0, X_1, Y_1, Z_1, где нулевые координаты - координаты начала коробки, а первые - конца (У направлен вверх), либо ''null ''в случае ошибки. 

<div class="mw-parser-output">
== Ссылки ==

*[https://minecraft.gamepedia.com/Bedrock_Beta_Script_Documentation Оригинальная документация] (на английском) - с описанием всех встроенных компонентов и событий.
*[https://minecraft.gamepedia.com/Bedrock_Beta_UI_Documentation Документация по пользовательским интерфейсам]
*[https://minecraft.gamepedia.com/Add-on Документация по аддонам]
</div>

Minecraft Script Engine

2018-11-06T14:06:54Z

193.105.201.12:

<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">'''Внимание! '''Данная документация предназначена исключительно для ознакомления, так как '''Minecraft Script Engine''' находится в разработке и конечный его вариант может существенно отличаться от текущего.</div>
== Система скриптинга ==

В '''Minecraft Script Engine''' использован язык программирования Javascript. Скрипты связываются с пакетами поведений, могут отлавливать внутриигровые события и выполнять определенные команды, в частности изменять данные различных компонентов игры.

Два примера уже доступны для скачивания и изучения:

{| border="1" cellpadding="1" cellspacing="1" style="width: 100%;"
|-
| style="text-align: center;" | '''Пример'''
| style="text-align: center;" | '''Ссылка'''
|-
| Mob Arena
| [https://aka.ms/minecraftscripting_mobarena https://aka.ms/minecraftscripting_mobarena]
|-
| Turn-Based RPG
| [https://aka.ms/minecraftscripting_turnbased https://aka.ms/minecraftscripting_turnbased]
|}

== Структура файлов и папок ==

В качестве основы предлагается использовать ванильный набор поведений, который можно скачать по [https://aka.ms/minecraftscripting_behaviorpack этой ссылке]. 

Все скрипты разделены на две основные группы - серверные и клиентские. Серверные скрипты управляют глобальными игровыми событиями, такими как спавн сущностей или изменение их компонентов. Клиентские скрипты обрабатывают лишь отдельные действия, связанные с игроком. Такая структура позволяет избавиться от необходимости разделять кодом серверную и клиентскую логику и создавать скрипты как для одиночной игры (где сервером будет выступать сам клиент), так и для многопользовательской. Следует также отметить, что количество скриптов в одном пакете поведений неограничено, и все скрипты будут запускаться независимо друг от друга. Все скрипты с расширением .js будут автоматически подгружены из папок client и server.

Пока '''Minecraft Script Engine''' находится в бета-версии, для его работы необходимо будет включение экспериментального геймплея в настройках мира. 

Структура файлов и папок для пакета поведения со скриптами приведена ниже:

[[File:Folder Structure.PNG|RTENOTITLE]]

<div class="mw-parser-output">
== Структура скрипта ==

Каждый скрипт должен регистрировать систему (клиентский - клиентскую, серверный - серверную). Достигается это следующим кодом:
<syntaxhighlight lang="Javascript">var sampleClientSystem == client.registerSystem(0, 0); // Для клиентских скриптов
var sampleServerSystem == server.registerSystem(0, 0); // Для серверных скриптов</syntaxhighlight>

Аргументами функции registerSystem является версия Minecraft Script Engine, под которую заточен данный скрипт. В примере выше это версия 0.0. Версии API будут различаться набором функционала и, соответственно, совместимостью с версиями майнкрафта.

Далее необходимо задать нашим системам функции ''initialize'',''update ''и ''shutdown'':
<syntaxhighlight lang="Javascript">sampleSystem.initialize == function() {
//Код инициализации
};
sampleSystem.update == function() {
//Код обновления
};
sampleSystem.shutdown == function() {
//Код завершения работы
};</syntaxhighlight>

Для отладки кода (обнаружения ошибок и даже построчного выполнения) нам понадобится компьютер с установленной [https://www.microsoft.com/uk-ua/software-download/windows10 Windows 10], [https://visualstudio.microsoft.com/ru/ Visual Studio] и [https://www.microsoft.com/store/productId/9NBLGGH2JHXJ Minecraft Bedrock Edition]. 

Файлы логов могут быть расположены в различных местах на различных платформах. В Windows 10 это ''%APPDATA%\..\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\logs''.

Также возможна отладка на ходу, для этого необходимо установить JIT Debugger и модули разработки Javascript в Visual Studio, затем подключиться к процессу Minecraft (''Debug -> Attach to Process''). Теперь с помощью кнопки Pause можно остановить выполнение скрипта и увидеть значения переменных непосредственно в процессе его выполнения. При этом через некоторое время может произойти отключение клиентов от сервера (''time out''). 
<div class="mw-parser-output"><div class="mw-parser-output"> </div> </div> </div>

== Команды ==

Все команды выполняются внутри функций с помощью контекста this. Это работает как в приведенных выше функциях, так и в определенных таким же образом собственных. 

=== Сущности ===

Для сущностей используются следующие команды:

*createEntity() - создает пустую сущность без <s>признаков жизни</s> компонентов и не добавляет её в мир. Возвращает объект ''EntityObject'', представляющий данную сущность, либо ''null'', если что-то пошло не так.
*createEntity(type, template) - создает сущность с типом ''type ''(собственный тип сущности, должен соответствовать правилам имен переменных) и компонентами, взятыми из сущности текущего пакета поведений (например, ''minecraft:cow'').
*destroyEntity(EntityObject)  - уничтожает объект ''EntityObject ''и делает его невалидным. При этом всесущности данного типа просто убираются из мира (без события смерти).
*isValidEntity(EntityObject) - возвращает ''true'', если ''EntityObject ''валден, в противном случае ''false''. Может также возвращать ''null ''при возникновении ошибки. 

=== Компоненты ===

Компоненты используются для задания параметров сущностям. По-сути, они являются тем и же компонентами, что используются в пакетах поведения, но могут быть динамически присвоены сущностям во время игры.

*registerComponent(name, data) - регистрирует новый компонент сущности с названием ''name ''и объектом данных ''data''. Рекомендуется называть свои компоненты в формате ''packName:customComponent'' во избежание конфликтов с другими наборами поведений. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
*createComponent(EntityObject, componentName) - создает экземпляр компонента с названием ''componentName ''и присваивает его сущности ''EntityObject''. Возвращает объект компонента, если вызов функции прошел успешно, в противном случае ''null''. 
*hasComponent(EntityObject, componentName) - возвращает ''true'', если ''EntityObject ''содержит компонент с названием ''componentName'', в противном случае ''false''. Может также возвращать ''null ''при возникновении ошибки. 
*getComponent(EntityObject, сomponentName) - ищет компонент с именем ''componentName'' в ''EntityObject.'' Возвращает объект компонента, если он есть, в противном случае ''null''.
*applyComponentChanges(componentObject) - применяет изменения в объекте компонента ''componentObject''. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
*destroyComponent(EntityObject, сomponentName) - убирает компонент с названием ''сomponentName ''из объекта ''EntityObject''. На данный моменнт работает только с компонентами, добавленными скриптом, и не работает с компонентами, определенными в JSON. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 
<div class="mw-parser-output">
=== События ===

События - одна из самых важных частей любой системы. В '''Minecraft Script Engine '''для управления событиями используются следующие функции:

*broadcastEvent(EventIdentifier, EventData) - вызывает событие с идентификатором ''EventIdentifier ''и данными ''EventData''. Возвращает ''ture'', если вызов события прошел успешно, в противном случае ''null''. 
*listenForEvent(EventIdentifier, CallbackObject) - подписывает функцию ''CallbackObject'' на событие ''EventIdentifier''. Событие может быть как собственным (вызваным с помощью ''broadcastEvent''), так и внутриигровым. Возвращает ''ture'', если вызов функции прошел успешно, в противном случае ''null''. 

=== Фильтры ===

Фильтры (''Англ. Script Views'') - способ отсортировать сущностей на основе их компонентов. Дополнительные возможности фильтрования предоставлют ''пространственные фильтры''. Все фильтры возвращают сущностей, на данный момент прогруженных в мире.

*registerView() - позволяет заригистрировать пустой фильтр, который будет возвращать все сущности в игре. Возвращает объект с ''ID ''фильтра либо ''null'', если во время выполнения команды произошла ошибка. 
*registerSpatialView(SpatialComponent, X_Attribute, Y_Attribute, Z_Attribute) - регистрирует фильтр, использующий пространственный компонент (задается с помощью minecraft:position либо кастомным компонентом). Принимает непосредственно пространственный компонент (координаты начала коробки) и размерности по осям X, Y, Z соответственно. Возвращает объект с ''ID ''фильтра либо ''null'', если во время выполнения команды произошла ошибка. 
*addFilter(ComponentName) - добавляет фильтрацию по компоненту ''ComponentName''. 
*getEntitiesFromView(View) - получает массив сущностей, подпадающий под фильтр ''View'', либо ''null ''в случае ошибки. 
*getEntitiesFromSpatialView(SpatialView, X_0, Y_0, Z_0, X_1, Y_1, Z_1) - возвращает массив сущностей, которые попадают в коробку с координатами X_0, Y_0, Z_0, X_1, Y_1, Z_1, где нулевые координаты - координаты начала коробки, а первые - конца (У направлен вверх), либо ''null ''в случае ошибки. 

== Ссылки ==

*[https://minecraft.gamepedia.com/Bedrock_Beta_Script_Documentation Оригинальная документация] (на английском) - с описанием всех встроенных компонентов и событий.
*[https://minecraft.gamepedia.com/Bedrock_Beta_UI_Documentation Документация по пользовательским интерфейсам]
*[https://minecraft.gamepedia.com/Add-on Документация по аддонам]
</div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div>

Заглавная страница

2018-10-25T10:04:26Z

193.105.201.12:

<div class="mw-parser-output">Mineprogramming Wiki - уникальный проект на основе [https://www.mineprogramming.org/ mineprogramming ], на котором собрано все, что нужно для программирования в среде Minecraft. Здесь вы сможете найти информацию о таких языках и технологиях, как [[InnerCore|InnerCore ]], [[ModPE|ModPE ]], [[CoreEngine|CoreEngine ]] , [[PocketMine|PocketMine ]], [[Forge|Forge ]], [[Minecraft_add-ons|Minecraft add-ons ]] и многим другим.
[https://www.mineprogramming.org/ Mineprogramming ]- еще более уникальный проект, посвященный программированию в Майнкрафте, при чем если на wiki вы найдете информацию по конкретным языкам и технологиям, то на [https://www.mineprogramming.org/ Mineprogramming ]расположены наши программы для создания модов, наши моды, а так же различные интересные статьи, посвященные программированию в Майнкрафте!
<div class="mw-parser-output">
<div class="mw-parser-output"><div class="mw-parser-output">
== Технологии Minecraft ==

*[[InnerCore|InnerCore ]] - революционный загрузчик модов для MinecraftPocket Edition. Имеет схожий с [[CoreEngine|CoreEngine ]]API
*[[Minecraft_Script_Engine|Minecraft Script Engine]] - новый движок от [https://mojang.com/ Mojang], позволяющий создавать дополнения к игре без установки вспомагательного программного обеспечения.
*[[ModPE|ModPE ]]- простейшее линейное API моддинга MCPE. Поддерживает создание предметов и блоков, работу с мобами, окружением, игроком.
*[[CoreEngine|CoreEngine ]]- движок, существенно расширяющий возможности [[ModPE|ModPE ]]. Может создавать интерфейс, контейнеры, обновляемые обьекты, сжимает блоки в мнимые id.
*[[Forge|Forge ]]- открытое API для моддинга Minecraft PC.
*[[Командные_блоки|Командные блоки ]]- блоки-терминалы, работающие от редстоуна. Простейший способ запрограммировать что-либо в Minecraft.
*[[PocketMine|PocketMine ]]- серверное ядро для Minecraft PE. . Является основой для большинства современных серверных движков на ПЕ, сам по себе устарел и не обновляется.
*[[Nukkit|Nukkit ]] - серверное ядро для Minecraft PE, разработанное на Java.
*[[Bukkit|Bukkit ]]- серверное ядро для Minecraft PC. Является основой для большинства современных серверных движков на ПК, сам по себе устарел и не обновляется.
*[[Vanillia|Vanillia ]]- официальное серверное ядро Minecraft PC.
*[[Minecraft_add-ons|Minecraft add-ons ]]- официальное закрытое API для моддинга Minecraft PE. Возможно изменение поведения мобов, текстур, шейдеров, добавление новых блоков за счет дат уже существующих, изменять еду и посадки.
</div> </div>

== Теория и практика программирования в Minecraft ==

*[[ID_блоков_и_предметов|ID блоков и предметов]]
*[[Форматирование_текста|Форматирование текста в чате]]
*[https://minecraft-ru.gamepedia.com/Цикл_дня_и_ночи Время]
</div>

InnerCore/Список коллбеков

2018-10-13T16:41:16Z

193.105.201.12:

=== ReadSaves ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ReadSaves", function () {

});</syntaxhighlight>

Чтение всех сохранений

=== WriteSaves ===
<syntaxhighlight lang="Javascript">Callback.addCallback("WriteSaves ", function () {

});</syntaxhighlight>

Запись всех сохранений

=== GenerateNetherChunk ===
<syntaxhighlight lang="Javascript">Callback.addCallback("GenerateNetherChunk", function (chunkX, chunkZ) {

});</syntaxhighlight>

Генерация чанка в аду по координатам

=== GenerateEndChunk ===
<syntaxhighlight lang="Javascript">Callback.addCallback("GenerateEndChunk", function(chunkX, chunkZ) {

}); </syntaxhighlight>

Генерация чанка в Эндер мире по координатам

=== GenerateChunk ===
<syntaxhighlight lang="Javascript">Callback.addCallback("GenerateChunk", function (chunkX, chunkZ) {

}); </syntaxhighlight>

Генерация чанка в обычном мире по координатам

=== GenerateChunkUndeground ===
<syntaxhighlight lang="Javascript">Callback.addCallback("GenerateChunkUndeground", function (chunkX, chunkZ) {

});</syntaxhighlight>

Генерация чанка под землей

=== PreRestart ===
<syntaxhighlight lang="Javascript">Callback.addCallback("PreRestart", function () {

});</syntaxhighlight>

Перед перезапуском bl (?)

=== Tick ===
<syntaxhighlight lang="Javascript">Callback.addCallback("tick", function () {

}); </syntaxhighlight>

Тик

<div class="mw-parser-output">
=== LevelSelected ===

 
<syntaxhighlight lang="Javascript">Callback.addCallback("LevelSelected", function (nameWorld, dirWorld) {

}); </syntaxhighlight>

Начало загрузки мира
</div>

=== LevelLoaded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("LevelLoaded", function () {

}); </syntaxhighlight>

Конец загрузки мира

=== LevelLeft ===
<syntaxhighlight lang="Javascript">Callback.addCallback("LevelLeft", function () {

}); </syntaxhighlight>

Выход из мира

<div class="mw-parser-output">
=== DestroyBlock ===

 
<syntaxhighlight lang="Javascript">Callback.addCallback("DestroyBlock", function (coords, block, player) {

});</syntaxhighlight>

Уничтожение блока;
</div>

=== DestroyBlockStart ===
<syntaxhighlight lang="Javascript">Callback.addCallback("DestroyBlockStart", function (coords, block, player) {

}); </syntaxhighlight>

=== DestroyBlockContinue ===

Начало уничтожения блока
<syntaxhighlight lang="Javascript">Callback.addCallback("DestroyBlockContinue", function (coords, block, progress, player) {

}); </syntaxhighlight>

Продолжение уничтожения блока. Вызывается 3 раза в тик (?)

=== Explosion ===
<syntaxhighlight lang="Javascript">Callback.addCallback("Explosion", function (coords, params) {

});</syntaxhighlight>

Взрыв

=== RedstoneSignal ===
<syntaxhighlight lang="Javascript">Callback.addCallback("RedstoneSignal", function (coords, params, block) {

}); </syntaxhighlight>

Изменение уровня сигнала редстоуна для зарегистированных потребителей

=== NativeCommand ===
<syntaxhighlight lang="Javascript">Callback.addCallback("NativeCommand", function (str) {

}); </syntaxhighlight>

Команда

=== ClientChat ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ClientChat", function (str) {

}); </syntaxhighlight>

Сообщение в чате

=== ServerChat ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ServerChat", function (str) {

}); </syntaxhighlight>

Мультиплеер не поддерживается

=== ItemUse ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ItemUse", function (coords, item, block) {

}); </syntaxhighlight>

Использование предмета

=== PlayerAttack ===
<syntaxhighlight lang="Javascript">Callback.addCallback("PlayerAttack", function (player, victim) {

}); </syntaxhighlight>

Атака игрока

=== EntityAdded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("EntityAdded", function (entity) {

}); </syntaxhighlight>

Добавление существа

=== EntityRemoved ===
<syntaxhighlight lang="Javascript">Callback.addCallback("EntityRemoved", function (entity) {

}); </syntaxhighlight>

Удаление существа

=== EntityDeath ===
<syntaxhighlight lang="Javascript">Callback.addCallback("EntityDeath", function (entity) {

}); </syntaxhighlight>

Смерть существа

=== EntityHurt ===
<syntaxhighlight lang="Javascript">Callback.addCallback("EntityHurt", function (attacker, victim, damage) {

}); </syntaxhighlight>

Получение урона мобом

=== ProjectileHit ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ProjectileHit", function (projectile, item, target) {

}); </syntaxhighlight>

Кидаемый предмет попадает в (?)

=== ProjectileHitBlock ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ProjectileHitBlock", function (projectile, coords, block) {

}); </syntaxhighlight>

Кидаемый предмет попадает в блок

=== ProjectileHitEntity ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ProjectileHitEntity", function (projectile, entity) {

}); </syntaxhighlight>

Кидаемый предмет попадает в существо

=== FoodEaten ===
<syntaxhighlight lang="Javascript">Callback.addCallback("FoodEaten", function (heal, satRatio) {

}); </syntaxhighlight>

Съедание еды

<div class="mw-parser-output">
=== NativeGuiChanged ===
<syntaxhighlight lang="Javascript">Callback.addCallback("NativeGuiChanged", function (screenName) {

}); </syntaxhighlight>

Изменение нативного экрана игры. [[InnerCore/Список_назаний_ванильных_экранов|Список назаний ванильных экранов]].
</div>

=== ExpAdd ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ExpAdd", function (amount, player) {

}); </syntaxhighlight>

Увеличение количества опыта у игрока

=== ExpLevelAdd ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ExpLevelAdd", function (levelAmount, player) {

}); </syntaxhighlight>

Увеличение уровня игрока

=== ModDirLoaded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ModDirLoaded", function () {

}); </syntaxhighlight>

Cразу после загрузки папки мода(ов)

=== PreBlocksDefined ===
<syntaxhighlight lang="Javascript">Callback.addCallback("PreBlocksDefined", function () {

}); </syntaxhighlight>

Перед добавлением блоков

=== BlocksDefined ===
<syntaxhighlight lang="Javascript">Callback.addCallback("BlocksDefined", function () {

});
</syntaxhighlight>

Добавление блоков

=== PreLoaded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("PreLoaded", function () {

}); </syntaxhighlight>

Перед окончательной загрузкой

=== APILoaded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("APILoaded", function () {

}); </syntaxhighlight>

Для загрузки API модов

=== ModsLoaded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("ModsLoaded", function () {

}); </syntaxhighlight>

Все моды загружены (?)

=== PostLoaded ===
<syntaxhighlight lang="Javascript">Callback.addCallback("PostLoaded", function () {

}); </syntaxhighlight>

Окончательная загрузка всего<br/>  

InnerCore

2018-09-18T11:25:48Z

193.105.201.12:

InnerCore

2018-09-18T11:24:48Z

193.105.201.12:

InnerCore/Структура модов

2018-04-19T07:29:09Z

193.105.201.12: Отмена правки 1492, сделанной 117.181.160.34 (обсуждение)

==Структура модов==
Мод под Inner Core представляет из себя директорию с файлом построения build.config, так же могут присутствовать несколько дополнительных файлов, таких как файл описания и стандартный файл конфигурации. Последний будет создан автоматически.

Если вы не хотите вдаваться в подробности построения модов, вы можете использовать стандартный шаблон мода, который описан [[InnerCore/Стандартный_шаблон_модов|здесь ]].

==Конфиг и описание==
Файл конфига - config.json - задается в формате JSON и генерируется, либо исправляется автоматически. Всегда будет присутствовать значение enabled, которое включает/выключает весь мод. Содержимое этого файла будет визуализировано в меню мода, которое открывается через меню Inner Core. Работа с этим файлом производистся целиком из кода.

Файл информации - mod.info - задается в формате JSON и может не пристуствовать, однако тогда информации о моде в меню Inner Core не будет, название мода будет по имени директории и т.д.

Формат файла mod.info:

<syntaxhighlight lang="javascript">{
"name":"Имя мода",
"author":"Автор мода",
"version":"Версия мода в любом формате",
"description":"Краткое описание мода"
}</syntaxhighlight>

Также директория мода может содержать файл mod_icon.png, который будет являться иконкой мода в меню Inner Core. Важен только формат - png - размер может быть любым.

==Основные параметры==
Файл построения задается в формате JSON и имеет несколько разделов, в которых описываются различные настройки и элементы мода.<br />
Первый раздел - defaultConfig - является обязательным и описывает основные параметры построения мода. С ним содержимое файла построения будет выглядеть следующим образом (комментарии, помеченные символом #, присутствовать не должны):<p class="mw_paragraph">
<syntaxhighlight lang="javascript">{
"defaultConfig": {
"api":"CoreEngine", #API, которое будет использовано для всех выполняемых файлов по-умолчанию, варианты API будут перечислены далее
"buildType":"develop", #Этот параметр при разработке должен быть develop, далее он будет изменяться с помощью Inner Core
"libraryDir":"lib/", #Необязательный параметр, который задает стандартную директорию, откуда будут загружаться библиотеки.
}
}</syntaxhighlight>
API задает абсолютное большинство методов, которые могут использовать исполняемые файлы мода. Однако есть набор базовых методов, которые доступны для конкретных типов выполняемых файлов.
Виды API:
<ul><li>CoreEngine - Основной и самый объемный API для разработки модов. В основном вам нужно будет использовать его, остальные варианты более ситуативны и не нужны в большинстве случаев. </li><li>AdaptedScript - Реализует основные возможности, однако не имеет различных реализаций, сильно упрощающих разработку, таких как Tile Entity.</li></ul>

==Исполняемые файлы==
Исполняемые файлы содержат исходный код мода, написаный под нужный вариант API на JavaScript, которые будут выполняться в различные моменты, зависящие от их типа. Так же их можно строить из отдельных директорий и компилировать в байт-код из меню Inner Core для быстродействия и лучшего дебага (релизные версии мода).

Исполняемые файлы описываются в разделе compile, который является массивом. Их может быть сколько угодно много:
<syntaxhighlight lang="javascript">{
"defaultConfig": {
...
},
...
"compile": [
{
"path":"Локальный путь к файлу, к примеру main.js, source/logger.js",
"sourceType":"Тип исполняемого файла, они будут перечислены далее",
"sourceName":"Имя, необязательный параметр, будет использовано при выводе ошибок",
"api":"Тип API, если вы хотите выбрать не тот тип, который вы указали в defaultConfig конкретно для этого файла, иначе этот параметр не нужен"
},
...
]
}</syntaxhighlight>

Типы исполняемых файлов:

# mod - В этом типе файлов находится основной исходный код модов, задающий их контент.
# launcher - Должен присутствовать только один файл этого типа. В нем осуществляется запуск мода в определенный момент (Например если мод использует API другого мода, он должен запуститься только после его загрузки и т.п.). Если никаких дополнительных условий для запуска не нужно, он просто должен содержать команду Launch();
# library - Библиотека. Может с помощью специальных методов, доступных только этому типу файлов, регистрировать новые модули API, которые используются модами, если те эту библиотеку импортируют. Этот тип файлов не надо описывать, если он находится в директории, заданной в параметре libraryDir.
# preloader - Отдельный специфический тип файла, который будет выполняться до загрузки MCPE после загрузки ресурсов и требуется для их создания и изменения. На момент написания данной документации, использует отдельный тип API, который еще плохо реализован.
# custom - Выполняется только с помощью специального метода - runCustomSource(), вызванного из остальных типов исполняемых файлов. Может принимать параметры.<span class="mw_htmlentity"></span>

Подробнее про каждый тип файлов и их специальные методы и значения будет рассказано в [[InnerCore/Базовые_методы_и_переменные_исполняемых_файлов|отдельной главе ]].

==Построение исполняемых файлов==
Исполняемым файлам можно задавать построение из отдельных директорий. Построение происходит из многих файлов, которые описываются в файле построения. Этот метод позволяет разбивать код на части и группировать их, а не писать один огромный файл. Это дает не только читабельность, но так же позволяет более оптимально компилировать моды и дебажить их в продакшине.

Директории построения задаются в разделе buildDirs, который является массивом:
<syntaxhighlight lang="javascript">{
"defaultConfig": {
...
},
...
"buildDirs": [
{
"dir":"dir/to/build/", #Директория, из которой будет выполняться построение, должна заканчиваться символом /
"targetSource":"dir/to/source/file", #Файл, в который будет выполняться построение. ВАЖНО: содержимое файла будет полностью перезаписываться при каждом построении, так что не стоит там что либо писать.
},
...
]
}</syntaxhighlight>

Директория построения задается следующим образом:

* Она должна содержать файлы с кодом, которые вы хотите объединить в исполняемый файл. Они могут находиться в дочерних директориях и иметь любые названия.
* Она должна содержать файл построения .includes, в нем прописаны все локальные пути файлов, которые участвуют в построении в нужном порядке, так же он может содержать комментарии (// или #) и пустые строки
Пример содержимого .includes:
<pre>// Предположим, что .includes находится в директории dev/ в моде<br class="mw_emptyline_first"><br class="mw_emptyline_first">// Этот файл должен находиться на пути dev/header.js
header.js<br class="mw_emptyline_first"><br class="mw_emptyline_first">// Эти файлы соответсвенно должны находиться в dev/source/
source/blocks.js
source/items.js</pre>

Важно понимать, что каждый из этих файлов должен быть завершенным куском кода, потому что каждый из них компилируется по отдельности. Т.е. нельзя начать блок в одном файле и закончить в следующем.

==Ресурсы==
Ресурсы модов делятся на две группы - текстуры интерфейса (GUI) и остальные (блоки, предметы, текстуры для моделей и т.п.). Какие бывают типы ресурсов будет рассказано в [[InnerCore/Ресурсы|отдельной главе ]].

Директории ресурсов описываются в разделе resources, их может быть сколько угодно много:
<syntaxhighlight lang="javascript">{
"defaultConfig": {
...
},
...
"resources": [
{
"path":"resource/dir/", #Директория ресурсов, должна заканчиваться символом /
"resourceType":"resource|gui", #Тип подгрузки ресурсов: resource - внутриигровые ресурсы, gui - текстуры интерфейса
},
...
]
}</syntaxhighlight>

Подробно о ресурсах и их использовании будет рассказано [[InnerCore/Ресурсы|отдельно ]].<br />
<span class="mw_htmlentity"></span>

Заглавная страница

2018-03-19T18:15:30Z

193.105.201.12:

Mineprogramming Wiki - уникальный проект на основе [https://www.mineprogramming.org/ mineprogramming ], на котором собрано все, что нужно для программирования в среде Minecraft. Здесь вы сможете найти информацию о таких языках и технологиях, как [[InnerCore|InnerCore ]], [[ModPE|ModPE ]], [[CoreEngine|CoreEngine ]] , [[PocketMine|PocketMine ]], [[Forge|Forge ]], [[Minecraft_add-ons|Minecraft add-ons ]] и многим другим.
[https://www.mineprogramming.org/ Mineprogramming ]- еще более уникальный проект, посвященный программированию в Майнкрафте, при чем если на wiki вы найдете информацию по конкретным языкам и технологиям, то на[https://www.mineprogramming.org/ Mineprogramming ]расположены наши программы для создания модов, наши моды, а так же различные интересные статьи, посвященные программированию в Майнкрафте!
==Технологии Minecraft==

* [[InnerCore|InnerCore ]] - революционный загрузчик модов для MinecraftPocket Edition. Имеет схожий с [[CoreEngine|CoreEngine ]]API
* [[ModPE|ModPE ]]- простейшее линейное API моддинга MCPE. Поддерживает создание предметов и блоков, работу с мобами, окружением, игроком.
* [[CoreEngine|CoreEngine ]]- движок, существенно расширяющий возможности [[ModPE|ModPE ]]. Может создавать интерфейс, контейнеры, обновляемые обьекты, сжимает блоки в мнимые id.
* [[Forge|Forge ]]- открытое API для моддинга Minecraft PC.
* [[Командные_блоки|Командные блоки ]]- блоки-терминалы, работающие от редстоуна. Простейший способ запрограммировать что-либо в Minecraft.
* [[PocketMine|PocketMine ]]- серверное ядро для Minecraft PE. . Является основой для большинства современных серверных движков на ПЕ, сам по себе устарел и не обновляется.
* [[Nukkit|Nukkit ]] - серверное ядро для Minecraft PE, разработанное на Java.
* [[Bukkit|Bukkit ]]- серверное ядро для Minecraft PC. Является основой для большинства современных серверных движков на ПК, сам по себе устарел и не обновляется.
* [[Vanillia|Vanillia ]]- официальное серверное ядро Minecraft PC.
* [[Minecraft_add-ons|Minecraft add-ons ]]- официальное закрытое API для моддинга Minecraft PE. Возможно изменение поведения мобов, текстур, шейдеров, добавление новых блоков за счет дат уже существующих, изменять еду и посадки.

==Теория и практика программирования в Minecraft==

* [[ID_блоков_и_предметов|ID блоков и предметов ]]

InnerCore/Структура модов

2018-03-19T18:09:08Z

193.105.201.12:

==Структура модов==
Мод под Inner Core представляет из себя директорию с файлом построения build.config, так же могут присутствовать несколько дополнительных файлов, таких как файл описания и стандартный файл конфигурации. Последний будет создан автоматически.

Если вы не хотите вдаваться в подробности построения модов, вы можете использовать стандартный шаблон мода, который описан [[InnerCore/Стандартный_шаблон_модов|здесь ]].

==Конфиг и описание==
Файл конфига - config.json - задается в формате JSON и генерируется, либо исправляется автоматически. Всегда будет присутствовать значение enabled, которое включает/выключает весь мод. Содержимое этого файла будет визуализировано в меню мода, которое открывается через меню Inner Core. Работа с этим файлом производистся целиком из кода.

Файл информации - mod.info - задается в формате JSON и может не пристуствовать, однако тогда информации о моде в меню Inner Core не будет, название мода будет по имени директории и т.д.<span class="mw_htmlentity"></span><br />
Формат файла mod.info:
<syntaxhighlight lang="javascript">{
"name":"Имя мода",
"author":"Автор мода",
"version":"Версия мода в любом формате",
"description":"Краткое описание мода"
}</syntaxhighlight>

Так же директоря мода может содержать файл mod_icon.png, который будет являться иконкой мода в меню Inner Core. Важен только формат - png - размер может быть любым.

==Основные параметры==
Файл построения задается в формате JSON и имеет несколько разделов, в которых описываются различные настройки и элементы мода.<br />
Первый раздел - defaultConfig - является обязательным и описывает основные параметры построения мода. С ним содержимое файла построения будет выглядеть следующим образом (комментарии, помеченные символом #, присутствовать не должны):
<syntaxhighlight lang="javascript">{
"defaultConfig": {
"api":"CoreEngine", #API, которое будет использовано для всех выполняемых файлов по-умолчанию, варианты API будут перечислены далее
"buildType":"develop", #Этот параметр при разработке должен быть develop, далее он будет изменяться с помощью Inner Core
"libraryDir":"lib/", #Необязательный параметр, который задает стандартную директорию, откуда будут загружаться библиотеки.
}
}</syntaxhighlight>

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

Виды API:

* CoreEngine - Основной и самый объемный API для разработки модов. В основном вам нужно будет использовать его, остальные варианты более ситуативны и не нужны в большинстве случаев.
* AdaptedScript - Реализует основные возможности, однако не имеет различных реализаций, сильно упрощающих разработку, таких как Tile Entity.

==Исполняемые файлы==
Исполняемые файлы содержат исходный код мода, написаный под нужный вариант API на JavaScript, которые будут выполняться в различные моменты, зависящие от их типа. Так же их можно строить из отдельных директорий и компилировать в байт-код из меню Inner Core для быстродействия и лучшего дебага (релизные версии мода).

Исполняемые файлы описываются в разделе compile, который является массивом. Их может быть сколько угодно много:
<syntaxhighlight lang="javascript">{
"defaultConfig": {
...
},
...
"compile": [
{
"path":"Локальный путь к файлу, к примеру main.js, source/logger.js",
"sourceType":"Тип исполняемого файла, они будут перечислены далее",
"sourceName":"Имя, необязательный параметр, будет использовано при выводе ошибок",
"api":"Тип API, если вы хотите выбрать не тот тип, который вы указали в defaultConfig конкретно для этого файла, иначе этот параметр не нужен"
},
...
]
}</syntaxhighlight>

Типы исполняемых файлов:

# mod - В этом типе файлов находится основной исходный код модов, задающий их контент.
# launcher - Должен присутствовать только один файл этого типа. В нем осуществляется запуск мода в определенный момент (Например если мод использует API другого мода, он должен запуститься только после его загрузки и т.п.). Если никаких дополнительных условий для запуска не нужно, он просто должен содержать команду Launch();
# library - Библиотека. Может с помощью специальных методов, доступных только этому типу файлов, регистрировать новые модули API, которые используются модами, если те эту библиотеку импортируют. Этот тип файлов не надо описывать, если он находится в директории, заданной в параметре libraryDir.
# preloader - Отдельный специфический тип файла, который будет выполняться до загрузки MCPE после загрузки ресурсов и требуется для их создания и изменения. На момент написания данной документации, использует отдельный тип API, который еще плохо реализован.
# custom - Выполняется только с помощью специального метода - runCustomSource(), вызванного из остальных типов исполняемых файлов. Может принимать параметры.<span class="mw_htmlentity"></span>

Подробнее про каждый тип файлов и их специальные методы и значения будет рассказано в [[InnerCore/Базовые_методы_и_переменные_исполняемых_файлов|отдельной главе ]].

==Построение исполняемых файлов==
Исполняемым файлам можно задавать построение из отдельных директорий. Построение происходит из многих файлов, которые описываются в файле построения. Этот метод позволяет разбивать код на части и группировать их, а не писать один огромный файл. Это дает не только читабельность, но так же позволяет более оптимально компилировать моды и дебажить их в продакшине.

Директории построения задаются в разделе buildDirs, который является массивом:
<syntaxhighlight lang="javascript">{
"defaultConfig": {
...
},
...
"buildDirs": [
{
"dir":"dir/to/build/", #Директория, из которой будет выполняться построение, должна заканчиваться символом /
"targetSource":"dir/to/source/file", #Файл, в который будет выполняться построение. ВАЖНО: содержимое файла будет полностью перезаписываться при каждом построении, так что не стоит там что либо писать.
},
...
]
}</syntaxhighlight>

Директория построения задается следующим образом:

* Она должна содержать файлы с кодом, которые вы хотите объединить в исполняемый файл. Они могут находиться в дочерних директориях и иметь любые названия.
* Она должна содержать файл построения .includes, в нем прописаны все локальные пути файлов, которые участвуют в построении в нужном порядке, так же он может содержать комментарии (// или #) и пустые строки
Пример содержимого .includes:
<pre>// Предположим, что .includes находится в директории dev/ в моде<br class="mw_emptyline_first"><br class="mw_emptyline_first">// Этот файл должен находиться на пути dev/header.js
header.js<br class="mw_emptyline_first"><br class="mw_emptyline_first">// Эти файлы соответсвенно должны находиться в dev/source/
source/blocks.js
source/items.js</pre>

Важно понимать, что каждый из этих файлов должен быть завершенным куском кода, потому что каждый из них компилируется по отдельности. Т.е. нельзя начать блок в одном файле и закончить в следующем.

==Ресурсы==
Ресурсы модов делятся на две группы - текстуры интерфейса (GUI) и остальные (блоки, предметы, текстуры для моделей и т.п.). Какие бывают типы ресурсов будет рассказано в [[InnerCore/Ресурсы|отдельной главе ]].

Директории ресурсов описываются в разделе resources, их может быть сколько угодно много:
<syntaxhighlight lang="javascript">{
"defaultConfig": {
...
},
...
"resources": [
{
"path":"resource/dir/", #Директория ресурсов, должна заканчиваться символом /
"resourceType":"resource|gui", #Тип подгрузки ресурсов: resource - внутриигровые ресурсы, gui - текстуры интерфейса
},
...
]
}</syntaxhighlight>

Подробно о ресурсах и их использовании будет рассказано [[InnerCore/Ресурсы|отдельно ]].<br />
<span class="mw_htmlentity"></span>

InnerCore

2018-02-28T11:40:28Z

193.105.201.12:

InnerCore был создан на базе чистого MCPE 1.0.3 и является полноценной средой для создания и игры с модами, дающей возможности куда большие, чем [[CoreEngine|CoreEngine]] & [[BlockLauncher|BlockLauncher]].<br/> Написанная с нуля нативная часть позволила решить абсолютное большинство проблем, связанных с моддингом на базе [[BlockLauncher|BlockLauncher]] и сделать API намного эффективнее.

== Документация по InnerCore ==

*Построение модов
**[[InnerCore/Структура_модов|Структура модов]]
**[[InnerCore/Стандартный_шаблон_модов|Стандартный шаблон модов]]
**[[InnerCore/Ресурсы|Ресурсы]]
**[[InnerCore/Компиляция_в_байткод|Компиляция в байткод]]
**[[InnerCore/Базовые_методы_и_переменные_исполняемых_файлов|Базовые методы и переменные исполняемых файлов]]
*События в игре. Модуль Callback
**[[InnerCore/Модуль_Callback|Модуль Callback]]
**[[InnerCore/Список_коллбеков|Список коллбеков]]
*Блоки и предметы
**[[InnerCore/Создание_блоков_и_предметов|Создание блоков и предметов]]
**[[InnerCore/Продвинутое_создание_блоков_и_предметов|Продвинутое создание блоков и предметов]]
**[[InnerCore/TileEntity|TileEntity]]
**[[InnerCore/Рецепты|Рецепты]]
**[[InnerCore/Жидкости_и_работа_с_ними|Жидкости и работа с ними]]
**[[InnerCore/Броня|Броня]]
*[[InnerCore/Модуль_World|Модуль World]]
*[[InnerCore/Модуль_Game|Модуль Game]]
*Сущности
**[[InnerCore/Модуль_Entity|Модуль Entity]]
**[[InnerCore/Создание_мобов|Создание мобов]]
**[[InnerCore/Пример_создания_моба|Пример создания моба]]
*[[InnerCore/Модуль_Player|Модуль Player]]
*GUI
**[[InnerCore/Модуль_UI|Модуль UI]]
**[[InnerCore/Введение_в_GUI|Введение в GUI]]
**[[InnerCore/Контейнеры|Контейнеры]]
**[[InnerCore/Динамичный_интерфейс|Динамичный интерфейс]]
*[[InnerCore/Модуль_ModAPI|Модуль ModAPI]]
*[[InnerCore/Модуль_Updatable|Модуль Updatable]]
*[[InnerCore/Модуль_GameObject|Модуль GameObject]]
*[[InnerCore/Анимации|Анимации]]
*Отладка
**[[InnerCore/Модуль_Logger|Модуль Logger]]
**[[InnerCore/Модуль_Debug|Модуль Debug]]
*[[InnerCore/Частицы|Частицы]]
*[[InnerCore/Переводы|Переводы]]
*[[InnerCore/Многопоточность|Многопоточность]]

== Список модов ==

{| border="1" cellpadding="1" cellspacing="1" style="width: 100%;"
|-
| Название мода
| Автор
| Мод в браузере
| Краткое описание
|-
| Radiation Craft
| [https://icmods.mineprogramming.org/search.php?author=67 Event_]
| [https://icmods.mineprogramming.org/mod.php?id=85 Radiation Craft]
|  
|}

 

 

InnerCore/Модуль Player

2018-02-05T11:57:34Z

193.105.201.12:

Для взаимодействия с игроком существует модуль Player.

*Player.addItemToInventory(itemId, count) - добавляет предмет в инвентарь игрока
*Player.get() - возвращает игрока как сущность для работы с ним с помощью модуля Entity.
*Player.getNameForEnt(player) - возвращает имя игрока как сущности player.
*Player.getName() - возвращает имя игрока.
*Player.getDimension() - возвращает id измерения, в котором находится игрок.
*Player.isPlayer(mob) - проверяет, является ли сущность mob игроком.
*Player.getPointed() - возвращает обьект, на который смотрит игрок.
*Player.getInventory(mob, [object], [object]) - возвращает инвентарь игрока как сущности mob.
*Player.getCarriedItem() - возвращает предмет, который держит игрок.
*Player.setCarriedItem(id, count, data) - заставляет игрока держать предмет с id, count, data.
*Player.decreaseCarriedItem(count) - удаляет count предметов из руки игрока.
*Player.setPosition(x, y, z) - ставит игрока на координаты x, y, z.
*Player.getPosition() - возвращает координаты игрока.
*Player.addPosition(x, y, z) - смещает игрока на координаты x, y, z.
*Player.setVelocity(velx, vely, velz) - ставит игроку трехмерное ускорение velx, vely, velz.
*Player.getVelocity() - возвращает трехмерное ускорение игрока.
*Player.addVelocity(velx, vely, velz) - добавляет игроку трехмерное ускорение velx, vely, velz.
*Player.experience() - возвращает состояние опыта игрока.
*Player.getExperience() - возвращает опыт игрока.
*Player.setExperience(exp) - устанавливает exp опыта игроку.
*Player.addExperience(exp) - добавляет exp опыта игроку.
*Player.level() - возвращает состояние уровня игрока.
*Player.getLevel() - возвращает уровень игрока.
*Player.setLevel(lvl) - ставит lvl уровень игроку.
*Player.addLevel(lvl) - добавляет lvl уровней игроку.
*Player.flying() - возвращает состояние полета игрока.
*Player.getFlyingEnabled() - проверяет, может ли летать игрок.
*Player.setFlyingEnabled(fly?) - устанавливает возможность игрока летать.
*Player.getFlying() - проверяет, летит ли игрок.
*Player.setFlying(fly?) - устанавливает состояние полета игрока.
*Player.exhaustion() - возвращает состояние истощения игрока.
*Player.getExhaustion() - возвращает истощение игрока.
*Player.setExhaustion(exh) - задает игроку exh единиц истощения.
*Player.hunger() - возвращает состояние сытости игрока.
*Player.getHunger() - возвращает сытость игрока.
*Player.setHunger(hnr) - задает hnr единиц сытости игрока.
*Player.saturation() - возвращает состояние насыщения игрока.
*Player.getSaturation() - возвращает насыщение игрока.
*Player.setSaturation(sat) - задает sat единиц насыщения игроку.
*Player.health() - возвращает состояние здоровья игрока.
*Player.getHealth() - возвращает здоровье игрока.
*Player.setHealth(hp) - задает hp единиц здоровья игроку.
*Player.score() - возвращает состояние счета игрока.
*Player.getScore() - возвращает счет игрока.