StorageInterface — различия между версиями
| Строка 1: | Строка 1: | ||
| − | <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"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"> |
Данная библиотека для Inner Core позволяет описать взаимодействие блоков с трубами, воронками и прочими предметами для транспортировки предметов и жидкостей с помощью интерфейсов хранилищ, а так же добавляет методы для извлечения и загрузки предметов и жидкостей. | Данная библиотека для Inner Core позволяет описать взаимодействие блоков с трубами, воронками и прочими предметами для транспортировки предметов и жидкостей с помощью интерфейсов хранилищ, а так же добавляет методы для извлечения и загрузки предметов и жидкостей. | ||
<div class="mw-parser-output"><div class="mw-parser-output"> | <div class="mw-parser-output"><div class="mw-parser-output"> | ||
| Строка 38: | Строка 38: | ||
<div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">StorageInterface.createInterface(id блока, {<br/> slots: {<br/> "slot1": {<br/> input: bool, // может ли слот принимать предметы<br/> output: bool, // может ли слот отдавать предметы<br/> isValid: function(item, side, tileEntity){ // может ли слот принять предмет item со стороны side<br/> return bool;<br/> },<br/> canOutput: function(item, side, tileEntity){ // можно ли извлечь предмет из слота (item - предмет в слоте)<br/> return bool;<br/> }<br/> },<br/> "slot2": {<br/> ...<br/> },<br/> ...<br/> },<br/> isValidInput: function(item, side, tileEntity){ // аналогична функции isValid слота, но действует на все слоты контейнера<br/> return true;<br/> },<br/> addItem: function(item, side, maxCount){ return int; }, // функция добавления предмета<br/> getOutputSlots: function(side){ return []; }, // функция получения слотов для извлечения предметов<br/> <br/> // методы работы с хранилищем жидкости<br/> canReceiveLiquid: function(liquid, side){ return false; }, // может ли tile entity принять жидкость (liquid - название жидкости)<br/> canTransportLiquid: function(liquid, side){ return false; }, // может ли tile entity отдать жидкость (liquid - название жидкости)<br/> addLiquid: function(liquid, amount){ // функция добавление жидкости<br/> return this.liquidStorage.addLiquid(luquid, amount);<br/> }<br/> getLiquid: function(liquid, amount){ // функция извлечения жидкости<br/> return this.liquidStorage.getLiquid(luquid, amount);<br/> }<br/> });</div> | <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">StorageInterface.createInterface(id блока, {<br/> slots: {<br/> "slot1": {<br/> input: bool, // может ли слот принимать предметы<br/> output: bool, // может ли слот отдавать предметы<br/> isValid: function(item, side, tileEntity){ // может ли слот принять предмет item со стороны side<br/> return bool;<br/> },<br/> canOutput: function(item, side, tileEntity){ // можно ли извлечь предмет из слота (item - предмет в слоте)<br/> return bool;<br/> }<br/> },<br/> "slot2": {<br/> ...<br/> },<br/> ...<br/> },<br/> isValidInput: function(item, side, tileEntity){ // аналогична функции isValid слота, но действует на все слоты контейнера<br/> return true;<br/> },<br/> addItem: function(item, side, maxCount){ return int; }, // функция добавления предмета<br/> getOutputSlots: function(side){ return []; }, // функция получения слотов для извлечения предметов<br/> <br/> // методы работы с хранилищем жидкости<br/> canReceiveLiquid: function(liquid, side){ return false; }, // может ли tile entity принять жидкость (liquid - название жидкости)<br/> canTransportLiquid: function(liquid, side){ return false; }, // может ли tile entity отдать жидкость (liquid - название жидкости)<br/> addLiquid: function(liquid, amount){ // функция добавление жидкости<br/> return this.liquidStorage.addLiquid(luquid, amount);<br/> }<br/> getLiquid: function(liquid, amount){ // функция извлечения жидкости<br/> return this.liquidStorage.getLiquid(luquid, amount);<br/> }<br/> });</div> | ||
Здесь указаны все функции объекта интерфейса, которые можно задать этим методом. При их отсутствии добавляются функции по умолчанию, и для некоторых функций приведён их код. | Здесь указаны все функции объекта интерфейса, которые можно задать этим методом. При их отсутствии добавляются функции по умолчанию, и для некоторых функций приведён их код. | ||
| − | <div class="mw-parser-output">Интерфейс хранилища сохраняется в поле ''interface ''объекта tile entity. В экземпляре интерфейса есть следующие указатели:</div> <div class="mw-parser-output">''tileEntity ''- на tile entity, к которому он привязан;</div> <div class="mw-parser-output">''container ''- на контейнер tile entity;</div> <div class="mw-parser-output">''liquidStorage ''- на хранилище жидкости tileEntity.</div> | + | <div class="mw-parser-output">Интерфейс хранилища сохраняется в поле ''interface ''объекта tile entity. В экземпляре интерфейса есть следующие указатели:</div> <div class="mw-parser-output">''tileEntity ''- на tile entity, к которому он привязан;</div> <div class="mw-parser-output">''container ''- на контейнер tile entity;</div> <div class="mw-parser-output">''liquidStorage ''- на хранилище жидкости tileEntity.</div> <div class="mw-parser-output"> </div> <div class="mw-parser-output">Добавление интерфейса для tile entity на примере железной печки из мода IndustrialCraft 2</div> <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">StorageInterface.createInterface(BlockID.ironFurnace, {<br/> slots: {<br/> "slotSource": {<br/> input: true,<br/> isValid: function(item, side){<br/> return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");<br/> }<br/> },<br/> "slotFuel": {<br/> input: true, <br/> isValid: function(item, side){<br/> return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;<br/> }<br/> },<br/> "slotResult": {output: true}<br/> }<br/> });</div> </div> <div class="mw-parser-output"><div class="mw-parser-output"> |
| − | Добавление интерфейса для tile entity на примере железной печки из мода IndustrialCraft 2 | ||
| − | <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">StorageInterface.createInterface(BlockID.ironFurnace, {<br/> slots: {<br/> "slotSource": {<br/> input: true,<br/> isValid: function(item, side){<br/> return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");<br/> }<br/> },<br/> "slotFuel": {<br/> input: true, <br/> isValid: function(item, side){<br/> return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;<br/> }<br/> },<br/> "slotResult": {output: true}<br/> }<br/> });</div> </div> <div class="mw-parser-output"><div class="mw-parser-output"> | ||
== Методы для передачи предметов и жидкостей == | == Методы для передачи предметов и жидкостей == | ||
| Строка 95: | Строка 93: | ||
Данная библиотека совместима с модами, использующими старый стандарт описания слотов tile entity через функцию ''getTransportSlots'', а так же добавляет эту функцию и функцию ''addTransportedItem ''для tile entity при создании его интерфейса. | Данная библиотека совместима с модами, использующими старый стандарт описания слотов tile entity через функцию ''getTransportSlots'', а так же добавляет эту функцию и функцию ''addTransportedItem ''для tile entity при создании его интерфейса. | ||
| − | </div> </div> </div> </div> </div> </div> | + | </div> </div> </div> </div> </div> </div> </div> </div> |
Версия 00:30, 5 марта 2020
Данная библиотека для Inner Core позволяет описать взаимодействие блоков с трубами, воронками и прочими предметами для транспортировки предметов и жидкостей с помощью интерфейсов хранилищ, а так же добавляет методы для извлечения и загрузки предметов и жидкостей.
Импорт
Для добавления библиотеки в мод ее файл (StorageInterface.js) нужно добавить в директорию lib/ в директории мода (если таковой нету, то ее нужно создать).
Для импорта библиотеки в мод в заголовочном файле (или если он остутвует в первом файле кода) следует добавить строку:
IMPORT("StorageInterface");
Интерфейсы хранилищ блоков
На данный момент интерфейсы привязываются только к tile entity, но в будущем по умолчанию интерфейсы будут прописаны у контейнеров из Майнкрафта, прежде всего печки.
Интерфейс для хранилища добавляется с помощью метода StorageInterface.createInterface(id блока, объект интерфейса) и в общем виде выглядит так:
StorageInterface.createInterface(id блока, {
slots: {
"slot1": {
input: bool, // может ли слот принимать предметы
output: bool, // может ли слот отдавать предметы
isValid: function(item, side, tileEntity){ // может ли слот принять предмет item со стороны side
return bool;
},
canOutput: function(item, side, tileEntity){ // можно ли извлечь предмет из слота (item - предмет в слоте)
return bool;
}
},
"slot2": {
...
},
...
},
isValidInput: function(item, side, tileEntity){ // аналогична функции isValid слота, но действует на все слоты контейнера
return true;
},
addItem: function(item, side, maxCount){ return int; }, // функция добавления предмета
getOutputSlots: function(side){ return []; }, // функция получения слотов для извлечения предметов
// методы работы с хранилищем жидкости
canReceiveLiquid: function(liquid, side){ return false; }, // может ли tile entity принять жидкость (liquid - название жидкости)
canTransportLiquid: function(liquid, side){ return false; }, // может ли tile entity отдать жидкость (liquid - название жидкости)
addLiquid: function(liquid, amount){ // функция добавление жидкости
return this.liquidStorage.addLiquid(luquid, amount);
}
getLiquid: function(liquid, amount){ // функция извлечения жидкости
return this.liquidStorage.getLiquid(luquid, amount);
}
});
slots: {
"slot1": {
input: bool, // может ли слот принимать предметы
output: bool, // может ли слот отдавать предметы
isValid: function(item, side, tileEntity){ // может ли слот принять предмет item со стороны side
return bool;
},
canOutput: function(item, side, tileEntity){ // можно ли извлечь предмет из слота (item - предмет в слоте)
return bool;
}
},
"slot2": {
...
},
...
},
isValidInput: function(item, side, tileEntity){ // аналогична функции isValid слота, но действует на все слоты контейнера
return true;
},
addItem: function(item, side, maxCount){ return int; }, // функция добавления предмета
getOutputSlots: function(side){ return []; }, // функция получения слотов для извлечения предметов
// методы работы с хранилищем жидкости
canReceiveLiquid: function(liquid, side){ return false; }, // может ли tile entity принять жидкость (liquid - название жидкости)
canTransportLiquid: function(liquid, side){ return false; }, // может ли tile entity отдать жидкость (liquid - название жидкости)
addLiquid: function(liquid, amount){ // функция добавление жидкости
return this.liquidStorage.addLiquid(luquid, amount);
}
getLiquid: function(liquid, amount){ // функция извлечения жидкости
return this.liquidStorage.getLiquid(luquid, amount);
}
});
Здесь указаны все функции объекта интерфейса, которые можно задать этим методом. При их отсутствии добавляются функции по умолчанию, и для некоторых функций приведён их код.
Интерфейс хранилища сохраняется в поле interface объекта tile entity. В экземпляре интерфейса есть следующие указатели:
tileEntity - на tile entity, к которому он привязан;
container - на контейнер tile entity;
liquidStorage - на хранилище жидкости tileEntity.
Добавление интерфейса для tile entity на примере железной печки из мода IndustrialCraft 2
StorageInterface.createInterface(BlockID.ironFurnace, {
slots: {
"slotSource": {
input: true,
isValid: function(item, side){
return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");
}
},
"slotFuel": {
input: true,
isValid: function(item, side){
return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;
}
},
"slotResult": {output: true}
}
});
slots: {
"slotSource": {
input: true,
isValid: function(item, side){
return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");
}
},
"slotFuel": {
input: true,
isValid: function(item, side){
return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;
}
},
"slotResult": {output: true}
}
});
Методы для передачи предметов и жидкостей
| Название | Аргументы | Описание |
| getNearestContainers | coords, side, sideExcluded | Возвращает соседние с блоком на координатах coords контейнеры в виде массива. Если указан параметр side, то вернёт контейнер с этой стороны. Если sideExcluded равен true, то наоборот, все контейнеры кроме контейнера с указанной стороны. |
| getNearestLiquidStorages | coords, side, sideExcluded | Аналогична предыдущей, но возвращает все соседние tile entity, имеющие хранилища жидкостей. |
| putItems | items, containers | Добавляет предметы из массива items в контейнеры из массива containers. Удобно использовать в связке с методом getNearestContainers. |
| putItemToContainer | item, container, side, maxCount | Метод более низкого уровня, на котором основана работа предыдущего метода. Добавляет стак предметов в контейнер, но позволяет также указать максимальное количество предметов, которое может быть передано за раз. |
| extractItemsFromContainer | inputContainer, container, side, maxCount, oneStack |
Позволяет извлечь предмет из контейнера и добавить его в tile entity. |
| transportLiquid | liquid, maxAmount, outputTile, inputTile, outputSide |
Передаёт жидкость из одного tile entity в другой. |
| extractLiquid | liquid, maxAmount, inputTile, outputTile, inputSide |
Похож на предыдущий, но позволяет извлечь жидкость из tile entity |
| checkHoppers | tileEntity | Позволяет tile entity взаимодействовать с воронками. Для этого должна выполняться в функции тика tile entity. Требует интерфейса хранилища у tile entity для работы. |
| addItemToSlot | item, slot, count | Внутренний метод библиотеки для добавления предмета в слот. При использовании на нативном контейнере нужно также установить слот, используя container.setSlot. |
Обратная совместимость
Данная библиотека совместима с модами, использующими старый стандарт описания слотов tile entity через функцию getTransportSlots, а так же добавляет эту функцию и функцию addTransportedItem для tile entity при создании его интерфейса.